Jannick | 19 May 2013 19:31
Picon

[1.8.4/LaTeX] collision with \usepackage{attachfile}

Hi,

with the today's version 1.8.4 the attachfile LaTeX package collides with
the hyperref package. The error disappeared after moving
\usepackage{attachfile} after the hyperref block.

I don't know to amend this without editing the refman.tex file every time. 

Any support is highly appreciated.

Best
J.

------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
Dimitri van Heesch | 19 May 2013 14:32
Picon
Favicon

Doxygen-1.8.4 in SVN

Hi,

Doxygen version 1.8.4 has just been released. 
Here is the changelog since last update:
--------------------------------------------------------------------------------
+ ADD: Included update for the Romanian translation.
+ BUG: id 699731: LaTeX: switch to using the xtabular package instead of
       longtable to prevent overfull vbox errors.
+ BUG: id 650004: use \page now generates a man page were the . is not
       replaced by _8.
+ BUG: id 700345: Comment blocking ending with ///// made slashes appear in
       the output.
+ BUG: id 700456: Added support for separating auto list items with an
       empty paragraph.
--------------------------------------------------------------------------------
Enjoy,
  Dimitri

------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
Peter A. Bigot | 17 May 2013 16:23

[PATCH] fix extension mapping to C

From: "Peter A. Bigot" <pab <at> pabigot.com>

CLanguageScanner::needsPreprocessing hard-codes a set of extensions that are
normally associated with non-C languages, and denies preprocessing for those
extensions.  Override this exclusion when EXTENSION_MAPPING has explicitly
associated the extension with a C-like language.

Signed-off-by: Peter A. Bigot <pab <at> pabigot.com>
---
 src/scanner.l |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)

