Sign me up Login

Details about package trurl

Name: trurl (PTS)
Uploader: Michael Ablassmeier <abi@debian.org> (Debian QA page)
Description: trurl - command line tool for URL parsing and manipulation

Package uploads

Upload #1

Information

Version: 0.15-1
Uploaded: 2024-08-28 08:24
Source package: trurl_0.15-1.dsc
Distribution: unstable
Section: web
Priority: optional
Homepage: https://github.com/curl/trurl
Vcs-Browser: https://salsa.debian.org/debian/trurl
Vcs-Git: https://salsa.debian.org/debian/trurl.git

Changelog

 trurl (0.15-1) unstable; urgency=medium
 .
   * New upstream version 0.15
   * Add debian/patches/manpage: ship manpage in nroff format

QA information

Comments

  1. Issues related to the manpage really would be better being resolved.
    
    W: trurl: groff-message troff:<standard input>:233: warning: macro '\' not defined [usr/share/man/man1/trurl.1.gz:1]
    N: 
    N:   A manual page provoked warnings or errors from the man program. Here are
    N:   some common ones:
    N:   
    N:   "cannot adjust" or "can't break" are issues with paragraph filling. They
    N:   are usually related to long lines. Justifying text on the left hand side
    N:   can help with adjustments. Hyphenation can help with breaks.
    N:   
    N:   For more information, please see "Manipulating Filling and Adjusting" and
    N:   "Manipulating Hyphenation" in the Groff manual (see info groff).
    N:   
    N:   "can't find numbered character" usually means that the input was in a
    N:   national legacy encoding. The warning means that some characters were
    N:   dropped. Please use escapes such as \[:a] as described on the groff_char
    N:   manual page.
    N:   
    N:   Other common warnings are formatting typos. String arguments to .IP
    N:   require quotes. Usually, some text is lost or mangled. See the groff_man
    N:   (or groff_mdoc if using mdoc) manual page for details on macros.
    N:   
    N:   The check for manual pages uses the --warnings option to man to catch
    N:   common problems, like a . or a ' at the beginning of a line as literal
    N:   text. They are interpreted as Groff commands. Just reformat the paragraph
    N:   so the characters are not at the beginning of a line. You can also add a
    N:   zero-width space (\&) in front of them.
    N:   
    N:   Aside from overrides, warnings can be disabled with the .warn directive.
    N:   Please see "Debugging" in the Groff manual.
    N:   
    N:   You can see the warnings yourself by running the command used by Lintian:
    N:   
    N:       LC_ALL=C.UTF-8 MANROFFSEQ='' MANWIDTH=80 \
    N:           man --warnings -E UTF-8 -l -Tutf8 -Z <file> >/dev/null
    N: 
    N:   Please refer to the groff_man(7) manual page and the groff_mdoc(7) manual
    N:   page for details.
    N: 
    N:   Visibility: warning
    N:   Show-Always: no
    N:   Check: documentation/manual
    N:   Renamed from: manpage-has-errors-from-man
    N: 
    N:
    W: trurl: wrong-manual-section 1 != 0.15 [usr/share/man/man1/trurl.1.gz:2]
    N: 
    N:   A manual page usually should contain a .TH header, specifying the section.
    N:   The section in this manual page doesn't match with the section in the
    N:   filename.
    N: 
    N:   Please refer to the groff_man(7) manual page and the man(1) manual page
    N:   for details.
    N: 
    N:   Visibility: warning
    N:   Show-Always: no
    N:   Check: documentation/manual
    N:   Renamed from: manpage-section-mismatch
    N: 
    N:
    I: trurl source: patch-not-forwarded-upstream [debian/patches/manpage]
    N: 
    N:   According to the DEP-3 headers, this patch has not been forwarded
    N:   upstream.
    N:   
    N:   Please forward the patch and try to have it included in upstream's version
    N:   control system. If the patch is not suitable for that, please mention
    N:   not-needed in the Forwarded field of the patch header.
    N: 
    N:   Please refer to social contract item 2, Coordination with upstream
    N:   developers (Section 3.1.4) in the Debian Developer's Reference, Changes to
    N:   the upstream sources (Section 4.3) in the Debian Policy Manual, and
    N:   Bug#755153 for details.
    N: 
    N:   Visibility: info
    N:   Show-Always: no
    N:   Check: debian/patches/dep3
    N:   Renamed from: send-patch
    Needs work Phil Wyett at Aug. 29, 2024, 5:33 p.m.
  2. yes, upstream has removed manpage from the source tarball at all bcs they auto generate it from MD file format. Unfortunately the tool to generate the manpage is in the curl source repository only and not part of debian. This is discussed upstream and the current patch is just a workaround to be able to ship an actual manpage at all. This will be fixed upstream with the next release.
    Michael Ablassmeier at Aug. 29, 2024, 5:57 p.m.