Command-line arguments

written by Ben Harrison


The usage for Angband on Unix systems is:

    Usage: angband [options] [-- subopts]
      -n       Start a new character
      -f       Request fiddle mode
      -w       Request wizard mode
      -v       Request sound mode
      -g       Request graphics mode
      -o       Request original keyset
      -r       Request rogue-like keyset
      -s<num>  Show <num> high scores
      -u<who>  Use your <who> savefile
      -m<sys>  Force 'main-<sys>.c' usage
      -d<def>  Define a 'lib' dir sub-path

Note that "-mx11" requests the use of the "main-x11.c" file.

Note that "--" is required before any subopts.

Note that "-n 1" is a "subopt" for the "main-x11.c" file
(but not for any other files that I know of), which requests
the use of "1" window.


So the following invocations will do the following things:

    angband

        run angband using some reasonable "main-xxx.c" file.

    angband -n

        run angband using some reasonable "main-xxx.c" file,
        starting a new character.

    angband -- -n 1

        run angband using some reasonable "main-xxx.c" file,
        using one window if "main-x11.c" is used.

    angband -n -- -n 1

        run angband using some reasonable "main-xxx.c" file,
        starting a new character,
        using one window (if "main-x11.c" is used).

    angband -mx11

        run angband using "main-x11.c" file.

    angband -n -mx11

        run angband using "main-x11.c" file,
        starting a new character.

    angband -mx11 -- -n 1
        run angband using "main-x11.c" file,
        using one window.

    angband -n -mx11 -- -n 1
        run angband using "main-x11.c" file,
        starting a new character,
        using one window.

    angband -n 1

        give a usage message (bad option "1").

    angband -mx11 -n 1

        give usage message.

    angband -n -mx11 -n 1

        give usage message.