doxygen-users

[Doxygen-users] order of modules in RTF/LaTex and how to exclude some sections?

[John C. <j.c...@ar...>]

We have groups (@defgroup) defined that form a hierarchy
of modules in the generated document.  When generating
RTF or PDF (via LaTex) these groups seem to be ordered
more by when they were encountered in the code rather than
following the group hierarchy -- so I lower level
group/module might have its detailed description come
BEFORE the higher level group.

In HTML this isn't a problem since groups are always
viewed by 'drilling' down.

ALSO, is there a way to exclude top level documentation
sections like 'Files' or 'Data Structures'.  What is
odd about the 'Data Structures' section to me is that it
lists data structures that are also part of some group.
If in a group, we prefer not to see a data structure
(or other declarations) documented until the rest of that
group/module is documented.

Thanks for any ideas!

--John

[Doxygen-users] best ways of getting images into generated outputs

[John C. <j.c...@ar...>]

What should I do if I had an image file (.gif, .png, .jpg,
etc.) and wanted to have some Doxygen comment in my source
code cause that image to be displayed in the generated output?

Ideally I want to have the imaged display in both LaTeX (which
I convert to .pdf) and HTML.  I know for HTML only I could
include an HTML <IMG> tag, but that doesn't help LaTeX.

Any thoughts on good options??

Thanks,

--John
j.c...@ar...

Re: [Doxygen-users] best ways of getting images into generated outputs

[Berno L. <ber...@ep...>]

What about looking in the commands section of the doxygen manual :-)

You have to use the \image command which has to be used for every output 
format you want to produce.

---
Gruß

Berno


Am Wednesday 05 September 2001 00:15 schrieben Sie:
> What should I do if I had an image file (.gif, .png, .jpg,
> etc.) and wanted to have some Doxygen comment in my source
> code cause that image to be displayed in the generated output?
>
> Ideally I want to have the imaged display in both LaTeX (which
> I convert to .pdf) and HTML.  I know for HTML only I could
> include an HTML <IMG> tag, but that doesn't help LaTeX.
>
> Any thoughts on good options??
>
> Thanks,
>
> --John
> j.c...@ar...

Re: [Doxygen-users] best ways of getting images into generated outputs

[Volker B. <boe...@we...>]

On Tue, 4 Sep 2001, John Clinton wrote:

> What should I do if I had an image file (.gif, .png, .jpg,
> etc.) and wanted to have some Doxygen comment in my source
> code cause that image to be displayed in the generated output?
> 
> Ideally I want to have the imaged display in both LaTeX (which
> I convert to .pdf) and HTML.  I know for HTML only I could
> include an HTML <IMG> tag, but that doesn't help LaTeX.

For bitmap-graphics I use PNG only (small size, portable), example:

  @image html billing_ext_arch.png
  @latexonly \begin{center} @endlatexonly
    @image latex billing_ext_arch.png width=10cm
  @latexonly \end{center} @endlatexonly

Unfortunately this doesn't work with the dvips driver of the graphicx
package, so you can't generate a dvi file from the code above. And even
the following will not work:

 $ cd latex
 $ make pdf

Since this only converts the dvi to pdf (via ps).
The only way is to use pdflatex:

 $ cd latex
 $ pdflatex refman

(Dimitri, perhaps you could add a 'pdflatex' target to the Makefile in the
generated latex directory.)

The alternative for latex is converting the bitmaps to EPS, but this costs
disk space and maintenance effort.

Regards,
Volker
-- 
Volker Boerchers, boe...@we...