svn commit: r46151 - head/en_US.ISO8859-1/htdocs/news/status

Tue Jan 6 23:04:15 UTC 2015

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 at FreeBSD.org</email>
+      </person>
+      <person>
+	<name>
+	  <given>Ulrich</given>
+	  <common>Spoerlein</common>
+	</name>
+	<email>uqs at FreeBSD.org</email>
+      </person>
+      <person>
+	<name>
+	  <given>The Documentation Team</given>
+	</name>
+	<email>docs at 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>
