Hello Marnanel,

Marnanel Thurman [2025-12-16 23:43 +0000]:
> The scour package has no man page. I have made one, based on the readme and 
> the
> output of scour --help.

Actually it does!
https://manpages.debian.org/unstable/scour/scour.1.en.html

It gets generated in debian/rules with help2man.

> *** /home/marnanel/src/scour/scour.1
> .TH scour 1 "Date: 2025/12/15 22:45:00" "Scour"
> .SH NAME
> scour \-  an SVG optimiser and cleaner
> .SH SYNOPSIS
> .TP
> \fBscour\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIinput.svg output.svg\fP
> .SH DESCRIPTION
> \fBscour\fP is an SVG optimizer/cleaner written in Python that reduces
> the size of scalable vector graphics by optimizing structure and removing 
> unnecessary data.
> 
> It can be used to create streamlined vector graphics suitable
> for web deployment, publishing/sharing or further processing.
> 
> The goal of \fBscour\fP is to output a file that renders identically at a 
> fraction of the size
> by removing a lot of redundant information created by most SVG editors. 
> Optimization
> options are typically lossless but can be tweaked for more aggressive 
> cleaning.

The description is not too different to the --help output, I think it has all
the necessary information. If you think some difference is important, it would
IMHO be better to send an upstream PR to chage the help output, and I can pull
it into the Debian package.

The options should be the same, and in fact it's better (from the distribution
point of view) to produce them from the --help output to keep it up to date.

Thanks,

Martin

Reply via email to