[Doxygen-users] Even though it is reading the tag file Doxygen isn't adding any external links

2017-04-28 Thread Mark
brary documentation. The package doxyFile contains TAGFILES = build/doc/mylib/mylib.tag=../../mylib/html Doxygen reports Reading and parsing tag files Reading tag file `build/doc/mylib/mylib.tag', location `../../mylib/html'... Apart from some warnings about duplicate anchors /User

[Doxygen-users] How can I stop Doxygen creating a _path_to_my_proj_lib_.3 man page?

2017-04-28 Thread Mark
ow <http://stackoverflow.com/questions/43677909/how-can-i-stop-doxygen-creating-a-path-to-my-proj-lib-3-man-page>. Regards -Mark -- Check out the vibrant tech community on one of the world's most engaging tech

[Doxygen-users] How can I generate a man page for a command?

2017-04-28 Thread Mark
? I am sure I can’t be the first person trying to generated end-user documentation with Doxygen. What am I missing? Regards -Mark -- Check out the vibrant tech community on one of the world's most engag

Re: [Doxygen-users] How can I generate a man page for a command?

2017-04-28 Thread Mark
> On Apr 29, 2017, at 11:48, Mark wrote: > > How can I get the man page to have this content? I have found an answer. If I change @mainpage to @page then a toktx.1 file is created. I still need to get rid of those 2 useless files named after the full paths to source files.

Re: [Doxygen-users] How can I generate a man page for a command?

2017-04-29 Thread Mark
> On Apr 29, 2017, at 12:43, Mark wrote: > > I have found an answer. Now I’m trying to think of a way to share text between the usage message printed by the app and this man page. Anyone got any bright ideas? Regards

Re: [Doxygen-users] How can I stop Doxygen creating a    _path_to_my_proj_lib_.3 man page?

2017-04-30 Thread Mark
blank. In this case I still get these pesky path files for the 2 directories in the path. Regards -Mark P.S. to Ken, sorry for the duplicate message. I failed to notice that my mail client had not set the proper from address.-

[Doxygen-users] How to create man-page style options listing?

2017-05-01 Thread Mark
groff, and therefore also \htmlonly and my own html. Regards -Mark -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm

[Doxygen-users] How can I get a Functions list in the top level of Doxygen's tree view?

2017-05-01 Thread Mark
can I do this? Asked also at stackoverflow <http://stackoverflow.com/questions/43629688/how-can-i-get-a-functions-list-in-the-top-level-of-doxygens-tree-view>. Regards -Mark -- Check out the vibrant tech community on one of

[Doxygen-users] Custom command where multiple adjacent are joined into a single "paragraph"

2017-05-03 Thread Mark
there is no underlying generic command having the behavior that could be used in an ALIAS. If such a thing exists, it has not exactly jumped out at me in special commands. Am I just missing it? Regards -Mark -- Che

[Doxygen-users] man page shows both page name and title. Bug in doxygen?

2017-05-03 Thread Mark
e top of the page with “toktx” in it. “A description” appears below this heading. This is okay except that NAME does not appear so the HTML does not look like the man page. Regards -Mark -- Check out the vibrant

Re: [Doxygen-users] Utilizing Doxygen for collaborative document building

2017-05-04 Thread Mark
em. You can put code (you do mean source code?) fragments into Asciidoctor and have them syntax highlighted in the output. Doxygen is for when you want your readers to be able to explore the code structure or get reference inform

[Doxygen-users] Creating an example using snippet

2017-05-09 Thread Mark
then the snippet is included in the documentation for whatever is declared following this comment block. Regards -Mark -- Check out the vibrant tech community on one of the world's most engaging tech

Re: [Doxygen-users] Creating a main "hub" for componentized documentation

2017-06-29 Thread Mark
> On Jun 29, 2017, at 15:09, Mark wrote: > > Hi Robert, > >> On Jun 29, 2017, at 13:16, Robert Dailey > <mailto:rcdailey.li...@gmail.com>> wrote: >> >> I have integrated Doxygen documentation generation into CMake via tag >> files. Each dependen

Re: [Doxygen-users] Creating a main "hub" for componentized documentation

2017-06-29 Thread Mark
; landing > page that connects everything together. I am looking for the same thing. So far I have not found an answer, not even by way of my query to this list. I hope you have better luck. Regards -Mark -- Che

Re: [Doxygen-users] doxygen layout file with missing elements: is it valid?

