summaryrefslogtreecommitdiffstats
path: root/src/docparser.cpp
Commit message (Collapse)AuthorAgeFilesLines
* Merge branch 'feature/bug_html_s' of ↵Dimitri van Heesch2019-12-261-1/+17
|\ | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_html_s
| * Adding HTML s tag, XML corrections for other tagsalbert-github2019-08-161-1/+17
| | | | | | | | | | | | Adding the HTML `<s>` tag (https://www.w3schools.com/tags/tag_s.asp). Adding 's' and correcting 'inc' to 'ins' in compound.xsd
* | Minor tweaksDimitri van Heesch2019-12-251-3/+4
| |
* | Merge branch 'feature/bug_style_change' of ↵Dimitri van Heesch2019-12-251-64/+70
|\ \ | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_style_change
| * \ Merge branch 'master' into feature/bug_style_changeDimitri van Heesch2019-12-251-90/+99
| |\ \
| * | | Warning with XML / HTML style commandsalbert-github2019-10-201-64/+70
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When having a problem like: ``` /// set <var> var start_interp </em> void fie(void); /// set <i> i start_interp void fie1(void); ``` we get the warnings (doubles omitted): ``` .../bb.h:5: warning: end of comment block while expecting command </em> ``` so - discrepancy between `<var>` and closing `</em>` is not reported, but wrong for as opening and closing tag should have the same tag name. - the missing `</i>` is reported as a missing `</em>` The problems here are due to the fact that `<var>`, `<i>` and `<em>` share all the style `HTML_EMPHASIS`, this problem has been fixed by adding the used tag name to the style information and testing o n the name and not the style type. The result is now: ``` .../bb.h:1: warning: found </em> tag while expecting </var> .../bb.h:2: warning: end of comment block while expecting command </var> .../bb.h:5: warning: end of comment block while expecting command </i> ``` so now the real problems are reported.
* | | | Fixed compiler warnings in docparser.cppDimitri van Heesch2019-12-231-4/+4
| |/ / |/| |
* | | Merge branch 'master' into spellingDimitri van Heesch2019-12-231-39/+37
|\ \ \
| * \ \ Merge pull request #7211 from albert-github/feature/issue_7210Dimitri van Heesch2019-12-231-32/+30
| |\ \ \ | | | | | | | | | | issue #7210: 1.8.16: Image inclusion is inconsistent
| | * | | issue #7210: 1.8.16: Image inclusion is inconsistentalbert-github2019-08-201-32/+30
| | | |/ | | |/| | | | | | | | | | | | | The consequence of #7084 (Missing warning about ambiguous files) was that in case a file was ambiguous only a message was given. Now a warning is given plus one of the ambiguous files is used (might be the wrong one).
| * | | Merge branch 'feature/bug_unsupported_html' of ↵Dimitri van Heesch2019-12-181-1/+1
| |\ \ \ | | | | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_unsupported_html
| | * | | Output of unknown xml/html tagalbert-github2019-11-061-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When having a problem like: ``` /** \file - Just name <name> - name plus subname <name subname> - name plus twice subname <name subname subname> - name plus subname subname="" <name subname subname=""> */ ``` we get correctly the warnings: ``` .../aa.h:3: warning: Unsupported xml/html tag <name> found .../aa.h:4: warning: Unsupported xml/html tag <name> found .../aa.h:5: warning: Unsupported xml/html tag <name> found .../aa.h:6: warning: Unsupported xml/html tag <name> found ``` but the output doesn't look good as there is `=""` added: ``` Just name <name> name plus subname <name subname=""> name plus twice subname <name subname="" subname=""> name plus subname subname="" <name subname="" subname=""> ``` This patch fixes this output.
| * | | | Fix logic bug in SVG detectionDimitri van Heesch2019-12-141-1/+1
| | | | |
| * | | | Renamed Portables to PortableDimitri van Heesch2019-12-081-5/+5
| | | | |
| * | | | Refactoring of portable.h and portable.cpp functions to be contained in a ↵Tobias Off2019-11-281-5/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | namespace Fixing some memory issues caused by not correctly freed pointers
* | | | | spelling: embeddingJosh Soref2019-11-121-2/+2
|/ / / /
* | | | Merge branch 'feature/bug_warn_illegal_command' of ↵Dimitri van Heesch2019-11-101-6/+12
|\ \ \ \ | | | | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_warn_illegal_command
| * | | | Better warning message in case of illegal commandalbert-github2019-11-061-4/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Correcting compilation errors and warnings like: ``` error: invalid conversion from ‘const char*’ to ‘char*’ [-fpermissive] char *cmd_start = (tok==TK_COMMAND_AT ? "@" : "\\"); warning: ISO C++ forbids converting a string constant to ‘char*’ [-Wwrite-strings] char *cmd_start = "\\"; ```
| * | | | Better warning message in case of illegal commandalbert-github2019-11-061-6/+12
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When having a problem like: ``` /** \file * * \link Something \see nothing2 \endlink * * \link Something @see nothing3 \endlink */ ``` We will get a.o. the warnings: ``` .../aa.h:3: warning: Illegal command see as part of a \link .../aa.h:5: warning: Illegal command see as part of a \link ``` it is not clear what the problem is. With this patch we get a little bit clearer warning: ``` .../aa.h:3: warning: Illegal command \see as part of a \link .../aa.h:5: warning: Illegal command @see as part of a \link ```
* | | | Spelling corrections for src directoryalbert-github2019-11-051-1/+1
|/ / / | | | | | | | | | | | | | | | | | | | | | Spelling corrections as found by codespell and in #561. Some reported problems were already fixed, others are fixed here, with some exceptions (a,o.): - "referenceby" in defgen.cpp as this is in the output and I cannot oversee the consequences (looks like none, but ...) - "HANGEUL_CHARSET" left as is as in some MS documentation is written: 'HANGUL_CHARSET: Also spelled "Hangeul". Specifies the Hangul Korean character set.' (https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-wmf/0d0b32ac-a836-4bd2-a112-b6000a1b4fc9).
* | | Merge pull request #7323 from albert-github/feature/bug_empty_html_tagDimitri van Heesch2019-11-021-18/+26
|\ \ \ | | | | | | | | Skip empty HTML tag
| * | | Skip empty HTML tagalbert-github2019-10-151-18/+26
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Due to the fact that an empty HTML tag (like `<strike/>` is seen as a start tag the rest of a documentation block is handled with the strikethrough. Same problem occurs for other tags as well, in most cases empty HTML tags should be left out of the output (and just give the warning about the empty tag). Mentioned example: ``` /** Before a strike: <strike/> after strike */ void fie_b_strike(void); ```
* | | | Merge branch 'master' into feature/bug_param_missing_warnDimitri van Heesch2019-11-011-24/+20
|\ \ \ \
| * \ \ \ Merge branch 'std'Dimitri van Heesch2019-10-271-19/+14
| |\ \ \ \ | | |_|_|/ | |/| | |
| | * | | Changed ArgumentList to be an STL containerDimitri van Heesch2019-10-271-19/+14
| | |/ /
| * | | Support for <a id="label">albert-github2019-10-161-1/+1
| |/ / | | | | | | | | | Support besides `<a name="label">` also `<a id="label">` as `id=` is the HTML attribute to define an ad for an HTML element.
| * | Warning when using empty HTML tagalbert-github2019-10-141-3/+4
| | | | | | | | | | | | | | | | | | - the HR tag has in xhtml the form <HR/>. Supporting empty tag - better warning (with tag name, for empty tag. - `</hr>` does not exist, correcting warning (analogous to `</br>`)
| * | Warning when using empty p HTML tagalbert-github2019-10-121-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When we use the construct: ``` <p/> ``` we get the warning: ``` warning: HTML tags may not use the 'empty tag' XHTML syntax. ``` tough the construct is handled properly, so we can omit the warning.
* | | Nicer warning for missing parameteralbert-github2019-09-301-5/+7
|/ / | | | | | | In case of just 1 missing parameter use the singular form (checking was already done, now we just count).
* | Reduce the use of QString in favor of the more efficient QCStringDimitri van Heesch2019-09-211-5/+9
| |
* | issue #7216: non-const getGroupDef() called on aliased member (cleanup + ↵Dimitri van Heesch2019-08-261-3/+2
|/ | | | null pointer fix)
* spelling error: suported -> supportedJoenio Costa2019-08-081-1/+1
|
* Merge pull request #7042 from albert-github/feature/bug_632754Dimitri van Heesch2019-08-071-1/+2
|\ | | | | Bug 632754 - The \copydoc Command Requires The Use of C++ Syntax in C# Code
| * Bug 632754 - The \copydoc Command Requires The Use of C++ Syntax in C# Codealbert-github2019-06-071-1/+2
| | | | | | | | Replace the scope separators to the default scope separators (::) of doxygen.
* | Merge pull request #7084 from albert-github/feature/bug_img_ambigDimitri van Heesch2019-08-071-14/+17
|\ \ | | | | | | Missing warning about ambiguous files
| * | Missing warning about ambiguous filesalbert-github2019-06-271-14/+17
| |/ | | | | | | | | - Handling of ambiguous files (in case of an ambiguous file `fd` does return a value) - using correct dictionary for warning
* | Merge branch 'feature/bug_endblock_msg' of ↵Dimitri van Heesch2019-08-041-16/+16
|\ \ | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_endblock_msg
| * | Correction warning messagealbert-github2019-06-011-13/+13
| |/ | | | | | | Consistency
* | Merge branch 'feature/issue_6831' of ↵Dimitri van Heesch2019-08-041-5/+13
|\ \ | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/issue_6831
| * | issue #6831 Failure to recognize class array with PHP in @varalbert-github2019-02-151-3/+19
| | | | | | | | | | | | | | | | | | | | | | | | There are 2 different situations here: - @var, here a special change is necessary to check and handle whether or not we are in PHP (declinfo.*, doxygen.cpp) - @param - the type recognition for the PHP type has to be extended with the `[]` possibility and subsequently the `[]` part has to be handled separately from the 'datatype' (doctokinizer.l, docparser.*). - In the output we now can have multiple text strings resulting in a small change in handling of the separator between the data type (*docvisitor.*)
* | | Merge branch 'fetaure/bug_html_ins_del_tag' of ↵Dimitri van Heesch2019-08-031-0/+34
|\ \ \ | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-fetaure/bug_html_ins_del_tag
| * | | Adding HTML tags ins and delalbert-github2019-04-041-0/+34
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Github does not support the `<u>` tag for underlined text, in HTML there exists the tag `<ins>`. On https://www.w3schools.com/tags/tag_ins.asp is written: The `<ins>` tag defines a text that has been inserted into a document. Browsers will normally strike a line through deleted text and underline inserted text. Most browsers will display the `<ins>` element with the following default values: ``` ins { text-decoration: underline; } ``` analogous there exists the tag `<del>` (https://www.w3schools.com/tags/tag_del.asp): The `<del>` tag defines text that has been deleted from a document. Browsers will normally strike a line through deleted text and underline inserted text. Most browsers will display the `<del>` element with the following default values: ``` del { text-decoration: line-through; } ``` Definitions analogue to the underline and strike through tag the implementation for the other formats has been chosen.
* | | | issue 7068: "QGDict::hashAsciiKey: Invalid null key" error messages (part 5)Dimitri van Heesch2019-08-031-1/+1
| | | |
* | | | issue 7068: "QGDict::hashAsciiKey: Invalid null key" error messages (part 3)Dimitri van Heesch2019-08-011-29/+62
| | | |
* | | | Merge branch 'feature/bug_retval_mult' of ↵Dimitri van Heesch2019-07-311-11/+36
|\ \ \ \ | | | | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_retval_mult
| * | | | Give warning when a retval is used multiple timesalbert-github2019-01-211-13/+84
| | | | | | | | | | | | | | | | | | | | Analogous to arguments when they have multiple `\param` commands this is also done when a return value is specified multiple times with the `\retval` command
* | | | | Non existing MSC file crashes doxygenDimitri van Heesch2019-07-291-5/+20
| | | | |
* | | | | Merge branch 'feature/issue_6925' of ↵Dimitri van Heesch2019-07-291-49/+101
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/issue_6925
| * | | | | issue #6925 Missing ATX headings in markdown pagesalbert-github2019-05-271-49/+101
| | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In general ATX headers ('#' headers and other markdown ) are converted to doxygen `\section` etc. commands In case not all levels of doxygen commands are present so like; ``` \section sect1 Section .... \subsubsection subsubsect1 Sub sub section ``` the information of the `\subsubsection` is not shown. Same happens in case the `\section` is not present at all. Part of the steering of the ATX headers is done by means of the configuration setting TOC_INCLUDE_HEADINGS (default is 5) setting this setting to '0' will not convert the '#' headers to `\section` etc. (but this as side note). Basic problem is fixing the not shown headers in case of missing levels in the `\section` commands. - In case the `\section` command does start the page - In case the `\section` command does not start the page. Case the `\section` command does start the page: this is handled in the routine `int DocSection::parse()` - see to it that not only the exact matching level is handled but also the 'jumps' in levels - loop all 'section' of the found type and its sub sections and only jump out in case of the 'jump' level case - give a warning in case of a 'level jump' Case the `\section` command does not start the page: this is handled in the routine ` void DocRoot::parse()` - as e.g. `\paragraph` could be followed by a `\subsubsection` each section type has to be handled one after another (otherwise higher types would not be handled) - note the order is important therefore a `\subsubsection` has to be handled after a `\paragraph. - due to the different handling the 'TK_LISTITEM' has to be handled at the end (each part can also give a 'TK_LISTITEM'
* | | | | Merge pull request #7023 from albert-github/feature/bug_warn_commandDimitri van Heesch2019-07-291-37/+43
|\ \ \ \ \ | | | | | | | | | | | | Incorrect warning message