MantisBT - Open CASCADE
View Issue Details
0028362Open CASCADE[OCCT] OCCT:Documentationpublic2017-01-16 19:122017-09-29 16:28
abv 
bugmaster 
normalminor 
closedfixed 
 
[OCCT] 7.2.0[OCCT] 7.2.0 
Not needed
0028362: Documentation - Doxygen warnings
Current master yields the following warnings when Doxygen documentation is generated (default compilation by CMake on Linux):

\\/home/abv/occt/dox/user_guides/boolean_operations/boolean_operations.md:\2668:\warning: image file /user_guides/boolean_operations/images/glue_options_image002.png is not found in IMAGE_PATH: assuming external image.\
\\/home/abv/occt/dox/user_guides/boolean_operations/boolean_operations.md:\2673:\warning: image file /user_guides/boolean_operations/images/glue_options_image001.png is not found in IMAGE_PATH: assuming external image.\
\\/home/abv/occt/dox/user_guides/boolean_operations/boolean_operations.md:\2676:\warning: image file /user_guides/boolean_operations/images/glue_options_image003.png is not found in IMAGE_PATH: assuming external image.\
\\/home/abv/occt/dox/user_guides/boolean_operations/boolean_operations.md:\2720:\warning: image file /user_guides/boolean_operations/images/glue_options_image004.png is not found in IMAGE_PATH: assuming external image.\
\\/home/abv/occt/dox/user_guides/boolean_operations/boolean_operations.md:\2726:\warning: image file /user_guides/boolean_operations/images/glue_options_image005.png is not found in IMAGE_PATH: assuming external image.\


\\/home/abv/occt/dox/dev_guides/upgrade/upgrade.md:\967:\warning: explicit link request to 'SelectionMode()' could not be resolved\
\\/home/abv/occt/dox/dev_guides/upgrade/upgrade.md:\1143:\warning: explicit link request to 'DefaultColor()' could not be resolved\
\\/home/abv/occt/dox/dev_guides/upgrade/upgrade.md:\1143:\warning: explicit link request to 'WasCurrentTouched()' could not be resolved\
\\/home/abv/occt/dox/dev_guides/upgrade/upgrade.md:\1143:\warning: explicit link request to 'ZDetection()' could not be resolved\
\\/home/abv/occt/dox/dev_guides/upgrade/upgrade.md:\1193:\warning: explicit link request to 'DynamicHilightAttributes()' could not be resolved\
\\/home/abv/occt/dox/dev_guides/upgrade/upgrade.md:\1193:\warning: explicit link request to 'HilightAttributes()' could not be resolved\
NA
No tags attached.
related to 0028440closed apn Open CASCADE Documentation - Doxygen errors on Linux 
related to 0028403closed apn Open CASCADE Avoid useless calls to BRepTools::Write() 
related to 0028836closed bugmaster Open CASCADE Doxygen warning in DRAW User Guide 
Issue History
2017-01-16 19:12abvNew Issue
2017-01-16 19:12abvAssigned To => ysn
2017-05-19 15:36abvTarget Version7.3.0 => 7.2.0
2017-06-02 12:45ysnNote Added: 0067016
2017-06-02 12:45ysnAssigned Toysn => abv
2017-06-02 12:45ysnStatusnew => resolved
2017-06-02 12:45ysnSteps to Reproduce Updatedbug_revision_view_page.php?rev_id=16848#r16848
2017-06-07 10:57abvNote Added: 0067168
2017-06-07 10:57abvStatusresolved => assigned
2017-06-20 23:32abvRelationship addedrelated to 0028440
2017-06-20 23:32abvRelationship addedrelated to 0028403
2017-06-20 23:36abvNote Added: 0067555
2017-06-20 23:36abvRelationship addedrelated to 0028346
2017-06-20 23:38gitNote Added: 0067556
2017-06-20 23:41gitNote Added: 0067557
2017-06-20 23:41abvNote Added: 0067558
2017-06-20 23:41abvAssigned Toabv => bugmaster
2017-06-20 23:41abvStatusassigned => resolved
2017-06-20 23:41abvStatusresolved => reviewed
2017-06-21 11:14apvTest case number => Not needed
2017-06-21 11:14apvNote Added: 0067561
2017-06-21 11:14apvStatusreviewed => tested
2017-06-23 12:25bugmasterChangeset attached => occt master 21b1980f
2017-06-23 12:25bugmasterStatustested => verified
2017-06-23 12:25bugmasterResolutionopen => fixed
2017-07-03 08:45gitNote Added: 0067865
2017-07-27 10:40abvRelationship addedrelated to 0028836
2017-09-29 16:17aivFixed in Version => 7.2.0
2017-09-29 16:28aivStatusverified => closed

Notes
(0067016)
ysn   
2017-06-02 12:45   
I cannot reproduce these warnings when I compile the current version of documentation.

The images exist in the corresponding folder and there are no links, only method names.

I assume that this bug can be closed now.
(0067168)
abv   
2017-06-07 10:57   
Warnings "explicit link request... could not be resolved" have been fixed in commit for 0028403. Note that in Doxygen syntax, two colons followed by ID means link to some tag, and method names given with "::" in the beginning cause that warning. Such semicolons should be removed. Note that putting "::" before method name in C++ means name is in the global scope, which is not correct in most of the cases where such problem appears.

First set of warnings is reproduced on Linux only, apparently due to the fact that paths beginning with slash are interpreted as full path (not relative to current folder).
(0067555)
abv   
2017-06-20 23:36   
Second set of warnings (Linux specific) has been corrected within 0028440.

However, 41 new warnings appeared since then:

\\D:/ABV/OCCT/occt/dox/user_guides/draw_test_harness/draw_test_harness.md:\10022:\warning: Unsupported xml/html tag <face> found\
\\D:/ABV/OCCT/occt/dox/user_guides/draw_test_harness/draw_test_harness.md:\10022:\warning: Unsupported xml/html tag <X> found\
...

All these due to wrong formatting of code block (not closed properly) introduced by fix for #28346
(0067556)
git   
2017-06-20 23:38   
Branch CR28362 has been created by abv.

SHA-1: febb2c2ee1adaef5751f3df69179d613e304d99a


Detailed log of new commits:

Author: abv
Date: Tue Jun 20 23:38:35 2017 +0300

    0028362: Documentation - Doxygen warnings
(0067557)
git   
2017-06-20 23:41   
Branch CR28362 has been updated forcibly by abv.

SHA-1: ddc3db9666eed1c57bcbd1fba563f18ad8e48ade
(0067558)
abv   
2017-06-20 23:41   
Fix pushed to CR28362, please integrate
(0067561)
apv   
2017-06-21 11:14   
Dear BugMaster,

Please integrate branch CR28362 into the occt git-repository master.
(0067865)
git   
2017-07-03 08:45   
Branch CR28362 has been deleted by kgv.

SHA-1: ddc3db9666eed1c57bcbd1fba563f18ad8e48ade