Re: [AD] Documentation system 2009

[ Thread Index | Date Index | More lists.liballeg.org/allegro-developers Archives ]


On 2009-01-19, Elias Pschernig <elias.pschernig@xxxxxxxxxx> wrote:
> On Sun, 2009-01-18 at 23:47 +1100, Peter Wang wrote:
> > On 2009-01-15, Elias Pschernig <elias.pschernig@xxxxxxxxxx> wrote:
> > > I myself don't see much reason to generate Natural Docs docs any longer
> > > - I copied over the naturaldocs web-updater script to publish the HTML
> > > version of the new docs on the SF site:
> > > 
> > > http://www.liballeg.org/a5docs/
> > > 
> > > We apparently still need some kind of front page and a navigation bar.
> > > And a search box like with Natural Docs might be nice.
> > 
> > Does anyone have a suggestion for a search box we can borrow?
> > 
> 
> I could adapt the search box on the front page, but it's an old-style
> server-side script, so no interactive search results display like with
> the AJAX one used by NaturalDocs..

I'll ask on a.cc.

> 
> Oh, and what is this comment for in inc.a.txt?
> 
> <!-- keep blank line for correct HTML -->
> 

The blank line is to separate the following </div> from the last list
item.

> According to markdown documentation [1]:
> """
> If list items are separated by blank lines, Markdown will wrap the items
> in <p> tags in the HTML output.
> """
> 
> So why would we want a "<p> tag" there?

I didn't realise it was causing extra blanks in the sidebar.

Peter





Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/