[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: HTML documentation - one file per function
From: |
David Bateman |
Subject: |
Re: HTML documentation - one file per function |
Date: |
Tue, 06 May 2008 09:36:35 +0200 |
User-agent: |
Thunderbird 2.0.0.12 (X11/20080306) |
address@hidden wrote:
> Quoting David Bateman <address@hidden>:
>> 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 address@hidden
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