Package: release.debian.org
Severity: normal
X-Debbugs-Cc: [email protected]
Control: affects -1 + src:scour
User: [email protected]
Usertags: unblock

Please unblock package scour

Only adds a manpage (and bumps Standards-Version).

unblock scour/0.38.2-6
diffstat for scour-0.38.2 scour-0.38.2

 changelog        |   15 +++++++++++++++
 control          |    3 ++-
 manpage_snippets |   38 ++++++++++++++++++++++++++++++++++++++
 rules            |   15 ++++++++++++++-
 scour.manpages   |    1 +
 5 files changed, 70 insertions(+), 2 deletions(-)

diff -Nru scour-0.38.2/debian/changelog scour-0.38.2/debian/changelog
--- scour-0.38.2/debian/changelog       2024-10-10 13:31:44.000000000 +0300
+++ scour-0.38.2/debian/changelog       2025-05-18 11:26:17.000000000 +0300
@@ -1,3 +1,18 @@
+scour (0.38.2-6) unstable; urgency=medium
+
+  [ Enkelena Haxhija ]
+  * Add man page for scour assembled from help2man, enriched with custom
+    snippets mostly from the upstream README.  The man page is auto-generated
+    via help2man, and the typo-in-manual-page lintian warning on "agressive ->
+    aggressive" comes from the program's --help output which is
+    programmatically converted. This will be fixed in the next upstream
+    release: https://github.com/scour-project/scour/pull/284/
+
+  [ Martin Pitt ]
+  * Bump Standards-Version to 4.7.2.  No changes necessary.
+
+ -- Martin Pitt <[email protected]>  Sun, 18 May 2025 08:26:17 +0000
+
 scour (0.38.2-5) unstable; urgency=medium
 
   * Bump Standards-Version to 4.7.0. No changes necessary.
diff -Nru scour-0.38.2/debian/control scour-0.38.2/debian/control
--- scour-0.38.2/debian/control 2024-10-10 13:25:55.000000000 +0300
+++ scour-0.38.2/debian/control 2025-05-18 11:25:54.000000000 +0300
@@ -4,10 +4,11 @@
 Maintainer: Martin Pitt <[email protected]>
 Build-Depends: debhelper-compat (= 13),
  dh-sequence-python3,
+ help2man,
  python3-all,
  python3-setuptools,
 Build-Depends-Indep: perl
-Standards-Version: 4.7.0
+Standards-Version: 4.7.2
 Homepage: https://github.com/codedread/scour
 Vcs-Git: https://salsa.debian.org/debian/scour.git
 Vcs-Browser: https://salsa.debian.org/debian/scour
diff -Nru scour-0.38.2/debian/manpage_snippets 
scour-0.38.2/debian/manpage_snippets
--- scour-0.38.2/debian/manpage_snippets        1970-01-01 02:00:00.000000000 
+0200
+++ scour-0.38.2/debian/manpage_snippets        2025-05-18 11:25:35.000000000 
+0300
@@ -0,0 +1,38 @@
+[DESCRIPTION]
+Scour is an SVG optimizer/cleaner that reduces the size of scalable vector 
graphics by optimizing structure and removing unnecessary data.
+.PP
+The goal of Scour is to output a file that renderes identically at a fraction 
of the size by removing a lot of redundant information created by most SVG 
editors.
+.PP
+Optimization options are typically lossless but can be tweaked for more 
agressive cleaning.
+
+[EXAMPLES]
+.PP
+Standard:
+.IP
+\fBscour -i input.svg -o output.svg\fR
+.PP
+For better compatibility with web browsers:
+.IP
+\fBscour -i input.svg -o output.svg --enable-viewboxing\fR
+.PP
+Maximum scrubbing:
+.IP
+\fBscour -i input.svg -o output.svg --enable-viewboxing --enable-id-stripping 
\[rs]
+  --enable-comment-stripping --shorten-ids --indent=none\fR
+.PP
+Maximum scrubbing and a compressed SVGZ file:
+.IP
+\fBscour -i input.svg -o output.svgz --enable-viewboxing --enable-id-stripping 
\[rs]
+  --enable-comment-stripping --shorten-ids --indent=none\fR
+.fi
+
+[COPYRIGHT]
+Jeff Schiller, Louis Simard, 2010
+
+.SH "MAN PAGE"
+Enkelena Haxhija (EnkelenaH) has produced this man page from the upstream 
README
+and the --help output for Debian with the help of
+.BR pandoc (1)
+and
+.BR help2man (1).
+The latter is executed at build time so --help output and this man page should 
stay consistent.
diff -Nru scour-0.38.2/debian/rules scour-0.38.2/debian/rules
--- scour-0.38.2/debian/rules   2024-01-08 10:51:41.000000000 +0200
+++ scour-0.38.2/debian/rules   2025-05-18 11:25:35.000000000 +0300
@@ -4,11 +4,24 @@
        dh $@ --buildsystem=pybuild
 
 execute_before_dh_auto_clean:
-       rm -f debian/dh_scour.1
+       rm -f debian/dh_scour.1 debian/scour.1
 
 execute_after_dh_auto_build:
        pod2man debian/dh_scour debian/dh_scour.1
 
+execute_before_dh_installman:
+       PYTHONPATH="." \
+       help2man --no-info \
+               --include debian/manpage_snippets \
+               --output debian/scour.1  \
+               --no-discard-stderr \
+               --name "Optimize and clean SVG files" \
+               "debian/scour/usr/bin/scour"
+       # Remove version line from --help output and the Copyright
+       # statement that we reproduce via debian/manpage_snippets
+       # in the correct section
+       sed -i "/^scour [0-9]/d; /^Copyright Jeff/d" debian/scour.1
+
 execute_after_dh_auto_test:
        for p in $$(py3versions -s); do \
          echo "Running tests with $$p..."; \
diff -Nru scour-0.38.2/debian/scour.manpages scour-0.38.2/debian/scour.manpages
--- scour-0.38.2/debian/scour.manpages  2020-11-26 11:37:07.000000000 +0200
+++ scour-0.38.2/debian/scour.manpages  2025-05-18 11:25:35.000000000 +0300
@@ -1 +1,2 @@
 debian/dh_scour.1
+debian/scour.1

Reply via email to