Discussion:
Lintian Warnings
(too old to reply)
Gunter Königsmann
2017-06-02 05:58:10 UTC
Permalink
Raw Message
Dear all,

lintian has the task of being "linty". So it outputs all kinds of
warnings that might be nothing but splitting hairs.
...but a few warnings I have found trying to generate a maxima debian
package might show places where we might improve things => Sending info
about them to the mailing list:

Files we install and that perhaps don't make too much sense in the
binary tree:
W: maxima: package-contains-vcs-control-file
usr/share/maxima/5.40.0/share/.gitattributes
W: maxima: script-not-executable
usr/share/maxima/5.40.0/doc/misc/grepforvariables.sh
W: maxima: script-not-executable
usr/share/maxima/5.40.0/doc/misc/processlisfiles.sh
W: maxima: script-not-executable
usr/share/maxima/5.40.0/share/contrib/lurkmathml/mathmltest
W: maxima: extra-license-file usr/share/maxima/5.40.0/share/logic/COPYING

An error in the manpage?
W: maxima: manpage-section-mismatch usr/share/man/man1/maxima.1.gz:1 1 != 1L

No idea: Do these standalone info files really need an dir node?
E: maxima: info-document-missing-dir-section
usr/share/info/abs_integrate.info.gz
E: maxima: info-document-missing-dir-entry
usr/share/info/abs_integrate.info.gz
E: maxima: info-document-missing-dir-section
usr/share/info/drawutils.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/drawutils.info.gz
E: maxima: info-document-missing-dir-section
usr/share/info/kovacicODE.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/kovacicODE.info.gz
E: maxima: info-document-missing-dir-section usr/share/info/logic.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/logic.info.gz

Kind regards,

Gunter.
Robert Dodier
2017-06-03 06:45:01 UTC
Permalink
Raw Message
Post by Gunter Königsmann
W: maxima: package-contains-vcs-control-file
usr/share/maxima/5.40.0/share/.gitattributes
should be excluded from packages
Post by Gunter Königsmann
W: maxima: script-not-executable
usr/share/maxima/5.40.0/doc/misc/grepforvariables.sh
W: maxima: script-not-executable
usr/share/maxima/5.40.0/doc/misc/processlisfiles.sh
should be nuked; there are probably other purpose-built scripts and
related files floating around
Post by Gunter Königsmann
W: maxima: script-not-executable
usr/share/maxima/5.40.0/share/contrib/lurkmathml/mathmltest
seems meaningful for its stated purpose (testing the share package);
could probably mark it executable to quiet warning
Post by Gunter Königsmann
W: maxima: extra-license-file usr/share/maxima/5.40.0/share/logic/COPYING
let it stand
Post by Gunter Königsmann
An error in the manpage?
W: maxima: manpage-section-mismatch usr/share/man/man1/maxima.1.gz:1 1 != 1L
change "1L" in doc/man/maxima.1.in to "1"
Post by Gunter Königsmann
No idea: Do these standalone info files really need an dir node?
E: maxima: info-document-missing-dir-section
usr/share/info/abs_integrate.info.gz
E: maxima: info-document-missing-dir-entry
usr/share/info/abs_integrate.info.gz
E: maxima: info-document-missing-dir-section
usr/share/info/drawutils.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/drawutils.info.gz
E: maxima: info-document-missing-dir-section
usr/share/info/kovacicODE.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/kovacicODE.info.gz
E: maxima: info-document-missing-dir-section usr/share/info/logic.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/logic.info.gz
Well, I gather that one needs to add @direntry stuff to the .texi in
order to quiet these warnings. It wouldn't serve any other purpose at
present, although I guess it's plausible that the dir entry could be
exploited in some way to group the pages or otherwise impose
organization, but that's speculative at this point. In any event it's
not a big deal to add @direntry.

If anyone wants to take on some of this clean up work, that would be
great. I might get around to doing it sooner or later.

best

Robert Dodier
Robert Dodier
2017-07-07 05:10:01 UTC
Permalink
Raw Message
Post by Robert Dodier
Post by Gunter Königsmann
W: maxima: package-contains-vcs-control-file
usr/share/maxima/5.40.0/share/.gitattributes
should be excluded from packages
done
Post by Robert Dodier
Post by Gunter Königsmann
W: maxima: script-not-executable
usr/share/maxima/5.40.0/doc/misc/grepforvariables.sh
W: maxima: script-not-executable
usr/share/maxima/5.40.0/doc/misc/processlisfiles.sh
should be nuked; there are probably other purpose-built scripts and
related files floating around
nuked all doc/misc
Post by Robert Dodier
Post by Gunter Königsmann
W: maxima: script-not-executable
usr/share/maxima/5.40.0/share/contrib/lurkmathml/mathmltest
seems meaningful for its stated purpose (testing the share package);
could probably mark it executable to quiet warning
marked
Post by Robert Dodier
Post by Gunter Königsmann
W: maxima: extra-license-file usr/share/maxima/5.40.0/share/logic/COPYING
let it stand
still standing
Post by Robert Dodier
Post by Gunter Königsmann
An error in the manpage?
W: maxima: manpage-section-mismatch usr/share/man/man1/maxima.1.gz:1 1 != 1L
change "1L" in doc/man/maxima.1.in to "1"
changed (I guess someone else covered this one)
Post by Robert Dodier
Post by Gunter Königsmann
No idea: Do these standalone info files really need an dir node?
E: maxima: info-document-missing-dir-section
usr/share/info/abs_integrate.info.gz
E: maxima: info-document-missing-dir-entry
usr/share/info/abs_integrate.info.gz
E: maxima: info-document-missing-dir-section
usr/share/info/drawutils.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/drawutils.info.gz
E: maxima: info-document-missing-dir-section
usr/share/info/kovacicODE.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/kovacicODE.info.gz
E: maxima: info-document-missing-dir-section usr/share/info/logic.info.gz
E: maxima: info-document-missing-dir-entry usr/share/info/logic.info.gz
order to quiet these warnings. It wouldn't serve any other purpose at
present, although I guess it's plausible that the dir entry could be
exploited in some way to group the pages or otherwise impose
organization, but that's speculative at this point. In any event it's
added @direntry/@dircategory to all that didn't have it

Thanks for pointing out these items.

best

Robert Dodier
Gunter Königsmann
2017-07-07 05:52:27 UTC
Permalink
Raw Message
Thanks a lot!

As debian has only automatic tests they tend to be picky on these things.

Will have another go at trying to make the automatic code import from
our repo to launchpad work: As soon as it is repaired we have a nightly
build there.

Kind regards,

Gunter.

Loading...