## doxygen-users — List for users of doxygen

You can subscribe to this list here.

2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 Jan Feb Mar Apr (1) May (118) Jun (150) Jul (115) Aug (75) Sep (92) Oct (102) Nov (139) Dec (87) Jan (131) Feb (60) Mar (114) Apr (83) May (125) Jun (82) Jul (95) Aug (98) Sep (109) Oct (97) Nov (72) Dec (70) Jan (117) Feb (122) Mar (187) Apr (114) May (154) Jun (131) Jul (130) Aug (98) Sep (121) Oct (107) Nov (80) Dec (54) Jan (78) Feb (71) Mar (118) Apr (56) May (56) Jun (64) Jul (164) Aug (104) Sep (101) Oct (69) Nov (107) Dec (98) Jan (75) Feb (77) Mar (107) Apr (114) May (142) Jun (106) Jul (79) Aug (108) Sep (115) Oct (140) Nov (128) Dec (63) Jan (86) Feb (71) Mar (125) Apr (55) May (48) Jun (143) Jul (99) Aug (91) Sep (93) Oct (82) Nov (46) Dec (45) Jan (69) Feb (97) Mar (125) Apr (112) May (65) Jun (80) Jul (82) Aug (84) Sep (56) Oct (74) Nov (63) Dec (74) Jan (161) Feb (115) Mar (58) Apr (73) May (58) Jun (79) Jul (57) Aug (115) Sep (79) Oct (62) Nov (93) Dec (37) Jan (69) Feb (115) Mar (77) Apr (85) May (124) Jun (58) Jul (44) Aug (85) Sep (90) Oct (80) Nov (87) Dec (48) Jan (52) Feb (71) Mar (54) Apr (37) May (66) Jun (86) Jul (84) Aug (68) Sep (94) Oct (66) Nov (36) Dec (53) Jan (59) Feb (77) Mar (59) Apr (67) May (76) Jun (54) Jul (95) Aug (92) Sep (84) Oct (72) Nov (46) Dec (60) Jan (43) Feb (77) Mar (88) Apr (121) May (81) Jun (69) Jul (97) Aug (64) Sep (55) Oct (55) Nov (38) Dec (60) Jan (85) Feb (70) Mar (81) Apr (83) May (51) Jun (65) Jul (71) Aug (39) Sep (47) Oct (32) Nov (43) Dec (28) Jan (64) Feb (22) Mar (54) Apr (20) May (59) Jun (20) Jul (50) Aug (17) Sep (37) Oct (56) Nov (40) Dec (24) Jan (51) Feb (29) Mar (57) Apr (31) May (23) Jun (50) Jul (30) Aug (66) Sep (59) Oct (21) Nov (29) Dec (12) Jan (33) Feb (30) Mar (19) Apr (23) May (16) Jun (31) Jul (17) Aug (19) Sep (21) Oct (20) Nov (15) Dec (6) Jan (16) Feb (13) Mar (16) Apr (23) May (16) Jun (5) Jul (14) Aug (13) Sep (10) Oct Nov Dec
S M T W T F S

1
(3)
2

3
(1)
4

5

6
(5)
7
(2)
8
(3)
9
(3)
10
(2)
11
(1)
12

13
(1)
14

15
(1)
16
(1)
17
(9)
18

19

20

21
(10)
22
(3)
23
(5)
24
(1)
25

26
(1)
27

28
(1)
29
(2)
30
(1)
31
(8)

Showing results of 64

