recommended for C++ libraries

Add a libgrokj2k1-doc package for the Doxygen generated API docs, this
has been inspired from some messages in the logs about non installed
files, e.g.:

dh_missing: warning: usr/share/doc/GROK/html/index.html exists in debian/tmp but is not installed to anywhere

Add the missing Build-Depends-Package field to
debian/libgrokj2k1.symbols as suggested by lintian:

I: libgrokj2k1: symbols-file-missing-build-depends-package-field

This is just to fix some noise when running `duck` and make it easier to
find out more useful fixes in the future.

This fixes the following notices from `duck`:

I: debian/copyright:954: URL: http://www.gnu.org/licenses/: INFORMATION (Certainty:possible)
   The web page at http://www.gnu.org/licenses/ works, but is also available via https://www.gnu.org/licenses/, please consider switching to HTTPS urls.

I: debian/copyright:933: URL: http://www.gnu.org/licenses/: INFORMATION (Certainty:possible)
   The web page at http://www.gnu.org/licenses/ works, but is also available via https://www.gnu.org/licenses/, please consider switching to HTTPS urls.

I: debian/copyright:108: URL: http://fsf.org/: INFORMATION (Certainty:possible)
   URL schema changed from HTTP to HTTPS during redirect(s): http://fsf.org -> https://www.fsf.org
   Please investigate and update the URL eventually, to avoid unneccesary redirects!

The Debian Policy states that a branch can and should specified in
Vcs-Git if the packaging bits are not in the default branch, see
https://www.debian.org/doc/debian-policy/ch-controlfields.html#version-control-system-vcs-fields

When putting options in debian/source/options the leading "--" must be
stripped.

This fixes a warning from `cme check dpkg`:

Warning: source options '--extend-diff-ignore' is confusingly close to 'extend-diff-ignore' (edit distance is 2). Is there a typo ?

Debian revisions should be stripped from versions in symbols files.

Not doing so leads to dependencies unsatisfiable by backports (1.0-1~bpo
<< 1.0-1 while 1.0-1~bpo >= 1.0).

This fixes the following lintian error:

E: libgrokj2k1: symbols-file-contains-current-version-with-debian-revision on symbol _ZNKSt13__future_base13_State_baseV221_M_is_deferred_futureEv@Base and 351 others

Add a repository-specific configuration file for git-buildpackage to
avoid having to pass options to it every time gbp is run.