summaryrefslogtreecommitdiffstats
path: root/src/docparser.cpp
Commit message (Collapse)AuthorAgeFilesLines
* 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
* 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
| * | | | | Incorrect warning messagealbert-github2019-06-031-37/+43
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In case we have e.g. the comment: ``` * @b: first ``` We get the warning message: ``` warning: expected whitespace after : command ``` instead of a better understandable: ``` warning: expected whitespace after \b command ```
* | | | | Remove not used classalbert-github2019-07-071-94/+0
|/ / / / | | | | | | | | | | | | | | | | | | | | | | | | As per comment in `docvisitor.h`: ``` class DocCopy; // TODO: no longer generated => remove ```
* | | | Simplified code a bitDimitri van Heesch2019-05-131-15/+5
| | | |
* | | | Merge branch 'feature/svg_image_determnation' of ↵Dimitri van Heesch2019-05-131-1/+15
|\ \ \ \ | | | | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/svg_image_determnation
| * | | | Image not seen as svg imagealbert-github2019-04-051-1/+15
| | |/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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: ``` [![Build Status](https://api.travis-ci.com/ILIAS-eLearning/ILIAS.svg?branch=release_5-3)](https://travis-ci.com/ILIAS-eLearning/ILIAS) [![Minimum PHP Version](https://img.shields.io/badge/php-%3E%3D%205.6-8892BF.svg)](https://php.net/) ```
* | | | Add const correctness for argument listsDimitri van Heesch2019-05-051-6/+6
| | | |
* | | | Further const correctness changesDimitri van Heesch2019-05-051-1/+1
| | | |
* | | | Merge branch 'feature/bug_init_fd_line' of ↵Dimitri van Heesch2019-04-281-1/+1
|\ \ \ \ | | | | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_init_fd_line
| * | | | Crash in case of usage of \line without \includealbert-github2019-04-191-1/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | In case thee `line` command is used without previous `\inclide` or `\dontinclude` command doxygen will crash due to a non initialized fd. We get the message: warning: No previous '\include' or \dontinclude' command for '\line' present also a small correcting regarding the warning message is done.
* | | | Improved const correctness and added support for inline namespacesDimitri van Heesch2019-04-211-129/+29
|/ / /
* | | Merge branch 'feature/bug_lineno_split_examples' of ↵Dimitri van Heesch2019-03-091-0/+28
|\ \ \ | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_lineno_split_examples
| * | | Show line numbers in "split" examplesalbert-github2019-03-031-0/+28
| | | | | | | | | | | | | | | | | | | | | | | | With the commands like `\skip`, `\skipline` it is possible to show parts of a file for further explanation / tutorials. They can be started with `\include` or `\dontinclude` but in case `\include` specifies that the line numbers have to be shown they are only shown in the full example and not in the split up example - show line numbers in split up example in case `lineno` is required - add `lineno` option to `\dontinclude` so here also line numbers can be shown.
* | | | Minor refactoringDimitri van Heesch2019-03-031-18/+2
| | | |
* | | | Warning if no file specified for special reading commandsalbert-github2019-03-031-0/+23
|/ / / | | | | | | | | | Create a warning in case no `\include` or `\dontinclude` command has been given before using `\skip`, `\line`, `\skipline` or `\utnil`