name: irma - The Information Retreival Middleware something-with-a
section: 1
arguments:
  - name: CONFIG_FILE
    optional: true
    moreThanOnce: true

description: |
  IRMa starts a small HTTP-server that will host a IR REST-API plus any static
  assets you provide.
  It is configured by giving it an arbitrary number of configuration files.
  The settings in these files will be merged; if there are conflicting settings,
  precedence is given to the setting encountered *first*.
  In addition, you can override some settings via command-line optoins.

options:
  - short: h
    long: help
    description: |
      Display a short help message.
  - short: m
    long: manpage
    description: |
      Create a manual page.
  - short: l
    long: listen
    argument: "address:port"
    description: |
      The address on which the server will listen. (Default: `localhost:9999`)
  - short: e
    long: es-host
    argument: "hostname:port"
    description: |
      The ElasticSearch node to connect to. (Default: `localhost:9200`)
  - short: i
    long: es-index
    argument: "name"
    description: |
      The ElasticSearch index name to use. (Default: `app-test`)
  - short: T
    long: config-types
    argument: directory
    description: |
      The files in the given directory will be loaded as via `require` and
      made available as additional types in the configuration files.
      Can be given multiple times. In case of conflicting names, the type
      encountered *first* will be used.
  - short: S
    long: install
    description: |
      Wrap up the current configuration and install it as a system service.

  - short: U
    long: uninstall
    description: |
      Uninstall a service previously created from this configuration