Hi Ivan, Regarding the "C", I notice that there is a line in Frank Lübeck's vim syntax file for GAP code which reads "syn match gapFunLine '^#[FVOMPCAW] .*$' contained", so I guess FVOMPCAW are the possible values of that letter. What they mean, I don't know... Similar patterns also appear in the GAP source code (i.e. the C code in the src/ directory), so it looks to me like it might just be a style convention of the GAP authors.
There is something kind of like docstrings mentioned in Chapter 4 of the GAPDoc-1.3 manual, but it's not automatically generated, and it has an XML-ish syntax rather than being plaintext like Doxygen or similar systems. I'm not sure if there's something else I haven't discovered. -Keshav Disclaimer: the boilerplate text at the foot of this email has been added automatically by my mail server. This was not done by my request (rather the opposite) so please disregard it. 2011/5/28 Ivan Andrus <darthand...@gmail.com>: > I have some gap files with functions that I have written. They are not part > of any package, nor I suspect will they ever be. I would like to add some > doxygen-style documentation and have it picked up by the GAP help system. I > have seen several gap files with documentation that looks something like: > > #################################################### > ## > #C SomeFunction( arg1, ) . . . . . . . . . . Short description > ## > ## Some long documentation describing what it's meant to do, > ## limits, caveats, or whatever > > I have looked at the GAPDoc package which I thought might be involved but it > seems to be completely different. I have been completely unable to find > documentation for either the format (e.g. what does the C mean), or how to > get it into GAP's help system. > > What is the best/easiest way to deal with such doxygen-style documentation? > > -Ivan > _______________________________________________ > Forum mailing list > Forum@mail.gap-system.org > http://mail.gap-system.org/mailman/listinfo/forum > CONFIDENTIALITY: This email is intended solely for the person(s) named and may be confidential and/or privileged. If you are not the intended recipient, please delete it, notify us and do not copy, use, or disclose its content. Thank you. Towards A Sustainable Earth: Print Only When Necessary _______________________________________________ Forum mailing list Forum@mail.gap-system.org http://mail.gap-system.org/mailman/listinfo/forum
