After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 549281 - Cutting off leading characters of filenames in Directory Reference
Cutting off leading characters of filenames in Directory Reference
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
1.5.6
Other All
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2008-08-25 10:40 UTC by Ernst
Modified: 2009-05-25 20:35 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Sample file set for bug (726.67 KB, application/x-compressed-tar)
2008-08-31 16:45 UTC, Ernst
Details

Description Ernst 2008-08-25 10:40:18 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:
Comment 1 Dimitri van Heesch 2008-08-30 18:59:13 UTC
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.
Comment 2 Ernst 2008-08-31 16:45:53 UTC
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.
Comment 3 Ernst 2008-08-31 16:47:16 UTC
By the way:

All my modifications in "Doxyfile" are marked with ############### BUGREPORT
Comment 4 Tobias Mueller 2009-02-23 13:51:11 UTC
Dimitri, you requested information seems to be provided in comment #2. I am thus reopening.
Comment 5 Ernst 2009-05-25 20:35:32 UTC
Bug disappeared in Doxygen version 1.5.9!

Thanks
Ernst