From owner-freebsd-doc@freebsd.org Thu May 25 12:22:03 2017 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 30CEFD809C6 for ; Thu, 25 May 2017 12:22:03 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: from mailman.ysv.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id 1CFF31EDF for ; Thu, 25 May 2017 12:22:03 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: by mailman.ysv.freebsd.org (Postfix) id 16E8BD809C3; Thu, 25 May 2017 12:22:03 +0000 (UTC) Delivered-To: doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 1610FD809BE; Thu, 25 May 2017 12:22:03 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [96.47.72.132]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "freefall.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id CDD1F1ED8; Thu, 25 May 2017 12:22:02 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: by freefall.freebsd.org (Postfix, from userid 1235) id 0C9864A0A; Thu, 25 May 2017 12:22:02 +0000 (UTC) Date: Thu, 25 May 2017 14:22:01 +0200 From: Baptiste Daroussin To: tj Cc: Glen Barber , arch@freebsd.org, doc@FreeBSD.org, current@FreeBSD.org, doceng@freebsd.org Subject: Re: The futur of the roff toolchain Message-ID: <20170525122201.7v5zfspu35a3qx47@ivaldir.net> References: <20170521125733.bmd4tmq6iqpsbvgl@ivaldir.net> <20170525114519.GB17188@FreeBSD.org> <20170525120629.kv2bi4yjtzcegx4e@ivaldir.net> <20170525121251.GB55153@tom-desk.erg.abdn.ac.uk> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="3fpbd6igd3luxhs4" Content-Disposition: inline In-Reply-To: <20170525121251.GB55153@tom-desk.erg.abdn.ac.uk> User-Agent: NeoMutt/20170428 (1.8.2) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 25 May 2017 12:22:03 -0000 --3fpbd6igd3luxhs4 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 Good catch thanks! I will see what I can do Bapt --3fpbd6igd3luxhs4 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEgOTj3suS2urGXVU3Y4mL3PG3PloFAlkmzGYACgkQY4mL3PG3 Plrl1A/9HWlW6GLv1EXf9ER47FzYBvz5okI6F99oCV53L6mpPc5lWKMb2Pwu8m+W cZumcsXtNpjS31GvG5BVifKoLZzBdYjHb5L6FyO1niFUWgPYrrOvtl0ZJixNEvpk 3M9PFTTURwIXJXlhEg5BkXcFEKowfrDibg8aQ0848/Wq0pOHuxvlg8bAVWU7BcLb N46av5gh3nW4gdt23wFtiSdM+/GnMZAbF3+RHDdtrmS8vhQsW2GRHJqx0sHApYSy TEt/n7F1kvyXGZbTOS7xuVMmYTH52+/XoQe3X/sxVzLT94Mf/1CMBh3lTvYoMaqI KGU5oLoIPYD0X/HSg31aCH6RwF8njiF6qdfBGmckZJymg33Vg1pJyDYkDF/u2GZ+ buUnjR5u3sNHIrWmyQI/syuZJlp1JhrgAvQU0AmxB1K2LE1z4WHeT3eCWeV3kM5C AJChnsmttYKDq0vVqR51RKLW4aWcGVH/MGF3YN5Odp/x4ruhI5o4hw/DNmf2/MqH LbTNnICfd84vnlKqNKG6gBezIJPUtvtwFE7KA92gS/dtcExYdmmB3UGT3MHAC/mr bDqgEp2VBrNh9I9ja/DOPgEJObyIMuv21xZ3xsJmOpXmci2ltTiS88Ddo0/7wxle ALPdQLjpi/kM4bmfn20Iio6Uyssquz48LRTV7BB1z409OkmTelg= =nB81 -----END PGP SIGNATURE----- --3fpbd6igd3luxhs4--