home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_2.iso / files / 652a.lha / SKsh_v2.0 / Readme_1st.doc next >
Text File  |  1992-05-25  |  7KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                       Important Stuff - Read This First!
  17.  
  18.                                      SKsh
  19.  
  20.                         A ksh-like Shell for the Amiga
  21.  
  22.                                   Version 2.0
  23.  
  24.  
  25.                              (Copyright) 1988-1992
  26.  
  27.                                   Steve Koren
  28.  
  29.                                  May 25, 1992
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.        Important: Please Read This First!
  74.  
  75.          This archive  contains the 2.0 release of SKsh, a shell for the
  76.          Amiga  which  is  similar to Unix ksh.  1.2 was the first  'Re-
  77.          lease' version; 1.0 and 1.1 were beta versions.
  78.  
  79.          SKsh  provides  a  number of things that other Amiga shells  do
  80.          not. I hope it will be  useful to Unix users who wish to have a
  81.          similar  environment on the Amiga.   Unix  provides many things
  82.          that SKsh does not, but  SKsh  comes  closer  than  most  other
  83.          Amiga shells.
  84.  
  85.          Please  understand that since the code can change at any  time,
  86.          absolutely anything you read here is also subject to change.
  87.  
  88.          Suggestions can be sent to me  (Steve  Koren)  by  one  of  the
  89.          methods listed in the "MiscInfo.doc" document.
  90.  
  91.          The  following files are  included in this documentation.  This
  92.          list is also subject to change:
  93.  
  94.             Addendum?.?.doc  - An addendum for each release
  95.             Bugs.doc         - Bug reports, limitations, etc. 
  96.             Diffs.doc        - Very incomplete list of diffs from ksh
  97.             ErrorCodes.doc   - The SKsh error codes
  98.             ExtCmds.doc      - Reference manual for external commands
  99.             Hints.doc        - A few hints for using SKsh
  100.             Install.doc      - How to Install SKsh - important
  101.             MiscInfo.doc     - How to report bugs, etc.
  102.             ReadMe_1st.doc   - This file
  103.             Reference.doc    - Reference manual for builtin stuff
  104.             TechNotes.doc    - Technical and implementation notes
  105.             TinySKsh.doc     - Briefly describes tiny_sksh
  106.             UserMan.doc      - User's guide to using SKsh
  107.             View.doc         - Describes the "view" command
  108.  
  109.          The UserMan.doc file is an introduction and tutorial  to  SKsh.
  110.          The Reference.doc file is a more  complete  reference  on  most
  111.          SKsh commands except external binaries, which are described  in
  112.          the ExtCmds.doc and View.Doc files.
  113.  
  114.          The folowing SKsh and initialization files should be included:
  115.  
  116.             sksh             - the main SKsh binary + builtins
  117.             sksh.msg         - the sksh message file
  118.             tiny_sksh        - smaller, unsupported version of SKsh
  119.             .skshinit        - initialization file for SKsh
  120.             .skshinit.pp     - preparsed form of above
  121.             .skshrc          - user customization file for SKsh
  122.             stuff.sksh       - other useful functions
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.        SKsh Amiga Shell             Page 2           Readme Information
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          The following external binary files should be included:
  140.  
  141.             bdf              - list mounted disks
  142.             cat              - concatenate files
  143.             cmp              - compare files
  144.             cp               - copy files
  145.             crc              - perform crc check on files
  146.             cut              - cut characters or fields
  147.             doc2man          - split man page entries
  148.             du               - check disk usage
  149.             encr             - encrypt/decrypt files
  150.             fgrep            - fast search for strings in files
  151.             find             - find files in directory tree
  152.             fmt              - a simple text formatter
  153.             fold             - fold long lines into shorter ones
  154.             grep             - search for expressions in files
  155.             head             - obtain first few lines of files
  156.             indent           - indent lines of files
  157.             join             - join files together
  158.             ln               - create filesystem links
  159.             num              - number lines in files
  160.             paste            - combine files into columns
  161.             printenv         - print AmigaDos environment variables
  162.             split            - split ASCII files into small pieces
  163.             srun             - run command in background
  164.             strings          - search for strings in files
  165.             tail             - obtain last few lines of files
  166.             tee              - copy input to files and std output
  167.             view             - file type encapsulator
  168.             usecount         - info about running shells
  169.             wc               - count lines, words, and characters
  170.             window           - window operations
  171.             xargs            - execute command lines on parameters
  172.             xd               - hex dump of files
  173.  
  174.  
  175.          The  following  SKsh  commands  are  implemented as scripts and
  176.          should be included as well:
  177.  
  178.             chext            - changes extensions of files
  179.             cleard           - clear the directory stack
  180.             dstack           - list the directory stack
  181.             emacs_mode       - use emacs command line editing mode
  182.             histlist         - list saved history files
  183.             histload         - load shell history from a file
  184.             histrm           - remove saved shell history files
  185.             histsave         - save shell history in a file
  186.             man              - look up entries in manual pages
  187.             path             - examine, set, or modify paths
  188.             popd             - pop directory from directory stack
  189.             pushd            - push directory onto directory stack
  190.             qrm              - query remove files
  191.             quit_serv        - stop SKsh ARexx servers
  192.             usage            - print usage message for commands
  193.  
  194.  
  195.        SKsh Amiga Shell             Page 3           Readme Information
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.             vi_mode          - use vi command line editing mode
  206.  
  207.  
  208.          These files should also be  included, although their use is op-
  209.          tional:
  210.  
  211.             Stuff.sksh       - optional utilities, functions, aliases
  212.             view.magic       - Sample magic file for the "view" command
  213.             tiny_sksh        - A smaller, more limited version of SKsh
  214.             crypted_data     - encrypted english text from encr
  215.             Install_?.?.sksh - a script file to assist in installation
  216.  
  217.          If you do not have ALL of  the  above  files,  your  version of
  218.          SKsh is incomplete.
  219.  
  220.          Also, please  carefully read the Installation guide.  You *can-
  221.          not*  simply type  SKsh  and  expect it to run; you must follow
  222.          the directions there for proper results.
  223.  
  224.          Also, please read the SKsh  copyright  statement  contained  in
  225.          the UserMan.doc file.  SKsh is NOT public domain software.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.        SKsh Amiga Shell             Page 4           Readme Information
  262.  
  263.  
  264.  
  265.