Op vrijdag 14 november 2003 06:37, schreef Jason Gunthorpe:
> I think a patch to correct the docbook SGML documents is probably a good
> idea.
>
> I don't know of any tool that will normalize the markup without mangling
> the indentation in the document. sgmlnorm (run on a system with the
> mangled DTDTYPE) will remove all tag minimization (and also expand
> entities, etc), but the resulting output is too mangled to be useful.
Jason and all,
I went ahead and made some (manual) changes to apt.ent and apt-cdrom to start
with. Please find the updated files attached. I use docbook4 I hope that it
does not clash with docbook3. If I run 'nsgmls -s apt-cdrom.8.sgml' no
errors are reported and the exit value is 0 (zero)
However if I run docbook2man apt-cdrom.8.sgml the following errors are
reported:
nsgmls:/home/richard/packages/SOURCES/apt-0.5.15cnc2/doc/
apt-cdrom.8.sgml:2:59:W: cannot generate system identifier for public text
"-//OASIS//DTD DocBook V4.2//EN"
nsgmls:/home/richard/packages/SOURCES/apt-0.5.15cnc2/doc/apt.ent:165:0:Q:
length of interpreted parameter literal must not exceed LITLEN (1024)
-----
This is for:
<!-- Should be used within the option section of the text to
put in the blurb about -h, -v, -c and -o -->
<!ENTITY apt-commonoptions "
<VarListEntry><term><option>-h</option></term>
<term><option>--help</option></term>
The entry contains about 1150 characters. If I remove enough characters
the error is gone.
-----
nsgmls:/home/richard/packages/SOURCES/apt-0.5.15cnc2/doc/
apt-cdrom.8.sgml:7:0:E: reference to entity "REFENTRY" for which no system
identifier could be generated
nsgmls:/home/richard/packages/SOURCES/apt-0.5.15cnc2/doc/apt-cdrom.8.sgml:2:0:
entity was defined here
nsgmls:/home/richard/packages/SOURCES/apt-0.5.15cnc2/doc/
apt-cdrom.8.sgml:165:10:E: there is no attribute "URL"
Can't call method "value" on an undefined value at /usr/share/sgml/docbook/
utils-0.6.6/helpers/docbook2man-spec.pl line 297, <STDIN> line 15.
---end of errors ----
apt-0.5.15cnc2/doc> docbook2man -v
DocBook-utils version 0.6.6 (jw version 1.1)
apt-0.5.15cnc2/doc> docbook2man -h
jw - Jade Wrapper
Any idea what might be wrong here? Is it my docbook2man version, is it
something in the sgml docs?
--
Richard Bos
Without a home the journey is endless
apt-cdrom.8.sgml
Description: SGML document
&docdir;examples/configure-index.gz">
/etc/apt.conf">
apt.conf
5
"
>
apt-get
8
"
>
apt-config
8
"
>
apt-cdrom
8
"
>
apt-cache
8
"
>
apt_preferences
5
"
>
sources.list
5
"
>
reportbug
1
"
>
dpkg
8
"
>
dpkg-buildpackage
1
"
>
gzip
1
"
>
dpkg-scanpackages
8
"
>
dpkg-scansources
8
"
>
dselect
8
"
>
apt@xxxxxxxxxxxxxxxxxxx
Jason Gunthorpe
1998-2001 Jason Gunthorpe
12 March 2001
">
APT bug page.
If you wish to report a bug in APT, please see
/usr/share/doc/debian/bug-reporting.txt or the &reportbug; command.
">
Author
APT was written by the APT team apt@xxxxxxxxxxxxxxxxxxx.
">
-h
--help
Show a short usage summary.
-v
--version
Show the program version.
-c
--config-file
Configuration File; Specify a configuration file to use.
The program will read the default configuration file and then this
configuration file. See &apt-conf; for syntax information.
-o
--option
Set a Configuration Option; This will set an arbitary configuration
option. The syntax is -o Foo::Bar=bar.
">
All command line options may be set using the configuration file, the
descriptions indicate the configuration option to set. For boolean
options you can override the config file by using something like
-f-,--no-f, -f=no
or several other variations.
">
|
