From owner-freebsd-doc Tue Feb 20 19:16:27 2001 Delivered-To: freebsd-doc@freebsd.org Received: from sgi04-e.std.COM (sgi04-e.std.com [199.172.62.134]) by hub.freebsd.org (Postfix) with ESMTP id 050D437B4EC for ; Tue, 20 Feb 2001 19:16:24 -0800 (PST) (envelope-from kwc@world.std.com) Received: from world.std.com (world-f.std.com [199.172.62.5]) by sgi04-e.std.COM (8.9.3/8.9.3) with ESMTP id WAA2171042; Tue, 20 Feb 2001 22:16:21 -0500 (EST) Received: (from kwc@localhost) by world.std.com (8.9.3/8.9.3) id WAA21576; Tue, 20 Feb 2001 22:16:20 -0500 (EST) Date: Tue, 20 Feb 2001 22:16:20 -0500 (EST) From: Kenneth W Cochran Message-Id: <200102210316.WAA21576@world.std.com> To: Brooks Davis Subject: Re: Tracking -docs like -stable Cc: freebsd-doc@freebsd.org References: <200102210104.UAA21183@world.std.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Date: Tue, 20 Feb 2001 17:12:37 -0800 >From: Brooks Davis >To: Kenneth W Cochran >Cc: freebsd-docs@FreeBSD.ORG >Subject: Re: Tracking -docs like -stable > >[Trimmed -stable from CC list since this is more of a -docs question.] > >On Tue, Feb 20, 2001 at 08:04:04PM -0500, Kenneth W Cochran wrote: >> Hello -stable & -docs: >> >> I'm trying to "track" documentation similarly to -stable. >> I can cvsup the "docs-supfile" Just Fine, but what needs to >> be done afterward? >> >> After cvsup of doc-all, in what directory should I be when >> making/building? >> >> What are the relevant make-targets for documentation & >> where can I find them? >> >> How do I properly omit building the .pdf and .ps versions? >> >> I can't find anything in The Books (Lehey v3 & the >> Handbook) & the docproj Web-site seems targeted toward >> documentation "authors" & not toward documentation "trackers." >> >> The textproc/docproj port is installed. >> >> Naturally, faq/doc/book pointers most welcome. :) > >Since very few people actually do this, I suspect the best documentation >is going to be the developers documentation. That's the "FreeBSD >Documentation Project Primer". You can find it at: > >http://www.freebsd.org/tutorials/docproj-primer/ > >It tells you how to build and keep your docs up to date. If you just >want to keep up to date docs, you can ignore the part about keeping a >local CVS repository since that's quite unnecessicary in this case. > >-- Brooks Well, I had already read & consulted that resource (it is also mentioned in /usr/doc/README), but if that resource had the answers I was seeking, I would not have written my original message. I also think that it would be a Good Idea for people tracking -stable to also track the documentation. :) I might speculate that the reason "few people actually do this" is that the procedure is not very well spelled-out (compared to tracking -stable). -kc To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message