Re: The futur of the roff toolchain

From: Baptiste Daroussin <bapt_at_FreeBSD.org>
Date: Thu, 25 May 2017 14:07:00 +0200
On Thu, May 25, 2017 at 11:45:19AM +0000, Glen Barber wrote:
> 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_at_ provide me a location where to push them.
> > 
> 
> Unless anyone on doceng_at_ objects within the next three days, I will
> create a new directory for the PDFs under doc/head/en_US.ISO8859-1/.
> 

Thank you,

For the record I have pushed the generated PDF:
https://people.freebsd.org/~bapt/pdfdocs/

The have been built with a modern groff and I forced the embedded fonts for all
fonts used.

Best regards,
Bapt

Received on Thu May 25 2017 - 10:07:01 UTC

This archive was generated by hypermail 2.4.0 : Wed May 19 2021 - 11:41:11 UTC