Re: [AD] Auto types (was: Improvements for the chm documentation version)

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


> - adds documentation about Allegro's structures and types in a separated
> chapter. This makes "man BITMAP" possible.

+There are several structures and types defined by Allegro which are used
+in many functions (like the BITMAP structure). This section of the manual
+describes their useful content from a user point of view when they don't fit

...from an user...

+very well any of the existing manual sections, and redirects you to the
+apropiate section when it's already described there. Note that unless stated

appropriate...

+otherwise, the contents showed here are just for read only purposes, there
+might be other internal flags which you should't depend on being available in

...shouldn't... and the construct sounds a bit intricate.

+future/past versions of Allegro.

past/future

+   Structure used by Allegro's 3d zbuffered rendering functions. You are not
+   supposed to miz ZBUFFER with BITMAP even though it is currently possible.

...to mix... it is currently possible to do so.

+   A packfile structure, similar to a stdio.h *FILE structure. Read chapter

FILE structure.

+   There's no get_clip like function. To obtain the clipping rectangle of an
+   existant bitmap, check the apropiate fields of the BITMAP structure

(Hey! that's French!) existing... appropriate...

+manipulation functions accordingly. Read chapter "Structures and types
+defined by Allegro" for an in ternal view of the MATRIX/_f structures.

...internal...

> - now chapters can be x-referenced like any other node.

Nice.

> - to avoid having to manually add references to BITMAP, PALETTE, etc,
> both info and html output generate them automatically detecting those
> types in the definitions.

Cool!

> - html version is cooler, and such autotypes aren't added to the "See
> also" part, but are directly hyperlinked.

+ *      Grzegorz Adam Hankiewicz made the output valid HTML 4.0, made sorted
+ *      TOCs, added support for cross references and optional CSS to color ,

Bogus terminating comma.

- Eric



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