From owner-freebsd-current@FreeBSD.ORG Mon Oct 22 18:56:12 2012 Return-Path: Delivered-To: current@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id EC2AD9D0 for ; Mon, 22 Oct 2012 18:56:12 +0000 (UTC) (envelope-from joel@vnode.se) Received: from mail.vnode.se (mail.vnode.se [62.119.52.80]) by mx1.freebsd.org (Postfix) with ESMTP id 96F568FC08 for ; Mon, 22 Oct 2012 18:56:12 +0000 (UTC) Received: from mail.vnode.se (localhost [127.0.0.1]) by mail.vnode.se (Postfix) with ESMTP id D4E2CE3F07A; Mon, 22 Oct 2012 20:56:04 +0200 (CEST) X-Virus-Scanned: amavisd-new at vnode.se Received: from mail.vnode.se ([127.0.0.1]) by mail.vnode.se (mail.vnode.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id EUXIrG0Xa8fJ; Mon, 22 Oct 2012 20:56:02 +0200 (CEST) Received: from jd.benders.se (jd.benders.se [212.247.52.12]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.vnode.se (Postfix) with ESMTPSA id ADFAFE3F079; Mon, 22 Oct 2012 20:56:02 +0200 (CEST) Date: Mon, 22 Oct 2012 20:55:55 +0200 From: Joel Dahl To: "C. P. Ghost" Subject: Re: RFC: removal of share/doc/{papers,psd,smm,usd} in 2 months Message-ID: <20121022185555.GL24215@jd.benders.se> References: <20121019143617.GF69724@acme.spoerlein.net> <5083B50D.2080009@beastielabs.net> <20121021095332.GM69724@acme.spoerlein.net> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Cc: current@freebsd.org X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.14 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: Mon, 22 Oct 2012 18:56:13 -0000 On 22-10-2012 14:53, C. P. Ghost wrote: > On Sun, Oct 21, 2012 at 11:53 AM, Ulrich Spörlein wrote: > > On Sun, 2012-10-21 at 10:40:45 +0200, Hans Ottevanger wrote: > >> On 10/19/12 16:36, Ulrich Spörlein wrote: > >> > Hi all, > >> > > >> > those roff sources have been very naughty and will be removed from the > >> > tree by the end of the year. Most of those papers are severely out of > >> > date and provide no more use to the system. They can probably also be > >> > found online using a search engine of your choice. > >> > > >> > >> Could you be more specific as to why these sources have been "very naughty"? > >> > >> > Should people feel strongly about them, we might be able to move them > >> > over to the doc repository. > >> > > >> > >> I strongly object this removal. As already pointed out by others, there > >> are papers documenting vi/ex and RPC/XDR. These papers are practically > >> the only docs available on these subjects, apart from the very terse man > >> pages. There are also tutorials on e.g. Yacc and Lex, that probably are > >> not that up-to-date but quite short and (at least for now) readily > >> available. And there is also the IPC Tutorial. > >> > >> This may not all be documents that are immediately needed for > >> operational purposes, but they do offer much needed background > >> information, also of historical character, i.e. how and why things > >> became as they are today. > > > > The handbook provides even more useful documentation and information, > > yet we don't have xsltproc in the base system, force everyone to compile > > it twice and then typeset all the documentation over and over again. > > > > They will therefore be moved to the doc repository were they probably > > should have been all along. > > How about converting them to SGML and integrating them into > the Handbook (with the caveat that they are outdated, but > retained for archival purposes)? We recently removed several outdated articles from the doc repo, so spending time on converting outdated stuff to XML and adding them to the doc repo makes no sense at all. -- Joel