The futur of the roff toolchain

Baptiste Daroussin bapt at FreeBSD.org
Thu May 25 12:59:49 UTC 2017


On Thu, May 25, 2017 at 01:12:51PM +0100, tj wrote:
> On Thu, May 25, 2017 at 02:07:00PM +0200, Baptiste Daroussin wrote:
> > 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@ 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/.
> > > 
> > 
> > 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.
> > 
> 
> Multicolumn doesn't render correct in firefox for this:
> 
> https://people.freebsd.org/~bapt/pdfdocs/papers/timecounter.pdf
> 
> but is fine for this:
> 
> https://people.freebsd.org/~bapt/pdfdocs/papers/devfs.pdf
> 
> - [tj]

Fixed, and reuploaded. because there should be some caching on people.f.o you
cannot yet see the fixed version but I have fixed it. It is supposed to be a
monocolumn as far as I understand it.

Bapt
-------------- 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/5b7ee183/attachment.sig>


More information about the freebsd-doc mailing list