1 2 3 > >> (Page 1 of 3)
 [Doxygen-users] Forward declarations of class templates produce spurious entries in class list From: Wojciech Śmigaj - 2012-08-31 21:18:45 Dear Doxygen developers, I think I have come across a bug in how Doxygen handles forward declarations of class templates. Suppose that I have the following file: namespace N { template class C; /** \brief C */ template class C { public: /** \brief method */ void method() {} }; } // end namespace N When I process it with Doxygen 1.8.2, the generated class list ("annotated.html") contains not only the N::C class template, but also a spurious entry "C" outside any namespace. The latter disappears if I remove the forward declaration of C. The same problem occurs if a forward declaration of a class template is found in a different source file than its definition, and each such declaration produces a new spurious entry in the class list. Best regards, Wojciech Smigaj 
 Re: [Doxygen-users] How to debug Doxygen crashes? From: Stefan Pendl - 2012-08-31 13:03:59 Am 31.08.2012 14:52, schrieb Taceant Omnes: > On Fri, Aug 31, 2012 at 1:08 PM, Stefan Pendl wrote: > >> You have two options: >> >> 1) run through the doxywizard >> 2) set the WARN_LOGFILE setting > > Thanks, but I would think that whatever goes to WARN_LOGFILE goes also > to stderr, and I already get that by calling Doxygen from the command > line. I was wondering if there was some option that would result in a > more verbose output beyond what normally goes to stderr? > Sure this is only a redirection. You can control what is displayed by the WARN_... settings, that's all. -- Stefan P. Top-posting: A: Because it messes up the order in which people normally read text. Q: Why is top-posting such a bad thing? A: Top-posting. Q: What is the most annoying thing in e-mail? 
 Re: [Doxygen-users] How to debug Doxygen crashes? From: Taceant Omnes - 2012-08-31 12:52:19 On Fri, Aug 31, 2012 at 1:08 PM, Stefan Pendl wrote: > You have two options: > > 1) run through the doxywizard > 2) set the WARN_LOGFILE setting Thanks, but I would think that whatever goes to WARN_LOGFILE goes also to stderr, and I already get that by calling Doxygen from the command line. I was wondering if there was some option that would result in a more verbose output beyond what normally goes to stderr? 
 Re: [Doxygen-users] How to debug Doxygen crashes? From: Stefan Pendl - 2012-08-31 12:08:49 Am 31.08.2012 12:40, schrieb Taceant Omnes: > I just had a Doxygen crash. I was able to debug it by looking at file > doxygen_entrydb_4952.tmp in which I could find the name of the > function that was being processed when the crash happened. I then > fixed the offending Doxygen tag. > > Hopefully I won’t see another crash, but if it happens, what else > could I do to figure out what caused it (short of creating my own > debug build of Doxygen). Is there some option I could pass on the > command line that could help? > You have two options: 1) run through the doxywizard 2) set the WARN_LOGFILE setting -- Stefan P. Top-posting: A: Because it messes up the order in which people normally read text. Q: Why is top-posting such a bad thing? A: Top-posting. Q: What is the most annoying thing in e-mail? 
 [Doxygen-users] (no subject) From: Praveen Ramanujam - 2012-08-31 12:06:07 Attachments: Message as HTML http://demo.abesayara.com/wp-content/plugins/zeixboofmuo/jhikdba.php?lhji=lhji
 Re: [Doxygen-users] XML tag problems SOLVED From: A L - 2012-08-31 11:37:10 Nevermind, I just found out that the additional paragraphs are only missing in the overview. In the detail section further down the page everything is as it should be. Cheers! 
 [Doxygen-users] XML tag problems From: A L - 2012-08-31 11:09:08 Hi, when I try to use the XML tag in a C# file I essentially get nothing in return: A comment like this (syntax from the ECMA-334 specification): /// /// /// search for and connect to a Wiimote. Exit application with messagebox if connection not possible. /// /// /// Set "change" event handler to /// /// /// /// private void Form1_Load(object sender, EventArgs e) produces this doxygen output: void Form1_Load (object sender, EventArgs e) Everything after the first tag is ignored. When I change the input to: /// /// search for and connect to a Wiimote. Exit application with messagebox if connection not possible. /// /// Set "change" event handler to /// /// /// /// I get: void Form1_Load (object sender, EventArgs e) search for and connect to a Wiimote. Exit application with messagebox if connection not possible. Only when I completely remove all tags, it works: /// /// search for and connect to a Wiimote. Exit application with messagebox if connection not possible. /// Set "change" event handler to /// /// /// private void Form1_Load(object sender, EventArgs e) Output looks (correctly) like this: void Form1_Load (object sender, EventArgs e) search for and connect to a Wiimote. Exit application with messagebox if connection not possible. Set "change" event handler to wm_WiimoteChanged I am using C# in Visual Studio 2010 and Doxygen 1.8.2 via the GUI frontend. Is this a bug that I should report or am I missing something? regards & RFC 
 [Doxygen-users] How to debug Doxygen crashes? From: Taceant Omnes - 2012-08-31 10:40:37 I just had a Doxygen crash. I was able to debug it by looking at file doxygen_entrydb_4952.tmp in which I could find the name of the function that was being processed when the crash happened. I then fixed the offending Doxygen tag. Hopefully I won’t see another crash, but if it happens, what else could I do to figure out what caused it (short of creating my own debug build of Doxygen). Is there some option I could pass on the command line that could help? 
 [Doxygen-users] Python docstrings and exclamation mark From: Vaclav Petras - 2012-08-30 14:00:10 Hi, I'm confused about python docstrings and how Doxygen handles them. By docstring I really mean this """ """. I don't want to use ## comments for documenting API in Python. When I use only simple docstring, I get docstring content in verbatim as stated in manual [1] (example [2]). """My comment. More here. """ But when I put exclamation mark at the beginning of docstring, Doxygen commands are interpreted as for other languages or ## comments (example [3]). """!My comment. More here. """ This is ok, I'm using this a lot and I like it. But I haven't found anything in the manual about that. So this is the source of confusion. As I understood doxypy [4] enables this, or maybe even something better, but I'm not using it. I'm using only Doxygen 1.8.1.2. Best, Vaclav [1] http://doxygen.org/docblocks.html#pythonblocks [2] http://www.stack.nl/~dimitri/doxygen/examples/docstring/html/classdocstring_1_1PyClass.html [3] http://www.stack.nl/~dimitri/doxygen/examples/pyexample/html/classpyexample_1_1PyClass.html [4] http://code.foosel.org/doxypy 
 [Doxygen-users] Accessing built-in Modules Filelist as sub-pages From: Joel Kuehner - 2012-08-29 19:05:31 Attachments: Message as HTML Is there a way to access the automatically-generated modules or file lists as sub-pages? I'd like to have a document hierarchy that is something like: mainpage UsersGuide Installation DesignGuide Architecture Modules FileList I can think of two options. Option 1 would be to make DesignGuide a page, and assign Modules and FileList as sub-pages. But I cannot figure out a way to do that. I'm assuming there is not, since I cannot find any documentation that explains how to do it. Option 2 would be to use a custom LAYOUT_FILE to make DesignGuide a usergroup tab, something like: This works, except that the Architecture page does not expand in the navigator (sub-pages and sections do not appear in the navigator). It seems like any user-defined tabs that are referenced by url are not represented in the navigator. I really like the navigator; losing that ability is not really acceptable for me. Is there some way to do this that has the hierarchy I've described as well as full navigator support? Joel
 Re: [Doxygen-users] How to put documentation at the top of a module page? From: André Glória - 2012-08-29 17:28:59 Attachments: Message as HTML Hello, it seems to me you probably need to go into customizations...http://www.stack.nl/~dimitri/doxygen/customize.html#layout Best regards, André On 23-08-2012 03:17, Andrew Voelkel wrote: > Hi, > > I'd like to put introductory paragraphs at the beginning of a module > page, before the list of functions and data structures. I would think > that this might do that: > > /// \defgroup mygroup my group > /// \brief > /// here would be > /// an introductory paragraph for the module > > But that doesn't work. It puts the text under "detailed description" > after the function and data structure definitions. > > Is there any way to get what I want? > > - Andy > > > > ------------------------------------------------------------------------------ > Live Security Virtual Conference > Exclusive live event will cover all the ways today's security and > threat landscape has changed and how IT managers can respond. Discussions > will include endpoint security, mobile security and the latest in malware > threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ > > > _______________________________________________ > Doxygen-users mailing list > Doxygen-users@... > https://lists.sourceforge.net/lists/listinfo/doxygen-users 
 [Doxygen-users] MathJax usage From: Albert - 2012-08-28 18:05:16 Dear all, I've been looking at the rendering of the formulas by MathJax compared by the standard rendering as done with the latex png files and the MathJax rendering is much better. In the beginning I used the MathJax from the CDN but this is a bit slow and one has to be connected to the Internet, furthermore in the Doxygen documentation it is advised to use a local copy. I've downloaded the 2.0 version, but it is not completely clear to me what I have to install as a minimal installation. At first glance the unpacked directory seems a good andidate but this does not work. I now have an installation with, besides the MathJax.js file, the extensions, jax and fonts directories (all from the main directory so not from the unpacked directory). I'm not sure whether or not I need the config and images directory. In advance, thanks for your advise Albert 
 [Doxygen-users] doubly rooted call graph From: Shentino - 2012-08-26 03:55:33 Is there a way to generate a call web between two functions and omit anything not between them? 
 Re: [Doxygen-users] documenting only "documented" data structure (second try) From: Andrew Voelkel - 2012-08-24 06:28:58 Attachments: Message as HTML Hi, I did have EXTRACT_ALL set to NO. So that wasn't the problem. But I did go back and looked at all the other options. I had to set HIDE_UNDOCUMENTED_CLASSES to YES as well. That seems redundant, but it worked! You suggestion about the xml file was also good. It not only gives me a feel for what is possible, but it also helps with another problem I was having. I'll repost about that problem separately. - Andy On Thu, Aug 23, 2012 at 12:08 AM, Jakob van Bethlehem < j.s.van.bethlehem@...> wrote: > On 08/23/2012 04:20 AM, Andrew Voelkel wrote: > > Hi All, > > > > I thought I'd try again to get an answer to this question: > > > > On Mon, Aug 20, 2012 at 6:38 PM, Andrew Voelkel andy@...>> wrote: > > > > Hi All, > > > > I've played with Doxygen before, but now I'm committing to using on > a project and need to deal with weird stuff I've noticed before. My task is > documenting public interfaces for an embedded system > > which is coded in C. > > > > I set Doxygen to only document "documented" entities. This works > fine for functions, but Doxygen still insists on generating (meaningless) > documentation for some (but not all!) data structures, > > regardless of whether they are documented or not. How can I fix this? > > > > I'd actually like to reorganize the way the top level HTML page is > organized. To me, having a "data structures" tab at the top level but no > "functions" tab doesn't make any sense. Is there an easy > > way to reorganize this sort of presentation? I'd either like to add > a functions tab or remove the data structures tab. > > > > - Andy > > > > Hej Andy, > > I can imagine no one answered, because you're question is quite incomplete: > - what configuration options are you passing (possibly EXTRACT_ALL is set > to YES?) > - provide a minimal example of code you're trying to parse, and explain > what you want to achieve with it > - from the top of my head, reorganizing html-stuff can be done by hacking > some, I think, XML-files; this procedure is nicely described in the manual > somewhere - a good reason not to get a too quick > response > - It's holiday season - it's not fair to expect an answer within hours ;) > > Greetsz, Jakob > > > ------------------------------------------------------------------------------ > Live Security Virtual Conference > Exclusive live event will cover all the ways today's security and > threat landscape has changed and how IT managers can respond. Discussions > will include endpoint security, mobile security and the latest in malware > threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ > _______________________________________________ > Doxygen-users mailing list > Doxygen-users@... > https://lists.sourceforge.net/lists/listinfo/doxygen-users > 
 [Doxygen-users] How do I configure Doxygen to produce output similar to the diagram attached From: adetheheat - 2012-08-23 09:40:59 We use doxygen and it does pretty much as we want it to. However we were thinking about changing our code and documents to make it look like a memory map.The attached jpg better explains how we want the doxygen output to look like. http://old.nabble.com/file/p34333850/registers.jpg Also, we want to be able to click inside the table to take us to another table to get more accurate descriptionof each register. Is this possible with doxygen ? Not looking for pages of explanation, in your answer if it's possible you could give an example of a system say with just two registers of a byte each so that I can see what to do. thanks in advance -- View this message in context: http://old.nabble.com/How-do-I-configure-Doxygen-to-produce-output-similar-to-the-diagram-attached-tp34333850p34333850.html Sent from the Doxygen - Users mailing list archive at Nabble.com. 
 Re: [Doxygen-users] documenting only "documented" data structure (second try) From: Jakob van Bethlehem - 2012-08-23 07:08:37 On 08/23/2012 04:20 AM, Andrew Voelkel wrote: > Hi All, > > I thought I'd try again to get an answer to this question: > > On Mon, Aug 20, 2012 at 6:38 PM, Andrew Voelkel > wrote: > > Hi All, > > I've played with Doxygen before, but now I'm committing to using on a project and need to deal with weird stuff I've noticed before. My task is documenting public interfaces for an embedded system > which is coded in C. > > I set Doxygen to only document "documented" entities. This works fine for functions, but Doxygen still insists on generating (meaningless) documentation for some (but not all!) data structures, > regardless of whether they are documented or not. How can I fix this? > > I'd actually like to reorganize the way the top level HTML page is organized. To me, having a "data structures" tab at the top level but no "functions" tab doesn't make any sense. Is there an easy > way to reorganize this sort of presentation? I'd either like to add a functions tab or remove the data structures tab. > > - Andy > Hej Andy, I can imagine no one answered, because you're question is quite incomplete: - what configuration options are you passing (possibly EXTRACT_ALL is set to YES?) - provide a minimal example of code you're trying to parse, and explain what you want to achieve with it - from the top of my head, reorganizing html-stuff can be done by hacking some, I think, XML-files; this procedure is nicely described in the manual somewhere - a good reason not to get a too quick response - It's holiday season - it's not fair to expect an answer within hours ;) Greetsz, Jakob 
 Re: [Doxygen-users] How to put documentation at the top of a module page? From: Jakob van Bethlehem - 2012-08-23 07:03:13  On 08/23/2012 04:17 AM, Andrew Voelkel wrote: > Hi, > > I'd like to put introductory paragraphs at the beginning of a module page, before the list of functions and data structures. I would think that this might do that: > > /// \defgroup mygroup my group > /// \brief > /// here would be > /// an introductory paragraph for the module > > But that doesn't work. It puts the text under "detailed description" after the function and data structure definitions. > > Is there any way to get what I want? > > - Andy Hello Andy, I did this in the past, except I don't know from the top of my head exactly how things work with using /// vs /** and what the \brief-command does with a newline. I can look it up in the manual, but I guess, so can you ;) It could also have something to do with the configuration settings you're using (especially some of the JAVA_* options) From your short example, my best guess is that you shouldn't put the newline after the \brief-command. If after some trials, and carefully reading the manual, you still can't quite get what you're looking for, please provide also you're configuration settings when posting your follow-up question and the type of documentation you're trying to generate (my guess is html, but I can't be sure from you're description) Greetsz, Jakob 
 Re: [Doxygen-users] documenting only "documented" data structure (second try) From: Andrew Voelkel - 2012-08-23 02:20:09 Attachments: Message as HTML Hi All, I thought I'd try again to get an answer to this question: On Mon, Aug 20, 2012 at 6:38 PM, Andrew Voelkel wrote: > Hi All, > > I've played with Doxygen before, but now I'm committing to using on a > project and need to deal with weird stuff I've noticed before. My task is > documenting public interfaces for an embedded system which is coded in C. > > I set Doxygen to only document "documented" entities. This works fine for > functions, but Doxygen still insists on generating (meaningless) > documentation for some (but not all!) data structures, regardless of > whether they are documented or not. How can I fix this? > > I'd actually like to reorganize the way the top level HTML page is > organized. To me, having a "data structures" tab at the top level but no > "functions" tab doesn't make any sense. Is there an easy way to reorganize > this sort of presentation? I'd either like to add a functions tab or remove > the data structures tab. > > - Andy > 
 [Doxygen-users] How to put documentation at the top of a module page? From: Andrew Voelkel - 2012-08-23 02:18:06 Attachments: Message as HTML Hi, I'd like to put introductory paragraphs at the beginning of a module page, before the list of functions and data structures. I would think that this might do that: /// \defgroup mygroup my group /// \brief /// here would be /// an introductory paragraph for the module But that doesn't work. It puts the text under "detailed description" after the function and data structure definitions. Is there any way to get what I want? - Andy 
 [Doxygen-users] \latexonly broken in 1.8.2? From: Andrew Voelkel - 2012-08-22 09:59:13 Attachments: Message as HTML >Am 22.08.2012 06:11, schrieb Andrew Voelkel: >> >> What happened? I need to use \latexonly because the \image command does >> not support PDF format input in PDFLATEX mode, even though Latex does. >> > >Did you try it? > >The doxygen manual tells us the only EPS is supported, but I have >successfully used PNG instead. I tried PDF in a slightly older version, and it didn't work. I haven't retried it in 1.8.2 But in any case, shouldn't \latexonly work, especially if it used to? - Andy 
 Re: [Doxygen-users] \latexonly broken in 1.8.2?? From: Stefan Pendl - 2012-08-22 05:35:04 Am 22.08.2012 06:11, schrieb Andrew Voelkel: > > What happened? I need to use \latexonly because the \image command does > not support PDF format input in PDFLATEX mode, even though Latex does. > Did you try it? The doxygen manual tells us the only EPS is supported, but I have successfully used PNG instead. -- Stefan P. Top-posting: A: Because it messes up the order in which people normally read text. Q: Why is top-posting such a bad thing? A: Top-posting. Q: What is the most annoying thing in e-mail? 
 [Doxygen-users] \latexonly broken in 1.8.2?? From: Andrew Voelkel - 2012-08-22 04:12:02 Attachments: Message as HTML Hi, I updated my version of doxygen to fix the problem that "make pdf" did not work properly on the Windows platform. But now previous input that produced the right latex output breaks both the latex and HTML output! For instance, the following code worked in a earlier version: /// \mainpage My Main Page /// \section first_sec First Section /// - item 1 /// - item 2 /// - item 3 /// . /// \latexonly \begin{DoxyImageNoCaption} \mbox{\includegraphics{"Block Diagram"}} \end{DoxyImageNoCaption} \endlatexonly (note that I couldn't use "/// \endlatexonly", which seems to make more sense, because it stuck "///" into the output). But with 1.8.2, the HTML output looks like : My Main Page @section first_sec First Section - item 1 - item 2 - item 3 . @latexonly {DoxyImageNoCaption} {{"Block Diagram"}} {DoxyImageNoCaption} The output in the tek file is also messed up. What happened? I need to use \latexonly because the \image command does not support PDF format input in PDFLATEX mode, even though Latex does. Help!! - Andy 
 [Doxygen-users] (no subject) From: Zapro - 2012-08-21 19:21:12 Attachments: Message as HTML http://pantiesplace.net/crtr/google.html
 Re: [Doxygen-users] Multiple Projects, Languages and Shared Config Files From: Cuckow, Pez - 2012-08-21 16:18:54 Attachments: Message as HTML Liebe Raimund, First of all thanks for all the detailed info, I'll look into everything another day (when I have slightly more time) and post back my findings and the setup we used in the end! MfG, Pez From: Klein, Raimund [mailto:Raimund.Klein@...] Sent: Tuesday, August 21, 2012 2:09 PM To: doxygen-users@... Subject: Re: [Doxygen-users] Multiple Projects, Languages and Shared Config Files Importance: High Hi Pez, Welcome to the Light. :) As to your first question, you have basically two ways: - The obvious way is to just create a master HTML page manually and link statically to the generated documentation. - If you want to ensure a consistent appearance, you can just create another general documentation project which will only consist of files with comments. (AFAIK This is how Dimitri maintains the Doxygen website itself.) I'll combine the replies to your other questions, as we have a similar setup: We're combining documentation for Java and VB .NET code (via the VB .NET to C#-filter) and doing our best to manage at least most of it in just one master config file. What came in very handy was the features of @INCLUDE_PATH and @INCLUDE for the configuration: http://www.stack.nl/~dimitri/doxygen/config.html combined with doxygen's ability to process configuration settings via stdin (look at http://www.stack.nl/~dimitri/doxygen/faq.html Item #17;). Of course, you can also just add a single doxyfile with additional settings to every project and just @INCLUDE the master file there. However, what I never found out is whether it's actually possible to build a real inheritance hierarchy with these options. Maybe someone can enlighten both of us on this matter? E.g. is the following scenario possible: One concrete project config file @INCLUDEs a general Java config file which in turn @INCLUDEs a master config file with the common options for all of my projects? Mit freundlichen Grüßen Raimund Klein EDV / Software Entwickler BERENBERG BANK Joh. Berenberg, Gossler & Co. KG Neuer Jungfernstieg 20 20354 Hamburg Telefon +49 40 350 60-8129 Telefax +49 40 350 60-955 E-Mail raimund.klein@... http://www.berenberg.de; Sitz: Hamburg - Amtsgericht Hamburg HRA 42659 Von: Cuckow, Pez [mailto:Pez.Cuckow@...] Gesendet: Dienstag, 21. August 2012 12:00 An: 'doxygen-users@...' Betreff: [Doxygen-users] Multiple Projects, Languages and Shared Config Files Hi all, I am new to Doxygen trying to get everyone in my team to look at using it, I've generated docs for one project and they seemed to like it so looking at multiple projects, I was wondering if someone could point me in the correct direction/give me some suggestions. As a team we manage 5/6 projects, what is the best way to approach this within Doxygen? Ideally we'd like them to be linked so you can go to one central page and access all the docs for each project but obviously as code there are no dependencies between them. On a further note a few of the projects code bases have 2/3 sets of programing language for example Java for the server, C# for GUI and some C for some other services. How does Doxygen code/how best to configure so it copes? My final question (appreciate this is a long one) is, is it possible to inherit config files? Ideally I'd like to be able to make one "master file", and then have one for each project with any project specific settings that all inherit the defaults from the master! Thanks for your time, Pez Diese Nachricht einschliesslich etwa beigefuegter Anhaenge ist vertraulich und kann dem Bank- und Datengeheimnis unterliegen oder sonst rechtlich geschuetzte Daten und Informationen enthalten. Wenn Sie nicht der richtige Adressat sind oder diese Nachricht irrtuemlich erhalten haben, informieren Sie bitte sofort den Absender über die Antwortfunktion. Anschliessend moechten Sie bitte diese Nachricht einschliesslich etwa beigefuegter Anhaenge unverzueglich vollstaendig loeschen. Das unerlaubte Kopieren oder Speichern dieser Nachricht und/oder der ihr etwa beigefuegten Anhaenge sowie die unbefugte Weitergabe der darin enthaltenen Daten und Informationen sind nicht gestattet. Wir weisen darauf hin, dass rechtsverbindliche Erklaerungen namens unseres Hauses grundsaetzlich der Unterschriften zweier ausreichend bevollmaechtigter Vertreter unseres Hauses beduerfen. Wir verschicken daher keine rechtsverbindlichen Erklaerungen per E-Mail an Dritte. Demgemaess nehmen wir per E-Mail auch keine rechtsverbindlichen Erklaerungen oder Auftraege von Dritten entgegen. Sollten Sie Schwierigkeiten beim Oeffnen dieser E-Mail haben, wenden Sie sich bitte an den Absender oder an info@.... Please refer to http://www.berenberg.de/my_berenberg/disclaimer_e.html for our confidentiality notice. 
 Re: [Doxygen-users] Multiple Projects, Languages and Shared Config Files From: Klein, Raimund - 2012-08-21 13:44:48 Attachments: Message as HTML Hi Pez, Welcome to the Light. J As to your first question, you have basically two ways: - The obvious way is to just create a master HTML page manually and link statically to the generated documentation. - If you want to ensure a consistent appearance, you can just create another general documentation project which will only consist of files with comments. (AFAIK This is how Dimitri maintains the Doxygen website itself.) I'll combine the replies to your other questions, as we have a similar setup: We're combining documentation for Java and VB .NET code (via the VB .NET to C#-filter) and doing our best to manage at least most of it in just one master config file. What came in very handy was the features of @INCLUDE_PATH and @INCLUDE for the configuration: http://www.stack.nl/~dimitri/doxygen/config.html combined with doxygen's ability to process configuration settings via stdin (look at http://www.stack.nl/~dimitri/doxygen/faq.html Item #17 ; ). Of course, you can also just add a single doxyfile with additional settings to every project and just @INCLUDE the master file there. However, what I never found out is whether it's actually possible to build a real inheritance hierarchy with these options. Maybe someone can enlighten both of us on this matter? E.g. is the following scenario possible: One concrete project config file @INCLUDEs a general Java config file which in turn @INCLUDEs a master config file with the common options for all of my projects? Mit freundlichen Grüßen Raimund Klein EDV / Software Entwickler BERENBERG BANK Joh. Berenberg, Gossler & Co. KG Neuer Jungfernstieg 20 20354 Hamburg Telefon +49 40 350 60-8129 Telefax +49 40 350 60-955 E-Mail raimund.klein@... http://www.berenberg.de ; Sitz: Hamburg - Amtsgericht Hamburg HRA 42659 Von: Cuckow, Pez [mailto:Pez.Cuckow@...] Gesendet: Dienstag, 21. August 2012 12:00 An: 'doxygen-users@...' Betreff: [Doxygen-users] Multiple Projects, Languages and Shared Config Files Hi all, I am new to Doxygen trying to get everyone in my team to look at using it, I've generated docs for one project and they seemed to like it so looking at multiple projects, I was wondering if someone could point me in the correct direction/give me some suggestions. As a team we manage 5/6 projects, what is the best way to approach this within Doxygen? Ideally we'd like them to be linked so you can go to one central page and access all the docs for each project but obviously as code there are no dependencies between them. On a further note a few of the projects code bases have 2/3 sets of programing language for example Java for the server, C# for GUI and some C for some other services. How does Doxygen code/how best to configure so it copes? My final question (appreciate this is a long one) is, is it possible to inherit config files? Ideally I'd like to be able to make one "master file", and then have one for each project with any project specific settings that all inherit the defaults from the master! Thanks for your time, Pez Diese Nachricht einschliesslich etwa beigefuegter Anhaenge ist vertraulich und kann dem Bank- und Datengeheimnis unterliegen oder sonst rechtlich geschuetzte Daten und Informationen enthalten. Wenn Sie nicht der richtige Adressat sind oder diese Nachricht irrtuemlich erhalten haben, informieren Sie bitte sofort den Absender über die Antwortfunktion. Anschliessend moechten Sie bitte diese Nachricht einschliesslich etwa beigefuegter Anhaenge unverzueglich vollstaendig loeschen. Das unerlaubte Kopieren oder Speichern dieser Nachricht und/oder der ihr etwa beigefuegten Anhaenge sowie die unbefugte Weitergabe der darin enthaltenen Daten und Informationen sind nicht gestattet. Wir weisen darauf hin, dass rechtsverbindliche Erklaerungen namens unseres Hauses grundsaetzlich der Unterschriften zweier ausreichend bevollmaechtigter Vertreter unseres Hauses beduerfen. Wir verschicken daher keine rechtsverbindlichen Erklaerungen per E-Mail an Dritte. Demgemaess nehmen wir per E-Mail auch keine rechtsverbindlichen Erklaerungen oder Auftraege von Dritten entgegen. Sollten Sie Schwierigkeiten beim Oeffnen dieser E-Mail haben, wenden Sie sich bitte an den Absender oder an info@... Please refer to http://www.berenberg.de/my_berenberg/disclaimer_e.html for our confidentiality notice. 

Showing results of 64

1 2 3 > >> (Page 1 of 3)