[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Help-glpk] Doxygen

From: Xypron
Subject: Re: [Help-glpk] Doxygen
Date: Sun, 17 Jun 2012 09:41:51 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:10.0.4) Gecko/20120510 Icedove/10.0.4

Hello Andrew,

I did not mean to replace or change the pdf documentation.

When trying to read your coding to understand it better it is helpful,
to have the coding in a form where you can easily navigate between the
different modules.

Adding a configuration file for Doxygen would allow the interested
person to easily generate such a cross referenced coding. Adding the
configuration file would not necessitate to make any other changes in GLPK.

Best regards


On 16.06.2012 11:00, Andrew Makhorin wrote:
> Hi Xypron,
> Sorry for a long delay in my response.
>> currently a cross reference to the GLPK code is missing.
>> Doxygen gives the possibility to generate a documentation from the
>> existing code.
>> For an example see
>> In the appendix you will fill configuration file "Doxyfile" and filter
>> "doxyfilter" (which should be chmod 755).
>> The filter discovers all lines containg "*  NAME" and indicates to
>> doxygen that this is the start of a special comment block, cf.
>> I suggest to add the two files to the root directory of the GLPK
>> source distribution.
>> To create the documentation in directory glpk-4.47/doc/doxygen
>> navigate to directory glpk-4.47 and invoke command doxygen.
>> Prerequisites for usage are:
>> - Doxygen
>> - sed
>> - Graphviz
>> More complete documentation could be produced after adjusting the
>> comment style in glpk a bit, e.g.
>> int var; /*!< Detailed description after the member */
>> instead of
>> int var; /* Detailed description after the member */
> Thank you for you suggestion.
> I have a negative experience on working with packages documented in such
> way and wouldn't like to use it.
> Could you provide an example of that that should be cross referenced? Do
> you mean routine names, terms, or what? I think that it would quite easy
> to make necessary additions in the LaTeX files. If you mean the source
> code, there exist some packages to automatically format it and produce,
> say, html or pdf pages provided with the index of all program objects
> and hyperlinks. However, I don't find that such way facilitates studying
> the source code.
> Andrew Makhorin

reply via email to

[Prev in Thread] Current Thread [Next in Thread]