ghost references by function (doxygen 1.8.13)

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

ghost references by function (doxygen 1.8.13)

Jan Ruzicka-3

Hi

 

Does anybody else see ghost links in references sections?

Doxygen version 1.8.13.

 

“References“ section of function documentation have functions that are not called in the documented function at all.

In example below, function just assigns values, but references has xxx::yyy::fatal_exit().

 

Sorry, I don’t have a nice small self-contained  test case.

 

Jan

 

[1] Example of doxygen output:

get_versions()

void xxx::yyy::get_versions           (              int &      major_,

                              int &      minor_,

                              int &      micro_

               )                            

 

Get the version numbers for this module.

 

Parameters

    major_             The major version number.

    minor_             The minor version number.

    micro_             The micro version number.

 

Returns

    void.

 

Definition at line 80 of file tools.cpp.

 

References xxx::yyy::fatal_exit().

 

Referenced by xxx::yyy::check_args().

{

     major_ = MAJOR_VERSION;

     minor_ = MINOR_VERSION;

     micro_ = MICRO_VERSION;

}

 

 

Jan Ruzicka

Senior Software Engineer

Comtech Mobile Datacom Corporation

20430 Century Blvd, Germantown, MD 20874

Office: 240-686-3300

Fax: 240-686-3301

The information contained in this message may be privileged and/or confidential. If you are not the intended recipient, or responsible for delivering this message to the intended recipient, any review, forwarding, dissemination, distribution or copying of this communication or any attachment(s) is strictly prohibited. If you have received this message in error, please so notify the sender immediately, and delete it and all attachments from your computer and network.

 




NOTICE TO RECIPIENT: This email, including attachments, may contain information which is confidential, proprietary, attorney-client privileged and/or controlled under U.S. export laws and regulations and may be restricted from disclosure by applicable State and Federal law. Nothing in this email shall create any legal binding agreement between the parties unless expressly stated herein and provided by an authorized representative of Comtech Telecommunications Corp. or its subsidiaries. If you are not the intended recipient of this message, be advised that any dissemination, distribution, or use of the contents of this message is strictly prohibited. If you received this message in error, please notify us immediately by return email and permanently delete all copies of the original email and any attached documentation from any computer or other media.

------------------------------------------------------------------------------
Announcing the Oxford Dictionaries API! The API offers world-renowned
dictionary content that is easy and intuitive to access. Sign up for an
account today to start using our lexical data to power your apps and
projects. Get started today and enter our developer competition.
http://sdm.link/oxford
_______________________________________________
Doxygen-users mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/doxygen-users
Reply | Threaded
Open this post in threaded view
|

Re: ghost references by function (doxygen 1.8.13)

Jan Ruzicka-3

Hi

 

The References section seems to always include a next function.

 

Jan

 

From: Jan Ruzicka
Sent: Thursday, March 09, 2017 11:38 AM
To: '[hidden email]' <[hidden email]>
Subject: ghost references by function (doxygen 1.8.13)

 

Hi

 

Does anybody else see ghost links in references sections?

Doxygen version 1.8.13.

 

“References“ section of function documentation have functions that are not called in the documented function at all.

In example below, function just assigns values, but references has xxx::yyy::fatal_exit().

 

Sorry, I don’t have a nice small self-contained  test case.

 

Jan

 

[1] Example of doxygen output:

get_versions()

void xxx::yyy::get_versions           (              int &      major_,

                              int &      minor_,

                              int &      micro_

               )                            

 

Get the version numbers for this module.

 

Parameters

    major_             The major version number.

    minor_             The minor version number.

    micro_             The micro version number.

 

Returns

    void.

 

Definition at line 80 of file tools.cpp.

 

References xxx::yyy::fatal_exit().

 

Referenced by xxx::yyy::check_args().

{

     major_ = MAJOR_VERSION;

     minor_ = MINOR_VERSION;

     micro_ = MICRO_VERSION;

}

 

 

Jan Ruzicka

Senior Software Engineer

Comtech Mobile Datacom Corporation

20430 Century Blvd, Germantown, MD 20874

Office: 240-686-3300

Fax: 240-686-3301

 

The information contained in this message may be privileged and/or confidential. If you are not the intended recipient, or responsible for delivering this message to the intended recipient, any review, forwarding, dissemination, distribution or copying of this communication or any attachment(s) is strictly prohibited. If you have received this message in error, please so notify the sender immediately, and delete it and all attachments from your computer and network.

 




