From owner-freebsd-arch@freebsd.org Thu May 25 11:45:26 2017 Return-Path: Delivered-To: freebsd-arch@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 ED8BED81E09 for ; Thu, 25 May 2017 11:45:26 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from mailman.ysv.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id D3859107C for ; Thu, 25 May 2017 11:45:26 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: by mailman.ysv.freebsd.org (Postfix) id D2D5DD81E04; Thu, 25 May 2017 11:45:26 +0000 (UTC) Delivered-To: arch@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 D2448D81E03; Thu, 25 May 2017 11:45:26 +0000 (UTC) (envelope-from gjb@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 A65921077; Thu, 25 May 2017 11:45:26 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from FreeBSD.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by freefall.freebsd.org (Postfix) with ESMTPS id F3BAA401C; Thu, 25 May 2017 11:45:20 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Date: Thu, 25 May 2017 11:45:19 +0000 From: Glen Barber To: Baptiste Daroussin Cc: arch@freebsd.org, doceng@freebsd.org, doc@FreeBSD.org, current@FreeBSD.org Subject: Re: The futur of the roff toolchain Message-ID: <20170525114519.GB17188@FreeBSD.org> References: <20170521125733.bmd4tmq6iqpsbvgl@ivaldir.net> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="61jdw2sOBCFtR2d/" Content-Disposition: inline In-Reply-To: <20170521125733.bmd4tmq6iqpsbvgl@ivaldir.net> X-Operating-System: FreeBSD 11.0-STABLE amd64 X-SCUD-Definition: Sudden Completely Unexpected Dataloss X-SULE-Definition: Sudden Unexpected Learning Event X-PEKBAC-Definition: Problem Exists, Keyboard Between Admin/Computer X-Spidey-Sense: Uh oh, Peter logged in User-Agent: Mutt/1.8.2 (2017-04-18) X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 25 May 2017 11:45:27 -0000 --61jdw2sOBCFtR2d/ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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 u= se 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 h= as not > be written for a ascii/text target but more for a PDF/html view - using p= ic(1) > for example) >=20 > A plan was to push as sources in the svn doc repository and continue to b= uild > 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). >=20 > What I want to propose now, it to render them as PDF (html?) once and pus= h them > somewhere (to be defined) as static document on our documentation website. > Please doceng@ provide me a location where to push them. >=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/. Glen Hat: doceng@ --61jdw2sOBCFtR2d/ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAlkmw8oACgkQAxRYpUeP 4pPGnw/+M+TI/COFXDONgIFGRlJMYt9Hs0CtD/aUQYnRavids7Ydj0ZJswCSFGsi wHI3y8HtSd9f7+gTEMC1gyeTIPTIRvIB/9iDhujhJ0RTYrlBop2FPI5hdWjXUXjK 6Xx12t4RaQ4sMvr3HChwZh5Co83N8hxuERJC3d7AjyJRoH8/tu00Yps29GAYDF8y KV4rXIuh9xmEZ49twO71ZXxdWbwWtbTNER5kmqs/7ipt/6t+ZGZK41kF1SQrcTc8 P+Pb59mqR5hEGod6k9XzBYmSLeHhxc4RJE1J9reN8W+30Vhf9ey5MPQvzzlg9TXg IN4zmMO8zs+3LI3U0N0VHkwB5pHPnkmubvK3fHcyPdofBMI82g3kHZZx0N+yWx43 HG8W6vTDHVUVu4SfqtiKnTk+mZxovQYkWkD5yEnd+FqQxTRpNDNtEjMrV2l2nMN5 PtgwBCU3+Ohdr0i8N6A9YYs+zxk0kMQrwuSLs9FK1soFC32oMn/z81WLdkQKYlLv z6F4N8rgMISv+pQJfCsH3M6ThFnPO+VjdEPAlbu3lSNtUnc+1KS5BaSfUZNN0lBw NsIRHyRKzlSsKiMSTSLn8q4t9JCOG0+dOwfYPo/6YpQGqCJkFkxPteSqGajozKEK dLkc6CermAxA+ovjJ+KflWFJEhCt1aXyc3zTb8UZyrtCk9qbiJw= =aTuO -----END PGP SIGNATURE----- --61jdw2sOBCFtR2d/--