Date: Tue, 6 Jan 2015 23:04:14 +0000 (UTC) From: Brad Davis <brd@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46151 - head/en_US.ISO8859-1/htdocs/news/status Message-ID: <201501062304.t06N4EQQ088719@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: brd Date: Tue Jan 6 23:04:13 2015 New Revision: 46151 URL: https://svnweb.freebsd.org/changeset/doc/46151 Log: - Correct the Months for this report - Unhide the bin category - Add bapt's report about mandoc(1) Reviewed by: bcr, bjk Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2014-10-2014-12.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2014-10-2014-12.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2014-10-2014-12.xml Tue Jan 6 21:08:22 2015 (r46150) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2014-10-2014-12.xml Tue Jan 6 23:04:13 2015 (r46151) @@ -7,7 +7,7 @@ <report> <date> - <month>July-September</month> + <month>October-December</month> <year>2014</year> </date> @@ -59,13 +59,11 @@ <description>Architectures</description> </category> - <?ignore <category> <name>bin</name> <description>Userland Programs</description> </category> - ?> <category> <name>ports</name> @@ -317,4 +315,68 @@ <task>More developers are needed, check the Issues on Github</task> </help> </project> + + <project cat="bin"> + <title>mandoc(1) support</title> + + <contact> + <person> + <name> + <given>Baptiste</given> + <common>Daroussin</common> + </name> + <email>bapt@FreeBSD.org</email> + </person> + <person> + <name> + <given>Ulrich</given> + <common>Spoerlein</common> + </name> + <email>uqs@FreeBSD.org</email> + </person> + <person> + <name> + <given>The Documentation Team</given> + </name> + <email>docs@FreeBSD.org</email> + </person> + </contact> + + <links> + <url href="http://mdocml.bsd.lv" /> + </links> + + <body> + <p><tt>mandoc(1)</tt> has been made the default manual page + formatter on HEAD -- man(1) will use <tt>mandoc(1)</tt> to + format manual pages by default, then fall back to + <tt>groff(1)</tt> if it fails.</p> + + <p>This change also fixes an issue with FreeBSD <tt>man(1)</tt> + command not able to properly deal with ".so" in gzipped manual + pages.</p> + + <p>The documentation team has spent a lot of time fixing issues + reported by <tt>mdoc(7)</tt> in the FreeBSD manual pages. This + greatly improves the quality of our manual pages.</p> + + <p>Most manual pages with remaining issues are from contrib/ for + which changes should be reported and fixed upstream.</p> + + <p>The "manlint" target has also been switch to use <tt>mandoc + -Tlint</tt> which results in the target being way more useful + when working on manual pages.</p> + + <p>Some <tt>groff(1)</tt> vs <tt>mandoc(1)</tt> formatting + differencies have been spotted and reported to mandoc's upstream + developers.</p> + </body> + + <help> + <task>Switch <tt>makewhatis(1)</tt> to the version shipped with <tt>mandoc(1)</tt></task> + <task>Figure out a way to detect non <tt>mandoc(1)</tt> friendly manpages from ports and create catpages with <tt>groff(1)</tt> for them</task> + <task>Remove <tt>groff(1)</tt> from base.</task> + </help> + </project> + </report>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201501062304.t06N4EQQ088719>