2017-07-05 Thread Mark
). > Didn't notice any visual issues. > > Is this valid? Will doxygen use internal defaults for missing > top-level elements in the layout XML? I look forward to the answer. If one of the added elements needs to point to a document for which tags are being imported, how do yo

Re: [Doxygen-users] Doxygen on Cygwin overwrites user defined paths

2017-08-07 Thread Mark
hought on other platforms too. Not sure why your results are different. As for the cygwin path issue, either make sure all tools, including doxygen, are cygwin tools or all are windows tools. You might be able to do some mixing by using scripts that use cygpath. Regards -Mark > On Jul

[Doxygen-users] Has to stop the tree view flashing?

2017-11-01 Thread Mark
most item is visible. This makes navigating through API documentation very difficult. How can I prevent these nasties? Regards -Mark

[Doxygen-users] External Documentation Linking Questions?

2017-11-01 Thread Mark
1. How to reference external documentation from a user tab? I am attempting to use a tag file to reference an external doxygen-generated doc. References within Doxygen generated pages are working. E.g., my @mainpage content includes "@ref history". This link correctly links to the document list

[Doxygen-users] External documentation links

2018-04-22 Thread Mark
. Only if I use @subpage externalref do I get a usable link. The documentation for using tags is a joke. It stops at the point where it's told you how to get doxygen to find the tags file. Regards -Mark -- Chec

[Doxygen-users] \includedoc and Markdown

2018-04-25 Thread Mark
viewed as a page in the documentation. Is this a bug or am I doing something wrong? Regards -Mark -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm

[Doxygen-users] explicit link request to 'notice' could not be resolved

2018-04-25 Thread Mark
arly structured titles that are working fine. I even copied the 1st 2 lines from one of those into notice.md but get the same message, modulo the link name. The file modes are identical. The files are all included in the doxyfile’s INPUT. Can someone give me a clue as to what is going wrong? Reg

[Doxygen-users] snippet woes

2018-05-03 Thread Mark
whole file I wouldn’t be using snippets. How can I stop Doxygen doing this? Regards -Mark -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm

Re: [Doxygen-users] External documentation links

2018-05-07 Thread Mark
I am still seeking help with the following questions. > On Apr 22, 2018, at 22:26, Mark wrote: > > I’m experimenting with TAG files and external links and have a couple of > questions. > > 1. Is it possible to disambiguate links in refs? I want to link to the index > pa

Re: [Doxygen-users] External documentation links

2018-05-07 Thread Mark
> On May 7, 2018, at 18:49, Mark wrote: > > So I ask again, is the a way to explicitly disambiguate my umbrella doc’s > index from libktx’s? Bonus question: is there someway to use a URL as the name for the reference “name” in \subpage command? Just putting a URL after it result

[Doxygen-users] How to prevent trivial man pages being generated?

2019-07-08 Thread Mark
find a man page for, e.g st_dev, a field in a statbuf struct. You won’t even find a man page for statbuf. Is there some way to limit Doxygen to generating man pages just for the API functions? Regards -Mark ___ Doxygen-users mailing list Doxygen

Re: [Doxygen-users] How to prevent trivial man pages being generated?

2019-07-08 Thread Mark
> On Jul 8, 2019, at 11:38, Mark wrote: > > Is there some way to limit Doxygen to generating man pages just for the API > functions? Other than not documenting the fields. Regards -Mark ___ Doxygen-users mailing list D

[Doxygen-users] multiple use of page label warning with only 1 use

