[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1110168: unblock: scour/0.38.2-6



Package: release.debian.org
Severity: normal
X-Debbugs-Cc: scour@packages.debian.org
Control: affects -1 + src:scour
User: release.debian.org@packages.debian.org
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 <mpitt@debian.org>  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 <mpitt@debian.org>
 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 to: