Fortran-FOSS-Programmers / ford

Automatically generates FORtran Documentation from comments within the code.
https://forddocs.readthedocs.io
GNU General Public License v3.0
405 stars 131 forks source link

Three potential issues with version 7.0 #575

Closed zoziha closed 10 months ago

zoziha commented 10 months ago

It's good to see that FORD has released version 7.0, I did my first try and found three issues:

  1. Page Code blocks do not have a background color, making it difficult to distinguish between the code block and the body. image

  2. When the Page code block is too wide, the style changes: the overall style appears to be shifted down. image Ford-0.6 style: image

  3. Count the source file 1 time repeatedly. image

Examples of specific projects can be found at repo: ford-bugs.

ZedThree commented 10 months ago

Thanks for the bug report with a nice clear reproducer @zoziha, it's very much appreciated!

Oddly, I don't see the repeated source files, but instead the Source Files tab doesn't work at all :frowning_face:

ZedThree commented 10 months ago

I can't reproduce the repeated source file. Please could you check that you don't have something like a temporary file that's getting picked up?

zoziha commented 10 months ago

@ZedThree Maybe it has something to do with the fact that I'm using Windows OS, I'm getting 2x source file counts with Ford-v7.0 on both Windows computers, and there are people in Fortran Discourse who have had similar experiences. The ford-bugs repository is all the files, there should be no extra temp files?

ZedThree commented 10 months ago

Ah, I think this is because Windows filesystems are (by default) case insensitive, so when we get a list of files, the upper/lower case extensions (with/without preprocessor for gfortran on Linux) match the same files. I think it should be sufficient to change a list to a set