New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

File List is confused when SHOW_FILES option is disabled (Origin: bugzilla #675036) #4689

Closed
doxygen opened this Issue Jul 2, 2018 · 0 comments

Comments

Projects
None yet
1 participant
@doxygen
Owner

doxygen commented Jul 2, 2018

status RESOLVED severity normal in component general for ---
Reported in version 1.8.0 on platform Other
Assigned to: Dimitri van Heesch

On 2012-04-28 18:57:02 +0000, Adam Gabry� wrote:

Hello,
I think File List is confused when SHOW_FILES option is disabled. We can collapse and uncollapse file list, but we cannot click any file. To see anything we must first click on "File List" and next choose file (click [code]). I think it will be better when user can see code, when he/she click on it name.
I upload sample documentation on my website: http://www.adam.gabrys.biz/v/2012-04-28/doxygen/file-list/

On 2012-05-03 18:47:32 +0000, Dimitri van Heesch wrote:

Confirmed. Should already be fixed in the current subversion snapshot.

On 2012-05-19 12:27:09 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.1. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.

On 2012-05-20 16:18:50 +0000, Adam Gabry� wrote:

I think that doxygen v1.8.1 generates documentation, which confuses user when SHOW_USED_FILES=YES and SHOW_FILES=NO.

I upload sample documentation on my website:
http://www.adam.gabrys.biz/v/2012-05-20/doxygen/file-list/

Example:
User open Parent class (http://www.adam.gabrys.biz/v/2012-05-20/doxygen/file-list/apidocs/html/class_parent.html) and next click URL "Parent.js" (http://www.adam.gabrys.biz/v/2012-05-20/doxygen/file-list/apidocs/html/_parent_8js_source.html). Why menu is empty?

I think the better solution for this problem would be to add links to files name in the list. I modified files.js from previous documentation (2012-04-28): http://www.adam.gabrys.biz/v/2012-05-20/doxygen/file-list/apidocs-better/html/files.html. You can click on file name in the list and go to the file.

Changes from:
var files =
[
[ "Child.js", null, null ],
[ "MyLib.js", null, null ],
[ "Parent.js", null, null ]
];
to:
var files =
[
[ "Child.js", "_child_8js_source.html", null ],
[ "MyLib.js", "_my_lib_8js_source.html", null ],
[ "Parent.js", "_parent_8js_source.html", null ]
];

On 2012-05-26 09:40:27 +0000, Dimitri van Heesch wrote:

Hi Adam,

I agree that the navigation tree should not become empty (that's a bug), but your solution is also not what you want if you set SHOW_FILES=NO, because doxygen would still show files like it does when SHOW_FILES=YES. I'll make doxygen just shown the root node with its direct children expanded in this case.

On 2012-06-10 09:41:53 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.1.1. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.

@doxygen doxygen closed this Jul 2, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment