[dev-context] cont-en.xml

Marius mariausol at gmail.com
Wed Jun 30 12:57:41 CEST 2010


I think that the best way is to put command syntax description just
before its definition in the context file. This way it will be easier
to keep it always in sync with the code. And most important point here
is that it must be in sync always. If it is, then we can just generate
cont-en.xml and other cont-xx.xml files, but also have a syntax

Just imagine:

context --check-syntax myfile.tex

shows you which options or commands are experimental, deprecated, and
which are unrecognized, and suggests the command or option to fix

What do you think?


On Sun, Jun 27, 2010 at 8:11 PM, Wolfgang Schuster
<schuster.wolfgang at googlemail.com> wrote:
> Am 23.06.10 09:35, schrieb Peter Münster:
>> On Wed, Jun 16 2010, Wolfgang Schuster wrote:
>>> i plan to update cont-en.xml with changes in mkiv (new keys and commands)
>> Hello Wolfgang,
>> Since Hans said "documentation about tex can best be done in tex", I've
>> put
>> my ideas into some files here:
>> http://pmrb.free.fr/tmp/context-commands/
>> What do you think about that?
> I agree that tex is the best tool to document tex but cont-en.xml is only
> a tool to help in the documentation and i can't see a big advantage to
> rewrite it in pure tex. The explanation for the keys/options is another
> thing but they are not what i'm working on.
> My files are now available here: http://bitbucket.org/wolfs/setup
> Wolfgang
> _______________________________________________
> dev-context mailing list
> dev-context at ntg.nl
> http://www.ntg.nl/mailman/listinfo/dev-context

More information about the dev-context mailing list