From owner-freebsd-current Mon Sep 13 4:44: 2 1999 Delivered-To: freebsd-current@freebsd.org Received: from mpp.pro-ns.net (pppdsle45.mpls.uswest.net [216.160.23.45]) by hub.freebsd.org (Postfix) with ESMTP id 5266414E59 for ; Mon, 13 Sep 1999 04:42:00 -0700 (PDT) (envelope-from mpp@mpp.pro-ns.net) Received: (from mpp@localhost) by mpp.pro-ns.net (8.9.3/8.9.3) id GAA03802; Mon, 13 Sep 1999 06:41:07 -0500 (CDT) (envelope-from mpp) From: Mike Pritchard Message-Id: <199909131141.GAA03802@mpp.pro-ns.net> Subject: Re: more In-Reply-To: <19990913121859.A49490@voodoo.pandhm.co.uk> from Dominic Mitchell at "Sep 13, 1999 12:19:00 pm" To: Dom.Mitchell@palmerharvey.co.uk (Dominic Mitchell) Date: Mon, 13 Sep 1999 06:41:07 -0500 (CDT) Cc: adamw@holonet.net (Adam Wight), freebsd@gndrsh.dnsmgr.net (Rodney W. Grimes), freebsd-current@FreeBSD.org X-Mailer: ELM [version 2.4ME+ PL54 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG > On Mon, Sep 13, 1999 at 06:03:19AM -0500, Mike Pritchard wrote: > > > Speaking of which, are there any plans to actually document vi any time > > > soon? Lots of useful features are missing from the man page! > > > > Sure! Where are your patches for this? I'll review them > > and commit them as soon as you supply them! > > Why bother? They are already documented in the vi papers, which are > distributed in the system already under > /usr/share/doc/usd/{12.vi,13.viref}. There is a reference to these in > the vi man pages already. True, but it would be nice if the man page was extended to include some more documentation. Remember, a lot of our users are lazy and if "man xxxxx" doesn't give them what they want, then they don't go looking elsewhere. Sad, but true. Now, the vi(1) man page does refer to the usd document, but doesn't tell you how to find it. That is a problem. It also references the "vi quick reference" card", which I have no idea where to find that (I used to have one sitting one my desk :-). I think that the originator's request is valid, especially since some of the original BSD documentation in /usr/share/doc/* has rotted since it was originally imported. We have been maintaining those documents more as a "historical" perspective than as accurate documentation on the current state of affairs. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mpp.pro-ns.net To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message