Bug 248194 - New section in FDP primer chapter 13, "Manual Pages": Testing mdoc markup
Summary: New section in FDP primer chapter 13, "Manual Pages": Testing mdoc markup
Status: Closed Overcome By Events
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-doc (Nobody)
URL: https://www.freebsd.org/doc/en_US.ISO...
Keywords:
Depends on:
Blocks:
 
Reported: 2020-07-23 00:43 UTC by Pau Amma
Modified: 2023-08-27 10:18 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Pau Amma 2020-07-23 00:43:52 UTC
That section, likely a short one, could just mention mandoc -T lint and using igor, but would still be useful to those (like me) making their first foray into manual page writing or revising.
Comment 1 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-08-27 09:36:52 UTC
Seems the problem is solved, https://docs.freebsd.org/en/books/fdp-primer/manual-pages/#manual-pages-testing

Bye and thanks for the report.
Comment 2 Graham Perrin 2023-08-27 10:17:56 UTC
Thanks, and belated thanks to fernape@ for <https://github.com/freebsd/freebsd-doc/commit/59e3915e5ca57b7a1be87a01f909929d554d6626> – I did find the current section of the primer very useful, in recent weeks, after I began learning about mdoc. 

Incidentally, from recent <https://lists.freebsd.org/archives/freebsd-hackers/2023-August/002438.html>: 

> … 
> deroff(1) removes a little too much; 
> <https://reviews.freebsd.org/P600$148-153>.
> 
> …

Over to freebsd-hackers, please, for anyone who'd like to continue the broader discussion, which had a spell-checking context.