summaryrefslogtreecommitdiffstats
path: root/src/docparser.cpp
Commit message (Collapse)AuthorAgeFilesLines
* Merge pull request #6643 from albert-github/feature/bug_xhtml_test_30Dimitri van Heesch2018-12-031-1/+10
|\ | | | | Incorrect number tag sequence for xhtml with htmlinclude command possible
| * Incorrect number tag sequence for xhtml with htmlinclude command possiblealbert-github2018-11-251-1/+10
| | | | | | | | | | | | Analogous to the `\htmlonly` also with the `\htmlinclude` command it is possible that some parts are added that cannot be inside a `<p> ... <\/p>` and thus we have to temporary close (and later reopen) the paragraph. The option `[block]` has been added to the `\htmlinclude` command (analogous to the `\htmlonly` command). Problem can be seen with the default doxygen test 30 (`[030_htmlinclude.dox]: test the \htmlinclude command`).
* | Restructured code to avoid the need for global stateDimitri van Heesch2018-11-251-3/+3
|/
* Replace ''printf' with appropriate warn 'message'albert-github2018-11-171-4/+5
| | | | In the code a 'printf' has been replaced with an appropriate 'warn' call (and renamed a local variable to prevent conflicts)
* Merge branch 'feature/bug_inline_image' of ↵Dimitri van Heesch2018-11-111-6/+43
|\ | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_inline_image
| * Inline imagesalbert-github2018-08-091-5/+42
| | | | | | | | Create the possibility of inline images with the `\image` command by means of the option `inline`.
* | Merge branch 'feature/issue_6517' of ↵Dimitri van Heesch2018-11-111-32/+114
|\ \ | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/issue_6517
| * | issue_6517: Emoji supportalbert-github2018-10-011-2/+121
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Added issue support for the different output types. - Sources of the emoji - based on the Unicode definition v11.0: - https://unicode.org/emoji/charts/full-emoji-list.html - http://www.unicode.org/emoji/charts/full-emoji-modifiers.html - github definition list: - https://api.github.com/emojis - Input of emoji: :<test>: with the restriction that direct after the opening colon and direct before the closing colon no space is allowed - doctokinizer.l, adding detection of emoji and new command `\:` - doktokinizer.h, adding "word" type TK_EMOJI - docparser.* handling of new "word" type TK_EMOJI (analogous to HTML Entities), handling of new command `\:` - cmdmapper,cpp, cmdmapper.h, adding new command `\:` - htmlentity.cpp, adding new definition required for new command `\:` - Emoji - emoji.cpp, emoji.h, class for handling emoji analogous to HTML Entities, including small directions on how to update the code when a new emoji is defined. Not everything is converted to lowercase for comparison and accents are removed. - doxygen.cpp possibility to create list of supported emoji - handling emoji for output types (analogous to HTML Entities), see documentation for different output types - docparser.h, *docvisitor.* - rtfdocvisitor.* converting output to UTF-16 (based on http://scruss.com/blog/2017/03/12/in-the-unlikely-event-you-need-to-represent-emoji-in-rtf-using-perl/) - latexdocvisitor.*, handling arguments for emoji in output (see also latexgen.cpp for meaning of the arguments of doxygenemoji). - latexgen.cpp, adding new latex command for doxygen (doxygenemoji) and prevent too many open file (code before documentclass) - config.xml, definition of `LATEX_EMOJI_DIRECTORY` with path to images required for LaTeX output - Documentation: - emojisup.doc, user description - commands.doc, description of new command `\:` - index.doc, reference to emoji chapter - xmlcmds.doc, adjust reference to next chapter as a new chapter is added - Doxyfile*, adding emoji chapter Build system - CMakeLists.txt adding new files
* | | Merge pull request #6438 from albert-github/feature/bug_citeDimitri van Heesch2018-10-281-5/+6
|\ \ \ | | | | | | | | Correcting labels for citations
| * | | Correcting labels for citationsalbert-github2018-08-101-5/+6
| | |/ | |/| | | | | | | | | | The labels for RTF and XML were incorrect due to the fact that the wrong branch was chosen in the code (the newAnchor was set for the results of the `\cite ` command as well). Small readability issue with XML (when there are a lot of citations).
* | | Renamed command and moved duplicated code into a macroDimitri van Heesch2018-10-271-22/+31
| | |
* | | Merge branch 'feature/bug_warning_msg' of ↵Dimitri van Heesch2018-10-271-143/+59
|\ \ \ | | | | | | | | | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_warning_msg
| * | | Correcting warning messages and echoing unknown commandalbert-github2018-08-261-143/+59
| | | | | | | | | | | | | | | | | | | | | | | | - In case an unknown command is given this was shown as a warning but not as normal text in the output, for this also a distinction between `\`and `@` commands has to be made - corrected command name in warning messages when handling arguments - making handling of some warning messages consistent
* | | | Merge pull request #6435 from albert-github/feature/bug_image_in_a_tagDimitri van Heesch2018-10-271-0/+3
|\ \ \ \ | | | | | | | | | | Possibility to have a \image command inside a <A> tag
| * | | | Possibility to have a \image command inside a <A> tagalbert-github2018-08-091-0/+3
| | |/ / | |/| | | | | | | | | | Enable the possibility to have a `\image` command inside a <A> tag
* | | | Bug 710654 - <img> on a \page does not copy the image to the html output folderalbert-github2018-10-121-5/+6
| |_|/ |/| | | | | | | | Create possibility to copy the image automatically to the HTML directory, in case file cannot be found no warning is given (consistency).
* | | Readded missing "Span" case to DocStyleChange::styleStringDimitri van Heesch2018-08-261-8/+9
| | |
* | | Merge branch 'feature/bug_667993' of ↵Dimitri van Heesch2018-08-261-1/+34
|\ \ \ | |_|/ |/| | | | | https://github.com/albert-github/doxygen into albert-github-feature/bug_667993
| * | Bug 667993 - HTML tags <u> and </u> not supportedalbert-github2018-07-071-1/+34
| | | | | | | | | | | | Added underline possibility and strike through possibility for the different output formats insofar it is possible (other similar possibilities are not always possible for all output formats either).
* | | Merge branch 'lineno'Dimitri van Heesch2018-08-191-1/+26
|\ \ \ | |_|/ |/| |
| * | Bug 691689 - Line numbers for examplesDimitri van Heesch2018-08-191-1/+26
| | |
* | | Bug 137447 - <a href> doesn't allow <img> as visible part?albert-github2018-08-051-0/+7
|/ / | | | | | | | | Enable possibility to have image in a `<a>` tag. Will only show in HTML as the `<img>` is only shown in HTML (as documented).
* | Bug 779407 - plantuml:an unwanted newline is generated after @startumlDimitri van Heesch2018-07-211-1/+2
|/
* Problems and some enhancements for LaTeX tablesalbert-github2018-05-301-3/+23
| | | | | | | | | | | | - Possibility to honor also the cell alignment when using Markdown tables for other formats (markdown.cpp, latexdocvisitor.cpp, lines: 1146, 1157, 1173) latexdocvisitor.cpp: - Possibility to nest tables to a further level when using LaTeX. It was only possible till level 2 (i.e. a longtabu followed buy a tabularx table). By placing tabularx in an extra set of brackets this is fixed (lines 938 and 951) - tablarx environment cannot handle the headers as used for the longtabu table. A header line is in case of tabularx implemented by mimicking the header line. - longtabu needs multiple times the header line (first and following), tabularx we only need 1 (line 998) - no longtabu special headers (line 1092) - tabularx cannot handle rowcolor, coloring done only with columncolor(line 1024, 1134, 1188) - no necessity for longtabu to define column with for spanned columns / rows(line 1048, 1134, 1171)
* Corrected warning in case of a not supported output format with \image command.albert-github2018-05-161-7/+9
| | | | | | | | | When using a not supported output format with the image command e.g. \image man foo.png we get the warning message: warning: image type man specified as the first argument of man is not valid this is corrected to: warning: output format man specified as the first argument of image command is not valid
* Merge pull request #681 from albert-github/feature/bug_794509Dimitri van Heesch2018-04-221-9/+8
|\ | | | | Bug 794509 - c# see langword broken
| * Bug 794509 - c# see langword brokenalbert-github2018-03-231-9/+8
| | | | | | | | | | - code.l: The word 'null' was not recognized as reserved word - docparser.l The attribute 'langword' should not generate a link but the 'langword' value as code.
* | Bug 793862 - Missed warning opportunity: duplicated argumentsalbert-github2018-02-271-6/+26
|/ | | | In case an argument has been documented multiple times a warning message is given.
* Merge branch 'master' of https://github.com/ahoogol/doxygen into ahoogol-masterDimitri van Heesch2017-12-281-1/+122
|\
| * Fixed compile errors in clang and gccahoogol2017-06-281-12/+12
| |
| * Added support for RTL(right to left) languages like Arabic and Persian in ↵ahoogol2017-06-251-1/+122
| | | | | | | | HTML output
* | Merge pull request #613 from Cyberboss/patch-1Dimitri van Heesch2017-12-241-1/+12
|\ \ | | | | | | Suppresses warning for XML <see langword="..."/>
| * | Suppresses warning for XML <see langword="..."/>Jordan Brown2017-10-191-1/+12
| | |
* | | Propagate language information to all <programlisting> XML elements.Vladimír Vondruš2017-11-191-0/+3
|/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is based on work done in 141dbfd5a4f79c98da14a1b414c6db4e1b34618b through ed9acb6e1bb81a2eec334180f7b8c1bf0598b444 and makes a few behavioral changes to it. There's a new attribute called `filename` and the `language` was removed, because it could provide misleading information. This allows for more flexibility on the user side. In particular: * For historical reasons, `*.txt` files are marked by Doxygen as C++ (see https://bugzilla.gnome.org/show_bug.cgi?id=760836 for details). In particular, code snippet included from a CMakeLists.txt file would be marked and highlighted as C++. So in this case, the language attribute would be very misleading. * Doxygen is aware only of a very small subset of languages and thus a lot of information can be lost when relying on its extension-to-language-name conversion -- in particular, all extensions that are not recognized are assumed to be C++. On the other hand, putting more effort into its language detection algorithms is not worth the time, as there will always be new languages that fail to detect. So let's leave that on the user of the XML output instead. * Using just file extension is not enough, it has to be a full filename. For example, `*.txt` can be either a plain text file or a `CMakeLists.txt`. * The path is not stripped from the filename, as it also may contain additional information that helps to detect the language better. In addition to that, filenames of code snippets included via the \include command and related are propagated to the <programlisting> element as well. With this change, (1) code snippets using simply \code some code \endcode will not produce any `filename` attribute and it's up to the user what to do -- assume C++, detect language from contents or not highlight anything. <programlisting> some code </programlisting> (2) Code snippets using \code{.cmake} some code \endcode will produce the following: <programlisting filename=".cmake"> some code </programlisting> (3) And finally, \include, \dontinclude and related \skip, \skipline etc. commands \include path/to/some-file.py will produce <programlisting filename="path/to/some-file.py"> some code </programlisting> The tests were updated to check all three cases. On the user side, when using Pygments for example, it's then just a matter of calling pygments.lexers.find_lexer_class_for_filename() with value of the `filename` attribute value and optionally also the code snippet for additional language analysis.
* | Misc. doxy and comment typosluzpaz2017-08-021-1/+1
|/
* Bug 770660 - Code snippet always shows line numbers from 1albert-github2016-09-031-1/+5
| | | | | | | | | This patch makes the handling of the \snippet and other commands consistent between the different languages (no line numbers anymore with python) and also introduces analogous to \includelineno the command \snippetlineno. Some non relevant changes: - *code.l Calculation of the end line was incorrect, in case of a snippet the end line was the number of lines of the snippet and not reltive to the start line. - *code.l made consistent over the different laguages, enabling exBlock and inlineFragment - testing/indexpage.xml in test 14 the \snippet command was used with python and giving line numbers, linenumbers are now gone (consistency)
* Warnings from CLANG compileralbert-github2016-08-281-0/+5
| | | | The CLANG compiler gave some warnings after pull request #503 ("Introducing commands includedoc and snippetdoc ") at places that are not / should not be reachable.
* Introducing commands includedoc and snippetdocalbert-github2016-08-211-11/+39
| | | | | Purpose to have the possibility to have repeating texts not repeated in the comments. The commands include and snippet introduce code blocks whilst the commands includedoc and snippetdoc inclode the text as is and it will be parsed by doxygen.
* Parse more than 1 size indiction in defaultHandleTitleAndSizeArtur Kink2016-08-081-15/+23
|
* Changed configuration mechanism to directly access options in order to ↵Dimitri van Heesch2016-01-171-26/+26
| | | | improve performance
* Bug 735152 - Python: Allow undocumented "cls" parameter for class methodsalbert-github2015-12-261-6/+6
| | | | Made 'cls' parameter analogous to the 'self' parameter. See also https://www.python.org/dev/peps/pep-0008 (paragraph: Function and method arguments)
* Bug 756604 - Unable to prevent a numbered listDimitri van Heesch2015-11-141-9/+30
|
* Bug 756604 - Unable to prevent a numbered listDimitri van Heesch2015-11-011-0/+9
|
* Bug 755080 - xrefitem link to list incorrect when using SHORT_NAMESDimitri van Heesch2015-10-241-1/+1
|
* Small correction of errors in case of CSharp XML tagsalbert-github2015-08-281-3/+3
| | | | Extended / corrected some error messages
* Added documentation for creating tablesDimitri van Heesch2015-08-261-2/+3
|
* Fixed various issues found by PVS-Studio.Dimitri van Heesch2015-08-181-12/+3
|
* Merge pull request #352 from groleo/diagnosticsDimitri van Heesch2015-08-081-1/+12
|\ | | | | docparser: warn when finding a documented empty return type
| * docparser: warn when finding a documented empty return typeAdrian Negreanu2015-06-211-1/+12
| | | | | | | | | | | | | | There is an example on pg24 of [1] where a libclang based comment parser emits a warning for a documented empty return type. [1] "Parsing Documentation Comments in Clang" http://llvm.org/devmtg/2012-11/Gribenko_CommentParsing.pdf
* | Improved handling of <caption> in tables for LaTeX output.Dimitri van Heesch2015-08-081-5/+52
|/