On Tue, Dec 27, 2016 at 09:14:25AM +0000, lumin wrote: > On Tue, 2016-12-27 at 05:10 +0100, Adam Borowski wrote: > > > > I'm afraid that the -dev package installs a lot of cruft to /usr/share/doc/, > > this includes all the sources and test cases for the testsuite, instructions > > how to run the testsuite, and so on. > > > > That place is meant for user documentation, or possibly examples. > > Thank you for reviewing the package. Initially I was thinking of the > convenience of shipping the docs in the -dev package but the fact shows > the docs are somewhat mess...
There's nothing wrong with shipping docs in -dev if they don't take too much space, or break other considerations (such as multiarch). And here you hardly have any actual docs: besides "NEWS" (a changelog) there's a "README" that describes some performance notes and (irrelevant for a compiled package) build instructions, and "Understanding_Hash_Functions" (some generic design talk). > I've split up those docs and examples into a separate package > farmhash-doc, and uploaded the latest version to mentors: I don't see why you would do that...? What I meant is that you install a lot of cruft that doesn't appear to be user docs at all: testsuite sources, testsuite test cases, a warning about required syntax for the testsuite, that's it. Nothing that's of any use to someone who wants to use the library in his own programs rather than to make changes in the library itself -- ie, stuff that's pointless outside a source package. Thus sorry if you misunderstood me, but I did not request a split, but questioned inclusion of stuff in the docs directory (and now package). On the other hand, I see no end-user docs, although the installed .h is moderately easy to read. Meow! -- Autotools hint: to do a zx-spectrum build on a pdp11 host, type: ./configure --host=zx-spectrum --build=pdp11
