[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