ALFS DTD going into CVS, get your opinions in now...
Kevin P. Fleming
kpfleming at linuxfromscratch.org
Mon Oct 27 16:48:36 PST 2003
James Robertson wrote:
> I would put the DTD straight under ALFS/ALFS.dtd and not bury it under
> docs. It "is" the DTD, not documentation on it.
Yes, that's a better idea.
> On a similar, but off-topic, does your script to build a distro tarball
> include the docs yet and then a target in the build system you just
> made? If not, what do I need to provide you to be able to do that?
The current tarball does include a "doc" directory, but nothing from
that directory is currently installed onto the target system (i.e. all
that stuff just sits in the unpacked source directory only). However, my
plan is to include the user's guide and hacker's guide in HTML form
(your preference as to single-file or multi-file, single-file is better
for me) in the doc directory in the tarball, then install them into
<prefix>/share/nALFS when nALFS is installed. To make this work, there
will need to be HTML-formatted copies of the guides available whenever a
tarball of nALFS is being readied; I don't want to force the nALFS
developer to have to have all the docbook/DSSSL stuff installed just to
make an nALFS tarball. It doesn't matter much to me whether the guides
are just "daily snapshotted" into HTML form, or whether we just go and
get the most recent "stable" release of the guides. Either way, that
step will be added to the hacker's guide in the section I already sent
you about making a distribution tarball.
> Are we going to include the DTD in the tarball that is to be used with
> the version of nALFS in the tarball? Do we have copies of the older
> versions of the DTD available? The only one I am familiar with is the
> v3.1 on Vassili's website. Seeing as how you want to add <install> to
> the DTD, we are moving to v3.2. I think that is a person wants an older
> version of the DTD, they can go get it. That can be put in the Hacker's
> guide under the CVS section (when I get that section in :-) ).
My plan is to include the most recent DTD (i.e. matching the highest
version number supported by any handler in the tarball) in the tarball
itself (this will also get installed into <prefix>/share/nALFS). If the
user wants an older version, they _may_ be able to find it on
alfs.lfs.org, if we've found an older one. Right now I have a 3.1 DTD,
which is an updated version of Vassili's, and that's all. However,
that's all we need for the moment, we haven't produced a newer syntax
version yet and won't for 1.2.0.
If anyone knows where there are copies of the 2.0 and 3.0 DTDs (not the
2.1.11 that is on Mark's site, that has diverged from 2.0 obviously) I'd
appreciate pointers to them. I'm going to create an ALFS/DTD directory,
then place the DTDs in there as ALFS-X.y.dtd. Once that is done, the
"ALFS DTD Syntax Document" link on the website needs to point the user
to somewhere that they can see both the DTD itself (for manual download
if they desire) and the syntax_doc that describes the content of the
DTD. I can modify my "nALFS snapshot" script to put copies of the DTDs
into alfs/view/dtd for the website, or anywhere else you want them.
More information about the alfs-discuss