home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 262.lha / ArpDoc_v1.3 / Set < prev    next >
Text File  |  1989-07-01  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4.      Set(V1.3)               ARP User's Manual               Set(V1.3)
  5.  
  6.  
  7.  
  8.      NAME
  9.           Set - Set or clear the value of an environment variable.
  10.  
  11.      SYNOPSIS
  12.           Set Variable=Value/... ESCAPE/k BCPL/k LISTALL/s
  13.  
  14.      DESCRIPTION
  15.       The ARP Set command allows you to manipulate the old format
  16.           MANX/Rokiki environment variables.  These are different from
  17.       environment variables created with the new V1.3 "SetEnv" and
  18.       "GetEnv" commands.  Programs which use the arp.library
  19.       environment variables will be able to read variables set by
  20.       either "Set" or "Setenv".
  21.  
  22.           To set the value of an environment variable, simply use SET
  23.           VARNAME=VAL, which sets the value of VARNAME to VAL.  To
  24.           remove this environment variable do Set VARNAME= or Set
  25.           VARNAME. There is no limit to the number of variables you
  26.           can set and clear with one command.  You can intermix
  27.           setting and clearing variables on the same command line.
  28.  
  29.           To view the values of all current environment variables,
  30.           simply use Set without any arguments.
  31.  
  32.           You can use spaces in your variable names and values, but it
  33.           is not generally a good idea.  If you do use spaces, you
  34.           must surround the complete expression with double quotes,
  35.           i.e., "Variable Name=Variable Value". Note that the similar
  36.           looking expression "Variable Name = Variable Value" has
  37.           hidden spaces.  The Variable ends with a space, and the
  38.           value begins with one. This is only one example of how
  39.           problematical spaces in environment variables and values can
  40.           become.
  41.  
  42.           Set also has special features for setting the Escape
  43.           character and increasing the amount of BCPL compatibility.
  44.           You can set the current escape character by using the ESCAPE
  45.           <char> keyword.
  46.  
  47.           One source of problems with old script files and ARP is the
  48.           use of the star "*" to refer to the current window.  ARP
  49.           programs tend to regard the star "*" as a wildcard, as is
  50.           common.  If you use the BCPL keyword to do SET BCPL TRUE,
  51.           those programs which tend to have problems with this will
  52.           attempt to overlook the "*" as a wildcard.
  53.  
  54.           Finally, you can get a listing of all variables, including
  55.           the values of ESCAPE and BCPL by using the keyword LISTALL.
  56.  
  57.      EXAMPLE
  58.           Set DODAH=SONG dateformat=0 copyflags= ESCAPE \
  59.  
  60.           The command line above creates or redefines the variable
  61.           DODAH to have the value SONG, dateformat to have the value
  62.  
  63.      Page 1                                          (printed 4/28/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Set(V1.3)               ARP User's Manual               Set(V1.3)
  71.  
  72.  
  73.  
  74.           0, removes the variable copyflags from the environment, and
  75.           sets the current ESCAPE character to \.
  76.  
  77.      ADDITIONAL CONSIDERATIONS
  78.           The ARP Shell also has builtin environment variable
  79.           expansion and assignment features.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/28/89)
  130.  
  131.  
  132.  
  133.