os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Correct the Months for this report

Browse source 
- Unhide the bin category
- Add bapt's report about mandoc(1)

Reviewed by:	bcr, bjk
This commit is contained in:
Brad Davis 2015-01-06 23:04:13 +00:00
parent 990934359c
commit 2343b0c247
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=46151
1 changed files with 65 additions and 3 deletions

68
en_US.ISO8859-1/htdocs/news/status/report-2014-10-2014-12.xml
View file

@ -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>