1. Forum
  2. Usenet
  3. LINUX.DEBIAN.BUGS.DIST

  • Bug#1069705: lilypond man-page has defective link on Debian

    From Christoph Brinkhaus@21:1/5 to All on Tue Apr 23 09:10:01 2024
    Source: lilypond
    Version: 2.24.1-2
    Severity: minor
    X-Debbugs-Cc: bug-lilypond@gnu.org

    Dear Maintainer,

    on https://manpages.debian.org/testing/lilypond/abc2ly.1.en.html is a
    reference to the abc standard applicable for this software. The related sentence is

    "abc2ly converts ABC music files (see
    http://abcnotation.com/abc2mtex/abc.txt) to LilyPond input."

    The correct link is "http://abcnotation.com/abc2mtex/abc.txt" which
    leads the reader to a wiki page and a text file.

    On Debian the link is "http://abcnotation.com/abc2mtex/abc.txt)". I felt
    free to check the Arch man-page where the link is correct. Therefore I
    guess that this little issue is related to Debian and not to LilyPond.
    On Debian the link is incorrect for different languages and not just
    English.

    Using a browser it is almost no effort to remove the trailing ")" but a
    correct link sould be better. Please fix the issue in one of the next
    updates.

    Thank you very much for taking care of the project,
    Christoph Brinkhaus

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Werner LEMBERG@21:1/5 to All on Tue Apr 23 10:30:01 2024
    on https://manpages.debian.org/testing/lilypond/abc2ly.1.en.html is a reference to the abc standard applicable for this software. The related sentence is

    "abc2ly converts ABC music files (see http://abcnotation.com/abc2mtex/abc.txt) to LilyPond input."

    The correct link is "http://abcnotation.com/abc2mtex/abc.txt" which
    leads the reader to a wiki page and a text file.

    `abc2ly`'s man page of LilyPond's development version gets created
    with `help2man` version 1.47.4, which gives

    ```
    abc2ly converts ABC music files
    (see https://abcnotation.com/standard/abc_v1.6.txt) to LilyPond input.
    ```

    On Debian the link is "http://abcnotation.com/abc2mtex/abc.txt)".

    I guess that the Debian people use another version of `help2man` that
    tries to convert URLs like the above to real hyperlinks, and that this
    version uses a regular expression that accepts `(` and `)` as part of
    URLs. While this is technically correct, it might fail for situations
    like the one under discussion where a human reader can easily deduce
    that the final, closing parenthesis is actually *not* part of the URL.

    Anyway, I've fixed this in LilyPond's git repository.

    https://gitlab.com/lilypond/lilypond/-/merge_requests/2309


    Werner

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)