Skip to contentSkip to conversation

Update Documentation/DocBook/kernel-locking.tmpl

PATCH Randy.Dunlap 2 participants 2 messages Dec 12, 2003 1 message not in the archive

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): [email protected]

#1 lore raw
| 
| This has needed doing for a while.  Reviews welcome. 
| 
| As an attachment because it's about 64k "raw".

Some could be fuser errors (with docbook stylesheets etc.)...

a. uses "gloss-timer" and "gloss-timers": choose one

b. docbook complained about many unclosed or unmatched instances

    of </sect1>, </chapter>, </listitem>, etc.

c. docbook complains about some 'C' syntactic items that are inside <LiteralLayout> or <programlisting>. E.g.:

- 'cache' in
list_for_each_entry(i, &cache, list)

- 'obj-' in

	list_del(&obj->list);

- 'cache_lock' in

	down(&cache_lock);

(see the pattern: '&' shouldn't be special inside these blocks, or at least that's how I think about it, but the software disagrees)

- docbook (at least my version) dislikes these #includes:
#include <linux/list.h>
#include <linux/slab.h>
#include <linux/string.h>
+#include <linux/rcupdate.h>
#include <asm/semaphore.h>
#include <asm/errno.h>

I'd read it for content soonish.

Thanks for the update.

--
~Randy

#2 lore raw

In message <[email protected]> you write:

Quoted 7 lines
| 
| This has needed doing for a while.  Reviews welcome. 
| 
| As an attachment because it's about 64k "raw".

Some could be fuser errors (with docbook stylesheets etc.)...

Yes, I fixed all these, but I sent out the old one (I'd fixed the ..sgml file, not the .tmpl file!).

Here's take II. See also:
http://www.kernel.org/pub/linux/kernel/people/rusty/kernel-locking/

Thanks,
Rusty.
--
Anyone who quotes me in their sig is an idiot. -- Rusty Russell.