Details
-
Type:
Bug
-
Status: Done
-
Resolution: Done
-
Fix Version/s: None
-
Component/s: astshim
-
Labels:
-
Story Points:0.25
-
Epic Link:
-
Sprint:AP S18-5
-
Team:Alert Production
Description
When building astshim with lsstsw, I got the following warning:
lsstsw2/build/astshim/doc/mainpage.dox:41: warning: unable to resolve reference to `CmpFrame.operator' for \ref command
This is a known bug in Doxygen 1.8.5; the workaround is to use autolinking rather than @ref.
I also got the following warnings:
lsstsw2/build/astshim/include/astshim/FrameSet.h:349: warning: explicit link request to 'BASE' could not be resolved
lsstsw2/build/astshim/doc/attributes_fitsChan.dox:143: warning: unable to resolve reference to `CardType' for \ref command
lsstsw2/build/astshim/include/astshim/Mapping.h:129: warning: Found unknown command `\refTranInverse'
lsstsw2/build/astshim/include/astshim/Mapping.h:130: warning: unable to resolve reference to `hasTranForward' for \ref command
lsstsw2/build/astshim/include/astshim/Mapping.h:130: warning: unable to resolve reference to `hasTranInverse' for \ref command
lsstsw2/build/astshim/include/astshim/Mapping.h:133: warning: Found unknown command `\tranInverse'
lsstsw2/build/astshim/include/astshim/Mapping.h:133: warning: Found unknown command `\tranForward'
I am reluctant to make astshim depend on base (though I will do that if it's necessary for astshim docs to be found). Meanwhile I set EXTRACT_ALL = YES and replaced the use of EXCLUDE_PATTERNS with EXCLUDE += src. If even EXCLUDE contaminates other packages then I'll remove that – it doesn't do any harm to let Doxygen scan the .cc files.