linux.git/Documentation/DocBook, branch v2.6.12

libata: more docs updates

2005-06-01T00:43:57+00:00

libata: doc updates

2005-05-30T23:49:12+00:00

libata: more doc updates

2005-05-30T19:41:05+00:00

Document recently-added ata_port_operations hooks.

Fill several doc stubs in libata-core.c.

libata: minor DocBook update

2005-05-30T17:15:52+00:00

[PATCH] docbook: Tell users to install xmlto, not stylesheets

2005-05-01T15:59:28+00:00

We have at least two users which were confused by these messages, myself
included.

Signed-off-by: Alexey Dobriyan 
Signed-off-by: Sam Ravnborg 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

[PATCH] DocBook: fix html link

2005-05-01T15:59:28+00:00

The start page for each book has changed from book1.html to index.html.
Update our generated links acocrdingly.

Signed-off-by: Martin Waitz 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

[PATCH] Docbook: use custom stylesheet

2005-05-01T15:59:27+00:00

With the custom stylesheet, functions are rendered using ANSI-C syntax and
xmlto is a bit quieter.

Signed-off-by: Martin Waitz 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

[PATCH] DocBook: Use xmlto to process the DocBook files.

2005-05-01T15:59:27+00:00

xmlto uses standared XSLT templates to generate manpages, (x)html pages, and
XML FO files which can be processed with passivetex.  This is much faster than
using jadetex for everything.  This patch also reduces the number of
kernel-specific scripts that are needed to generate documentation.

Signed-off-by: Martin Waitz 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

[PATCH] DocBook: remove obsolete templates

2005-05-01T15:59:27+00:00

As the author of tulip-user and via-audio docbooks, I can say that they are
out of date and should be deleted.

Signed-off-by: Martin Waitz 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

[PATCH] DocBook: changes and extensions to the kernel documentation

2005-05-01T15:59:25+00:00

I have recompiled Linux kernel 2.6.11.5 documentation for me and our
university students again.  The documentation could be extended for more
sources which are equipped by structured comments for recent 2.6 kernels.  I
have tried to proceed with that task.  I have done that more times from 2.6.0
time and it gets boring to do same changes again and again.  Linux kernel
compiles after changes for i386 and ARM targets.  I have added references to
some more files into kernel-api book, I have added some section names as well.
 So please, check that changes do not break something and that categories are
not too much skewed.

I have changed kernel-doc to accept "fastcall" and "asmlinkage" words reserved
by kernel convention.  Most of the other changes are modifications in the
comments to make kernel-doc happy, accept some parameters description and do
not bail out on errors.  Changed  to @pid in the description, moved some
#ifdef before comments to correct function to comments bindings, etc.

You can see result of the modified documentation build at
  http://cmp.felk.cvut.cz/~pisa/linux/lkdb-2.6.11.tar.gz

Some more sources are ready to be included into kernel-doc generated
documentation.  Sources has been added into kernel-api for now.  Some more
section names added and probably some more chaos introduced as result of quick
cleanup work.

Signed-off-by: Pavel Pisa 
Signed-off-by: Martin Waitz 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds