| Commit message (Collapse) | Author | Age | Files | Lines |
|\
| |
| |
| |
| | |
cfriedt/feature/cfriedt/6955/allow-javadoc-style-comment-blocks-with-a-doxyfile-variable
Allow Javadoc-style comment blocks with a Doxyfile variable
|
| | |
|
| | |
|
| | |
|
| | |
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Javadoc allows comments like this (which I refer to as "banner" comments)
/*****************
*
*****************/
but doxygen does not recognize them.
Instead, the doxygen manual says to do this
/*************//**
*
****************/
which some users aren't even aware is required. It also behaves poorly with clang-format.
I'm proposing to add a Doxyfile boolean option JAVADOC_BANNER which will default to NO. When set to YES, it will consider the first and second comments above to be equivalent.
However, I don't believe that the JAVADOC_BANNER option should default to YES, as there are likely a number of projects who have used the former syntax with full expectation that it would *not* appear in their documentation.
At least having the JAVADOC_BANNER default to NO allows users to opt-in voluntarily by adding JAVADOC_BANNER = YES to their Doxyfile. If the consensus is to make it a default at a later time, first a warning can be added during build that should trigger users to modify their comment style, and then eventually the default could be set to JAVADOC_BANNER = YES, or the config option could be removed entirely and it would just always be enabled.
|
|\ \
| | |
| | | |
Missing debug statements sqlcode and xmlcode lexers
|
| | |
| | |
| | |
| | | |
The messages for `doxygen -d lex` were missing in case of the sqlcode.l and xmlcode.l
|
| | | |
|
|\ \ \
| |/ / |
|
| |\ \
| | | |
| | | | |
Class definition with collections
|
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | | |
Class definitions can have collections and these can have strings e.g.:
class Url(namedtuple('Url', url_attrs)):
and this results in:
warning: Detected potential recursive class relation between class conda::_vendor::urllib3::util::url::Url and base class Url!
Strings are now possible and seen as strings.
See also (including example with namedtuble): https://docs.python.org/3/library/collections.html
|
| |\ \ \
| | | | |
| | | | | |
Incorrect Reached end of file while still inside a (nested) comment for TCL / Python
|
| | | |/
| | |/|
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | | |
/ Python
In case we have in the comment (or in the code) of a TCL file of Python file a construct like:
```
proc get_suite {dir {sort 1}} {
set files [glob -nocomplain $dir/*.bin]
set files [glob -nocomplain $dir/*.ps]
}
```
we get the warning:
```
warning: Reached end of file while still inside a (nested) comment. Nesting level 2 (probable line reference: 3, 2)
```
although the '/*' construct has no special comment meaning in TCL / Python (comment signs '#' / '#' or '"""). So if a c-comment construct is found it is ignored for TCL and Python.
|
|\ \ \ \
| |/ / / |
|
| |\ \ \
| | | | |
| | | | | |
Incorrect output tag order
|
| | |/ /
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | | |
When we have the Mardown file:
```
# First heading level 1
Some text ...
```
we get in the HTML file:
```
...
<div class="PageDoc"><div class="header">
<div class="headertitle">
<div class="title">First heading level 1 </div> </div>
</div><!--header-->javascript">
<div class="contents">
<div class="textblock"><p>Some text ... </p>
</div></div><!-- PageDoc -->
</div><!-- contents -->
...
```
Here we see that the `PageDoc` is closed before the `Contents` although the `PageDoc` was opened before the `Contents`.
In this constellation it doesn't give problems as both translate to `</div>` tag and in other output formats nothing is outputted, but in case in another format something is outputted this might lead to problems also the comment is now so that is indicates the error.
|
|\ \ \ \
| |/ / / |
|
| |\ \ \
| | | | |
| | | | | |
Revert "alternate fix for .dot file handling"
|
| |/ / / |
|
| |\ \ \
| | | | |
| | | | | |
issue #6945 \class after \brief doesn't count as a new line - resulting docs show merged descriptions
|
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | | |
show merged descriptions
Set "ends brief description" for the different for the commands mentioned in issue (as well as addtogroup)
|
|\ \ \ \ \
| |/ / / / |
|
| |\ \ \ \
| | | | | |
| | | | | | |
Fixes #6765 - Fixed C++17-namespace assignment bug
|
| | |/ / /
| | | | |
| | | | |
| | | | | |
Added scope save and restore before and after namespace parsing
|
|/ / / / |
|
|\ \ \ \
| | | | |
| | | | | |
Special handling of the UTF8 nbsp sequence
|
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | | |
The UTF8 nbsp sequence 0xc2 0xa0 is not seen as a whitespace sequence and not handled properly.
This can lead to:
```
warning: found </c> tag without matching <c>
```
when we have e.g. ```e.g. `linux`<br>``` where the space between the `.` and the backtick is actually the UTF8 nbsp sequence
Replacing the the UTF8 nbsp sequence with the ` ` sequence.
|
|\ \ \ \ \
| | | | | |
| | | | | | |
issue #6990 Dot produces no Graphs
|
| | | | | |
| | | | | |
| | | | | |
| | | | | | |
Backslashes also have to be escaped otherwise a tooltip / brief description like `//!replace "\" with "\\"` won't be produced properly.
|
|\ \ \ \ \ \
| | | | | | |
| | | | | | | |
alternate fix for .dot file handling
|
| | | | | | |
| | | | | | |
| | | | | | |
| | | | | | | |
new processing job
|
| | | | | | |
| | | | | | |
| | | | | | |
| | | | | | | |
output files
|
| | | | | | | |
|
|\ \ \ \ \ \ \ |
|
| |\ \ \ \ \ \ \
| | | | | | | | |
| | | | | | | | | |
USE_HTAGS = YES, there are _no_ call / caller graphs in the documentation
|
| | | |/ / / / /
| | |/| | | | |
| | | | | | | |
| | | | | | | |
| | | | | | | |
| | | | | | | | |
Even when htags are enabled the source code has to be parsed, but should not be written by doxygen writers. During the "generateFileSources" some other settings are done as well like for "REFERENCED_BY_RELATION".
(based on question of Maciej W via lists.sourceforge.net on March 24 2014)
|
| |\ \ \ \ \ \ \
| | |/ / / / / /
| |/| | | | | | |
Don't try to load htags filemap in case htags fails
|
| |/ / / / / /
| | | | | | |
| | | | | | |
| | | | | | | |
Don't try to load htags filemap in case htags fails as when a wrong / old filemap is lying around this leads / can lead to incorrect results
|
| |\ \ \ \ \ \
| | | | | | | |
| | | | | | | | |
Enable example doxmlparser possibilities for cmake build
|
| | | | | | | |
| | | | | | | |
| | | | | | | |
| | | | | | | |
| | | | | | | | |
The doxmlparser example program could be build by the build system before the use of cmake. In cmake it was available but "disabled" by means of an empty CMakeLists.txt in the doxmlparser main directory.
(Windows is not fond of symbolic links, so removing link between src/doxmlintf.h and include/doxmlintf.h)
|
|/ / / / / / /
| | | | | | |
| | | | | | |
| | | | | | | |
specialization
|
|\ \ \ \ \ \ \
| |_|/ / / / /
|/| | | | | | |
|
| | | | | | | |
|
| |\ \ \ \ \ \
|/ / / / / / /
| | | | | | |
| | | | | | | |
https://github.com/albert-github/doxygen into albert-github-feature/svg_image_determnation
|
| | |_|_|_|/
| |/| | | |
| | | | | |
| | | | | |
| | | | | |
| | | | | |
| | | | | |
| | | | | |
| | | | | | |
In case a svg image url has some decoration behind it, the image is not seen as a svg image. The decoration is taken away from the determination.
Found by means of:
```
[](https://travis-ci.com/ILIAS-eLearning/ILIAS)
[](https://php.net/)
```
|
|\ \ \ \ \ \
| | | | | | |
| | | | | | | |
issue #6869 SVG image generated by \dot or \dotfile does not render properly in HTML
|
| | | | | | |
| | | | | | |
| | | | | | |
| | | | | | |
| | | | | | |
| | | | | | | |
in HTML
The path to the svgpan.js should be relative to the svg file. For files generated with `dot` or `\dotfile` this is the root of the HTML tree, so relpath is here an empty reference (the svg file still needs the relpath as this file is referenced from a html file that is possibly in a sub directory).
|
|\ \ \ \ \ \ \
| |_|_|/ / / /
|/| | | | | | |
Markdown file as internet link
|
| | | | | | |
| | | | | | |
| | | | | | |
| | | | | | | |
Removed debug statements.
|