Bug#799915: libghc-hledger-dev: please document the best way to get hold of extra/

[Philip Hands]

Package: libghc-hledger-dev
Version: 0.26-1
Severity: wishlist

Dear Maintainer,

I note that a script that seems quite useful (hledger-equity.hs) is only
available in the git source under the extra directory.

I think it would be helpful to point this out in a README, saying that
if one wants the contents of extra/ it needs to be cloned with git,
and that one will need to install libghc-hledger-dev for Hledger.Cli

Perhaps even better would be to put this directory under, e.g.:

  /usr/share/doc/hledger/extra

but I'd understand why that might not seem right, given that upstream
seems to strip this out of the released tarball, despite it being in
the tagged commit for the release in git.

I've reported this against the library package, since that's needed
to run the scripts, but I actually think that if you're going to add a
README section it would be more helpful if it were in the hledger package.

Cheers, Phil.

-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable'), (500, 'oldstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 4.0.0-2-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages libghc-hledger-dev depends on:
ii  ghc [libghc-time-dev-1.5.0.1-962ac]                               7.10.2-2
ii  libc6                                                             2.19-19
ii  libghc-base-compat-dev [libghc-base-compat-dev-0.8.2-01607]       0.8.2-1
pn  libghc-base-dev-4.8.1.0-4f720                                     <none>
ii  libghc-cmdargs-dev [libghc-cmdargs-dev-0.10.13-c7393]             0.10.13-3
pn  libghc-containers-dev-0.5.6.2-7a88d                               <none>
ii  libghc-csv-dev [libghc-csv-dev-0.1.2-8fc72]                       0.1.2-8
pn  libghc-directory-dev-1.2.2.0-4c0f5                                <none>
pn  libghc-filepath-dev-1.4.0.0-8fee9                                 <none>
pn  libghc-haskeline-dev-0.7.2.1-0a475                                <none>
ii  libghc-hledger-lib-dev [libghc-hledger-lib-dev-0.26-58adf]        0.26-2
ii  libghc-hunit-dev [libghc-hunit-dev-1.2.5.2-1e21f]                 1.2.5.2-4
ii  libghc-mtl-compat-dev [libghc-mtl-compat-dev-0.2.1.3-3ca5c]       0.2.1.3-2
ii  libghc-mtl-dev [libghc-mtl-dev-2.2.1-5cf33]                       2.2.1-1
ii  libghc-old-time-dev [libghc-old-time-dev-1.1.0.3-81c58]           1.1.0.3-1
ii  libghc-parsec3-dev [libghc-parsec-dev-3.1.9-5921a]                3.1.9-3
ii  libghc-pretty-show-dev [libghc-pretty-show-dev-1.6.8.2-dbdf5]     1.6.8.2-3
pn  libghc-process-dev-1.2.3.0-d24d9                                  <none>
ii  libghc-regex-tdfa-dev [libghc-regex-tdfa-dev-1.2.0-f714a]         1.2.0-5
ii  libghc-safe-dev [libghc-safe-dev-0.3.9-fba01]                     0.3.9-2
ii  libghc-shakespeare-dev [libghc-shakespeare-dev-2.0.5-11c37]       2.0.5-2
ii  libghc-split-dev [libghc-split-dev-0.2.2-bdc18]                   0.2.2-4
ii  libghc-tabular-dev [libghc-tabular-dev-0.2.2.7-098fb]             0.2.2.7-3
pn  libghc-terminfo-dev-0.4.0.1-c72a7                                 <none>
ii  libghc-text-dev [libghc-text-dev-1.2.1.3-cebfc]                   1.2.1.3-1
ii  libghc-unordered-containers-dev [libghc-unordered-containers-dev  0.2.5.1-3
ii  libghc-utf8-string-dev [libghc-utf8-string-dev-1-4aa0f]           1-2
ii  libghc-wizards-dev [libghc-wizards-dev-1.0.2-6ec24]               1.0.2-3

libghc-hledger-dev recommends no packages.

Versions of packages libghc-hledger-dev suggests:
pn  libghc-hledger-doc   <none>
pn  libghc-hledger-prof  <none>

-- no debconf information