Bug 248194

Summary:	New section in FDP primer chapter 13, "Manual Pages": Testing mdoc markup
Product:	Documentation	Reporter:	Pau Amma <pauamma>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed Overcome By Events
Severity:	Affects Only Me	CC:	carlavilla, fernape
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/manpages.html

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

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.