Re: [AD] 4.9 docs

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


On Wed September 16 2009, Peter Wang wrote:
> On 2009-09-16, Thomas Fjellstrom <tfjellstrom@xxxxxxxxxx> wrote:
> > On Wed September 16 2009, Peter Wang wrote:
> > > On 2009-09-16, Thomas Fjellstrom <tfjellstrom@xxxxxxxxxx> wrote:
> > > In your `Build/docs' directory there should be a file called `protos'
> > > with the prototypes extracted.  For testing you can run `make
> > > gen_protos' to generate it manually, or simply run this to see if there
> > > is any output at all:
> > >
> > >     awk -f docs/scripts/make_protos.awk src/*.c
> >
> > That works, and the protos file gets built if I do a "make html". But
> > strangely the html itself doesn't seem to include protos.
> 
> What happens if you run something like this in your build directory?
> 
>     PANDOC=cat ../docs/scripts/make_page --protos docs/protos
>  ../docs/src/refman/acodec.txt
> 
> You should get something like:
> 
> # Audio codecs
> 
> ## FLAC addon
> 
> ### al_init_flac_addon
> 
>     bool al_init_flac_addon(void)
> 
> This function to registers [al_load_sample_flac] with [al_load_sample] to
> handle files with the extension ".flac".  You will need to include the
> `allegro_flac.h` header file and link with the `allegro_flac` library.
> ...

Nope, no protos in there. I'm not sure why.

> 
> ---------------------------------------------------------------------------
> --- Come build with us! The BlackBerry&reg; Developer Conference in SF, CA
>  is the only developer event you need to attend this year. Jumpstart your
>  developing skills, take BlackBerry mobile applications to market and stay
>  ahead of the curve. Join us from November 9&#45;12, 2009. Register
>  now&#33; http://p.sf.net/sfu/devconf
> 


-- 
Thomas Fjellstrom
tfjellstrom@xxxxxxxxxx




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