From owner-freebsd-current@FreeBSD.ORG Mon Oct 22 12:53: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 896D754F for ; Mon, 22 Oct 2012 12:53:12 +0000 (UTC) (envelope-from cpghost@cordula.ws) Received: from mail-ob0-f182.google.com (mail-ob0-f182.google.com [209.85.214.182]) by mx1.freebsd.org (Postfix) with ESMTP id 3F5148FC0C for ; Mon, 22 Oct 2012 12:53:11 +0000 (UTC) Received: by mail-ob0-f182.google.com with SMTP id wc20so3180781obb.13 for ; Mon, 22 Oct 2012 05:53:11 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:x-originating-ip:in-reply-to:references:date :message-id:subject:from:to:content-type:content-transfer-encoding :x-gm-message-state; bh=3DhxC68v+RY4fBirMald19A7etHvrBu7vjqVfnmhzgk=; b=XYW2Gz6tNM8LWy55XPN//9Z3/UMiEiLiS5agQCdyushk6X0ZoCo81vKT32NvH723zs VzBdlgTh9/xMrqlL1TfVEZOfloYTo5VuX2II5iE88Qr/3vHMi80u6iO4AcjZnn+DDWtK PtpnDiYXe4dsboBney9IR7eyA/+zxE+pZeYDx9pa3So7aA4GrxLCGJtcp4ibB3vjN27I Tg/TjKE5yu987zd7NqS4EdVpevU6d8XA4hmzQ2mT494+V3oQxVi863NueEVQdZdH+t8/ Kxu6zkqayqzkUXfLAtSLji6yyH8hPYZMO/67pS7pdtl9E4PmMf0TF/fGF0X4W5667e3t fiVQ== MIME-Version: 1.0 Received: by 10.60.169.202 with SMTP id ag10mr8126194oec.84.1350910391564; Mon, 22 Oct 2012 05:53:11 -0700 (PDT) Received: by 10.182.91.132 with HTTP; Mon, 22 Oct 2012 05:53:11 -0700 (PDT) X-Originating-IP: [93.221.178.135] In-Reply-To: <20121021095332.GM69724@acme.spoerlein.net> References: <20121019143617.GF69724@acme.spoerlein.net> <5083B50D.2080009@beastielabs.net> <20121021095332.GM69724@acme.spoerlein.net> Date: Mon, 22 Oct 2012 14:53:11 +0200 Message-ID: Subject: Re: RFC: removal of share/doc/{papers,psd,smm,usd} in 2 months From: "C. P. Ghost" To: current@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Gm-Message-State: ALoCoQmEFVjyLpWMR9G2TSuuiT7LVkBfBfZCy+6wNeJ0e4uinkA2Pe+l2GXk55ThHxsahX5ajnY+ 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 12:53:12 -0000 On Sun, Oct 21, 2012 at 11:53 AM, Ulrich Sp=F6rlein wrote= : > On Sun, 2012-10-21 at 10:40:45 +0200, Hans Ottevanger wrote: >> On 10/19/12 16:36, Ulrich Sp=F6rlein 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 naugh= ty"? >> >> > 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)? > Cheers, > Uli -cpghost. --=20 Cordula's Web. http://www.cordula.ws/