Commit e8c0be1ce9 changed the name
of the configuration environment to build the jack-example-tools,
but forgot to change it for man pages.

While there, also improve the short description of this option in the
OSS backend part of usage help and jack_control.

wscript:
Add option `--example-tools` to allow optional build of executables and
libraries provided by jack-example-tools (defaults to True).
It can be used as `--example-tools=yes|no` or `--no-example-tools` or
plain `--example-tools`.
Based on the new option, set the configuration environment variable
`HAVE_JACK_EXAMPLE_TOOLS` which is used throughout the configuration
and build steps to include the `example-clients`, `tools` and `tests`
subdirectories.

man/wscript:
Provide the `HAVE_JACK_EXAMPLE_TOOLS` build environment variable to the
`fill_template` script as second argument.
Remove unused imports.

man/fill_template:
Change the behavior of the script to only create all man pages if the
second argument to the script is `True` (the jack-example-tools are
being built), else only create the man page for jackd.

Found via `codespell -q 3`

The FreeBoB project was renamed to FFADO in 2007.
All users should use the FFADO backend by now (2019).

Backend name to be removed: "freebob"
Alternative backend to use: "firewire"

Please check the jackd manpage for details about "firewire" backend.

This commit is part of legacy cleanup.

closes issue #365.

Fixes #410

It is in the --help but not in the man page.

* update manpage: add Firewire backend options

additions:
-firewire backend options
-note about JACK name
-links to JACK github page, mailinglist, ffado.org
-manpage author
-note about how to create pdf from manpage

removals:
-dead/unavailable links

formatting:
-remove double spaces after '.'
-all urls are bold, enclosed in <>, ending with / if it's not a file
-(non-printable) empty lines between sections for better overview

other:
-partial rewording of main paragraph. misc small changes (see diff).

* typo

* use ',' everywhere to list short/long options

* Unify indication of default values.

* More backend unification (remove 'specify ..')

* -1 typo

Flagged by the Debian QA tool.

Mostly automatic search-n-replace of the mistakes flagged.

Thanks to Timo Wischer for the initial work

this enables making reproducible builds of this package

Signed-off-by: Olaf Hering <olaf@aepfle.de>

waf complains about missing source files, e.g.:

   could not find 'jack/*.h' in /home/adi/jack2/common

ant_glob fixes the problem

misc is no longer available, but luckily, we don't need it.

git-svn-id: http://subversion.jackaudio.org/jack/jack2/trunk/jackmp@4521 0c269be4-1314-0410-8aa9-9f06e86f4224

git-svn-id: http://subversion.jackaudio.org/jack/jack2/trunk/jackmp@4333 0c269be4-1314-0410-8aa9-9f06e86f4224

git-svn-id: http://subversion.jackaudio.org/jack/jack2/branches/libjacknet@4181 0c269be4-1314-0410-8aa9-9f06e86f4224

git-svn-id: http://subversion.jackaudio.org/jack/jack2/trunk/jackmp@4163 0c269be4-1314-0410-8aa9-9f06e86f4224

git-svn-id: http://subversion.jackaudio.org/jack/jack2/branches/libjacknet@4042 0c269be4-1314-0410-8aa9-9f06e86f4224

git-svn-id: http://subversion.jackaudio.org/jack/jack2/trunk/jackmp@4014 0c269be4-1314-0410-8aa9-9f06e86f4224