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] _______________________________________________ freebsd-doc@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
