GNOME Bugzilla – Bug 549281
Cutting off leading characters of filenames in Directory Reference
Last modified: 2009-05-25 20:35:32 UTC
Please describe the problem: Creating a documentation with files from several directories (RECURSIVE=YES) and there are files with same names doxygen tries ty keep the filenames in each directory reference unique by prepending the filenames with parts of the directory name there are stored in. Unfortunatelly doxygen just prepends as many characters of the directory in front of filenames as needed to keep uniqueness within the whole documentation. But it would be better (for reading) to always prepend filenames with at least full directory names. ------------------------------ Example 1: Directory is "osgGA" which gets abbreviated to "A" in front of file "Version.cpp": src » osgGA osgGA Directory Reference Files file AnimationPathManipulator.cpp [code] file DriveManipulator.cpp [code] file EventQueue.cpp [code] file EventVisitor.cpp [code] file FlightManipulator.cpp [code] file GUIEventAdapter.cpp [code] file GUIEventHandler.cpp [code] file KeySwitchMatrixManipulator.cpp [code] file MatrixManipulator.cpp [code] file NodeTrackerManipulator.cpp [code] file StateSetManipulator.cpp [code] file TerrainManipulator.cpp [code] file TrackballManipulator.cpp [code] file UFOManipulator.cpp [code] file A/Version.cpp [code] ------------------------------ Example 2: Directory is "osgManipulator " which gets abbreviated to "anipulator" in front of include files "Export" and "Version": include » osgManipulator osgManipulator Directory Reference Files file AntiSquish [code] file Command [code] file CommandManager [code] file Constraint [code] file Dragger [code] file anipulator/Export [code] file Projector [code] file RotateCylinderDragger [code] file RotateSphereDragger [code] file Scale1DDragger [code] file Scale2DDragger [code] file ScaleAxisDragger [code] file Selection [code] file TabBoxDragger [code] file TabPlaneDragger [code] file TabPlaneTrackballDragger [code] file TrackballDragger [code] file Translate1DDragger [code] file Translate2DDragger [code] file TranslateAxisDragger [code] file TranslatePlaneDragger [code] file anipulator/Version [code] Steps to reproduce: 1. Create a "standard" documentation which is made of files in different directories RECURSIVE = YES and SHOW_DIRECTORIES = YES. Make sure that in each of the directories is at least one file with same filename. Actual results: See under problem description above. Expected results: See under problem description above. Does this happen every time? YES Other information:
I tried to reproduce the problem, but it appears more difficult than the steps you describe. Can you please attach a small (dummy) example that shows the problem (source tree + config file in a zip). Thanks in advance.
Created attachment 117708 [details] Sample file set for bug On Windows: 1. Unpack BugReport.zip to C:\BugReport 2. Open command window and change working dir to C:\BugReport 3. Enter command doxygen Doxyfile 4. Documentation is in C:\BugReport\doc 5. Open C:\BugReport\doc\index.html 6. See the src » osgGA Directory Reference documentation for the problem described in the initial bug report. ----------------------------------- I tried different situations - my conclusion is that the namespaces osg:: and osgGA:: (or any other namespace starting with osg*::) leads to the problem.
By the way: All my modifications in "Doxyfile" are marked with ############### BUGREPORT
Dimitri, you requested information seems to be provided in comment #2. I am thus reopening.
Bug disappeared in Doxygen version 1.5.9! Thanks Ernst