Re: [PATCH] Update Documentation/DocBook/kernel-locking.tmpl

Re: [PATCH] Update Documentation/DocBook/kernel-locking.tmpl

[Randy.Dunlap]

| 
| 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

Re: [PATCH] Update Documentation/DocBook/kernel-locking.tmpl

[Rusty Russell]

[-- Attachment #1: Type: text/plain, Size: 540 bytes --]

In message <20031211200055.778ca906.rddunlap@osdl.org> you write:
> | 
> | 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.


[-- Attachment #2: locking-guide-2.6.patch.gz --]
[-- Type: application/octet-stream, Size: 18954 bytes --]

[PATCH] Update Documentation/DocBook/kernel-locking.tmpl

[Rusty Russell]

[-- Attachment #1: Type: text/plain, Size: 119 bytes --]

This has needed doing for a while.  Reviews welcome. 

As an attachment because it's about 64k "raw".

Cheers,
Rusty.


[-- Attachment #2: locking-guide-2.6.patch.gz --]
[-- Type: application/octet-stream, Size: 18369 bytes --]

[-- Attachment #3: Type: text/plain, Size: 70 bytes --]

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