From owner-freebsd-doc@freebsd.org Thu May 25 12:12:57 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 BE2DBD804AC for ; Thu, 25 May 2017 12:12:57 +0000 (UTC) (envelope-from tj@enoti.me) 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 A01771929 for ; Thu, 25 May 2017 12:12:57 +0000 (UTC) (envelope-from tj@enoti.me) Received: by mailman.ysv.freebsd.org (Postfix) id 9A610D804A9; Thu, 25 May 2017 12:12:57 +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 99793D804A6; Thu, 25 May 2017 12:12:57 +0000 (UTC) (envelope-from tj@enoti.me) Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7196E1926; Thu, 25 May 2017 12:12:56 +0000 (UTC) (envelope-from tj@enoti.me) Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id 672DF20926; Thu, 25 May 2017 08:12:55 -0400 (EDT) Received: from frontend1 ([10.202.2.160]) by compute3.internal (MEProxy); Thu, 25 May 2017 08:12:55 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-sender :x-me-sender:x-sasl-enc:x-sasl-enc; s=fm1; bh=cWugNugJThzWFxoR7e 7ARY9ki91ODXR4j7BzIxSLjjw=; b=eVVq8jKptCPb/RdG+BsgC0Hj4g6prYdNrS PN1nyvtXuZqQHQ1EoZ+uv0541kySfRyy9hlwPiBDAjizBFVeUwZYvPOvwCWTM0CA Vxr1tIJ9vsWGkE2oDPz7vpf1aj8awLfCdDsIaaTUT+mYc6W+4zrWhvSrT9xo+1mx jan2nNkjixvU212ZYNYf7bSYvaRCfHb3hVhY3gZo7vZtjt42W7bWUgUHcIUob3vv t/MOBLZFjHXQRAv/Jbz7fWq//J3E58ZIUMERoLju5opZFSROlKlV3t+Vxv+ACiBz X+/q3iW52BF/wpRzUIKCLmG/GCL+SLnRunibDU9xWpb74VWKGVQg== X-ME-Sender: X-Sasl-enc: UaMzTCUitmFv80ii0EGRD46b52MYv8LA7zPDof9iLCm4 1495714375 Received: from tom-desk.erg.abdn.ac.uk (tom-desk.erg.abdn.ac.uk [139.133.204.4]) by mail.messagingengine.com (Postfix) with ESMTPA id 8136C7E545; Thu, 25 May 2017 08:12:54 -0400 (EDT) Date: Thu, 25 May 2017 13:12:51 +0100 From: tj To: Baptiste Daroussin 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: <20170525121251.GB55153@tom-desk.erg.abdn.ac.uk> References: <20170521125733.bmd4tmq6iqpsbvgl@ivaldir.net> <20170525114519.GB17188@FreeBSD.org> <20170525120629.kv2bi4yjtzcegx4e@ivaldir.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20170525120629.kv2bi4yjtzcegx4e@ivaldir.net> User-Agent: Mutt/1.7.2 (2016-11-26) 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:12:57 -0000 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]