Generate a CLI manual

[jamoore]

The scripts provided by Roger for printing/parsing the CLI help texts should be moved to one of our repositories (ome.git/docs?) and included in the build:

#!/bin/bash

set -e

hlog="/tmp/help.txt"
clog="/tmp/commands.txt"
rm -f "$hlog" "$clog"

commands()
{
    if bin/omero "$@" --help >/dev/null 2>/dev/null; then
        bin/omero "$@" --help | sed -e '1,/subcommand>$/d' -e "s/^[[:space:]][[:space:]]*\([[:graph:]][[:graph:]]*\).*$/\1/"
    fi
}

help()
{
    if bin/omero "$@" --help >/dev/null 2>/dev/null; then
        cat <<EOF >>"$hlog"

-------------------------------------------------------------------------------
[ omero $@ --help ]
-------------------------------------------------------------------------------
EOF
        bin/omero $@ --help >> "$hlog"
    fi
}

dump_commands()
{
    local prefix=$1
    shift
    echo "Dumping 'bin/omero $@'"
    help "$@"
    if [ -n "$cmd" ]; then

[hflynn]

Following issues spotted during proof-reading:

• admin reindex - "Command-line tool for re-index the database" -> should be "re-indexing". Also LIMITATION bit after examples - "You will need to all passwordless login to PostgreSQL" -> this should be "call"?
• cecog - "Provides actions for prepairing data and otherwise integrating with Cecog" - assume this should be "preparing"?
• cecog merge - "Therefore need EMAN2 or PIL installed locally" -> should be "Therefore it needs…" or similar
• chgrp obj - "Objects to be processedd in the form" -> "processed"
• omero config - Should this be talking about 4.2 configuration files?
• export - "If --iterate is used used, the only…" -> remove extra "used"
• import - "If they interfere with any of the Python arguments, you may need to end precede your arguments with…" -> doesn't make sense, end or precede?
• load - "This can be used as the #! header of a file to make standand-alone script" -> "stand-alone"
• shell - "All arguments not understood vi bin/omero shell will be passed to the shell" -> "vi"? Not sure what this is in aid of, intended to be "via"? But still not sure that makes sense.

[sbesson]

See ​https://github.com/openmicroscopy/openmicroscopy/pull/3520.

bin/omero help --all --recursive

should give an exhaustive help of the CLI.