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
Hello Jason and others,
unfortenately I haven't obtained a reaction on my previous email, hopefully I
get one this time. I have finally been able to process 1 of the apt man
documents successfully. I must admit though that I went 1 step further than
just correcting the docbook SGML documents. I used apt-cdrom.8.sgml in my
attempt to get the docu processed. I converted the docu from docbook3 to
docbook xml 4. The document I have now can be check and processed easily
with respectively xmllint and xmlto.
Attached are the updated documents and the resulting man page.
I hope that you can accept the new document format and have them included in
the release. I can't check if debian has an xmlto package or support for
docbook4 as the server are offline.
In case the "patch" will be accepted I will convert the other man documents as
well.
--
Richard Bos
Without a home the journey is endless
&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.
">
cdrom.8.xml
Description: Text Data
apt-cdrom.8
Description: Troff document
|
