Hi Guido,
TL;DR: Most stuff is fine, but for an upload, I'd like to have at least
debian/copright to be streamlined. Fixes for the remaining remarks are
of course appreciated, too. Details see below.
(And if you don't mind that it there will be a slightly different
package in Debian than on SourceForge, I'd prefer that package to have
the version 1.0.6-1, too.)
On Sun, Jun 08, 2014 at 11:21:03AM +0200, Guido van Steen wrote:
> I have just uploaded a new version of Fizsh to Sourceforge. This is version
> 1.0.6. I have also uploaded the corresponding Debian source package to
> Debian Mentors. This package is availabe at
> http://mentors.debian.net/debian/pool/main/f/fizsh
>
> Could you please review the package? I looking forward to reading your
> review.
So far I noticed the following things:
debian/copyright:
* The licenses "BSD-3-clause~zsh-history-substring-search-contributors",
"BSD-3-clause~fizsh" and
"BSD-3-clause~zsh-syntax-highlighting-contributors" seem to be
identical word-wise. In that case the license only needs to be
spelled out respectively defined once.
Of course they differ in the copyright holders, but those are
already listed in the "Files:" starting paragraphs and should only
be listed there.
* The "License:" starting paragraphs only define the license text and
do not need verbatim formatting. They should be word-wrapped if
lines are longer than 80 columns. Comments signs from licenses
copied from source code headers can and should be dropped.
debian/README: This file should be probably better named
debian/README.source.
debian/rules:
* lintian warning script-not-executable
# the scripts in the "./scripts/" directory of the source package are
# copied to both "./debian/usr/bin/" and "./debian/etc/fizsh/". they
# are also copied to "./debian/fizsh/usr/share/fizsh/", but they are
# not meant to be copied there. moreover they end up there without the
# executable bit, which causes lintian to complain about
# "script-not-executable". therefore they are explicitly removed after
# dh_install.
While it is good to not have the files in the package twice, this
maybe a case where it may have been better to override the lintian
warning as the files are meant to be sourced (if it works without
them being executables). This not seldom with shell-related
packages.
So just decided if you want them user-modifiable or not and put them
in either /etc/fizsh or /usr/share/fizsh and override the above
mentioned lintian warning.
Another way to get rid of that lintian warning would be to remove the
shebang lines from those scripts. They're not needed anyway if the
scripts are just sourced.
* A general remark on lines like the following:
[ -d foo ] && rm -rf foo || true
Just using "rm -rf foo" should suffice and is easier to read:
* If the directory doesn't exist, it does nothing
* It does exit with return code 0 even if the file does not exist.
* Warnings from configure:
# without the following override the ./configure script would be called with two
# unrecognized options: --disable-maintainer-mode, --disable-dependency-tracking
override_dh_auto_configure:
./configure \
--prefix=/usr \
--includedir=\${prefix}/include \
--mandir=\${prefix}/share/man \
--infodir=\${prefix}/share/info \
--sysconfdir=/etc \
--localstatedir=/var
I think those warnings can be safely ignored and hence the override
could be dropped. I'm though fine if you are annoyed by the warnings
and prefer to keep the override. (I'd be rather annoyed by such a
long override. :-)
debian/changelog:
* While it is acceptable, I find the style with a blank line between
each item hard to read.
* I'd also indent any line not starting wit "*" by two blanks.
debian/watch and .sig files:
* The .sig files mentioned in the context of pgpsigurlmangle are meant
to be signature files, not public key files as on [1]. See the
documentation for "gpg --sign" for details. The public key file goes
into debian/upstream/signing-key.asc as done correctly with the
package.
[1] http://sourceforge.net/projects/fizsh/files/
I'd be nice if you could fix that at "upstream".
Feel free to ask if my explanations weren't clear enough or too short.
To not only mention negative stuff I noticed, I was also positively
surprised that the package is indeed lintian clean, even with
--pedantic and --experimental!
Yay! :-)
Regards, Axel
--
,''`. | Axel Beckert <abe@debian.org>, http://people.debian.org/~abe/
: :' : | Debian Developer, ftp.ch.debian.org Admin
`. `' | 1024D: F067 EA27 26B9 C3FC 1486 202E C09E 1D89 9593 0EDE
`- | 4096R: 2517 B724 C5F6 CA99 5329 6E61 2FF9 CD59 6126 16B5