2020-03-17 Thread Mark
I am getting the following warning: multiple use of page label 'license', (other occurrence: , line: 1) in a Markdown file with the following heading: License and Attribution Notices {#license} === - The warning appears on the last line shown -

Re: [Doxygen-users] multiple use of page label warning with only 1 use

2020-03-17 Thread Mark
> On Mar 17, 2020, at 16:10, Mark wrote: > > I am getting the following warning: > > multiple use of page label 'license', (other occurrence: , line: > 1) > I figured it out. The file was input to two projects one of which was exporting tags read by

[Doxygen-users] How to make a doc containing other docs?

2020-03-19 Thread Mark
? Regards -Mark ___ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users

[Doxygen-users] member name appearing in Modules/Groups

2020-03-20 Thread Mark
something that recently changed. Is it a bug? The intent of \memberof is not clear from the documentation which gives little information beyond it being useful when documenting c apis. Maybe I should just delete all the \memberof commands. Regards -Mark

Re: [Doxygen-users] member name appearing in Modules/Groups

2020-03-21 Thread Mark
> On Mar 20, 2020, at 17:17, Mark wrote: > > That is for a function “classA_testcase” which has \memberof classA in the > doxygen comment and is in some group created with \defgroup, if I navigate to > the function via the Data Structures or Files entries of the left-hand pane

[Doxygen-users] Generating man pages *only* for functions

2020-06-13 Thread Mark
. Regards -Mark ___ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users

[Doxygen-users] Turn off syntax highlighting in fenced code blocks

2020-07-20 Thread Mark
I have a fenced code block ``` Text that is not code ``` and it is being highlighted. How can I prevent that? I tried ```text and ```plaintext, ```{.text} and ```{.txt} but none made any difference. Regards -Mark ___ Doxygen-users mailing list

Re: [Doxygen-users] Turn off syntax highlighting in fenced code blocks

2020-07-20 Thread Mark
pport, e.g. \code{.unparsed} Show this as-is please \endcode “ Regards -Mark > On Jul 20, 2020, at 14:30, Mark wrote: > > No, sadly that doesn’t work either. Nor does ```unparsed. > > doxygen seems to think these blocks are some language called hljs. This is > the HTML

Re: [Doxygen-users] localization of documentation does not work for me

2023-02-24 Thread Mark
The official way to support multiple languages, which I’ve used successfully in the past, is to mark the comment language with \~[LanguageId], e.g. /** comment \~English \brief English brief description A longer description \~German \brief Deutsche kurzbeschreibung Eine längere Beschreibung

[Doxygen-users] How to set the url in a navindex tab to follow the link in a .tag file?

2023-07-02 Thread Mark
? Or is what I am trying to do impossible? Regards -Mark ___ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users

[Doxygen-users] Including doc comments in \code blocks in markdown

2013-01-26 Thread Mark Zeren
I am trying to write Objective-C coding guidelines in a markdown file and would like to provide code examples that include doc comments. However when I do something like: \code{.m} /** a good friend of Bar */ @interface Foo @end \endcode The comment becomes a blank line in the resulting code b

[Doxygen-users] @property in fenced code blocks causes doxygen crash

2013-01-26 Thread Mark Zeren
In a markdown file the following fenced code block causes a doxygen crash ~~~{.m} @property Foo *foo; ~~~ The corresponding \code block works fine: \code{.m} @property Foo *foo; \endcode I have tried this with Apple's provided 1.8.2 and also 1.8.3 --

Re: [Doxygen-users] Including doc comments in \code blocks in markdown

2013-01-26 Thread Mark Zeren
\endcode This separates the two *'s of the displayed comment with an invisible doc comment... On Jan 26, 2013, at 7:16 AM, Mark Zeren wrote: > > I am trying to write Objective-C coding guidelines in a markdown file and > would like to provide code

[Doxygen-users] 1.8.4: crashing: src/scanner.{l, cpp} DBG_CTX not checking for NULLs

2013-08-08 Thread Mark Ashley
The DBG_CTX macro at scanner.l line 529 causes a core dump in fprint()->strlen() on Solaris as the values aren't checked for NULL first. A quick fix is to comment out the macro and uncomment the dummy one before compiling. /bin/perl -pe '($. == 49) && s%^%//%' -i src/scanner.l /bin/perl -

[Doxygen-users] After upgrade to 1.8.5 : "input buffer overflow, can't enlarge buffer because scanner uses REJECT"

2013-11-15 Thread Ziegler, Mark
Doxygen/source/U_EthernetHandler.pas... Exiting... input buffer overflow, can't enlarge buffer because scanner uses REJECT" So I downgraded to 1.8.4 again and run job with same source and everything went well. Can somebody help me? Mit freundlichen Grüßen | Best reg

Re: [Doxygen-users] Silent installer for doxygen

2017-08-24 Thread Ziegler, Mark
Hello, doxygen setup is built using Inno Setup. Silent install is documented here http://www.jrsoftware.org/ishelp/ Mit freundlichen Grüßen | Best regards, i.A. MARK ZIEGLER Produktbereich Profilieren | Product Unit Profiling Leitung Softwareentwicklung | Head of Software R&D Phone +4

[Doxygen-users] Documenting conceptual functions

2017-07-20 Thread Zieg, Mark (KSC-ESC-624)[SGT - ESC]
Hi, Sorry if this has been documented elsewhere, but it's a hard thing to Google for. I have a C++ application which exposes a service over an API. I already use Doxygen to render lovely maintenance documentation for the server application itself. However, I'd also like to use Doxygen to ren