Re: [AD] Generate documentation about examples from their sources

[Eric Botcazou <ebotcazou@xxxxxxxxxx>]

> > - would it be feasible to specialize the example references, so
> > that they appear in the HTML docs with a layout different from
> > that of regular refs?
>
> I don't understand, retry with some example.

The regular refs are displayed in HTML with a specific layout (preceded by 
"See also:" and written in blue). I'd rather have the refs to the examples 
not mixed with the regular refs, but displayed one line below (for example: 
preceded with "Example of use:" and written in green).

> > - would it be feasible to specify in the ._tx file a per-function
> > limit on the number of example referenced (e.g 1 for allegro_init) ?
>
> It would be possible, but I don't think it would help much. How
> about this instead: when there are more than say 4 examples using
> the same function, it would generate a single reference to the
> examples' chapter.

Fine with me.

> > P.S: what of your patch against the configure machinery to dump
> > the config options? It is nice too, so I'd like to have it in the
> > next WIP. Could you apply it (even if you find it incomplete)?
>
> Simply forgot about it, will try to recover it this weekend.

Thanks.

-- 
Eric Botcazou