Bug#849387: RFS: farmhash/0~20161014-g92e897b-1 [ITP]
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
Reply to: