[cvsnt] Re: building the cvs docs

David Somers dsomers at omz13.com
Thu Jan 19 23:30:22 GMT 2006


Tony Hoyle wrote:
> Not in any current copy of the documents it isn't.

Well it somehow made it into cvsnt-2.5.03.2214.tar.gz

> That was there for about a day - I think Bo hand edited it rather than
> using an xml editor, and got it slightly wrong.

That's why its normally a Very Good Idea to run files through xmllint when
you're editing them by hand insetad of in a warm-and-cosy validating
editor :-)

> If you really must rebuild the documentation (I strongly recommend
> downloading the standard ones and shipping that) then make sure that it
> is *exactly* the same as the shipped documentation, including all the
> filenames, and the version correctly inserted.

Its build from the shipped source tarball, and the version number in the
files is tweaked.

> xmlto appears to 
> randomise the filenames which is incorrect & will lead to support issues.

Randomize the filenames? Never seen that.

Normally I would use your build file in docs, but it has some hardcoded
paths to some files which don't tally with the distro that I use (gentoo).
xmlto seems to do things ok for the html files, and that's all I'm
generating in the cvsnt ebuild for gentoo.

-- 
David Somers
VoIP/SIP: FWD dial **44808449868206; voipuser.org dial 08449868206
PGP Key = 7E613D4E
Fingerprint = 53A0 D84B 7F90 F227 2EAB  4FD7 6278 E2A8 7E61 3D4E



More information about the cvsnt mailing list