| Commit message (Collapse) | Author | Age | Files | Lines |
|\
| |
| | |
issue #8585 INLINE_SOURCES = YES do not generate code inline from sources if there is no @return after @brief.
|
| |
| |
| |
| |
| |
| |
| | |
there is no @return after @brief.
- Extended tests for the determination whether or not detailed section is available
- Corrected links in the brief section part depending on the presence / not present detailed documentation
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
LaTeX/ RTF
When we have a program like:
```
/** \file */
/** outer */
struct Outer
{
/** foo */
union Foo
{
/** Bar */
struct FooFlags
{
bool cond1; /*!< \brief bar 1
* \details details1 bar 1
*/
bool cond2; /*!< bar 2 */
} flags; /*!< \brief foo bar
* \details details2 of foo bar
*/
} myMember; /*!< public member */
private:
void myWork(); /*!< private member function */
};
```
and a Doxyfile like
```
INLINE_SIMPLE_STRUCTS = YES
QUIET=YES
GENERATE_RTF=YES
```
We see in HTML that brief and detailed description start on a separate line, but for LaTeX and RTF (it is not implemented in docbook) the detailed description directly follows the brief description without a line separator.
|
|/
|
|
| |
INLINE_SIMPLE_STRUCTS=YES
|
| |
|
|\
| |
| | |
Incorrect type for enum struct
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
In case we have the simple file:
```
/// \file
/// docu with nothing
enum MyEnum_not { v1_0, v2_0 };
/// docu with class
enum class MyEnum_cls { v1_2, v2_2 };
/// docu with struct
enum struct MyEnum_str { v1_3, v2_3 };
```
with settings:
```
QUIET=YES
ALWAYS_DETAILED_SEC=YES
```
the `enum struct` is shown as `enum class` in the brief description and in the detailed description just as `enum` (the later also is the case for the `enum class).
|
| |
| |
| |
| |
| | |
- methods were marked const but still returned a non-const reference,
cause wrongly optimized code for some platforms/compilers
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
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()'
|
| | |
|
| | |
|
| |
| |
| |
| |
| | |
- direct use of std::stringstream and std::ostream gave a 30%
drop in performance.
|
| | |
|
| |
| |
| |
| |
| | |
- Dir is based on ghc::filesystem, a std::filesystem compatible
implementation that does not require C++17.
|
| | |
|
|\ \ |
|
| | | |
|
| | | |
|
| | | |
|
| | | |
|
| | | |
|
| | | |
|
|/ /
| |
| |
| |
| |
| | |
Adding support for lex. The lex files consist of a mixture of lex specific structures, that are handled in the the lexcode.l and lexscanner.l, abd C code that is handled by the C parsers (hence the rules used are partly copied from scanner.l).
Special attention has been paid to memberdef.cpp as the initial values should not be handled by the lex parsers but by the C parsers.
|
|/ |
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
|
|
| |
Currently typedef'd function pointers, typically used as callbacks,
don't have their `@param` documentation properly validated. This commit
adds a proper check by initializing their memberdef with the parsed
args. To avoid duplicating the params in the output, since typedef's
already have the params in their definition, an extra check was added.
Signed-off-by: Fabio Utzig <fabio.utzig@nordicsemi.no>
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
| |
Split Definition/ClassDef/NamespaceDef/MemberDef into a immutable and mutable part
Aliases are immutable, other symbols are stored using an immutable
interface but can be made mutable explicitly by dynamic casting.
|
| |
|
|
|
|
| |
undocumented entities
|
|
|
|
|
|
| |
Fixes error:
"\begin{DoxyCodeInclude} on input line 93 ended by \end{DoxyCode}"
while generating the LaTeX version of the manual
|
| |
|
| |
|
|
|
|
| |
default
|
|\
| |
| |
| | |
into tolnaisz-arg_name_as_comment
|
| |
| |
| |
| | |
EXTRACT_ANON_ARGUMENTS.
|
| |
| |
| |
| | |
corrected typo
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
When having:
```
/*!
* \brief Performs some side effect
*/
auto side_effect_after() -> void {}
```
We get the warning:
```
warning: return type of member side_effect_after is not documented
```
as the trailing return type was not taken into consideration.
|
| |
| |
| |
| |
| | |
- reverted some of the change that introduced the problem
- fixed the original problem (#7216) in a different way
|
|/ |
|
| |
|
|
|
|
| |
Also fixed bug preventing direction to be stripped from the parameter documentation.
|
|
|
|
| |
A parameter can only be present for a function, so we should test on the member being a function it as well.
This fix is for the problem as reported by @tgpfeiffer
|
| |
|