From owner-svn-doc-all@freebsd.org Sat Oct 17 21:40:35 2015 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id CD147A17B29; Sat, 17 Oct 2015 21:40:35 +0000 (UTC) (envelope-from bjk@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 8F47D1A55; Sat, 17 Oct 2015 21:40:35 +0000 (UTC) (envelope-from bjk@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t9HLeYAA095377; Sat, 17 Oct 2015 21:40:34 GMT (envelope-from bjk@FreeBSD.org) Received: (from bjk@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id t9HLeYYM095376; Sat, 17 Oct 2015 21:40:34 GMT (envelope-from bjk@FreeBSD.org) Message-Id: <201510172140.t9HLeYYM095376@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bjk set sender to bjk@FreeBSD.org using -f From: Benjamin Kaduk Date: Sat, 17 Oct 2015 21:40:34 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47608 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 17 Oct 2015 21:40:36 -0000 Author: bjk Date: Sat Oct 17 21:40:34 2015 New Revision: 47608 URL: https://svnweb.freebsd.org/changeset/doc/47608 Log: Add report on the mandoc and roff toolchains, from bapt Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2015-07-2015-09.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2015-07-2015-09.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2015-07-2015-09.xml Sat Oct 17 21:20:08 2015 (r47607) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2015-07-2015-09.xml Sat Oct 17 21:40:34 2015 (r47608) @@ -2389,4 +2389,67 @@ + + mandoc and roff Toolchain + + + + + Baptiste + Daroussin + + bapt@FreeBSD.org + + + + + Heirloom + doctools + mandoc + + + +

mandoc is a suite of tools for compiling + mdoc, the roff macro language of choice for BSD + manual pages.

+ +

mandoc is the default renderer for manpages on + &os; head. This quarter, the apropos(1) utility was switched to + use mandoc's version, which offers a new database format (in + sqlite) bringing more powerful, fine-grained ways to search + manpages.

+ +

While mandoc is very good for manpages, we also provide + lots of other documentation in plain roff format. The + heirloom toolchain is being studied to replace groff in + base. The heirloom nroff toolchain has multiple benefits: it has + very good unicode support, and very good compatibility with + groff.

+ +

A great deal of work as been done testing the heirloom + nroff toolchain with all the roff documents in the base system + (including manpages), and upstream has been very proactive in + fixing reported bugs.

+ +

The 'soelim(1)' utility has been replaced with a + BSD-licensed version which is good enough to work with all available + roff toolchains (to ease transition). This version + of the soelim(1) utility, originally written solely for &os;, is + now part of the mandoc tool suite.

+ +

The col(1) utility has been cleaned up and updated to + recognize both SUSv2-style escape-digit and BSD-style + escape-control-char sequences in the input stream (in coordination + with Ingo Schwarze from OpenBSD)

+ +

The checknr(1) utility has been cleaned up and extended to + support modern roff(7) macros (including synchronizing code from NetBSD + and the heirloom docutils version).

+ +

Many roff fixes were made to documentation and manpages, + having been discovered while testing the new toolchain. +

+ + +