Re: Executable example scripts in documentation

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

 



Richard W.M. Jones wrote:
https://bugzilla.redhat.com/show_bug.cgi?id=487527#c3

The above review is blocked because I want to include three example
scripts in the documentation, and I want them to be executable so that
people can run them without an unnecessary extra step.

rpmlint warns about this (spurious-executable-perm).  But I think rpmlint
is wrong.

There are scant guidelines about this - just one oblique reference in
a "packaging mistakes" page.  There is no convincing explanation I can
find as to why including an executable script in documentation is a
bad thing.

They sometimes pull in additional dependencies.

We also have lots of executable examples already, and quite rightly so:

find /usr/share/doc/ -perm /111 -a \! -type d

Yes, I include them in some of my own packages. Care is needed to avoid unwanted dependencies (they can be filtered out if you're aware of them, but again you need to be careful not to prune any real dependencies) but it certainly shouldn't be a review blocker.

Paul.

--
fedora-devel-list mailing list
fedora-devel-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/fedora-devel-list

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Fedora Announce]     [Fedora Kernel]     [Fedora Testing]     [Fedora Formulas]     [Fedora PHP Devel]     [Kernel Development]     [Fedora Legacy]     [Fedora Maintainers]     [Fedora Desktop]     [PAM]     [Red Hat Development]     [Gimp]     [Yosemite News]
  Powered by Linux