home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / cli / gulam103.zoo / gulam / gulam.inf < prev    next >
Text File  |  1988-09-06  |  50KB  |  1,305 lines
  1. Info file gulam.info, produced by texinfo-format-buffer   -*-Text-*-
  2. from file g.txi
  3.  
  4.  
  6. File: gulam.info  Node: top, Up: (DIR), Next: usage
  7.  
  8. Introduction
  9. ============
  10.  
  11. *Gulam* is a shell (i.e., a command line interpreter) for AtariST
  12. computers.  It contains some 60+ built-in commands, provides file name
  13. completion a la *TENEX*, has history, alias and rehash
  14. facilities, and integrates the shell with microEmacs easing the
  15. editing of commands being issued.  Among the built-in commands are
  16.  
  17. `egrep'     
  18.      a regular expression based string  pattern  finder.
  19. `te'     
  20.      a simple terminal emulator.
  21. `rx/sx'     
  22.      Xmodem  file  transfers
  23. `pr'     
  24.      a text file printer with pagination.
  25.  
  26. In common usage, it resembles *csh* of *Unix 4.xBSD*;
  27. Gulam's control structures, lexical conventions and other details are,
  28. however, quite different from csh.  While I have borrowed ideas from
  29. other shells (such as Korn shell), I made no heroic attempts to be
  30. compatible with any.  Where possible, I have tried to make
  31. *Gulam* less `surprising' in what it does.
  32.  
  33. The word *Gulam* is pronounced as *Gulaam* in Hindi/Urdu,
  34. and means an obedient servant.
  35.  
  36. *Gulam* is a free program; you are encouraged to give it to others,
  37. but at no cost.  However, the source is copyrighted (i.e., it is not in the
  38. public domain) and will be part of a book on systems programming I am
  39. writing.  The source is available on request, with the usual provisos
  40. regarding material in manuscript form.  This manual is written in the
  41. *TeXinfo* format (the *GNU* documentation format); a laser-printed
  42. TeX-typeset copy of this 40-page manual is also available at cost ($2.00).
  43.  
  44. I am advised to include a disclaimer because there are unreasonable people
  45. out there.
  46.  
  47. "I make no warranty with respect to this manual, or the program it
  48. describes, and disclaim any implied/explicit suggestions of usefulness for
  49. any particular purpose.  Use this program only if you are willing to assume
  50. all risks, and damages, if any, arising as a result, even if it is caused
  51. by negligence or other fault."
  52.  
  53. The first release of this program did contain bugs.  The present
  54. beta-version (dated Sept 1987) is a result of fixing 15 bugs, 9 internal
  55. code improvements (about 180 lines of rewriting), 9 user-visible
  56. improvements.  I am sure this version too has bugs, and undesirable
  57. features.  Users are encouraged to tell me both good and bad things about
  58. this program.
  59.  
  60.  
  61. Many thanks to: Jwahar R.  Bammi for help in every aspect during the
  62. writing of the shell and this manual, and demanding that
  63. *Gulam* be a `reasonably full fledged' shell; David Conroy for
  64. writing a `small is beautiful' microEmacs; Henry Spencer for the
  65. regexp(3) package that is now built into *Gulam*; AtariST for
  66. its value to price ratio.  The program was developed using Megamax and
  67. Mark Williams C compilers.  It now uses my own malloc.c.
  68.  
  69.  
  70.  
  71. Comments on the Present Implementation
  72. ======================================
  73.  
  74. I find the present implementation eminently useable, and indeed use it
  75. all the time, in preference to other shells.
  76.  
  77. Here are some features that I (still) find unsatisfactory.  Control
  78. structures are quite ad-hoc, and incomplete.  I had a tough time in
  79. decreeing that the typical `+-*/()[]{}' are not delimiters; but
  80. that decision made *Gulam* smaller.
  81.  
  82. Here is a list (complete?) of things new and/or diffrent from the
  83. alpha-version.
  84.  
  85.   1. the bugs causing memory-lossage have been fixed.
  86.   2. an application program can now call one of *Gulam*'s routines
  87.      that is equivalent to system() call.
  88.   3. an application program can now call one of *Gulam*'s routines
  89.      that can receive keyboard input from the user, with all the facilities of
  90.      `ue', and return the line input by the user.
  91.   4. `ue' can now insert-file.
  92.   5. stdout append-redirection (`>>') is now implemented.
  93.   6. a new sub-word consisting of three dots `...' expands to the list
  94.      of all filenames rooted at the current or given directory.
  95.   7. doing a `set path <path-list>' will also cause an automatic
  96.      `setenv PATH <path-list> ; rehash'.
  97.   8. `ue' can now fill-paragraph.
  98.   9. new shell variable `verbosity' controls how silent *Gulam* is.
  99.  10. cp will not copy directories and their contents unless
  100.      given the `-r' flag.
  101.  11. `ue' can now use mouse movements as cursor
  102.      movements (see mscursor).
  103.  12. diskettes can be formatted (single/double-sided) in TOS standard way.
  104.  13. the command mem can not only report the GEMDOS free-list but also the list
  105.      of GEMDOS Malloc-ated chunks.
  106.  14. shaded background on the screen is provided for the `gem' command.
  107.  15. the keypad keys can be toggled to become numeric
  108.      or extra-function keys.
  109.  16. there are 3 separate key-bindings for the one *gulam* buffer, and
  110.      the one *mini* buffer, and all the regular buffers.
  111.  
  113. File: gulam.info  Node: usage, Prev: top, Up: top, Next: lexical-conventions
  114.  
  115. General Usage
  116. =============
  117.  
  118. The syntactic details of individual commands, and the specific rules that
  119. are followed in evaluating them are given later.  This section is an
  120. overview of how the integration of `ue' with a shell is used.
  121.  
  122. The moment you enter *Gulam*, you are in a ue-buffer
  123. called *mini*.  Thus, all the typical `ue' text-editing
  124. functions are available, except commands such as `Visit-file',
  125. `Switch-to-buffer', etc.  The `RETURN' key causes the entire
  126. line (on which the return is typed) to be evaluated.  The output, if
  127. any, of the command you issued appears on the screen but does not
  128. enter any ue-buffer.  The built-in command `ue' (without any
  129. arguments) takes you into the special ue-buffer named *gulam*;
  130. the output of (built-in) commands issued while you are in *gulam*
  131. does enter that buffer, which can be freely edited.  The command
  132. `ue' FILENAME will read-in each of the named files into
  133. their ue-buffers.  From within `ue', you can
  134. `Switch-to-Gulam-buffer' (whose default binding is `ESC-g').
  135.  
  136. To conserve/manage memory, we release all `ue' buffers when `ue'
  137. is exited in the usual way (i.e., `UNDO', or `⑧-⇨');
  138. exiting temporarily via the `ə' does not release memory.
  139. Issuing a substantial number of commands through the *mini* buffer,
  140. without entering `ue' in between, will accumulate all the commands
  141. (but not their output) in the *mini* buffer, and soon there will be a
  142. memory shortage.  To prevent this, enter and exit `ue' once in a
  143. while, or delete (using `⇦', or `Delete') characters in the
  144. *mini* buffer.
  145.  
  146.  
  147.  
  149. File: gulam.info  Node: lexical-conventions, Prev: usage, Up: top, Next: command-processing
  150.  
  151. Lexical Conventions
  152. ===================
  153.  
  154. All  input  to  *Gulam*  is  case-sensitive; on the other hand, TOS
  155. file names are case-independent.  
  156.  
  157. The  evaluation  of  the command line  begins by dividing it into
  158. "words" and "subwords".  The "word-delimiters" are
  159. space, tab, return, line-feed (the so-called white chars),
  160. single-quote, double-quote, semicolon, and the vertical-bar.
  161.  
  162.  
  163. Note that  `+-*=/()[]{}' etc. are *not* "word-delimiters".  A
  164. "word"  is  either
  165.  
  166.    * A  sequence  of  chars  not containing any "word-delimiters".
  167.    * A  string  of  arbitrary chars enclosed in single/double-quotes.
  168.    * A `semicolon'.
  169.    * A `vertical-bar'.  
  170.  
  171. Eg,  the lines below 
  172.  
  173.      date  01-22-87-22:08:34  #sets the TOS and ikbd date-time
  174.      alias c 'mmcc e:\gulam\$1.c; cp e:\gulam\$1.o .'
  175.      if    {$x + $y ==23 }
  176.      if    { -e $1.c }
  177.  
  178. would be divided into the words (shown between slashes) 
  179.  
  180.      /date/01-22-87-22:08:34/#sets/the/TOS/and/ikbd/date-time/
  181.      /alias/c/'mmcc e:\gulam\$1.c; cp e:\gulam\$1.o .'/
  182.      /if/{$x/+/$y/==23/}/
  183.      /if/{/-e/$1.c/}/
  184.  
  185. "Comments" begin  with  a  word  whose first char is `#', and
  186. end  at  the  end  of line.  A `#' embedded in the middle of a word
  187. does not begin a comment.  
  188.  
  189. The "subword-delimiters" are the characters in 
  190. `!@#$%^&-=+`~{}:;'"\|,.<>/'.
  191.  
  193. File: gulam.info  Node: command-processing, Prev: lexical-conventions, Up: top, Next: batch-files
  194.  
  195. Outline of Command Processing
  196. =============================
  197.  
  198. The command line is string pre-processed as described below before invoking
  199. it as a command.
  200.  
  201.    * History substitutions occur first.
  202.    * Dollar substitutions, wiggle  expansion,  meta  expansions  occur second.
  203.    * Split the resulting  line  into semi-colon separated commands.
  204.    * For each command,  alias  expand  it,  and  dollar-substitute.
  205.    * Execute each resulting command.  
  206.  
  208. File: gulam.info  Node: batch-files, Prev: command-processing, Up: top, Next: buffers
  209.  
  210. Batch Files
  211. ===========
  212.  
  213. A "batch file", also called a shell file, is a text file containing
  214. *Gulam* commands, both internal and external.  Such files must have
  215. the extension `.g' for them to be recognized as commands.  See the
  216. section on `gulam.g' for an example shell file.
  217.  
  218. In processing these files *Gulam* uses `ue' buffers.  So, if
  219. you have `ue' as a command in a batch file, and then exit `ue'
  220. with either `UNDO' or `⑧-⇨', all the buffers
  221. (including the one holding the batch file) will be released, and
  222. *Gulam* will surely crash. So, do *NOT* include `ue' as a
  223. command in a shell file.
  224.  
  225. Redirections to/from batch files do not work properly.
  226.  
  228. File: gulam.info  Node: buffers, Prev: batch-files, Up: top, Next: command-line-editing
  229.  
  230. Buffers: Gulam, Mini and Regular Buffers
  231. ========================================
  232.  
  233. Once you invoke *Gulam*, you are always in one of the microEmacs
  234. (*uE*) "buffers" which are reservoirs of text.  In this program, a
  235. typical line-oriented command shell is integrated with microEmacs.  This
  236. necessitated two special kinds of buffers, named *gulam* and
  237. *mini*, along with the regular buffers.
  238.  
  239. Right after you invoke *Gulam*, you are in *mini*, and each
  240. line you type is taken as a *Gulam* command, and executed.  Any
  241. output produced by such a command is displayed on the screen but not
  242. entered into any microEmacs buffer.  Should you desire to capture such
  243. output into a buffer, enter the *gulam* buffer by typing `ue'
  244. without any arguments.  If you are editing in a regular buffer elsewhere in
  245. microEmacs, pressing `ESC-g' (see `kb' below for
  246. `switch-to-Gulam-buffer') will get you into *gulam*.
  247.  
  248. While you are in *Gulam*, the `RETURN' key behaves as it does in
  249. *mini*.  All command input, including giving the names of buffers
  250. within `ue', takes place in *mini*.  The window for this buffer
  251. is always at the bottom of screen, and usually only one-line high.  (Some
  252. of you may want to experiment with `⑧-ə' and
  253. `⑧-z'.) You enter the *mini* either because (A) you are
  254. outside the normal microEmacs, or (B) a command such as
  255. `Switch-to-buffer' wants to read your input.  The *mini* is like
  256. any other buffer except for the bindings of a few keys, and the disallowing
  257. of `ue' functions that change/switch buffers/windows/files.  One of
  258. these exceptional keys (in *mini*) is the `RETURN' key: it will
  259. submit the entire line -- even if the cursor was somewhere in the middle of
  260. the line-- to the shell (case A), or to such `ue' commands as
  261. `Visit-File' (case B).  Until you press `RETURN', you can edit not
  262. only that line but others in *mini* just as you would in regular
  263. buffers.
  264.  
  265. Note that unless you occasionally exit microEmacs with
  266. `⑧-⇨' or `UNDO', both *gulam* and *mini*
  267. buffers will keep growing, and you may run out of memory.
  268.  
  270. File: gulam.info  Node: command-line-editing, Prev: buffers, Up: top, Next: invoking-gulam
  271.  
  272. Command Line Editing
  273. ====================
  274.  
  275. Full microEmacs editing is available while typing the command.  Thus, you
  276. can transopse chars by `④', and go to the beginning of the line
  277. by `⇧', and ⑨ank in a perviously deleted word, etc.
  278.  
  279. In addition to these, there are three convenience features.  After typing
  280. the first few chars of a file name, if you press the key marked
  281. `INSERT', *Gulam* will attempt to complete the file name;
  282. pressing `CLR/HOME' will show all possible completions.  Secondly, if
  283. you type `!n' and then press `INSERT', you will see that the
  284. history-expanded result is brought into the buffer, which can then be
  285. further edited if necessary.  Thirdly, pressing the `DOWNARROW' key
  286. will cycle you through the previous commands.
  287.  
  288.  
  290. File: gulam.info  Node: invoking-gulam, Prev: command-line-editing, Up: top, Next: Glossary
  291.  
  292. Invoking Gulam
  293. ==============
  294.  
  295. *Gulam* can be used in four ways.  Two of these four use `TOS'
  296. variable named `_shell_p' (at `0x04f6L').  This (supposedly)
  297. contains a pointer to a routine that takes a string as an argument and
  298. executes it as a shell command.  *Gulam* has slightly extented this.
  299. `*_shell_p', as set by *Gulam*, points the bottom of a (jump)
  300. table, which currently is:
  301.  
  302.              .long   0x86420135        / our magic number
  303.              jmp     getlineviaue_
  304.      togu_:  jmp     callgulam_
  305.  
  306. Thus, `*((long *) 0x04f6L)' == address of `togu_'.  Before
  307. invoking either routine, it always is a good idea to check if the magic
  308. number is present.  Let `mp = *((long *) 0x04f6L) - 12L'.  Then,
  309. `*mp' better be `0x86420135'.
  310.  
  311.   1. The most common usage is as an (outermost) interactive shell.
  312.      Double-click on `gulam.prg'.  Keep your version of `gulam.g' also
  313.      in the same folder.
  314.   2. `int callgulam(p) char *p;' returns the status of executing
  315.      shell command given as a string pointed by `p'.  Let `fp =
  316.      *((long *) 0x04f6L)'.  Then to call this routine, you do `(*fp)(p)'.
  317.   3. `void getlineviaue(p) char *p;' returns in the user-supplied
  318.      array of chars pointed by `p' the command line typed by the user.  Full
  319.      uE editing facilities are available in this inputting process.  `p' must
  320.      point to an array of at least 256 chars; longer input lines cannot be
  321.      given.  The line may contain control characters (inserted by the ^Q
  322.      feature of `ue').  It is ascii NUL terminated.  Let `fp = *((long *)
  323.      0x04f6L) - 6L'.  Then to call this routine, you do `(*fp)(p)'.
  324.   4. For non-interactive use, *Gulam* can be invoked (from shells, from
  325.      application programs via `Pexec()', or `callgulam()') with arguments.
  326.  
  327. `gu 'ls -l' 'echo hello'' is similar to typing the two commands to the
  328. shell in interactive mode.
  329.  
  330. `gu 'pwd' -c scrpt a b c d' does `pwd', and then invokes the
  331. (presumably valid) *Gulam* shell script named `scrpt.g' with
  332. `a b c d' as the script files arguments.  Following the `-c'
  333. must be the name of a batch file.
  334.  
  335. *Gulam* has no other options.
  336.  
  338. File: gulam.info  Node: Glossary, Prev: invoking-gulam, Up: top, Next: top
  339.  
  340. Glossary
  341. ========
  342.  
  344. File: gulam.info  Node: builtins, Prev: Glossary, Up: Glossary, Next: cd
  345.  
  346.  
  347. Builtin Commands
  348. ----------------
  349.  
  350. A command executed directly by the shell is called a "built-in"
  351. command.  The 62 built-in commands of *Gulam* are:
  352.  
  353.      alias dm     endwhile help    more  printenv set    ue
  354.      cat   dirc   exit     history mson  pushd    setenv unalias
  355.      cd    dirs   fg       if      msoff pwd      source unset
  356.      chmod echo   fgrep    kb      mv    rehash   sx     unsetenv
  357.      copy  egrep  foreach  lpr     peekw ren      te     which
  358.      cp    ef     format   ls      pokew rm       teexit while
  359.      date  endfor gem      mem     popd  rmdir    time
  360.      df    endif  grep     mkdir   print rx       touch
  361.  
  363. File: gulam.info  Node: alias, Prev: Glossary, Up: Glossary, Next: cat
  364.  
  365. alias
  366. -----
  367.  
  368. The `alias' built-in command works almost like a shell file but one
  369. that is stored in the internal data structures of *Gulam*.  It often
  370. just specifies a shorter or different name for a command.
  371.  
  372.      alias cc c:\megamax\mmcc.ttp    #1
  373.      unalias cc                      #2
  374.      alias c 'mmcc e:\gulam\$1.c; cp e:\gulam\$1.o .' #3
  375.      alias r  'echo $1.c $1.o; r'    #4
  376.      alias                           #5
  377.      alias g 'echo $3 $1'            #6
  378.      alias cg 'f:\cc.ttp -c -Ie:\gulam -DMWC e:\gulam\$1.c' #7
  379.  
  380. Alias without args (see #5) lists all the aliases that are currently
  381. defined.  The command unalias (see 2) removes the def of an alias.  Line 4
  382. shows a recursive definition; try it out!  If we invoke `g' as in
  383. `g a b c d e f' this is equivalent to `echo c a d e f'; i.e., all
  384. arguments above the highest that was used in a "$-substitution" are
  385. appended to the resulting command string before executing it.
  386.  
  388. File: gulam.info  Node: cat, Prev: alias, Up: Glossary, Next: cd
  389.  
  390. cat
  391. ---
  392.  
  393. This command `catenates' files to the standard output (normally screen).
  394. By redirecting output, you can concatenate several files into a combined
  395. file.
  396.  
  397.      cat f1 f2 >f3    # f3 will now equal f1 followed by f2
  398.      cat f1 > prn:    # print the file f1 as is; see also print and lpr
  399.      cat f1        # show it on the screen; use ^S/^Q to stop/go
  400.  
  402. File: gulam.info  Node: cd, Prev: cat, Up: Glossary, Next: chmod
  403.  
  404. cd
  405. --
  406.  
  407. The `cd' command changes the current working directory; it also sets
  408. the shell variable named `cwd', the environment variable
  409. named  `CWD'.  If `cd' was given noarguments,  it is equivalent
  410. to `cd $home'.
  411.  
  413. File: gulam.info  Node: chmod, Prev: cd, Up: Glossary, Next: cp
  414.  
  415. chmod
  416. -----
  417.      chmod [+-whsvm] FILENAMES
  418.  
  419. `chmod' changes the read/write attributes of the files.  The
  420. `+' flags have inverse effect to the `-' flags.  The `+w'
  421. makes them read-write, and `-w' makes them read-only.  The
  422. `+h' hides the files from directory searches; `+s' marks
  423. them as hidden system files; `-m' turns off the `archived' flag
  424. on the file.
  425.  
  426.  
  428. File: gulam.info  Node: cp, Prev: chmod, Up: Glossary, Next: date
  429.  
  430. cp
  431. --
  432.      cp FILENAMES TARGET-DIR
  433.      cp FILENAME1 FILENAME2
  434.  
  435. Copies files.  In the first form, any number of files may be copied into
  436. the destination directory; files in the target dir will have their original
  437. names.  In the second form, only one file is copied, and the new one will
  438. be named filename2.
  439.  
  440.      cp FNM FNM    # will exit with status -1 
  441.      cp -r D1 DIR2     # if d1 is a directory, this command
  442.                    # will create a dir named d1 in dir2, and 
  443.                    # copies all the files in d1 to to dir2\d1 
  444.  
  445. In the second example above, if -r option is omitted, cp will ignore any
  446. directory names in the list of source files.  Use the -r option with
  447. caution.  E.g.,
  448.  
  449.      cp -r d1  d1\d2 # is dangerous 
  450.  
  451. will, assuming that d1\d2 is a directory, copy/create subtree d1 inside d2.
  452. But, the problem is that d1 will keep growing as a result until of course
  453. there is no more room on the target disk!
  454.  
  455. A simple way to print a file as is, instead of using lpr or print, is to
  456.  
  457.      cp fnm prn: 
  458.  
  459. There is a `+t' option that gives the created target files the time
  460. and date of the source files.  If you care about this, you may want to set
  461. up an alias as in:
  462.  
  463.      alias cp 'cp +t' 
  464.  
  465.  
  466. $cwd and $CWD
  467. -------------
  468.  
  469. The shell variable named `cwd' (and env var named `CWD') holds the
  470. full path name of the current working directory.  
  471.  
  473. File: gulam.info  Node: date, Prev: cp, Up: Glossary, Next: df
  474.  
  475. date
  476. ----
  477.  
  478. The `date' command, without arguments, prints the current date and
  479. time.  With arguments, it sets the date and time.  
  480.  
  481.      date 01-22-87-22:08:34 
  482.  
  483. will set the date to Jan 22, 87 and time to 10:08:34 pm.  Instead of hyphen,
  484. and colon, other delimiters can be used, as long as the whole argument of date
  485. is still one word.
  486.  
  488. File: gulam.info  Node: df, Prev: date, Up: Glossary, Next: dm
  489.  
  490. df
  491. --
  492.      df DRIVENAMES
  493.  
  494. `df'  shows the free space on the asked for drive(s); e.g.,
  495.      df a c f
  496.  
  498. File: gulam.info  Node: dm, Prev: df, Up: Glossary, Next: dirc
  499.  
  500. dm
  501. --
  502.  
  503. `dm' (drive map) gives a string of letters that stand for the
  504. installed drives.
  505.  
  507. File: gulam.info  Node: dirc, Prev: dm, Up: Glossary, Next: dirs
  508.  
  509. dir cache dirc
  510. --------------
  511.  
  512. To help do the Tenex file name completion efficiently, there is a
  513. cache of contents of directories.  `dirc' shows the names of
  514. these dirs, and how many bytes are used by their contents.  Unless you
  515. did a `set dir_cache 1', or you executed commands that only
  516. examine the file system the `dirc' has nothing to show since the
  517. cache is flushed at the end of each command.  Try *Gulam* with
  518. `dir_cache' set to 1.  Note however that this cache is updated
  519. only by commands that change the contents of a directory (such as
  520. `rm', `cp').  A rather annoying result is that even after
  521. you change the diskette in a drive, you may see the directory contents
  522. of the previous diskette listed.  An `UNDO', `dirc -',
  523. `rm' with/without arguments will explicitly flush the cache.
  524.  
  526. File: gulam.info  Node: dirs, Prev: dirc, Up: Glossary, Next: echo
  527.  
  528. dirs
  529. ----
  530.  
  531. *Gulam* has an internal stack of directories whose content is
  532. printed by the `dirs' command.  The built-in commands `pushd',
  533. and `popd' are the only others that operate on this stack.
  534.  
  536. File: gulam.info  Node: dollar-substitutions, Prev: command-line-editing, Up: top, Next: expressions
  537.  
  538. Dollar-substitutions
  539. --------------------
  540.  
  541. The subword `$x' in a command is substituted by the value of it.  If
  542. `x' is the name of a shell var, or an environment var, then `$x'
  543. is the value of that variable.  If `x' is an unsigned number, it
  544. stands for the x-th argument; thus, `$0' usually gives the command
  545. name.   `$*'  stands  for the text of the entire command; `$-' stands
  546. for  words  `$1'  to dollar-last; `$<' stands for the on-demand input
  547. given by the user.  
  548.  
  549.  
  550.  
  551. Dotg.g
  552. ------
  553.  
  554. -- see Batch Files, and gulam.g 
  555.  
  557. File: gulam.info  Node: echo, Prev: dirs, Up: Glossary, Next: ef
  558.  
  559. echo
  560. ----
  561.  
  562. The `echo' command prints its arguments.  
  563.  
  564.      echo c:\mwc\...    # all the fnms in the dir tree rooted at c:\mwc will be echoed
  565.  
  567. File: gulam.info  Node: ef, Prev: echo, Up: Glossary, Next: egrep
  568.  
  569. ef
  570. --
  571. -- stands for `elseif'; see `if'
  572.  
  574. File: gulam.info  Node: egrep, Prev: ef, Up: Glossary, Next: endif
  575.  
  576. egrep
  577. -----
  578. -- see `grep'
  579.  
  581. File: gulam.info  Node: endif, Prev: egrep, Up: Glossary, Next: endfor
  582.  
  583. endif
  584. -----
  585. -- see `if'
  586.  
  588. File: gulam.info  Node: endfor, Prev: endif, Up: Glossary, Next: exit
  589.  
  590. endfor
  591. ------
  592. -- see foreach
  593.  
  594.  
  595. Style of Environment String 
  596. ----------------------------
  597.  
  598. This shell var controls the format of the environment string supplied to
  599. the external command invoked through *Gulam*.
  600.  
  601.      set env_style bm # to get a style of env a la MS-DOS
  602.      set env_style mw # Mark Williams
  603.      set env_style gu # the "normal" style, a la Unix
  604.  
  606. File: gulam.info  Node: exit, Prev: endfor, Up: Glossary, Next: fg
  607.  
  608. exit
  609. ----
  610.      exit [NUMBER]
  611.  
  612. The `exit' built-in command is used to force termination of a shell
  613. script.
  614.  
  616. File: gulam.info  Node: expressions, Prev: dollar-substitutions, Up: top, Next: flags
  617.  
  618. Expressions 
  619. ------------
  620.  
  621. An "atomic exp" is either a NUMBER, a FILENAME, a FILE
  622. PREDICATE, a { EXP }, or ! ATOMIC EXP.
  623.  
  624. A FILE PREDICATE on a file name FNM is of the form `-c
  625. FNM' where `c' is in `{e, f, d, h, v, m}'.  These letters
  626. stand for "exists", "is-a-regular-file", "is-a-dir",
  627. "is-a-hidden-file", "is-a-volume-label", and
  628. "is-an-archived-file".  A FILEPRED yields 1 if it is true, 0
  629. otherwise.
  630.  
  631. An arithmetic expression is constructed using the operators `+-/%*'.
  632. All these are of equal precedence and evaluated left-to-right; thus,
  633. `2 + 4 / 2' is equal to 3.  However, the braces raise the precedence
  634. of the ops within them; thus, `2 + { 6 / 2}' is equal to 5.  An exp
  635. with no operators, i.e., an atom, is a special case because we want the
  636. string form of the atom (e.g., as for `blah' in `set s blah').  A
  637. non-numeric string yields 0 as its numeric value in an arith exp.
  638.  
  639. A "relational expression" is of the form `arithexp relation
  640. arithexp', where relation is any one of `<=, <, ==, !=, >,' or
  641. `>='.  Such a relation yields a 1 if it holds, 0 otherwise.
  642. (Relational operators among strings are not implemented yet.)  You may
  643. combine expressions using the boolean operators `&&' and `||'
  644. (which are not, for now, short-circuit evaluated).
  645.  
  646. Note the spaces in the examples above; see Lexical Structure.  
  647.  
  649. File: gulam.info  Node: fg, Prev: exit, Up: Glossary, Next: file-names
  650.  
  651. fg
  652. --
  653.  
  654. `fg' is part of the simulation of what we were used to doing on Unix
  655. with GNU-Emacs: get out of it by stopping GNU (`ə' in ue/Gulam),
  656. do a few shell commands and get back in by `fg' (works the same in
  657. ue/Gulam).
  658.  
  659.  
  661. File: gulam.info  Node: file-names, Prev: fg, Up: Glossary, Next: foreach
  662.  
  663. File Names
  664. ----------
  665.  
  666. There are many conveniences in *Gulam* that relate to specifying
  667. filenames.  It can complete a file name given its first few characters.
  668. (Tenex is widely considered to be the first OS to implement this.) Type the
  669. first few characters, and then press the key marked `INSERT' (or
  670. `CLR/HOME'), while you are in *mini*.  If you are in buffer
  671. *gulam*, use `ESC' `ESC' (2 escapes).
  672.  
  673. The canonical form of the full path name of a file begins with a letter
  674. designating the disk drive, followed by a colon, a back-slash separated
  675. list of identifiers.  All but the last of these identifiers must be a
  676. directory name.  In the non-standard form, you may also use a dot `.', and
  677. dot-dot `..' in place of the identifiers in appropriate contexts.  Whenever
  678. *Gulam* completes your filenames, it will produce the standard form
  679. full path names.
  680.  
  681. *Gulam* will standardize, in three situations, non-standard form of
  682. a `path', as shown in the example below.  These situations are:
  683.   1. Tenex file name expansion is invoked.
  684.   2. the word contains meta characters.
  685.   3. the name is being given to one of the file operations in `ue'.
  686.  
  687. `e:\gulam\a:\lex.c' is standardized to `a:\lex.c'
  688. `e:\gulam\\src\util.c' is standardized to `c:\src\util.c'
  689. `e:\gulam\~\ex.o' is standardized to `d:\bin\ex.c'
  690.  
  691. assuming that the current drive was `c:\', and home was `d:\bin', and
  692. variable `parent_expand' is set.  This is especially nice inside
  693. `ue' when visiting other files.
  694.  
  695. Words, as given by the you, that contain meta characters (which are
  696. `*?|()[]') or the string `...' are expanded.  In general, one
  697. such word produces a list of file names.  These file name regular
  698. expressions (fnmre) are like regular expressions (re), but have different
  699. semantics.  Occurrences of an fnmre, outside of strings, are replaced by
  700. the sorted blank-separated list of file names matching the fnmre.  An fnmre
  701. differs from re in (1) `.' stands for itself; (2) `*' is matches zero or
  702. more arbitrary characters.  Question mark matches any one character.
  703. `[a-g]' matches any one letter in a, b, ..., g.  `[zen]' matches one of z,
  704. e, or n.  Parentheses serve to group expressions.  An exp `g*' matches file
  705. names that begin with a `g'; `*.c' matches those ending in `.c'
  706.  
  707. The 3 dots, as in `c:\tex\...', stand for all the names
  708. of the files in the subtree at `c:\tex'.  If `c:\tex' has
  709. subdirectories, and so on, all their names and files they contain are
  710. included.  Thus, `echo e:\...\*.c' will show all the `.c'
  711. files in all the directories on drive e.  Remember that `...'
  712. expansion causes many directories to be visited.  This is not only
  713. time consuming, but also seems to trigger the Atari TOS's 40 folder
  714. bug after a few such operations.  (In my tests, I never lost a file as
  715. a result.  Nor can I tell precisely when and in what form this shows
  716. up.  Most frequent indication was that `cd' to an existing drive
  717. would fail.)
  718.  
  720. File: gulam.info  Node: flags, Prev: expressions, Up: top, Next: history-substitutions
  721.  
  722. Flags
  723. -----
  724.  
  725. Most commands (built-in or external) take flags to alter the behavior of
  726. the command in a minor way.  The convention made popular by Unix shells is
  727. adopted here for *Gulam*'s built-ins: a flag is of the form
  728. `-C', or `+C', where C stands for one
  729. character.  The option `-i', which interrogates you for each of the
  730. operand of the command before executing it, is provided on most commands.
  731.  
  733. File: gulam.info  Node: foreach, Prev: file-names, Up: Glossary, Next: format
  734.  
  735. foreach
  736. -------
  737.  
  738. The `foreach' command is used in shell scripts (but not at the
  739. terminal) to specify repetition of a sequence of commands while the value
  740. of a certain shell variable ranges through a specified list.  The
  741. `foreach' command ends with an `endfor' on a separate line all by
  742. itself.
  743.  
  744.      foreach i { a b c *.o [a-k]*[ch] } 
  745.              echo $i 
  746.      endfor 
  747.  
  749. File: gulam.info  Node: format, Prev: foreach, Up: Glossary, Next: gem
  750.  
  751. format
  752. ------
  753.  
  754. This command formats diskettes, in the standard form (360K, or 720K) in
  755. either the `A' or `B' floppy drive.  It does not touch
  756. hard-/ram-disks, no matter what arguments (illegal or not) you give it.
  757. Its valid arguments are either `a', `b', or both.  The optional
  758. flag `-2' implies double-sided formatting; otherwise the diskette is
  759. formatted single-sided.
  760.  
  761.      format        # does nothing 
  762.      format b      # format the floppy in dr B, single-sided 
  763.      format -1 b   # same as format b 
  764.      format -2 a   # format the floppy in dr A, double-sided 
  765.  
  766. If you issue the wrong command (e.g., `format -2 a' on a single-sided
  767. drive), you will hear a lot of grinding noises; a `control-C' will kill
  768. this, but not right away.
  769.  
  771. File: gulam.info  Node: gem, Prev: format, Up: Glossary, Next: grep
  772.  
  773. gem
  774. ---
  775.  
  776. The word `gem' is a prefix, like `time' is, to commands.  This
  777. enables proper running via *Gulam* of most programs that use the
  778. desktop metaphor.  It clears screen, turns cursor off, enables mouse and
  779. then executes the command, and after the command is finished it again
  780. clears screen, turns cursor on, disables mouse.
  781.  
  782. The `time' and `gem' prefixes mix in either order, and the
  783. command name will be searched for in the usual way.
  784.  
  785. We do not know, for sure, if all desktop/window/mouse oriented programs can
  786. be run properly with this command prefix.  So experiment, and be ready to
  787. hit the reset button before using the prefix.
  788.  
  789. `dvi' is an example of a command that needs to be run with `gem'
  790. prefix.  And you may be tempted to do the following.
  791.  
  792.      alias dvi 'gem dvi'              # recurses infinitely 
  793.      alias dzz dvi                    # dzz or whatever 
  794.      alias dvi 'gem dzz'              # will work 
  795.      alias dvi 'gem c:\bin\dvi.prg'   # also will work 
  796.  
  798. File: gulam.info  Node: grep, Prev: gem, Up: Glossary, Next: gulam.g
  799.  
  800. grep/egrep/fgrep
  801. ----------------
  802.      grep/egrep/fgrep RE-PATTERN FILENAMES
  803.  
  804. The `grep' command searches through a list of argument files for a
  805. specified string.  Thus
  806.  
  807.      grep lex[aw] e:\gulam\*.c 
  808.  
  809. will print each line in the files that contains a substring matching
  810. `lex[aw]'. `grep' stands for "globally find regular expression
  811. matches and print". `grep' and `egrep' are one and the same.
  812. The first argument to `egrep' is a regular expression, and the rest
  813. are expected to be file names. `fgrep''s first argument is the as-is
  814. string to be searched for in the files.  Because of the preprocessing done
  815. by *Gulam*, the as-is string for `fgrep' or the regular exp for
  816. `egrep' is generally enclosed in single-quotes.
  817.  
  819. File: gulam.info  Node: gulam.g, Prev: grep, Up: Glossary, Next: help
  820.  
  821. gulam.g
  822. -------
  823.  
  824. Files with the `.g' extension are expected to contain *Gulam*
  825. commands; `gulam.g' is the name of the startup file.  *Gulam*
  826. attempts to find this file in the current directory, and if found executes
  827. its contents.  Here is an example file:
  828.  
  829.      # bgn of my gulam.g
  830.      
  831.      set prompt      '$ncmd $cwd gu > $u'
  832.      set histfile    e:\history.g
  833.      set baud_rate   9600
  834.      set sz_rs232_buffer     4096
  835.      # set palette; note the trailing '-'
  836.      set rgb '005-707-070-075-'
  837.      # the following sets tabs on Epson MX-80
  838.      set pr_bof '^Q033^QD^Q010^Q020^Q030^Q040^Q050^Q033^QC^Q102'
  839.      set pr_eof '^Q214'
  840.      set pr_eop '^Q214^Qn'
  841.      set pr_eol '^Qr^Qn'
  842.      
  843.      #setenv PATH c:\bin,d:\bin,f:  # no trailing back slashes
  844.      #rehash
  845.      set path c:\bin,d:\bin,f:      # this is equiv to above 2 lines
  846.      setenv TEMP f:\
  847.      alias h   history
  848.      alias ll  ls -lF
  849.      alias p   more
  850.      alias rm rm -i # asks before deleting
  851.      alias ug 'ue e:\gulam\$1.c'
  852.      alias cg 'f:\cc.ttp -c -V -Ie:\gulam -DMWC e:\gulam\$1.c'
  853.      alias cpall 'cp e:\ue\*.o e:\gulam*.o f:\ '
  854.      alias bk 'cp e:\gulam\*.[chs] a:\ '
  855.      # end of my gulam.g
  856.  
  857.  
  858. Gulam Variables and Environment
  859. -------------------------------
  860.  
  861. The following shell variables cause/control useful effects.  The format of
  862. the explanation is `variable_name: default-value meaning'.
  863.  
  864. `batch_max_nesting: 20'     
  865.      if you need to nest batch file execution at levels deeper than this,
  866.      change this variable.
  867.      
  868. `batch_echo: 0'     
  869.      if  1  echoes each command of the batch file as it is executed.  
  870.      
  871. `baud_rate: none'     
  872.      for  use  in  the  terminal  emulator, rx/sx file transfers.  
  873.      
  874. `cwd:'     
  875. `CWD: full  pathname  of  current directory'     
  876.      gets re-set every time a cd, pushd or popd is executed.  
  877.      
  878. `delay: unset'     
  879.      set it to control the duration that the cursor sits
  880.      on a matching paren, bracket, or brace.  A value of 2000 produces about
  881.      a 2-sec delay.
  882.      
  883. `dir_cache: 0'     
  884.      if non-0, turns on the dir list cache.  This substantially speeds up the
  885.      Tenex file name completion.
  886.      
  887. `ginprompt: $<'     
  888.      the  prompt  shown  when  asking you for input in dollar-substituting a $<.
  889.      
  890. `gulam_help_file: none'     
  891.      set this var to the full pathname of the `gulam.hlp' file, which
  892.      contains descriptive info about keys, functions, bindings and
  893.      commands.  Unless this var is set properly, the wall chart that
  894.      `ue' generates is of not much use.
  895.      
  896. `histfile: none'     
  897.      reads and saves history in file named $histfile .
  898.      
  899. `history: 20'     
  900.      This variable controls the number of previous commands displayed
  901.      by the command `history'.
  902.      
  903. `home'     
  904. `HOME: full pathname of home directory'     
  905.      home  is  the directory you were in before invoking *Gulam*.  
  906.      
  907. `mscursor: unset'     
  908.      set it to a string of 4 digits (e.g., "0508").  This
  909.      controls the scaling of mouse movements being turned into cursor keys.  If
  910.      it is set to "0000", mouse movements do not get translated to cursor keys.
  911.      
  912.      
  913. `ncmd: number  of  the  current  command'     
  914.      gets  set  after each executing each command.  
  915.      
  916. `nrows: unset'     
  917.      This variable controls the number of lines per screen.  At present, only
  918.      valid values are 25 or 50.  Changing `nrows' to 50 will cause the
  919.      re-initialization of the screen using the small system font.
  920.      
  921. `path: unset'     
  922.      when set, it will cause the environment variable PATH to be
  923.      automatically also set to the same string ($path), and cause
  924.      rehashing.
  925.      
  926. `parent_expand: unset'     
  927.      when set, the Tenex name completion will provide the full path name rather
  928.      than just the leaf name.
  929.  
  930. The following pr_XXX vars are relevant with `print', and `lpr'
  931. commands.  When set, these strings are sent to the printer :
  932.  
  933. `pr_bof: unset'     
  934.      send before printing each new file.
  935. `pr_eol: rn'     
  936.      send after each line.
  937. `pr_eop:214'     
  938.      send after each page (214 == ASCII   + 0200). 
  939. `pr_eof: 214'     
  940.      send after the end of file.  
  941.  
  942. Thus, to have a left margin of eight-spaces, just define `pr_eol' as
  943. `rnt'.  To turn condensed mode etc., just set
  944. `pr_bof' to the appropriate string after looking it up in the
  945. printer's manual.  See the section on strings for an explanation of
  946. .
  947.  
  948. `prompt: >>'     
  949.      see gulam.g for an example.
  950. `prompt_tail: unset;'     
  951.      when set,   $prompt_tail  is  appended  to  the  displayed  prompt
  952.      string.   This is a kludge to mollify those of you who insist
  953.      on having a trailing blank in their prompt! 
  954. `rgb'     
  955. `RGB: `000-700-007-070-''     
  956.      sets  the  palette:  3 octal digits (followed by a  dummy  '-')  per
  957.      color;  2  in  hi-rez,  4  in med-rez, 16 in low-rez.
  958. `rx_remote_cmd: unset'     
  959.      command  to  send  to remote to receive file
  960.      with  Xmodem.   For  our  Unix, this string is `xm st'.  The rx
  961.      command  appends  a space followed by the file name and sends
  962.      the resulting string to the remote as if you typed it.  
  963. `sx_remote_cmd: unset'     
  964.      command to send to remote to send file with Xmodem.  Similar to the above.  
  965. `semicolon_max: 20'     
  966.      Number  of `;' per line; to stop infinite recursions in alias expanded
  967.      commands.
  968. `status'     
  969.      status  of  the  most  recent external command; set after each external
  970.      command.
  971. `sz_rs232_buffer: unset'     
  972.      The  built-in  terminal  emulator,  when invoked,  will  reallocate  a
  973.      buffer  of  this size (if this value  is  >  256) for the associated IOREC.
  974.      If unset, or if set  but  to  a  value  lower  than  4096, you may experience
  975.      XON/XOFF occuring at 9600.  I recommend 4096.
  976. `time: unset'     
  977.      If set to non-0, times every command.  
  978. `verbosity: unset'     
  979.      This controls the amount of feed back you get from *Gulam*.  When
  980.      unset, or set to <= 0, *Gulam* will be extremely quiet, and report
  981.      only on errors.  If you wish commands like `cp' to report the
  982.      goings-on, set verbosity to 2.
  983.  
  984.  
  985. HELP
  986. ----
  987.  
  988. The all-upper case name `HELP' in this manual stands for the key marked
  989. `HELP' on the Atari ST.  Pressing this key, outside the `ue', will
  990. show all the *Gulam* built-in commands, and a brief version of the
  991. hash table.  Within `ue', it can show the binding of an individual
  992. key, or produce a wall-chart of all bindings.
  993.  
  994. The `shift-HELP' key resets the special key table mapping that Gulam/uE
  995. use; after pressing `shift-HELP' the function keys, and arrow keys
  996. become equivalent to `', and the keypad will work as a typcial
  997. numerical keypad.  To get back to the Gulam/uE key table, press
  998. ` ', which not only refreshes the display but also sets the key
  999. table.
  1000.  
  1002. File: gulam.info  Node: help, Prev: grep, Up: Glossary, Next: history
  1003.  
  1004. help
  1005. ----
  1006.  
  1007. Typing the letters `help' while outside `ue', or in buffer
  1008. *gulam* is equivalent to pressing `HELP'.
  1009.  
  1011. File: gulam.info  Node: history, Prev: help, Up: Glossary, Next: if
  1012.  
  1013. history
  1014. -------
  1015.      history [-h]
  1016.  
  1017. The `history' command lists the last N commands.  Each command is
  1018. preceded by its number; to suppress these numbers, supply the `-h'
  1019. flag.  The value N is obtained by `$history'.  To change this N to,
  1020. say, 30, do `set history 30'.
  1021.  
  1023. File: gulam.info  Node: history-substitutions, Prev: flags, Up: top, Next: io-redirection
  1024.  
  1025. History Substitutions
  1026. ---------------------
  1027.  
  1028. Occurrences of the form `!!', `!number', `!string' refer to
  1029. the text of previously issued commands.  The text of these older commands
  1030. itself does not contain `!' unless it is part of a string argument.
  1031. Each `!!' is replaced by the text of the immediately preceding
  1032. command.  *Gulam* consecutively numbers the commands that you have
  1033. issued.  (The current count can be seen in the shell variable named
  1034. NCMD.) Each `!n' is replaced by the
  1035. n-th  old  command.   Each  `!str' is a replaced by the most recent
  1036. old command that begins with str.  
  1037.  
  1038. The name completion feature works with history substitutions also.
  1039. Pressing `INSERT' or `ESC-ESC' will bring the history-matched
  1040. command and replace the current line in the buffer, which you can further
  1041. edit.
  1042.  
  1043.  
  1044. $home also $HOME
  1045. ----------------
  1046.  
  1047. The shell variable "home" is initially set to the full pathname of the
  1048. directory from which *Gulam* was invoked.  However, it can be set
  1049. again with set command to whatever.  The wiggle `~' in file
  1050. names expands to "$HOME".  
  1051.  
  1053. File: gulam.info  Node: if, Prev: history, Up: Glossary, Next: lpr
  1054.  
  1055. if
  1056. --
  1057.  
  1058. The "if" stmt is similar to those in many programming languages.  The
  1059. Boolean expression of shell if stmts typically involves tests on file names
  1060. and types.  (See Expressions.) There is no `then'.  Any remaining
  1061. lexemes after the Boolean exp are ignored.
  1062.  
  1063.      if {-d e:\gulam\lex} + 2 == 3 
  1064.              echo e:\gulam\lex is a dir 
  1065.      ef -e e:\gulam\lex      # read ef as `else if' 
  1066.              echo e:\gulam\lex does exist 
  1067.      ef 
  1068.              echo e:\gulam\lex does NOT exist 
  1069.      endif 
  1070.  
  1072. File: gulam.info  Node: io-redirection, Prev: history-substitutions, Up: top, Next: metacharacter-expansion
  1073.  
  1074. IO Redirection
  1075. --------------
  1076.  
  1077. Prefixing a file name F with `>' causes all standard output
  1078. produced by that command to get deposited into file F.  Similarly,
  1079. `<g' will cause standard input to be taken from the file G
  1080. rather than the key board.  If you prefer, you may include white chars
  1081. between the `<' (or `>' ) and the filename.  If you have more
  1082. than one `<', or `>' in a command all but the last are ignored.
  1083.  
  1084. Note that because of TOS and compiler peculiarities, not all external
  1085. commands will behave as above.
  1086.  
  1087.      ls -l > lsout # get the ls -l output into file lsout
  1088.      ls -l >> f1   # append the ls -l output to f1
  1089.      ecmd '>blah'  # invoke ecmd and give it the arg >blah as is to it.  
  1090.  
  1092. File: gulam.info  Node: kb, Prev: if, Up: Glossary, Next: lpr
  1093.  
  1094. kb
  1095. --
  1096.  
  1097. This command redefines microEmacs keybindings.  To bind key with code 144
  1098. to function with hex-number 1d while you are in the *regular* buffer,
  1099. do
  1100.  
  1101.      kb -r 144 1d      
  1102.  
  1103. Use -g for redefining the bindings of *gulam* buffer; -m for mini
  1104. buffer.  You can find the key codes and hex-numbers of functions in the
  1105. wall-chart (shown below), which can be produced by pressing the `HELP'
  1106. key, a `B', and then a `r' (or `g', or `m').  The key
  1107. names, and function names will not appear unless a `set
  1108. gulam_help_file <filename>' was done earlier.
  1109.  
  1110.      key-code in hex
  1111.      |    function code in hex
  1112.      |    |    key name (kb ignores this)
  1113.      |    |    |         function name (kb ignores this)
  1114.      ---------------------------------------------------
  1115.      081  5c   F1         kill-backward-word
  1116.      082  5d   F2         kill-word
  1117.      083  20   F3         kill-line
  1118.      084  35   F4         copy-region-as-kill
  1119.      085  51   F5         kill-buffer
  1120.      086  50   F6         list-buffers
  1121.      087  4e   F7         switch-to-buffer
  1122.      088  3f   F8         write-file
  1123.      089  3d   F9         find-file
  1124.      08a  3e   F10        save-buffer
  1125.      08b  14   HELP       help
  1126.      08c  0d   UNDO       quick-exit
  1127.      08d  62   INSERT     scroll-down
  1128.      08e  61   HOME       scroll-up
  1129.      0bb  23   UPARRO     previous-line
  1130.      0bc  0f   DNARRO     gulam-forward-line
  1131.      0bd  1a   LTARRO     backward-char
  1132.      0be  1b   RTARRO     forward-char
  1133.      140  30   C-@       set-mark-command
  1134.      141  1e   C-A        beginning-of-line
  1135.      142  1a   C-B        backward-char
  1136.      143  06   C-C        switch-to-gulam-buffer
  1137.      144  1d   C-D        delete-char
  1138.      145  1f   C-E        goto-end-of-line
  1139.      146  1b   C-F        forward-char
  1140.      147  13   C-G        keyboard-quit
  1141.      148  1c   C-H        backward-delete-char
  1142.      149  11   TAB        goto-next-tab
  1143.      14a  25   LFD        newline-and-indent
  1144.      14b  20   C-K        kill-line
  1145.      14c  19   C-L        redraw-display
  1146.      14d  10   RET        gulam-do-newline
  1147.      14e  0f   C-N        gulam-forward-line
  1148.      14f  22   C-O        open-line
  1149.      150  23   C-P        previous-line
  1150.      151  33   C-Q        quoted-insert
  1151.      152  2b   C-R        search-backward
  1152.      153  2c   C-S        search-forward
  1153.      154  34   C-T        transpose-chars
  1154.      156  61   C-V        scroll-up
  1155.      157  36   C-W        kill-region
  1156.      159  3b   C-Y        yank
  1157.      15a  0e   C-Z        temporary-exit
  1158.      15f  14   C-_        help
  1159.      029  6b   )          blink-matching-paren-hack
  1160.      07d  6b   }         blink-matching-paren-hack
  1161.      05d  6b   ]          blink-matching-paren-hack
  1162.      0c0  0c   KLP        move-window-dn
  1163.      0c1  0b   KRP        move-window-up
  1164.      0c7  4a   KSLASH     split-window-vertically
  1165.      0c2  49   KSTAR      delete-other-windows
  1166.      0c5  45   KMINUS     previous-window
  1167.      0c3  44   KPLUS      next-window
  1168.      0c4  17   KENTER     call-last-kbd-macro
  1169.      0c6  26   KDOT       goto-line
  1170.      0b0  0a   K0         terminal-emulator
  1171.      0b7  55   K7         beginning-of-buffer
  1172.      0b8  32   K8         recenter
  1173.      0b9  54   K9         end-of-buffer
  1174.      0b4  5a   K4         backward-word
  1175.      0b5  23   K5         previous-line
  1176.      0b6  5e   K6         forward-word
  1177.      0b1  1e   K1         beginning-of-line
  1178.      0b2  0f   K2         gulam-forward-line
  1179.      0b3  1f   K3         goto-end-of-line
  1180.      541  09   C-X C-A    show-key-board-macro
  1181.      542  50   C-X C-B    list-buffers
  1182.      543  12   C-X C-C    save-buffers-kill-emacs
  1183.      546  3d   C-X C-F    find-file
  1184.      549  4d   C-X TAB    insert-buffer
  1185.      54f  41   C-X C-O    delete-blank-lines
  1186.      54e  0c   C-X C-N    move-window-dn
  1187.      550  0b   C-X C-P    move-window-up
  1188.      552  08   C-X C-R    read-file
  1189.      553  3e   C-X C-S    save-buffer
  1190.      556  3d   C-X C-V    find-file
  1191.      557  3f   C-X C-W    write-file
  1192.      558  42   C-X C-X    exchange-point-and-mark
  1193.      55a  46   C-X C-Z    shrink-window
  1194.      421  27   C-X !      execute-one-Gulam-command
  1195.      421  07   C-X !      execute-buffer
  1196.      43d  43   C-X =      what-cursor-position
  1197.      428  15   C-X (      start-kbd-macro
  1198.      429  16   C-X )      end-kbd-macro
  1199.      431  49   C-X 1      delete-other-windows
  1200.      432  4a   C-X 2      split-window-vertically
  1201.      442  4e   C-X B      switch-to-buffer
  1202.      445  17   C-X E      call-last-kbd-macro
  1203.      446  18   C-X F      no-op
  1204.      449  3c   C-X I      file-insert
  1205.      44b  51   C-X K      kill-buffer
  1206.      44e  44   C-X N      next-window
  1207.      44f  44   C-X O      next-window
  1208.      450  45   C-X P      previous-window
  1209.      453  52   C-X S      save-some-buffers
  1210.      45a  47   C-X Z      enlarge-window
  1211.      348  5c   ESC C-H    kill-backward-word
  1212.      221  07   ESC !      execute-buffer
  1213.      22e  30   ESC .      set-mark-command
  1214.      23e  54   ESC >      end-of-buffer
  1215.      23c  55   ESC <      beginning-of-buffer
  1216.      25b  56   ESC [      beginning-of-paragraph
  1217.      25d  57   ESC ]      end-of-paragraph
  1218.      225  2f   ESC %      query-replace
  1219.      220  59   ESC SPC    just-one-space
  1220.      242  5a   ESC B      backward-word
  1221.      243  5b   ESC C      capitalize-word
  1222.      244  5d   ESC D      kill-word
  1223.      246  5e   ESC F      forward-word
  1224.      247  06   ESC G      switch-to-gulam-buffer
  1225.      24c  5f   ESC L      downcase-word
  1226.      251  29   ESC Q      fill-paragraph
  1227.      252  2b   ESC R      search-backward
  1228.      253  2c   ESC S      search-forward
  1229.      255  60   ESC U      upcase-word
  1230.      256  62   ESC V      scroll-down
  1231.      257  35   ESC W      copy-region-as-kill
  1232.      27f  5c   ESC DEL    kill-backward-word
  1233.      35b  05   ESC ESC    expand-name-gulam-style
  1234.      344  63   ESC C-D    expand-names-and-show-them
  1235.      346  04   ESC C-F    file-name
  1236.      07f  1c   DEL        backward-delete-char
  1237.      0ab  37   SHIFT-HELP keys-reset
  1238.      000  00   NUL        no-op
  1239.      000  00   NUL        no-op
  1240.      000  00   NUL        no-op
  1241.      000  00   NUL        no-op
  1242.      000  00   NUL        no-op
  1243.      000  00   NUL        no-op
  1244.      000  00   NUL        no-op
  1245.      000  00   NUL        no-op
  1246.      000  00   NUL        no-op
  1247.      000  00   NUL        no-op
  1248.  
  1250. File: gulam.info  Node: lpr, Prev: if, Up: Glossary, Next: ls
  1251.  
  1252. lpr
  1253. ---
  1254.      lpr FILENAMES
  1255.  
  1256. The command `lpr' prints its files as-is, with no processing at the
  1257. end of lines.
  1258.  
  1260. File: gulam.info  Node: ls, Prev: lpr, Up: Glossary, Next: mem
  1261.  
  1262. ls
  1263. --
  1264.      ls [-ltrRLF] FILENAMES 
  1265.  
  1266. The `ls' (list files) command, with no arguments, prints the sorted
  1267. list of names of the files in the current directory.  It has a number of
  1268. useful flag arguments, and can also be given the names of directories as
  1269. arguments, in which case it lists the names of the files in these
  1270. directories.
  1271.  
  1272. If no flags are given, `ls' prints only the filenames.  The `-L'
  1273. causes a full-length line for each file giving its attributes, size,
  1274. creation date, and name.  The `-l' (small el) is the same as `-L'
  1275. except that the output is sorted by name.  The `-R' will cause the
  1276. subtrees of directories in the argument list of files to be traversed.  The
  1277. `-F' will append to each listed filename one char that indicates the
  1278. type of that file: `*' if it is executable (i.e., has an extension of
  1279. `.prg, .tos, .ttp', or `.g'), a `\' if its is a directory, a
  1280. ' ' otherwise.  The `-t' causes a sort by time of modification of the
  1281. files.  The `-r' reverses the chosen order of sorting.
  1282.  
  1283. `ls' always (even if DIR_CACHE is 1)
  1284. updates the directory cache for the relevant directories.
  1285.  
  1287. File: gulam.info  Node: mem, Prev: ls, Up: Glossary, Next: mcdir
  1288.  
  1289. mem
  1290. ---
  1291.  
  1292. `mem' shows the list of free chunks of memory available.  It does
  1293. this by following lists starting at an (undocumented) TOS location
  1294. (`0x7e8e' for ROMS dated 04221987, `56ec' for older ROMS),
  1295. Because of the way *Gulam* uses dynamically allocated memory,
  1296. the size of the largest free chunk fluctuates both up and le:.
  1297. ysysy´ש),catr \'-Lc´inee ate`-L
  1298. e, Ns e(iòhe
  1299. alwlar, PdateXמthe  (ut tt£JΓ⌠⌠⌠inei⇦Õ
  1300.  
  1301.  
  1302.  
  1303. IR'R
  1304. c
  1305. namnR'Rµ