This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Experiment: gcc and doxygen


On Thu, Feb 14, 2002 at 05:25:18PM -0800, Joe Buck wrote:
> But in this case it will be cheaper to teach people to fish than to give
> them the fish.  That is, the doxygen source and your instructions on how
> to generate the data will take less disk space than just the data, right?

Less space, certainly.  Less time?  Hmm.

Short version:

1)  Get doxygen.
2)  Get the "dot" utility.
3)  Create a doxygen config file.

Long version:

1)  Get doxygen:  www.doxygen.org and use the latest version you possibly
    can -- they believe in "release early, release often" and are fixing
    bugs very fast.
2)  GraphViz is from AT&T (http://www.research.att.com/sw/tools/graphviz/),
    with a spinoff at www.graphviz.org, and last time I checked required
    strange AT&T tools to build from source.  Get a prebuilt binary.
3)  I took libstdc++'s doxygen file and hacked it up.  It's below.  You'll
    need to modify it to fit local paths (full paths aren't required, but it
    gets confusing without them).  Settings to investigate include INPUT,
    OUPUT_DIRECTORY, STRIP_FROM_PATH, FILE_PATTERNS, EXCLUDE, EXCLUDE_PATTERNS,
    HTML_STYLESHEET, and DOT_PATH. 

Put the config file in the top-level directory.  Run "doxygen configfile".
On a reasonably fast i686 with little load, it takes about half an hour.
Listen for a burst of disk activity; that's the end of processing when
all the HTML is being created.  It means your computer is usable again.  :-)


Phil

-- 
If ye love wealth greater than liberty, the tranquility of servitude greater
than the animating contest for freedom, go home and leave us in peace.  We seek
not your counsel, nor your arms.  Crouch down and lick the hand that feeds you;
and may posterity forget that ye were our countrymen.            - Samuel Adams

Attachment: doxy_gcc.cfg
Description: Text document


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]