diff --git a/src/scanner.l b/src/scanner.l
index 32f00c8..37a3a53 100644
--- a/src/scanner.l
+++ b/src/scanner.l
 <at>  <at>  -6833,7 +6833,9  <at>  <at>  void CLanguageScanner::parseCode(CodeOutputInterface & codeOutIntf,
 bool CLanguageScanner::needsPreprocessing(const QCString &extension)
 {
   QCString fe=extension.lower();
-  return 
+  SrcLangExt lang = getLanguageFromFileName(extension);
+
+  return (SrcLangExt_Cpp == lang) ||
    !( fe==".java" || fe==".as"  || fe==".d"    || fe==".php" || 
       fe==".php4" || fe==".inc" || fe==".phtml" 
     );
--

-- 
1.7.7.6

(Continue reading)

Peter A. Bigot | 17 May 2013 15:56

EXTENSION_MAPPING inc=C does not preprocess

I normally document certain C macros in a .h file with the following syntax:

   #ifndef SOMETHING_IN_H
   /** Document something */
   #define SOMETHING_IN_H
   #endif /* SOMETHING_IN_H */

I need to document some macros that are in a file with extension .inc which
is included into certain C implementation files.  I enable this by adding to
doxygen.cfg:

   EXTENSION_MAPPING = inc=C

However using my normal pattern in a .inc file with several versions
including svn head I get:

   /tmp/test/test.inc:4: warning: documentation for unknown define 
SOMETHING_IN_INC found.

It turns out that, though I've asked Doxygen to treat .inc files as C files,
scanner.l's implementation of CLanguageScanner::needsPreprocessing
explicitly rejects preprocessing .inc files (as it does .java, .as, 
.php, and
several other extensions).

I can see the exclusion of files with extensions exclusively associated with
other languages, but "inc" is pretty generic and (IMO) should not be assumed
by Doxygen to be a PHP source file (which appears to be the default).

Any chance of getting this fixed?  I can work around it by building a local
(Continue reading)

Torsten Hees | 16 May 2013 15:40
Picon

Using an image as ref to a page

Hello,
 
is it possible to use an image instead of text for a reference
 
\ref page1 Link to my Page -> Something like: \ref page1 \img html nicepicture.png
 
or a way that doxygen copy all pcitures inside of my image folder to the output directory. At the moment I do the image refernece with html and I run skript to copy the missing pictures to the output directory. :(
 
 
------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
_______________________________________________
Doxygen-users mailing list
Doxygen-users <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
Arbol One | 15 May 2013 18:55
Picon
Favicon

Adding notes in the main page

I would like to add a note in the main page, right below the '<title> documentation', how do I do that?
Also, how do I go about creating html documentation that would display the following values:
 * \author    The Learner
* \author    The Lerner of the Lerner (he is lost)
* \version 0.0.1
* \date 2013
* \pre First initialize the system.
* \bug No bugs reported
* \warning It is not that some people have willpower and some don't. It's just that some people are ready to change or adapt and other are not
* \copyright <my copyright>

 
 
Thanks in advance
------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
_______________________________________________
Doxygen-users mailing list
Doxygen-users <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
Geoff Worboys | 15 May 2013 10:33
Picon

Unusual template member functions

Hi,

1) I have some template member functions that look like this:

class MyClass {
public
  template<typename C> class UnitIterator;
...
public:
  template<typename C> UnitIterator<C> unit_begin();
...
};

They are unusual in that they have no parameters based on the
template type, so they must always be used explicitly, as in:
  auto iter = myobj.unit_begin<char>();

These seem to be causing doxygen some problems.

When using grouping  <at> {.. <at> } the members appear in the group and
also ungrouped (ie. copies at the top of the list).

Inside the group the return type is as expected (no MyClass::
prefix), but the copies at the top are listed as returning
MyClass::UnitIterator<C>, which is not usual.

Other template member functions in the same class are grouping
properly (no duplication).  The fact that these particular items
have no parameters seems to be the only distinction.

2) I have another class with some static template member
functions.  These also appear to be being duplicated but in a
different way and without the same restriction.  eg:

class MyClass2 {
...
protected:
  template<typename C> static AClass* afunc(const C* ainput);
...
};

In this case the template is showing under the heading of
"static protected member functions" as expected BUT the same
templates are ALSO showing under public member functions
(where it appears the "static" has been stripped off them).

Okay, so my descriptions are a little vague.  I am happy to try
and create a more complete demo of the problems if I can.  But
first I thought I would try asking if there might be something
I'm missing.

P.S. I've had a number of issues that seem to be related to
static members (and possibly C++11 initialisation using {...})
but they have been really strange and difficult to tie down
(coming and going with minor changes).  Am I the only one?

--

-- 
Geoff Worboys
Telesis Computing Pty Ltd

------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
Torsten Hees | 15 May 2013 11:33
Picon

Is there a special command like /textinclude

Hello,
 
I'm looking for a function like /htmlinclude or /include but without the restriction that there are added things like /code /endcode. I want that only all the text inside of the included file is paste on the place where the include is.
 
My aim is to have a top level description about a widget in a txt file that is a part of my detail description and I can use the same toplevel description to create a page for an overview of all widgets. I don't want to use /ref, because I want that the user can read all in one page to give a good overview.
 
Any ideas?
------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
_______________________________________________
Doxygen-users mailing list
Doxygen-users <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
Ron Wilson | 15 May 2013 01:54
Picon

feature request: option to auto execute PerlMod backend

Although a makefile can run any postprocessing needed, running Doxygen
from DoxyWizard does not.

Since Doxygen already automatically runs input filters as specified by
the configuration, it makes sense to provide for running custom
postprocessing - including PerlMod backends - automatically as well.

------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
Ron Wilson | 14 May 2013 23:38
Picon

alias parameter expansion

I am using Doxygen 1.8.3.1 for Windows as downloaded from the Doxygen
download page.

I am using Windows 7 Pro

I have attached my test Doxyfile and .c/.h files.

I defined the alias "change" to take a parameter. In c_test.c, I
invoke the alias twice, each with a differnet value. In the generated
document, the second expansion used the same value as the first
expansion:

<dl class="change1"><dt><b><a class="el"
href="change1.html#_change1000001">Changes
(1.3):</a></b></dt><dd>Simplify display format. </dd></dl>
<dl class="bug"><dt><b><a class="el"
href="bug.html#_bug000002">Bug:</a></b></dt><dd>Doxygen alias, below,
expanded incorectly - got 1.3, expected 1.2 </dd></dl>
<dl class="change1"><dt><b><a class="el"
href="change1.html#_change1000002">Changes
(1.3):</a></b></dt><dd>Display an internal global variable. </dd></dl>




DOXYFILE_ENCODING      = UTF-8


PROJECT_NAME           = Tools


PROJECT_NUMBER         = 


PROJECT_BRIEF          = 


PROJECT_LOGO           = 


OUTPUT_DIRECTORY       = C:\Projects\Tools\Documents


CREATE_SUBDIRS         = NO


OUTPUT_LANGUAGE        = English


BRIEF_MEMBER_DESC      = YES


REPEAT_BRIEF           = YES


ABBREVIATE_BRIEF       = "The $name class" \
                         "The $name widget" \
                         "The $name file" \
                         is \
                         provides \
                         specifies \
                         contains \
                         represents \
                         a \
                         an \
                         the


ALWAYS_DETAILED_SEC    = NO


INLINE_INHERITED_MEMB  = NO


FULL_PATH_NAMES        = NO


STRIP_FROM_PATH        = 


STRIP_FROM_INC_PATH    = 


SHORT_NAMES            = NO


JAVADOC_AUTOBRIEF      = YES


QT_AUTOBRIEF           = YES


MULTILINE_CPP_IS_BRIEF = NO


INHERIT_DOCS           = YES


SEPARATE_MEMBER_PAGES  = NO


TAB_SIZE               = 8


ALIASES                = "change{1}=\xrefitem change\1 \"Changes (\1)\" \"Changes in Rel \1\"" \
                         "req=\par Requirements" \
                         "global{1}=\param [global \1]" \
                         "misra=\xrefitem misraX \"MISRA Exception\" \"MISRA Exceptions\""


TCL_SUBST              = 


OPTIMIZE_OUTPUT_FOR_C  = YES


OPTIMIZE_OUTPUT_JAVA   = NO


OPTIMIZE_FOR_FORTRAN   = NO


OPTIMIZE_OUTPUT_VHDL   = NO


EXTENSION_MAPPING      = 


MARKDOWN_SUPPORT       = NO


AUTOLINK_SUPPORT       = YES


BUILTIN_STL_SUPPORT    = NO


CPP_CLI_SUPPORT        = NO


SIP_SUPPORT            = NO


IDL_PROPERTY_SUPPORT   = YES


DISTRIBUTE_GROUP_DOC   = YES


SUBGROUPING            = YES


INLINE_GROUPED_CLASSES = NO


INLINE_SIMPLE_STRUCTS  = NO


TYPEDEF_HIDES_STRUCT   = NO


SYMBOL_CACHE_SIZE      = 0


LOOKUP_CACHE_SIZE      = 0



EXTRACT_ALL            = YES


EXTRACT_PRIVATE        = NO


EXTRACT_PACKAGE        = NO


EXTRACT_STATIC         = YES


EXTRACT_LOCAL_CLASSES  = YES


EXTRACT_LOCAL_METHODS  = NO


EXTRACT_ANON_NSPACES   = NO


HIDE_UNDOC_MEMBERS     = NO


HIDE_UNDOC_CLASSES     = NO


HIDE_FRIEND_COMPOUNDS  = NO


HIDE_IN_BODY_DOCS      = NO


INTERNAL_DOCS          = NO


CASE_SENSE_NAMES       = NO


HIDE_SCOPE_NAMES       = NO


SHOW_INCLUDE_FILES     = YES


FORCE_LOCAL_INCLUDES   = NO


INLINE_INFO            = YES


SORT_MEMBER_DOCS       = YES


SORT_BRIEF_DOCS        = NO


SORT_MEMBERS_CTORS_1ST = NO


SORT_GROUP_NAMES       = NO


SORT_BY_SCOPE_NAME     = NO


STRICT_PROTO_MATCHING  = NO


GENERATE_TODOLIST      = YES


GENERATE_TESTLIST      = YES


GENERATE_BUGLIST       = YES


GENERATE_DEPRECATEDLIST= YES


ENABLED_SECTIONS       = 


MAX_INITIALIZER_LINES  = 50


SHOW_USED_FILES        = YES


SHOW_FILES             = YES


SHOW_NAMESPACES        = YES


FILE_VERSION_FILTER    = 


LAYOUT_FILE            = 


CITE_BIB_FILES         = 



QUIET                  = NO


WARNINGS               = YES


WARN_IF_UNDOCUMENTED   = YES


WARN_IF_DOC_ERROR      = YES


WARN_NO_PARAMDOC       = NO


WARN_FORMAT            = "$file:$line: $text"


WARN_LOGFILE           = 



INPUT                  = C:\Projects\Tools


INPUT_ENCODING         = UTF-8


FILE_PATTERNS          = *.c \
                         *.dox


RECURSIVE              = NO


EXCLUDE                = 


EXCLUDE_SYMLINKS       = NO


EXCLUDE_PATTERNS       = 


EXCLUDE_SYMBOLS        = 


EXAMPLE_PATH           = 


EXAMPLE_PATTERNS       = *


EXAMPLE_RECURSIVE      = NO


IMAGE_PATH             = 


INPUT_FILTER           = 


FILTER_PATTERNS        = 


FILTER_SOURCE_FILES    = NO


FILTER_SOURCE_PATTERNS = 


USE_MDFILE_AS_MAINPAGE = 



SOURCE_BROWSER         = NO


INLINE_SOURCES         = NO


STRIP_CODE_COMMENTS    = YES


REFERENCED_BY_RELATION = NO


REFERENCES_RELATION    = NO


REFERENCES_LINK_SOURCE = YES


USE_HTAGS              = NO


VERBATIM_HEADERS       = YES



ALPHABETICAL_INDEX     = YES


COLS_IN_ALPHA_INDEX    = 5


IGNORE_PREFIX          = 



GENERATE_HTML          = YES


HTML_OUTPUT            = html


HTML_FILE_EXTENSION    = .html


HTML_HEADER            = 


HTML_FOOTER            = 


HTML_STYLESHEET        = 


HTML_EXTRA_STYLESHEET  = 


HTML_EXTRA_FILES       = 


HTML_COLORSTYLE_HUE    = 220


HTML_COLORSTYLE_SAT    = 100


HTML_COLORSTYLE_GAMMA  = 80


HTML_TIMESTAMP         = YES


HTML_DYNAMIC_SECTIONS  = NO


HTML_INDEX_NUM_ENTRIES = 100


GENERATE_DOCSET        = NO


DOCSET_FEEDNAME        = "Doxygen generated docs"


DOCSET_BUNDLE_ID       = org.doxygen.Project


DOCSET_PUBLISHER_ID    = org.doxygen.Publisher


DOCSET_PUBLISHER_NAME  = Publisher


GENERATE_HTMLHELP      = NO


CHM_FILE               = 


HHC_LOCATION           = 


GENERATE_CHI           = NO


CHM_INDEX_ENCODING     = 


BINARY_TOC             = NO


TOC_EXPAND             = NO


GENERATE_QHP           = NO


QCH_FILE               = 


QHP_NAMESPACE          = org.doxygen.Project


QHP_VIRTUAL_FOLDER     = doc


QHP_CUST_FILTER_NAME   = 


QHP_CUST_FILTER_ATTRS  = 


QHP_SECT_FILTER_ATTRS  = 


QHG_LOCATION           = 


GENERATE_ECLIPSEHELP   = NO


ECLIPSE_DOC_ID         = org.doxygen.Project


DISABLE_INDEX          = NO


GENERATE_TREEVIEW      = NO


ENUM_VALUES_PER_LINE   = 4


TREEVIEW_WIDTH         = 250


EXT_LINKS_IN_WINDOW    = NO


FORMULA_FONTSIZE       = 10


FORMULA_TRANSPARENT    = YES


USE_MATHJAX            = NO


MATHJAX_FORMAT         = HTML-CSS


MATHJAX_RELPATH        = http://www.mathjax.org/mathjax



MATHJAX_EXTENSIONS     = 


SEARCHENGINE           = NO


SERVER_BASED_SEARCH    = NO


EXTERNAL_SEARCH        = NO


SEARCHENGINE_URL       = 


SEARCHDATA_FILE        = searchdata.xml


EXTERNAL_SEARCH_ID     = 


EXTRA_SEARCH_MAPPINGS  = 



GENERATE_LATEX         = NO


LATEX_OUTPUT           = latex


LATEX_CMD_NAME         = latex


MAKEINDEX_CMD_NAME     = makeindex


COMPACT_LATEX          = NO


PAPER_TYPE             = a4


EXTRA_PACKAGES         = 


LATEX_HEADER           = 


LATEX_FOOTER           = 


PDF_HYPERLINKS         = YES


USE_PDFLATEX           = YES


LATEX_BATCHMODE        = NO


LATEX_HIDE_INDICES     = NO


LATEX_SOURCE_CODE      = NO


LATEX_BIB_STYLE        = plain



GENERATE_RTF           = NO


RTF_OUTPUT             = rtf


COMPACT_RTF            = NO


RTF_HYPERLINKS         = NO


RTF_STYLESHEET_FILE    = 


RTF_EXTENSIONS_FILE    = 



GENERATE_MAN           = NO


MAN_OUTPUT             = man


MAN_EXTENSION          = .3


MAN_LINKS              = NO



GENERATE_XML           = NO


XML_OUTPUT             = xml


XML_SCHEMA             = 


XML_DTD                = 


XML_PROGRAMLISTING     = NO



GENERATE_AUTOGEN_DEF   = NO



GENERATE_PERLMOD       = YES


PERLMOD_LATEX          = YES


PERLMOD_PRETTY         = YES


PERLMOD_MAKEVAR_PREFIX = 



ENABLE_PREPROCESSING   = YES


MACRO_EXPANSION        = YES


EXPAND_ONLY_PREDEF     = YES


SEARCH_INCLUDES        = YES


INCLUDE_PATH           = 


INCLUDE_FILE_PATTERNS  = 


PREDEFINED             = "USAGE(x)=/** x */"


EXPAND_AS_DEFINED      = 


SKIP_FUNCTION_MACROS   = YES



TAGFILES               = 


GENERATE_TAGFILE       = 


ALLEXTERNALS           = NO


EXTERNAL_GROUPS        = YES


PERL_PATH              = /usr/bin/perl



CLASS_DIAGRAMS         = NO


MSCGEN_PATH            = 


HIDE_UNDOC_RELATIONS   = YES


HAVE_DOT               = NO


DOT_NUM_THREADS        = 0


DOT_FONTNAME           = Helvetica


DOT_FONTSIZE           = 10


DOT_FONTPATH           = 


CLASS_GRAPH            = YES


COLLABORATION_GRAPH    = YES


GROUP_GRAPHS           = YES


UML_LOOK               = NO


UML_LIMIT_NUM_FIELDS   = 10


TEMPLATE_RELATIONS     = NO


INCLUDE_GRAPH          = YES


INCLUDED_BY_GRAPH      = YES


CALL_GRAPH             = NO


CALLER_GRAPH           = NO


GRAPHICAL_HIERARCHY    = YES


DIRECTORY_GRAPH        = YES


DOT_IMAGE_FORMAT       = png


INTERACTIVE_SVG        = NO


DOT_PATH               = 


DOTFILE_DIRS           = 


MSCFILE_DIRS           = 


DOT_GRAPH_MAX_NODES    = 50


MAX_DOT_GRAPH_DEPTH    = 0


DOT_TRANSPARENT        = NO


DOT_MULTI_TARGETS      = NO


GENERATE_LEGEND        = YES


DOT_CLEANUP            = YES
Attachment (c_test.c): text/x-csrc, 2346 bytes
Attachment (Undertest.h): text/x-chdr, 6107 bytes
------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
_______________________________________________
Doxygen-users mailing list
Doxygen-users <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
Arbol One | 14 May 2013 03:09
Picon
Favicon

icon not displayed

I am trying to display the attached file in the main page generated by Doxygen, Following  the instructions the image's height is less than 55 px and the its width is less than 200 px. However, the image does not show only a small box in the main page, saying 'icon'.
What am I doing wrong?


# With the PROJECT_LOGO tag one can specify an logo or icon that is
# included in the documentation. The maximum height of the logo should not
# exceed 55 pixels and the maximum width should not exceed 200 pixels.
# Doxygen will copy the logo to the output directory.
 
PROJECT_LOGO           = icons\logo.png
------------------------------------------------------------------------------
AlienVault Unified Security Management (USM) platform delivers complete
security visibility with the essential security capabilities. Easily and
efficiently configure, manage, and operate all of your security controls
from a single console and one unified framework. Download a free trial.
http://p.sf.net/sfu/alienvault_d2d
_______________________________________________
Doxygen-users mailing list
Doxygen-users <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Gmane