!-----------------------------------------------------------------------
! Display the Gildas programs usage, i.e. describe options and
! some trick for the call.
!-----------------------------------------------------------------------

say "Usage: "'sic%program'" [OPTIONS] [COMMAND-LINE]"
say ""
say "Options:"
say "  -nw: No Window"
say "    Disable the X window and GUI menus for the whole session."
say "    For a permanent effect, put the line  ""SIC_WINDOW NO""  in"
say "    ~/.gag.dico"
say "  -niw: No Initial Window"
say "    Disable the X window and GUI menus at startup.  They  can"
say "    be opened later on with the commands DEVICE (e.g.  DEVICE"
say "    IMAGE WHITE) and ""@ menu"" respectively. For  a  permanent"
say "    effect, put the line ""SIC_INITWINDOW NO"" in ~/.gag.dico"
say "  -logname: Base name for .log, .mes, and .hist files"
say "    The date-time string is still inserted in the base name at"
say "    startup, and removed on normal exit"
say "  -logdir: Directory for the .log, .mes, and .hist files.  For"
say "    a permanent  effect,  put  the  line  ""GAG_LOG: <dir>""  in"
say "    ~/.gag.dico"
say "  -nl: No Log files"
say "    No log and message files will be produced in ~/.gag/logs/"
say "    for this session. For a permanent effect,  put  the  line"
say "    ""SIC_LOGFILES NO"" in ~/.gag.dico"
say "  -d: Debug"
say "    Start the program with debug messages enabled.  They  can"
say "    be disabled or reenabled later on with  the  command  SIC"
say "    DEBUG MESSAGE"
say "  -v: Version"
say "    Display the version information"
say "  -h: Help"
say "    Display this help"
say ""
say "Batch mode:"
say "  shell> [nohup] "'sic%program'" < readfrom.pro > writeto.log 2>&"'1'" &"
say "  ""nohup"" should not be required if  you  really  redirect"
say "  STDIN, STDOUT, and STDERR as in the above example."
say "  The command ""exit"" is not  needed  at  the  end  of  the"
say "  file ""readfrom.pro"" since a EOF signal will terminate"
say "  the process."
