summaryrefslogtreecommitdiffstats
path: root/parts/doxygen/README.dox
blob: 21dc48b8de5edd425cbf1094774caac5981d7309 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
/**
\class DoxygenPart
Integrates Doxygen - http://www.doxygen.org into KDevelop.
It allows you to call the Doxygen executable from a KDevelop menu.
It integrates a GUI into the "KDevelop Project Configuration dialog" to
configure Doxygen (it reads and writes Doxygen Compatible configuration files).

<b>To update to a newer doxygen version:</b>

  -# Merge over the config.h and config.cpp files from the addon/doxywizard/
    directory in the doxygen sources.
    You'll need:
    - GNU bison v1.34 or better
    - GNU flex v2.5.4 or better
    - Kompare from KDEsdk or kdiff3
    .
    You'll have to issue:
        <code>\verbatim$ ./configure --with-doxywizard && make\endverbatim</code>
    to get the config.h and config.cpp files on this directory.
    You should also copy config.l if you'd like to do some debugging.
    <br>
    -# To do the merge on config.cpp you should use:
          <code>\verbatim$ kdiff3 doxygen-location/src/config.cpp tdevelop-location/parts/doxygen/config.cpp\endverbatim</code>
      - Be careful because doxygen uses the deprecated QList class while KDevelop
      uses the new QPtrList so you should not merge certain lines of code!!!
      - Be careful because doxygen uses the deprecated QRegExp::match() method while
      KDevelop uses the new QRegExp::search() and QRegExp::matchedLength() mehtods
      instead so you should not merge certain lines of code!!!
      - Be careful because KDevlop uses the QFile::encodeName() function and the
      original doxygen code doesn't. So do NOT delete the QFile::encodeName() calls.
      .
    <br>
    -# To do the merge on config.h you should use:
          <code>\verbatim$ kdiff3 doxygen-location/src/config.h tdevelop-location/parts/doxygen/config.h\endverbatim</code>
      - Again, be careful because doxygen uses the deprecated QList class while KDevelop
      uses the new QPtrList so you should not merge certain lines of code!!!
      .
    <br>
    .
  -# Copy over the file <code>doxygen-location/src/lang_cfg.h</code> to the <code>tdevelop-location/parts/doxygen/</code> directory.
  -# Add the new i18n strings to messages.cpp.
    To do so, run KDevelop and go to Project-> Project Options... -> Doxygen.
    Take a look at KDevelop' console output, it will warn you about the missing
    messages. Add them to messages.cpp file.
  -# Update version.cpp
  -# Add anything else you needed to do, to get it to compile, to the parts/doxygen/README.dox file.

Everything else we can customize for our look & feel.

\authors <a href="mailto:dimitri AT stack.nl">Dimitri van Heesch</a>

\maintainer <a href="mailto:bernd AT kdevelop.org">Bernd Gehrmann</a>
\maintainer <a href="mailto:a.lucas at tu-bs dot de">Amilcar Lucas</a>


\feature Call Doxygen executable from a KDevelop menu.
\feature Configure Doxygen inside KDevelop.
\feature Create a configuration file with correct ProjectName, Author, Version and
    location of source files whenever a new KDevelop project is created.
\feature Automaticaly generate a Doxygen search database whenever the "search engine" option in Doxygen configuration is activated and you "Run Doxygen".


\requirement You need to install the <a href="http://www.doxygen.org">Doxygen</a> binaries in your machine. This part supports
all versions up to the version stated on the version.cpp file. As usual it is
recomended to use the latest version or at least >= 1.3.4.
\requirement It is recomended that you also install <a href="http://www.graphviz.org">dot</a> >= 1.8.7 (tool to generate graphical
dependencies).


\bug doesn't resize the configuration GUI properly.


\faq <b>Do I need to install Doxygen?</b>
     Yes
*/