Date: Thu, 25 May 2017 14:59:47 +0200 From: Baptiste Daroussin <bapt@FreeBSD.org> To: tj <tj@enoti.me> Cc: Glen Barber <gjb@FreeBSD.org>, arch@freebsd.org, doc@FreeBSD.org, current@FreeBSD.org, doceng@freebsd.org Subject: Re: The futur of the roff toolchain Message-ID: <20170525125947.5myf5cavuyxvwvkr@ivaldir.net> In-Reply-To: <20170525121251.GB55153@tom-desk.erg.abdn.ac.uk> References: <20170521125733.bmd4tmq6iqpsbvgl@ivaldir.net> <20170525114519.GB17188@FreeBSD.org> <20170525120629.kv2bi4yjtzcegx4e@ivaldir.net> <20170525121251.GB55153@tom-desk.erg.abdn.ac.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
--efqrsk2ytmo7fvgn Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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. > > > >=20 > > > > I would like to push them elsewhere. Those documents are mostly use= ful for > > > > historical reason (hence we want to keep them) but not really for d= aily 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 docum= ents has not > > > > be written for a ascii/text target but more for a PDF/html view - u= sing pic(1) > > > > for example) > > > >=20 > > > > A plan was to push as sources in the svn doc repository and continu= e 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 m= arkup to make > > > > the rendering of those documents clean (also meaning almost noone s= hould read > > > > them considering some were not really readable). > > > >=20 > > > > What I want to propose now, it to render them as PDF (html?) once a= nd push them > > > > somewhere (to be defined) as static document on our documentation w= ebsite. > > > > Please doceng@ provide me a location where to push them. > > > >=20 > > >=20 > > > 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/. > > >=20 > >=20 > > Thank you, > >=20 > > For the record I have pushed the generated PDF: > > https://people.freebsd.org/~bapt/pdfdocs/ > >=20 > > The have been built with a modern groff and I forced the embedded fonts= for all > > fonts used. > >=20 >=20 > Multicolumn doesn't render correct in firefox for this: >=20 > https://people.freebsd.org/~bapt/pdfdocs/papers/timecounter.pdf >=20 > but is fine for this: >=20 > https://people.freebsd.org/~bapt/pdfdocs/papers/devfs.pdf >=20 > - [tj] Fixed, and reuploaded. because there should be some caching on people.f.o y= ou 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 --efqrsk2ytmo7fvgn Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEgOTj3suS2urGXVU3Y4mL3PG3PloFAlkm1ToACgkQY4mL3PG3 PloR3Q//Sus+q3+ZmmlLh+P16EmEAWbidUc0Ba5lsMTY7HBfMTtZhNn4HUbGsbdy Fu7nHar91tNzEmR1HofmA3U0NtI7WvdzzZTKWkBFIUg1WIEEox4+QygRazV+gZLp AKHw7/QlPNwrHLA7net+aI282qf8qglelCMTooDZpg3f7uV6p/zVImIDITC9ioxX wequmVtHQAmpREO8KoYN24xeuKfzBJvX69b1yNa6PDkrTuCJHlq5FjIhQ1mthfWj ZVAiAPl0AhoqrjYFoXt+6VylOsGMLP9MJdYNM4x+F//0gewJ10OAjSGwxXVyZtl+ 1zpLGkeR4qEVrAfSGP60umfztGz2n/wPw3bDAsRvAnxaj+ccfiJ9a/z9t92Tavek kQIdlsi2kmmQ50QVJdpBZolmNA7wCxbsiOagfos2wf9+3XxCsETobGUcwcLbhfSo SdKpr/3phIx4lfHHAaaEChStj/jRHWYd0tfcdGWWTl6EZ+iz4coyGMiqGFLiGZI5 CTkjt7wNrdE1pj5Ooc9Y7Is4yenL7i0Qtj8R0PB0YoDqMKzEnxJDZns4aH3pxJOA c3tcLsKlRG/cVMIII52FtFcbKExN+NmngPXdERJwgCGjc56JblZsXa2GPlM+Bsrc aC7plRtXkTAPb+8UVADjHc+YcafX4Egtt6kEoDdqN6ibjSB67GY= =ClDq -----END PGP SIGNATURE----- --efqrsk2ytmo7fvgn--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20170525125947.5myf5cavuyxvwvkr>