HTML documentation - one file per function

[David Bateman]

soren at hauberg.org wrote:
> Quoting David Bateman <David.Bateman at motorola.com>:
>> It was written by at least 4 people that I know of, which is why its a
>> mix of m4, perl, python and Makefile magic. Cleaning it up into a single
>> language with some makefiles might be nice, particularly getting rid of
>> the m4 as that part of the build is slow. However, this is a low
>> priority as it works now.
>
> Actually, I'd rather not get rid of the m4 part as this is also what
> the octave.org web site uses. At some point (you know, that point
> where I have some spare time...) I'd like to see some of the
> Octave-Forge website scripts used to build part of the octave.org
> website. Specifically, I think it would be nice to use these scripts
> to build the manual, and possibly also have the function reference on
> octave.org.
>
The m4 part takes more than 80% of the build time of the docs and its
only used to to do regexp replacements, that might be done in the
make_index script itself. I'd vote to do it there and do the same thing
for the octave website...

Cheers
David




-- 
David Bateman                                David.Bateman at motorola.com
Motorola Labs - Paris                        +33 1 69 35 48 04 (Ph) 
Parc Les Algorithmes, Commune de St Aubin    +33 6 72 01 06 33 (Mob) 
91193 Gif-Sur-Yvette FRANCE                  +33 1 69 35 77 01 (Fax) 

The information contained in this communication has been classified as: 

[x] General Business Information 
[ ] Motorola Internal Use Only 
[ ] Motorola Confidential Proprietary