Re: Docs patches

Adriaan de Groot wrote:

> Three patches tonight:
> 
> 1) user-basics.diff -- Fixes up some layout stuff in user-basics -- filename 
> tags, command tags.

Good.

> 2) user-basics-add.diff -- Adds a description of line breaking.
> Although it is mentioned in passing in the tutorial, I think that
> either the reference manual or the user manual (or both) needs a
> detailed explanation.

Good.

> 3) Adds user-depend.diff -- a section detailing what :program, :lib, :dll and 
> :ltlib do. The tutorial shows you a few examples. The user manual should 
> provide a fairly clear explanation of what to use and when and what some of 
> the details are.

I had to fix the patch to include it (delete a stray <bridgehead> line)
but it's fine otherwise.

I do get a few errors from jade:
- The <anchor> tag isn't allowed where it was.  I've added the "id" to
  the <bridgehead> tag.

- This gives an error:
	<entry>
	<variablelist>
  But this works:
	<entry><variablelist>
  Don't ask me why!

- You added links to "ref-dll", "ref-program", etc.  That should be
  "cmd-dll", "cmd-program", etc.

It's not too bad, but we should try to finish this XML vs SGML
discussion some day to avoid these problems.

Thanks!

-- 
hundred-and-one symptoms of being an internet addict:
258. When you want to see your girlfriend, you surf to her homepage.

 /// Bram Moolenaar -- [email protected] -- http://www.Moolenaar.net   \\\
///          Creator of Vim - Vi IMproved -- http://www.Vim.org          \\\
\\\              Project leader for A-A-P -- http://www.A-A-P.org        ///
 \\\  Help AIDS victims, buy here: http://ICCF-Holland.org/click1.html  ///


-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf