----------------------------------------------------------------------------
Usage: ferretloop [-] [-h] [-q] [-d] [-k] [-c] [-n] [-o directory_name]
         [-s start:end:delta] [-f sloop_format] [-i info_text] [-r reference_file]
         [--ps2gif_option "option"]
         ferret_script 'ferret_script_args'

Description:
   ferretloop will help you to perform a loop on a ferret_script.
   ferretloop is a shell script which loops the execution of
   a ferret_script following a loop definition.
   If files are specified on standard input, ferretloop will
   also perfom the loop over each file.
   Result output is a directory (ferretloop_#processusnumber) with
   a multiframe gif file and if --pdf option specified a multipage pdf
   file.
   If error occured, the output directory will contain all
   prepared script files (*jnl), output execution files (*stdout),
   produced ps and gif files.
   Input files can be indicated on standard input either from:
   - a file list:
       ferretloop - ferret_script 'ferret_script_args' < file_list
   - output of a command:
       cat list_file | ferretloop - ferret_script 'ferret_script_args'
       echo /dir/*.nc | ferretloop - ferret_script 'ferret_script_args'

Arguments:
   ferret_script: Name of the ferret script
                  (use preferably full pathname or environment variable).

   ferret_script_args: Arguments of the ferret script
                       (use single quoting ' to be able to include
                       special characters like ",[,]).

Options:
   -h, --help, -help
       Print this manual.

   -p, --pdf
       plt files are produced and convert to a multipage pdf file.

   -q, --quiet
       Nothing is printed on standard output.

   -o, --output directory_name
       The name of the directory specified will be used as output directory.
       Default is ferretloop_#processusnumber.
       Specify a local directory name and NOT a pathname directory.

   -d, --debug
       ferret output are printed on standard output
       and journal, meta files are not deleted.

   -n, --noexec
       Prepare ferret script files, no execution.

   -c, --check
       Check if ferret can access to files
       and prepare ferret script files.

   -k, --keep
       Keep ps files, no convertion and merge.

   -i, --info text
       Put a information text in a file with .info as extension.
       This information will be used as bookmark and list item
       by pdf2pdf andf indexhtml scripts.

   -r, --ref file
       This option allow you to specify a reference file
       and will be used when parsing arguments to replace
       the string "referencefile".

   -s, --sloop start:end:delta
       This option specifies the script loop definition.
       start:end:delta must be integers separated by colons.
       The string "sloop" (script loop) can be specified in
       the ferret_script_args and will take values from
       start to end by step of delta.
       If not specified, the script is repeat only once
       and sloop will be equal to 1.

   -f, --format_sloop format
       This option controls the format of the sloop counter.
       Format must be defined according as in C echo function.
       Default is %d. %02d will define sloop as: 01,02,03...
       %04d will define sloop as: 0001,0002,0003...

   --ps2gif_option "options"
       ps2gif options.

   -
       ferretloop reads standard input and loops the execution
       of the ferret_script over the number of filenames read.
       The string "inputfile" (input file) must be specified in
       the ferret_script_args to take the value of the input file(s).
       The string "inputfile_nb" (input file number) must be specified in
       the ferret_script_args and will take the value of
       the current number of input file(s).

Examples:
   * Considering that ferret_script is a ferret script which
     can be run as yes? go ferret_script
       ferretloop ferret_script ' '
     will perform the ferret_script and produce a gif image.

   * Considering that ferret_script is a ferret script which
     can be run as yes? go ferret_script var[l=2]
       ferretloop --sloop 1:12:3 ferret_script 'var[l=sloop]'
     will perform the ferret_script following l=1,4,7,10 and produce a gif image.

   * Considering that ferret_script is a ferret script which
     can be run as yes? go ferret_script file var[l=2]
       echo /dir/*nc | ferretloop - --sloop 1:12:3 ferret_script 'inputfile var[l=sloop]'
     will perform the ferret_script over the netcdf files from directory dir
     and over each file following l=1,4,7,10 and produce a gif image.

Notes:
   If input files are netcdf files then their access are checked.
   DODS URL access are checked 3 times before give up.

----------------------------------------------------------------------------