From owner-freebsd-current@freebsd.org Thu May 25 12:07:01 2017 Return-Path: Delivered-To: freebsd-current@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 D132DD78E83 for ; Thu, 25 May 2017 12:07:01 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org [IPv6:2001:1900:2254:206a::50:5]) by mx1.freebsd.org (Postfix) with ESMTP id BE0981FB1 for ; Thu, 25 May 2017 12:07:01 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: by mailman.ysv.freebsd.org (Postfix) id B9D7DD78E80; Thu, 25 May 2017 12:07:01 +0000 (UTC) Delivered-To: current@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 B9483D78E7F; Thu, 25 May 2017 12:07:01 +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 99B2C1FAF; Thu, 25 May 2017 12:07:01 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: by freefall.freebsd.org (Postfix, from userid 1235) id C0CCC449D; Thu, 25 May 2017 12:07:00 +0000 (UTC) Date: Thu, 25 May 2017 14:07:00 +0200 From: Baptiste Daroussin To: Glen Barber Cc: arch@freebsd.org, doceng@freebsd.org, doc@FreeBSD.org, current@FreeBSD.org Subject: Re: The futur of the roff toolchain Message-ID: <20170525120629.kv2bi4yjtzcegx4e@ivaldir.net> References: <20170521125733.bmd4tmq6iqpsbvgl@ivaldir.net> <20170525114519.GB17188@FreeBSD.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="ibymrjwgghg2m2zb" Content-Disposition: inline In-Reply-To: <20170525114519.GB17188@FreeBSD.org> User-Agent: NeoMutt/20170428 (1.8.2) X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 25 May 2017 12:07:01 -0000 --ibymrjwgghg2m2zb Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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 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/asci= i 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) > >=20 > > 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 bi= t and > > while working on heirloom doctools import I had to fix a bunch of marku= p to make > > the rendering of those documents clean (also meaning almost noone shoul= d read > > them considering some were not really readable). > >=20 > > What I want to propose now, it to render them as PDF (html?) once and p= ush them > > somewhere (to be defined) as static document on our documentation websi= te. > > 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 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 --ibymrjwgghg2m2zb Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEgOTj3suS2urGXVU3Y4mL3PG3PloFAlkmyOQACgkQY4mL3PG3 PlqUURAAs8gSIXEud08R9TeaN0MQRSPBkKuApTnY9ZkvHoN6Sm2LyJ1MkFuUyXpK bfdeYIHZT5InIWEdfNS9fTu0YzwyiGfwk+mIkz7D2wRjaIrbfci+OWY7Xy8G/ng3 WfCQqAXyujdoR2KcXam7+8VpQ9o0a9I7WKWnDyVEbPtjJjX5PlHGV1Olt9+0LbTd 9bEEOTN1AKuZDDswX5pDDRZdnK4DkwBhm44/HswRue8p15Vv1xAIPsTmvgToQ4Xe PerBcy7czqkMwNj2cjRxCPModkdSWuvVQL09iwtu8T/3+6nGfkeyYwZ4WTW/wOCq N4e6TPytBfoSp8jhlxq0hcgSSlcW6ily5k8DlIQFI0IBJZGDpJobAcVtpPDl+P8V dmUnmdmRaa0Qxu+InpRP1hZFxxdBBoHPvalq/sSfy+mr9UnhEl25qrhVr5W8JqNF gTN9RKgz2rW8bxTQr35rouUZs2iwQ3d/LGI6U6VXqEPMiyJ+VJCjFogrE5wPFI/k lb68Y1qdwaOUsg+iaYDKxNFvsA3TP2PupUs5WEvAmEh/umPJXixLXvtk+gAXKiHF nNngW9olRvWrkA9SAYQRa2udAD30qciUTmjalNxnL8NEnXv3t8J7Dm9Q0wJ+ymNP B6QsFChLGuq4sXYQVebSeqGznQz3ow0mUqBgIZ6fCgfbLs8r5RY= =Nxns -----END PGP SIGNATURE----- --ibymrjwgghg2m2zb--