Re: JBD Documentation added in BK-current

[Sam Ravnborg <sam@ravnborg.org>]

On Mon, Oct 14, 2002 at 11:03:15PM +0100, Roger Gammans wrote:
> 
> Well. I'm not surprised there are a few I couldn't find an SGML reference
> for the linuxdoc dtd , or a tutorial when I wrote it, so I guessed by looking
> at other documents and source code. 
> 
> > [I'm cleaning up the mess in the Makefile after JBD was added right now].
> 
> Did I really make it that messy?
The infrastructure in the docbook makefile has changed since 2.4.

Took a look in the journal-api.sgml file, based on the comments you gave.
I had to do a little more to crete .html without warnings.
I've submitted this to Linus and trivial.. as well.

Browsing the resulting file I wonder why there are references to several
jbd files, but they do not include docgen comments.
Are there some patches missing in 2.5 that updates the comments?

	Sam

===== Documentation/DocBook/journal-api.tmpl 1.1 vs edited =====
--- 1.1/Documentation/DocBook/journal-api.tmpl	Mon Oct  7 16:36:06 2002
+++ edited/Documentation/DocBook/journal-api.tmpl	Tue Oct 15 20:06:15 2002
@@ -208,7 +208,7 @@
 if you allow unprivileged userspace to trigger codepaths containing these
 calls.
 
-<para>
+</para>
 </sect1>
 <sect1>
 <title>Summary</title>
@@ -244,7 +244,8 @@
    }
    journal_destroy(my_jrnl);
 </programlisting>
-
+</para>
+</sect1>
 </chapter>
 
   <chapter id="adt">