| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
|
|
|
|
|
|
|
| |
- Similar problems can occur with the `\startuml` and `msc` command.
```
/**
* @startuml
* {\f} @code
* @enduml
*/
```
- some further needed corrections (for lexcode)
- `\endvhdlflow` does not exist
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When we have in one file a `\page` followed by a `\mainpage` than this page is not shown / completely ignore, an example:
```
@page pg_tst_1 Test 1
the 1 page
@mainpage Test MainPage
the mainpage
```
this problem is due to the fact that `handleMainPage` is called when a `\mainpage` command is found, and this is also the case at the end of the content of `\page` resulting in the fact that the name of this page is removed (and thus actually the complete page).
|
|\ |
|
| |\
| | |
| | | |
Usage of default lex rule with `\param`
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
In case we have a file like
```
/// \file
/// the fie
/// \param
/// arg the argument
void fie(int arg);
```
we get in the console output extra empty lines, this is due to the fact that the default lex rule kicks in an the output is echoed to the consol.
We have defined an explicit rule.
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
This commit changes the following in relation to string use
- The implicit convert from 'QCString' to 'const char *' is removed
- Strings parameters use 'const QCString &' as much as possible in favor
over 'const char *'
- 'if (s)' where s is a QCString has been replaced by 'if(!s.isEmpty())'
- data() now always returns a valid C-string and not a 0-pointer.
- when passing a string 's' to printf and related functions 'qPrint(s)' is
used instead of 's.data()'
- for empty string arguments 'QCString()' is used instead of '0'
- The copy() operation has been removed
- Where possible 'qstrcmp(a,b)==0' has been replaces by 'a==b' and
'qstrcmp(a,b)<0' has been replaced by 'a<b'
- Parameters of string type that were default initialized with '= 0' are
no initialized with '= QCString()'
|
|/ /
| |
| |
| |
| | |
Especially with commands like `\f$\mbox{\LaTeX}\f$`MathJax has some problem as it is not, yet, able to use the commands `\raise` and `lower` inside the `\mbox` as used in this LaTeX command.
Also switching in and out of math-mode doesn't work as the resulting code either doesn't work in MathJax or in LaTeX, hence the new command s `\f(` and `\f)`.
|
| | |
|
| | |
|
|/ |
|
| |
|
|\ |
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
When having:
```
/// \file
/// The namespace docu
namespace Demo
{
/// <summary>
/// The base class
/// </summary>
public class Base
{
/// <summary>
/// The foo function
/// </summary>
/// <remarks>
/// <param name="value">The foo parameter</param>
/// <returns>foo Something</returns>
/// </remarks>
public virtual int foo(int value);
}
}
```
and we run this with `doxygen -d commentscan` we see that the `</summary>` is in the detailed part and not in the brief part:
```
CommentScanner: D:/speeltuin/issue_7356/bug_csharp_summary/Class1.cs:6
input=[
<summary>
The base class
</summary>
]
-----------
CommentScanner: D:/speeltuin/issue_7356/bug_csharp_summary/Class1.cs:6
output=[
brief=[line=6
<summary>
The base class
]
docs=[line=6
</summary> ]
inbody=[line=-1
]
]
```
this happened between the versions 1.8.14(OK) and 1.8.15(wrong), most likely through an improvement in case there are multiple brief section.
In case `</summary>` we should be already in the brief section so no need to switch again as the second switch would have no effect and we would land in the details.
|
|/
|
|
|
| |
- Correct handling of C comment start and end tokens as well as Cpp comment start in rules. These tokes can give "Reached end of file while still inside a (nested) comment..."
- Correct other warnings in respect to lex files
|
| |
|
|
|
|
| |
(restores 1.8.16 behavior)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When having an example like:
```
/*! \file
<table>
<tr><th> Command</th> <th> Function</th></tr>
<!-- this is a multiline comment
end of comment -->
<tr><td> ? \xx6 </td><td> Dummy</td></tr>
</table>
*/
```
we get the warning:
```
.../aa.c:5: warning: Found unknown command '\xx6'
```
instead of
```
.../aa.c:6: warning: Found unknown command '\xx6'
```
|
|
|
|
|
|
| |
- topLine is replaced by startLine
- changed unputDocnl macro into a more self contained function-like
macro
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
All examples together are a bit big so they are all in the attached file together with the warnings before and after this patch.
When looking at the output we see that a number of lines are off by 1 ore more due to the insertion of extra lines in the code or due to the fact that there is a reference to the start of the documentation of the page and not the line of the page command.
- commentscan.l
in case of a rule contaiinge {DOCNL} this can be `=n` or `\ilinebr` in the later case this should not be replaced by `\n` as this results in an increase of the line count later on.
in case of a page like command also register the line of the command as "topline".
- entry.h, entry.cpp
storage space for the "topline" registering the line of the page like commands.
- doxygen.cpp
setting and using the "topline"
- markdown.cpp, markdown.h
don't add a `\n` as this increases the line count but use the `\ilinebr`
to get correct warnings see to it that when having empty lines at the top of the page and a page is added that the empty lines appear after the page command.
- index.cpp
using the "topline" instead of the "docLine" to get the correct warning
- pagedef.cpp, pagedef.h
set and retrieve the "topline" for page like commands.
- util.cpp, util.h
setting and using the "topline"
in `addRelatedPage` use the known file name and line for the warning regarding the section label
- cite.cpp, context.cpp, reflist.cpp
changed to have good function calls.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When having an example like:
```
## General \PYgen0 docu
#
#
#
#
# General detail \PYgen1 text
# and more
STYLE_TEMPLATE = r'''
\makeatletter
'''
## General \PYgen2 docu
#
#
#
#
#
# General detail \PYgen3 text
# and more
STYLE_TEMPLATE1 = r'''
\makeatletter
'''
```
with
```
EXTRACT_ALL = YES
QUIET = YES
```
we get the warnings (removed doubles and sorted):
```
bb.py:1: warning: Found unknown command '\PYgen0'
bb.py:10: warning: Found unknown command '\PYgen1'
bb.py:12: warning: Found unknown command '\PYgen2'
bb.py:23: warning: Found unknown command '\PYgen3'
```
we see here (especially with `PYgen3` a wrong line number.
After fixing the line count in `pyscanner.l` there was for the second block an offset of 1. This was caused by `commentscan.l` introduced with #7960 after correcting this this offset was also gone.
Revisiting the original example of #7960 showed that here here was also an offset of 1 (probably due to a misinterpretation of where the `<tr>` warning should be mentioned), here it is now also correct..
(The original mismatch was shown of Fossies for the Pygments package)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When having the alias:
```
ALIASES += sbl_add_package_main_class{4}="\addtogroup \1-ref-manual ^^ @{ ^^ \class \2 ^^ \brief \3 \4 ^^ @}"
```
for the comment block:
```
/**
\sbl_add_package_main_class{Molecular_potential_energy, T_Phi_psi_dihedral_angles_visitor,
Defines iterator over all successive pairs of dihedrals.,
\details Defines iterator over all successive pairs of dihedrals.
\tparam CovalentStructure The type of the input covalent structure
}
*/
```
we get the warning:
```
warning: the name '\ilinebr' supplied as the argument of the \class, \struct, \union, or \include command is not an input file
```
The problem was that the rule:
```
<ClassDocArg2>{FILE}|"<>" { // second argument; include file
```
took the `\ilinebr`, the rule:
```
<ClassDocArg2>{DOCNL} {
```
should habe been checked before.
(reported as: https://stackoverflow.com/questions/63710433/doxygen-alias-with-arguments-the-classical-linebr-problem)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When having a file like (but extended example based on a problem found in CGAL where line numbers were a bit off):
```
/*! The <hr2> class `Face_filtered_graph` is an adaptor that creates a filtered view of a graph */
struct Face_filtered_graph_no_det
{
/*!
* \brief constructs an empty face filtered graph (no face is selected)
*
*
*
*
*
*
*
*
* <table class="params">
* something
* something
* </table>
*
*
*
*
*
*
*
*
* <table class="params">
* something
* something
* </table>
*/
Face_filtered_graph_no_det();
}
```
we get:
```
.../no_det.h:1: warning: Unsupported xml/html tag <hr2> found
.../no_det.h:5: warning: expected <tr> tag but found TK_LNKWORD token instead!
.../no_det.h:17: warning: expected <tr> tag but found TK_LNKWORD token instead!
```
instead of:
```
.../no_det.h:1: warning: Unsupported xml/html tag <hr2> found
.../no_det.h:14: warning: expected <tr> tag but found TK_LNKWORD token instead!
.../no_det.h:26: warning: expected <tr> tag but found TK_LNKWORD token instead!
```
Line counting is in an interpreter, especially when merging blocks etc.) a difficult situation.
- `util.cpp`: `\ilinebr` is an internal newline, but the line count should not be increased
- `commentscan.l`
- put empty lines in output as well otherwise they are missing in the line count
- don't insert `\n` to separate blocks, but use the artificial `\ilinebr`
- properly initialize the `docLine` (important for examples were at the beginning of the block there are a number of newlines
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Introduces new option NUM_PROC_THREADS.
It specifies the number threads doxygen is allowed to use during
processing. When set to 0 doxygen will based this on the number of cores
available in the system. You can set it explicitly to a value larger than 0
to get more control over the balance between CPU load and processing speed.
At this moment only the input processing can be done using multiple threads.
I plan to extend this with more parallel processing in the future.
Since this is still an experimental feature the default is set to 1,
which efficively disables parallel processing. Please report any issues you
encounter that appear when changing the default.
Note that generating dot graphs in parallel is still controlled separately
by the DOT_NUM_THREADS setting.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When having a `@struct` command without argument one gets the misleading warning:
```
warning: missing argument after \class.
```
instead of:
```
warning: missing argument after '\struct'.
```
This happens with a number of commands, for these commands the `currentCmd` has been introduced.
(Found in cmake through Fossies).
|
| |
|
|
|
|
|
|
| |
- White space around \\ilinebr is not preserved in commentscan
- Cases where \n was unput in doctokenizer are now handled in the same
way for \\ilinebr
|
|
|
|
|
|
|
| |
- Routines to strip leading and trailing whitespace now also take
\\ilinebr into account
- Added a number of cases in doctokenizer.l where \\ilinebr wasn't
handled yet.
|
| |
|
|
|
|
|
|
|
|
|
|
| |
- Changed \_linebr to \ilinebr
- \ilinebr is now also passed to doctokenizer
- Also fixes issue #7493 regarding \snippet inside markdown tables and
dealing with wrong line on issues detected by docparser after a
markdown table.
- Added function tracing to markdown (enabled with -d markdown in a
debug build)
|
|
|
|
| |
paragraph separator
|
|
|
|
| |
brief description
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
| |
Also added option HTML_FORMULA_FORMAT to generate SVG files for images (requires pdf2svg)
|
|
|
|
| |
use explicit constructor' issue on some versions of gcc.
|
| |
|
| |
|
| |
|
|\ |
|
| | |
|
|\ \
| | |
| | | |
Remove unused rules
|
| |/
| |
| |
| | |
Remove some unused rules.
|
|/
|
|
|
|
| |
`\xmlinclude`
Adding for consistency with `\*only`, `\htmlincclude` and `\latexinclude` the commands: `\rtfinclude`, `\docbookinclude`, `\maninclude` and `\xmlinclude`
|
| |
|
| |
|