algol68g/a68g.1

   1 .Dd June 2008
   2 .Dt A68G 1
   3 .
   4 .Sh NAME
   5 a68g \- Algol 68 Genie, an Algol 68 interpreter
   6 .
   7 .Sh SYNOPSIS
   8 a68g
   9 .Op Fl apropos | help | info [string]
  10 .Op Fl assertions | Fl noassertions
  11 .Op Fl backtrace | Fl nobacktrace
  12 .Op Fl brackets
  13 .Op Fl check | Fl norun
  14 .Op Fl debug | Fl monitor
  15 .Op Fl echo Ar string
  16 .Op Fl execute Ar unit
  17 .Op Fl extensive
  18 .Op Fl frame Ar number
  19 .Op Fl handles Ar number
  20 .Op Fl heap Ar number
  21 .Op Fl listing
  22 .Op Fl moids
  23 .Op Fl overhead Ar number
  24 .Op Fl pragmats | Fl nopragmats
  25 .Op Fl precision Ar number
  26 .Op Fl preludelisting
  27 .Op Fl print Ar unit
  28 .Op Fl reductions
  29 .Op Fl run
  30 .Op Fl source | Fl nosource
  31 .Op Fl stack Ar number
  32 .Op Fl statistics
  33 .Op Fl terminal
  34 .Op Fl timelimit Ar number
  35 .Op Fl trace | Fl notrace
  36 .Op Fl tree | Fl notree
  37 .Op Fl unused
  38 .Op Fl verbose
  39 .Op Fl version
  40 .Op Fl warnings | Fl nowarnings
  41 .Op Fl xref | Fl noxref
  42 .Ar filename
  43 .
  44 .Sh DESCRIPTION
  45 Algol 68 Genie (Algol68G) is an Algol 68 interpreter. It can be used for executing Algol 68 programs or scripts. Algol 68 is a rather lean orthogonal general-purpose language that is a beautiful means for denoting algorithms. Algol 68 was designed as a general-purpose programming language by IFIP Working Group 2.1 (Algorithmic Languages and Calculi) that has continuing responsibility for Algol 60 and Algol 68.
  46 .
  47 .Sh OPTIONS
  48 Options are passed to a68g either from the file .a68g.rc in the working directory, the environment variable A68G_OPTIONS, the command-line or from pragmats.
  49 .Pp
  50 Option precedence is as follows: pragmat options supersede command-line options, command-line options supersede options in environment variable A68G_OPTIONS, A68G_OPTIONS supersedes options in .a68g.rc.
  51 .Pp
  52 Listing options, tracing options and -pragmat, -nopragmat, take their effect when they are encountered in a left-to-right pass of the program text, and can thus be used, for example, to generate a cross reference for a particular part of the program.
  53 .Pp
  54 Options are not case sensitive. In the list below, uppercase letters are mandatory for recognition. For instance
  55 .Pp
  56     a68g -prec 200 -ti 60 ...
  57 .Pp
  58 means
  59 .Pp
  60     a68g -precision 200 -timelimit 60 ...
  61 .Pp
  62 Where numeric arguments are required, suffices k, M or G are allowed for multiplication with 2 ** 10, 2 ** 20 or 2 ** 30 respectively.
  63 .Bl -tag -width Ds
  64 .
  65 .It Fl APropos | Help | INfo Ar [string]
  66 Print info on options if string is omitted, or print info on string otherwise.
  67 .
  68 .It Fl Assertions | Fl NOAssertions
  69 Control elaboration of assertions.
  70 .
  71 .It Fl BACKtrace | Fl NOBACKtrace
  72 Control whether a stack backtrace is done in case a runtime-error occurs.
  73 .
  74 .It Fl BRackets
  75 Consider [ .. ] and { .. } as being equivalent to ( .. ). Traditional Algol 68 syntax allows ( .. ) to replace [ .. ] in bounds and slices.
  76 .
  77 .It Fl Check | Fl NORun
  78 Check syntax only, the interpreter does not start.
  79 .
  80 .It Fl DEBUG | Fl MONitor
  81 Start in the monitor. Invoke the monitor in case a runtime-error occurs; the program will pause in the monitor on the line that contains the error.
  82 .
  83 .It Fl ECHO Ar string
  84 Echo string to standout.
  85 .
  86 .It Fl Execute Ar unit
  87 Execute the Algol 68 unit. In this way one-liners can be executed from the command line.
  88 .
  89 .It Fl EXTensive
  90 Generate an extensive listing.
  91 .
  92 .It Fl FRAME Ar number
  93 Set the frame stack size to
  94 .Ar number
  95 bytes.
  96 .
  97 .It Fl HANDLES Ar number
  98 Set the handle space size to
  99 .Ar number
 100 bytes.
 101 .
 102 .It Fl HEAP Ar number
 103 Set the heap size to
 104 .Ar number
 105 bytes.
 106 .
 107 .It Fl LISTing
 108 Generate a concise listing.
 109 .
 110 .It Fl MOIDS
 111 Generate an overview of modes in the listing file.
 112 .
 113 .It Fl OVERHEAD Ar number
 114 Set overhead for stack checking.
 115 .
 116 .It Fl PORTcheck | Fl NOPORTcheck
 117 Enable or disable portability warning messages.
 118 .
 119 .It Fl PRagmats | Fl NOPRagmats
 120 Control elaboration of pragmats.
 121 .
 122 .It Fl PRECision Ar number
 123 Set the precision for LONG LONG modes to
 124 .Ar number
 125 significant digits.
 126 .
 127 .It Fl PRELUDElisting
 128 Generate a listing of preludes.
 129 .
 130 .It Fl Print Ar unit
 131 Print the value yielded by the Algol 68 unit. In this way one-liners can be executed from the command line.
 132 .
 133 .It Fl QUOTEstropping
 134 Use quote stropping.
 135 .
 136 .It Fl REDuctions
 137 Print reductions made by the parser.
 138 .
 139 .It Fl RUN
 140 Override the norun option.
 141 .
 142 .It Fl SOURCE | Fl NOSOURCE
 143 Control the listing of source lines in the listing file.
 144 .
 145 .It Fl STACK Ar number
 146 Set the stack size to
 147 .Ar number
 148 bytes.
 149 .
 150 .It Fl STatistics
 151 Generate statistics in the listing file.
 152 .
 153 .It Fl TImelimit Ar number
 154 Interrupt the interpreter after
 155 .Ar number
 156 seconds, generating a time limit exceeded error.
 157 .
 158 .It Fl TRace | Fl NOTRace
 159 Control tracing of the running program.
 160 .
 161 .It Fl TREE | Fl NOTREE
 162 Control listing of the syntax tree in the listing file.
 163 .
 164 .It Fl UNUSED
 165 Generate an overview of unused tags in the listing file.
 166 .
 167 .It Fl UPPERstropping
 168 Use upper stropping, which is the default stropping regime.
 169 .
 170 .It Fl VERBose
 171 Use verbose mode.
 172 .
 173 .It Fl Version
 174 Print the version of the running image of a68g.
 175 .
 176 .It Fl Warnings | Fl NOWarnings
 177 Enable warning messages or suppress suppressible warning messages.
 178 .
 179 .It Fl Xref | Fl NOXref
 180 Control generation of a cross-reference in the listing file.
 181 .
 182 .El
 183 .
 184 .Sh AUTHOR
 185 Author of Algol68G is Marcel van der Veer <algol68g@xs4all.nl>.
 186