Date: Tue, 20 Feb 2001 22:16:20 -0500 (EST) From: Kenneth W Cochran <kwc@world.std.com> To: Brooks Davis <brooks@one-eyed-alien.net> Cc: freebsd-doc@freebsd.org Subject: Re: Tracking -docs like -stable Message-ID: <200102210316.WAA21576@world.std.com> References: <200102210104.UAA21183@world.std.com>
next in thread | previous in thread | raw e-mail | index | archive | help
>Date: Tue, 20 Feb 2001 17:12:37 -0800 >From: Brooks Davis <brooks@one-eyed-alien.net> >To: Kenneth W Cochran <kwc@world.std.com> >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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200102210316.WAA21576>