On Aug 17, 2010, at 11:39 AM, Jonas Smedegaard wrote:

On Tue, Aug 17, 2010 at 05:16:09PM +0200, Reinhard Tartler wrote:
On Tue, Aug 17, 2010 at 15:35:10 (CEST), Hans-Christoph Steiner wrote:
README.txt and LICENSE.txt are part of the Pd library format. They are part of the library, and the Help Browser (aka the library browser) looks for them to display them. The library format is basically a directory with files in it, and a subdir called 'examples'. That install target actually serves to enforce that all the standard files are there.

In this library, I could replace the file with a symlink to ../../../ common-licenses/GPL-2, but other libraries might have different licenses so this wouldn't always be the case.

I guess that both the license and the README.txt actually belongs to /usr/share/doc/$package, that's what debian policy tells us to do. IIRC, documentation browsers like dhelp and the default webserver's configurations publish /usr/share/doc so that users can browse package documentation.

So moving these files and symlink them to where the package expect them seems to me the right thing to do.

This is wrong, actually:

Code must not depend on /usr/share/doc existing on the machine, so when a file is needed both by runtime and below /usr/share/doc then the actual file should be placed elsewhere and a symlink be placed below /usr/share/doc.

Not sure if this is explicitly clarified in Debian Policy or only a result of close-reading FHS (File Hierarchy Standard) or some such. Perhaps look for sections regarding example scripts.

In this context, I think the above suggestion makes the most sense. So here's my plan:

- make the LICENSE.txt file into a symlink, if GPL, BSD or other common license - make usr/share/doc/pd-motex/README.txt a symlink to the one in the library

I'd need to remove LICENSE.txt then make the symllnk. What's the best way to remove the file? I could patch the Makefile to remove the line in 'make install' that installs LICENSE.txt the add a link in debian/ links. Is there some easy/proper way in debhelper to just remove an installed file?



"Making boring techno music is really easy with modern tools, but with live coding, boring techno is much harder." - Chris McCormick

pkg-multimedia-maintainers mailing list

Reply via email to