From owner-freebsd-current@FreeBSD.ORG Fri Oct 19 22:42:16 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 6262EEAD for ; Fri, 19 Oct 2012 22:42:16 +0000 (UTC) (envelope-from jhs@berklix.com) Received: from tower.berklix.org (tower.berklix.org [83.236.223.114]) by mx1.freebsd.org (Postfix) with ESMTP id CB1118FC12 for ; Fri, 19 Oct 2012 22:42:15 +0000 (UTC) Received: from mart.js.berklix.net (p57BCF57F.dip.t-dialin.net [87.188.245.127]) (authenticated bits=0) by tower.berklix.org (8.14.2/8.14.2) with ESMTP id q9JMg5fn087981; Fri, 19 Oct 2012 22:42:07 GMT (envelope-from jhs@berklix.com) Received: from fire.js.berklix.net (fire.js.berklix.net [192.168.91.41]) by mart.js.berklix.net (8.14.3/8.14.3) with ESMTP id q9JMfriw082501; Sat, 20 Oct 2012 00:41:54 +0200 (CEST) (envelope-from jhs@berklix.com) Received: from fire.js.berklix.net (localhost [127.0.0.1]) by fire.js.berklix.net (8.14.4/8.14.4) with ESMTP id q9JMffPI060071; Sat, 20 Oct 2012 00:41:47 +0200 (CEST) (envelope-from jhs@fire.js.berklix.net) Message-Id: <201210192241.q9JMffPI060071@fire.js.berklix.net> To: John-Mark Gurney Subject: Re: RFC: removal of share/doc/{papers,psd,smm,usd} in 2 months From: "Julian H. Stacey" Organization: http://berklix.com BSD Unix Linux Consultancy, Munich Germany User-agent: EXMH on FreeBSD http://berklix.com/free/ X-URL: http://www.berklix.com In-reply-to: Your message "Fri, 19 Oct 2012 08:55:42 PDT." <20121019155542.GQ1967@funkthat.com> Date: Sat, 20 Oct 2012 00:41:41 +0200 Sender: jhs@berklix.com 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: Fri, 19 Oct 2012 22:42:16 -0000 > I guess the real bug is that we've been installing these, but never > referencing them, or telling users where they could find them... I.e. > in man vi: > ``An Introduction to Display Editing with Vi'', found in the ``UNIX > User's Manual Supplementary Documents'' section of both the 4.3BSD and > 4.4BSD manual sets. This document is the closest thing available to an > introduction to the vi screen editor. > > refers to usd/12.vi/paper.ascii.gz, but no reader of the man page would > know that... Same w/ the other docs in the same section.. I'm not sure > many users would think to go man hier to see where they are located, or > even know that they might be distributed w/ FreeBSD... > > I think the same thing applies foo memacros and others too... That the > man page provides a short reference, and that these provide a more > detailed description of what is happening... Yes, I'd also prefer to Not see a load of deletes, some of those things are expected in Unix, (aka UCB ring binder manuals on my shelf). Better to give more useful references in man/ to point to exact full paths in /usr/share. It'd make FreeBSD easier for some, & more readers could bring more fixes to keep them up to date. Cheers, Julian -- Julian Stacey, BSD Unix Linux C Sys Eng Consultant, Munich http://berklix.com Reply below not above, like a play script. Indent old text with "> ". Send plain text. Not: HTML, multipart/alternative, base64, quoted-printable.