phmarek / fsvs

Full System Versioning System
GNU General Public License v3.0
6 stars 3 forks source link

Duplicate anchors #11

Closed albert-github closed 1 year ago

albert-github commented 1 year ago

When running a link checker we get the warnings:

Processing      file:///.../doxygen/html/group__Entries.html

List of duplicate and empty anchors
        fsvsS_constants Lines: 129, 774
        ChgFlag Lines: 122, 225
        EntFlags        Lines: 84, 718

By introducing proper labels this can be prevented.

phmarek commented 1 year ago

Thanks a lot for all your work!

Please try a complete compile cycle; the static character arrays for command-line help output in doc.g-c (generated from the Doxygen results) don't match the command table names any more; and the text files look a bit strange as well:

Eg. doc/fsvs-howto-backup.5:

-HOWTO: Backup \- 
+howto_backup \- HOWTO: Backup

The manual page (man -l doc/fsvs-howto-backup.5) looks like this:

NAME
       howto_backup - HOWTO: Backup

        - This document is a step-by-step explanation how to do backups using FSVS.

SYNOPSIS
Detailed Description
       This document is a step-by-step explanation how to do backups using FSVS.

The duplicated NAME, the dash in the next line, SYNOPSIS and immediately Detailed Description... might all be doxygen stuff in the newer versions, but perhaps there's an easy way to clean that up?

Thanks!

albert-github commented 1 year ago

Best is to create separate issues for the above mentioned problems (like I did for the question about " Non reachable link generated" i.e. #10 ) so it is better recorded and not lost in a closed merge request.

(I realize I should actually create 2 issues as well for:

albert-github commented 1 year ago

It would also be useful to have the man and html pages as they were distributed with the old version.

phmarek commented 1 year ago

The documentation is available in git, so that the build process doesn't need doxygen installed.

So you can just look at the differences via "git diff".