The futur of the roff toolchain

[Glen Barber]

On Sun, May 21, 2017 at 02:57:33PM +0200, Baptiste Daroussin wrote:
> No the problem left is documentations available in share/doc.
> 
> I would like to push them elsewhere. Those documents are mostly useful for
> historical reason (hence we want to keep them) but not really for daily use of
> modern FreeBSD.
> Another issue with those documentation, they are installed as text/ascii version
> in base, which makes most of them not really readable (as the documents has not
> be written for a ascii/text target but more for a PDF/html view - using pic(1)
> for example)
> 
> A plan was to push as sources in the svn doc repository and continue to build
> them. This approach also have an issue: over the time roff evolved a bit and
> while working on heirloom doctools import I had to fix a bunch of markup to make
> the rendering of those documents clean (also meaning almost noone should read
> them considering some were not really readable).
> 
> What I want to propose now, it to render them as PDF (html?) once and push them
> somewhere (to be defined) as static document on our documentation website.
> Please doceng@ provide me a location where to push them.
> 

Unless anyone on doceng@ objects within the next three days, I will
create a new directory for the PDFs under doc/head/en_US.ISO8859-1/.

Glen
Hat:	doceng@

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20170525/7fc72522/attachment.sig>