documentation

I will work on documentation.

Hugo, please get the Luan source and look at docs/manual.html .  If I add

<div></div>

on line 178 at the end of the "Introduction" section then the heading of the next section gets messed up.  Why?

Feel free to edit the css files which I took from lua.org .  You may also conbined them into one file.

My plan is to edit this document and to use classes like class="added", class="removed", class="changed" to indicate how Luan differs from Lua.

manual.css has a rule like this:

p+h1, ul+h1 {
   ...
}

This rule means "for headers (h1) tags that come after a paragraph (p) or after an unordered list (ul), do...".
When you add a div between the paragraph and the header, you break that rule. A simple solution is to change the rule like this:

p+h1, ul+h1, h1.myheader {
   ...
}

and then change the h1 headers in the HTML file to:

...
<h1 class="myheader">
...

This "p+h1, ul+h1" is horrible.  So I could replace it with "h1.myheader" and add that class to all headers.  But the only h1 where this doesn't apply is the top one, so maybe I could just make the rule "h1" and somehow treat the top case differently.  Which way is better?

fschmidt wrote

I could just make the rule "h1" and somehow treat the top case differently.

This is the simplest.

Hugo <Nabble> wrote

fschmidt wrote

I could just make the rule "h1" and somehow treat the top case differently.

This is the simplest.

Okay but I don't know how to do this.  Can you do it?

I can't commit to the luan trunk.

fixed

Done in rev 243.

lowering to priority 2 until some other things are done