NOTICE TO RECIPIENT: This email, including attachments, may contain information which is confidential, proprietary, attorney-client privileged and/or controlled under U.S. export laws and regulations and may be restricted from disclosure by applicable State and Federal law. Nothing in this email shall create any legal binding agreement between the parties unless expressly stated herein and provided by an authorized representative of Comtech Telecommunications Corp. or its subsidiaries. If you are not the intended recipient of this message, be advised that any dissemination, distribution, or use of the contents of this message is strictly prohibited. If you received this message in error, please notify us immediately by return email and permanently delete all copies of the original email and any attached documentation from any computer or other media.

------------------------------------------------------------------------------
Announcing the Oxford Dictionaries API! The API offers world-renowned
dictionary content that is easy and intuitive to access. Sign up for an
account today to start using our lexical data to power your apps and
projects. Get started today and enter our developer competition.
http://sdm.link/oxford
_______________________________________________
Doxygen-users mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/doxygen-users
Reply | Threaded
Open this post in threaded view
|

Re: ghost references by function (doxygen 1.8.13)

Jan Ruzicka-3
In reply to this post by Jan Ruzicka-3

Hi

 

The problem seems to be related to a combination of group, namespace and function definition.

 

See attached tgz.

The a.cpp and c.cpp behave normally as expected.

The c.cpp links functions to each other even when they have any calls in their body.

 

The difference between b.cpp and c.cpp

Is syntax of function definition

 

    int

    aa::

    a1 (void)

       

   triggers the issue (I know that it is not usual syntax, but source code can’t be changed at this moment)

 

vs.

 

    int aa::a1 (void)

 

   behaves as expected.

 

Thanks for any help.

Jan

 

From: Jan Ruzicka
Sent: Thursday, March 09, 2017 12:29 PM
To: '[hidden email]' <[hidden email]>
Subject: RE: ghost references by function (doxygen 1.8.13)

 

Hi

 

The References section seems to always include a next function.

 

Jan

 

From: Jan Ruzicka
Sent: Thursday, March 09, 2017 11:38 AM
To: '[hidden email]' <[hidden email]>
Subject: ghost references by function (doxygen 1.8.13)

 

Hi

 

Does anybody else see ghost links in references sections?

Doxygen version 1.8.13.

 

“References“ section of function documentation have functions that are not called in the documented function at all.

In example below, function just assigns values, but references has xxx::yyy::fatal_exit().

 

Sorry, I don’t have a nice small self-contained  test case.

 

Jan

 

[1] Example of doxygen output:

get_versions()

void xxx::yyy::get_versions           (              int &      major_,

                              int &      minor_,

                              int &      micro_

               )                            

 

Get the version numbers for this module.

 

Parameters

    major_             The major version number.

    minor_             The minor version number.

    micro_             The micro version number.

 

Returns

    void.

 

Definition at line 80 of file tools.cpp.

 

References xxx::yyy::fatal_exit().

 

Referenced by xxx::yyy::check_args().

{

     major_ = MAJOR_VERSION;

     minor_ = MINOR_VERSION;

     micro_ = MICRO_VERSION;

}

 

 

Jan Ruzicka

Senior Software Engineer

Comtech Mobile Datacom Corporation

20430 Century Blvd, Germantown, MD 20874

Office: 240-686-3300

Fax: 240-686-3301

 

The information contained in this message may be privileged and/or confidential. If you are not the intended recipient, or responsible for delivering this message to the intended recipient, any review, forwarding, dissemination, distribution or copying of this communication or any attachment(s) is strictly prohibited. If you have received this message in error, please so notify the sender immediately, and delete it and all attachments from your computer and network.

 




NOTICE TO RECIPIENT: This email, including attachments, may contain information which is confidential, proprietary, attorney-client privileged and/or controlled under U.S. export laws and regulations and may be restricted from disclosure by applicable State and Federal law. Nothing in this email shall create any legal binding agreement between the parties unless expressly stated herein and provided by an authorized representative of Comtech Telecommunications Corp. or its subsidiaries. If you are not the intended recipient of this message, be advised that any dissemination, distribution, or use of the contents of this message is strictly prohibited. If you received this message in error, please notify us immediately by return email and permanently delete all copies of the original email and any attached documentation from any computer or other media.

------------------------------------------------------------------------------
Announcing the Oxford Dictionaries API! The API offers world-renowned
dictionary content that is easy and intuitive to access. Sign up for an
account today to start using our lexical data to power your apps and
projects. Get started today and enter our developer competition.
http://sdm.link/oxford
_______________________________________________
Doxygen-users mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/doxygen-users

doxygenTest.tgz (37K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: ghost references by function (doxygen 1.8.13)

alinp
This post has NOT been accepted by the mailing list yet.
In reply to this post by Jan Ruzicka-3
I see the issue as well and my code is straight C (no C++).  It appears to be affecting the call graphs as well.