Doc BoF at EuroBSDCon

[John Baldwin]

On Monday 06 December 2004 08:52 am, Len Zettel wrote:
> On Monday 06 December 2004 06:01 pm, Murray Stokely wrote:
> > On Mon, Dec 06, 2004 at 12:48:16PM +0000, Len Zettel wrote:
> > > So I took a stab at creating an sgml file incorporating the changes
> > > (by editing the existing file for the document in question).
> > > When it came time create an html file from the sgml (so I
> > > could check the work) I flunked out.  The make couldn't
> > > find some of the necessary boiler plate.
> >
> > Ok, then you either didn't have all the tools installed (the docproj
> > port can help), or didn't have all stylesheets checked out from
> > CVS/CVSup (the full 'doc' module), or temporarily something was
> > broken.  The last possibilty is not as likely as the first two.
>
> I did the docproj port.  The problem probably was that
> when I started changing things I wanted
> to keep the original tree pristine, so I moved some (but not
> all) stuff.
> If you will excuse the criticism, this is a classic chicken-egg
> problem.  I have been finding it very difficult to figure
> out the ins and outs of the make system from the
> existing documentation.

What will probably be easiest is to cvsup the repository rather than the docs 
directly, and then use cvs to checkout the doc tree.  You can then use cvs to 
get diff's, revert changes if you want to go back to the original, etc., and 
edit the files in place such that 'make' will work ok.

-- 
John Baldwin <jhb at FreeBSD.org>  <><  http://www.FreeBSD.org/~jhb/
"Power Users Use the Power to Serve"  =  http://www.FreeBSD.org