| Re: [AD] Docs and set_gfx_mode |
[ Thread Index |
Date Index
| More lists.liballeg.org/allegro-developers Archives
]
On 2004-09-26, Elias Pschernig <elias@xxxxxxxxxx> wrote:
> Hm, I misunderstood @externalfile. It doesn't actually include
> the file, as I had expected. Maybe we should replace @externalfile
> by a new command @include.. which would just parse the specified
> file as if it was at that place in the main ._tx file. That would
> also solve the problem of .pdf output missing some of the docs.
Never wanted to try it because it's kind of a gray area. Each
._tx file has it's own header settings, and it would feel like
overridding those, in some way... maybe. You would also kind of
loose the flexibility to link external files with names other than
the current main ._tx file being processed, because the makedoc
reading part is completely unaware of the writer.
The solution should be something which keeps the HTML output as is,
and just improves the output of non HTML formats. The way to handle
this would be to pass makedoc from the commandline a -swallow
parameter for the non HTML outputs. Makedoc would then process
@externalfile as a real @include.