home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / cs-dos.arc / INTRO.TXT < prev    next >
Encoding:
Text File  |  1990-03-24  |  16.9 KB  |  2 lines

  1.  
  2.  
  3.                                        ├╙-─╧╙
  4.  
  5.  
  6.  
  7.                       ─OCUMENTATION FOR ─╧╙ SHELL ╓ERSION 1.42
  8.  
  9.  
  10.  
  11.                             ├OPY╥IGHT 1987,1989 ├HRIS ╙MEETS
  12.  
  13.  
  14.  
  15. -----------------------------------------------------------------------------
  16.  
  17.        ╔╬╘╥╧─╒├╘╔╧╬
  18.  
  19.  
  20.  
  21.            ├╙-─╧╙ FOR  THE ├OMMODORE 128 EVOLVED FROM AND IN MANY RESPECTS IS
  22.        SIMILAR TO  THE ├OMMODORE  64 ┴╥├64  UTILITY. ╔F YOU ARE FAMILIAR WITH
  23.        ┴╥├64, THEN  YOU SHOULD  CATCH ON TO ├╙-─╧╙ RATHER QUICKLY. ┴T LEAST A
  24.        RUDIMENTARY FAMILIARITY  WITH ┴╥├64 IS ASSUMED IN THIS DOCUMENT. ┴╥├64
  25.        HAS BEEN  AROUND FOR SEVERAL YEARS NOW SO MORE THAN LIKELY YOU'VE COME
  26.        ACCROSS IT  BEFORE; OTHERWISE YOU PROBABLY WOULDN'T BE READING THIS IN
  27.        THE FIRST  PLACE. ╘HE RELEVANT PORTIONS OF THE ┴╥├64 DOCUMENTATION ARE
  28.        REPEATED HERE  IN A ├128 CONTEXT, BUT YOU MIGHT STILL FIND THEM USEFUL
  29.        AS A SUPPLEMENT TO THIS DOCUMENT.
  30.  
  31.            ╔N ORDER  TO MAKE  IT EASY TO ADD NEW COMMANDS AND FEATURES TO ├╙-
  32.        ─╧╙, ALOT  OF REORGANIZATION HAD TO BE DONE. ╞IRST OF ALL, THE PROGRAM
  33.        HAS BEEN  BROKEN DOWN INTO SEVERAL SMALLER INTER-RELATED CHUNKS. ╘HERE
  34.        ARE NO  BUILT IN  COMMANDS. ┴LL  OF THE  COMMANDS ARE  EXTERNAL.  ╘HIS
  35.        SOUNDS LIKE  A STEP  DOWN, BUT  IT'S NOT.  ╔T'S ACTUALLY  A  BIG  STEP
  36.        UPWARDS. ┴NY  COMMAND, OR  ANY PROGRAM, MACHINE LANGUAGE OR ┬┴╙╔├, CAN
  37.        BE MADE  TO BEHAVE  JUST LIKE  A BUILT IN COMMAND SIMPLY BY COPYING IT
  38.        FROM THE FLOPPY DISK INTO AN INTERNAL ╥┴═ DISK. ╘HIS ADDS A GREAT DEAL
  39.        OF FLEXIBILITY  SINCE YOU  CAN NOW  PICK AND CHOOSE WHICH COMMANDS YOU
  40.        WANT OR DON'T WANT, AND CAN EVEN ADD A FEW COMMANDS OF YOUR OWN.
  41.  
  42.            ╘HE BIGGEST, OR RATHER, THE MOST IMPORTANT CHUNK IS THE ─╧╙ SHELL.
  43.        ╘HIS IS  THE FIRST PROGRAM THAT IS INSTALLED WHEN YOU BOOT THE SYSTEM.
  44.        ╘HE  SHELL'S   PRIMARY  FUNCTION   IS  TO  SERVE  AS  A  COMMAND  LINE
  45.        INTERPRETER. ╘HAT  IS, WHEN  YOU ENTER  A LINE OF TEXT AND HIT ╥┼╘╒╥╬,
  46.        THE SHELL ANALYZES THE LINE YOU ENTERED AND BASED ON WHAT IT FINDS, IT
  47.        EITHER EXECUTES  AN EXTERNAL (FROM FLOPPY) OR INTERNAL (FROM ╥┴═ DISK)
  48.        PROGRAM, OR  SIMPLY PASSES THE LINE ON TO THE ┬┴╙╔├ INTERPRETER. ╫HILE
  49.        IT'S AT  IT, IT  ALSO PARSES  THE COMMAND  LINE AND CHECKS FOR SPECIAL
  50.        CHARACTERS THAT  TELL IT  TO RE-DIRECT ALL SCREEN OUTPUT EITHER TO THE
  51.        PRINTER OR  TO A  DISK FILE.  ╘HE ╙╚┼╠╠  ALSO PROVIDES  A  LIBRARY  OF
  52.        SUBROUTINES WHICH ARE ACCESSED BY VARIOUS EXTERNAL COMMANDS.
  53.  
  54.            ╔F YOU  HAPPEN TO  HAVE AN  EXTRA 1571 LAYING AROUND AND YOU DON'T
  55.        MIND TYPING  A DRIVE  LETTER IN FRONT OF EVERY COMMAND, THEN YOU'RE ON
  56.        YOUR WAY  ONCE THE  ╙╚┼╠╠ HAS BEEN LOADED. ╘HE 1571 IS PRETTY QUICK AT
  57.        GETTING THE  COMMANDS INTO  PLACE, SO  THIS ISN'T  A BAD WAY TO FLY IF
  58.        YOU'RE USING  SEVERAL DRIVES.  ═ORE LIKELY,  HOWEVER, YOU'LL  WANT  TO
  59.        INTERNALIZE AT  LEAST A  FEW OF  THE MOST  COMMONLY USED  COMMANDS AND
  60.        INSTALL A ╥┴═ DISK. ╘HATS WHERE ┴╒╘╧┼╪┼├ COMES IN.
  61.  
  62.            ╧NCE THE ╙╚┼╠╠ IS ╥╒╬, AND GETS ITSELF INTO PLACE, THE FIRST THING
  63.        IT DOES  IS CHECK  DRIVE 0 OF UNIT 8 FOR A ╙┼╤ FILE CALLED "AUTOEXEC".
  64.        ┴╒╘╧┼╪┼├ IS  JUST A  REGULAR TEXT  FILE  AND  WHATEVER  IS  IN  IT  IS
  65.        "┼╪┼├UTED" JUST  AS IF  IT HAD  BEEN TYPED  FROM THE KEYBOARD. ╘HIS IS
  66.        YOUR CHANCE TO CONFIGURE THINGS THE WAY YOU'RE USED TO THEM. ╨╧╦┼ YOUR
  67.        FAVORITE SCREEN  COLORS INTO PLACE, SETUP DRIVE NUMBERS, INSTALL A ╥┴═
  68.        DISK AND  IF YOU LIKE, PLAY YOUR FAVORITE ROCK AND ROLL SONG AND WATCH
  69.        YOUR NAME FLASH ACROSS THE SCREEN IN 16 BRILLIANT COLORS.
  70.  
  71.            ╙┼╘╥┴═ WILL INSTALL A ╥┴═ DISK FOR YOU. ┘OU CAN STICK THE ╥┴═ DISK
  72.        IN EITHER  BANK 1  OR BANK 0, OR IF YOU HAVE ACCESS TO AN ┼╨╥╧═ BURNER
  73.        YOU MAY  WANT TO  STICK IT  IN ONE  OF BANKS  4 TO  12 LATER  ON.  ╞OR
  74.        STARTERS, BANK 1 IS THE BEST PLACE TO STICK IT. ╔ WON'T GO INTO DETAIL
  75.        ABOUT ╙┼╘╥┴═  HERE AS  IT'S DESCRIBED ELSEWHERE. ╞OR NOW JUST TYPE (OR
  76.        INCLUDE IN YOUR ┴╒╘╧┼╪┼├ ╞╔╠┼) THE LINE:
  77.  
  78.              A:SETRAM 1,49152
  79.  
  80.            ╘HIS WILL  RESERVE AN  AREA OF  ╥┴═ IN BANK 1 STARTING AT LOCATION
  81.        49152 ($├000)  AND ENDING AT WHATEVER HAPPENS TO BE THE CURRENT TOP OF
  82.        ╥┴═ FOR  ┬┴╙╔├ (NORMALLY  $╞┼╞╞). ┘OU'VE NOW GOT 16╦ OF ╥┴═ TO FILL UP
  83.        WITH COMMANDS.  ╘HE FIRST ONE YOU'LL WANT TO INSTALL IS ╔╬╙╘┴╠╠, WHICH
  84.        IS THE COMMAND TO ADD NEW COMMANDS TO THE ╥┴═ DISK. ─O THIS WITH:
  85.  
  86.              A:INSTALL A:INSTALL
  87.  
  88.            ╘HE FIRST  "A:INSTALL" TELLS  THE SHELL  TO SEARCH  DRIVE A: FOR A
  89.        FILE NAMED "INSTALL" AND LOAD IT INTO THE ├-128'S MEMORY. ╧NCE LOADED,
  90.        THE SHELL  TRANSFERS CONTROL  OVER TO  THE LOADED  PROGRAM. ╘HE  SHELL
  91.        PASSES THE  SECOND PARAMETER  "A:INSTALL" TO THE INSTALL PROGRAM WHICH
  92.        THEN COPIES THE FILE FROM FLOPPY INTO THE INTERNAL ╥┴═ DISK.
  93.  
  94.            ┘OU NOW HAVE ONE INTERNAL COMMAND. ╬OW THAT "INSTALL" IS INTERNAL,
  95.        IT WILL  BEHAVE ALOT  LIKE A  ┬┴╙╔├ KEYWORD. ┘OU WON'T HAVE TO INCLUDE
  96.        THE "A:"  ANYMORE. ╬OTE, HOWEVER, THAT INSTALLED COMMANDS ONLY WORK IN
  97.        DIRECT MODE, AND HAVE NO EFFECT IF INCLUDED IN A ┬┴╙╔├ PROGRAM.
  98.  
  99.            ╬EXT YOU'LL  WANT TO  INSTALL  SOME  OF  THE  MORE  COMMONLY  USED
  100.        COMMANDS. ╞OR INSTANCE...
  101.  
  102.              INSTALL REMOVE DIR RDIR REN ARC
  103.  
  104.            ╫OULD INTERNALIZE FIVE MORE COMMANDS, OR IF YOU'RE IMPATIENT...
  105.  
  106.              INSTALL A:*=P
  107.  
  108.            ╔NSTALLS EVERYTHING. ╘O SEE WHAT YOU'VE INSTALLED, TYPE:
  109.  
  110.              RDIR
  111.  
  112.            ╘O GET  A DIRECTORY  OF THE  ╥┴═ DISK.  ╔F YOU  SEE SOMETHING THAT
  113.        SHOULDN'T BE THERE (LIKE THE SHELL) GET RID OF IT...
  114.  
  115.              REMOVE "SHELL"
  116.  
  117.            ─ELETES "SHELL" FROM THE ╥┴═ DISK. ╧R IF YOU'D RATHER USE ├┴╘┴╠╧╟:
  118.  
  119.              REMOVE DIR
  120.  
  121.            GETS RID OF THAT USELESS COMMAND.
  122.  
  123.            ╧NCE YOU'VE  PLAYED AROUND  A BIT  AND DECIDED  WHICH COMMANDS YOU
  124.        LIKE AND  WHICH ONES  YOU DON'T LIKE, YOU CAN SAVE THE ENTIRE ╥┴═ DISK
  125.        AS ONE SINGLE FILE WITH THE ╨╒╘╥┴═ COMMAND. ╩UST THINK UP A NAME, AND
  126.  
  127.              PUTRAM WHATEVER
  128.  
  129.            ╙O THAT NEXT TIME YOU BOOT THE SHELL YOU CAN JUST
  130.  
  131.              GETRAM WHATEVER
  132.  
  133.            ╔NSTEAD    OF    INSTALLING    EVERYTHING    ALL    OVER    AGAIN.
  134.  
  135.  
  136. ------------------------------------------------------------------------------
  137.  
  138.  
  139.  
  140.        ╘HE ├OMMAND ╠INE AND ╔/╧ ╥EDIRECTION
  141.  
  142.  
  143.          ╫HEN ┬┴╙╔├  RETURNS YOU  TO THE  ╥┼┴─┘ PROMPT,  THE ├-128  JUST SITS
  144.        THERE WITH ITS CURSOR MERRILY BLINKING AWAY WAITING FOR YOU TO TELL IT
  145.        WHAT TO  DO NEXT.  ┼VENTUALLY, YOU  GET TIRED OF WATCHING THE BLINKING
  146.        CURSOR AND  TYPE IN  A LINE  OF TEXT  AND HIT THE ╥┼╘╒╥╬ KEY. ┴NY TEXT
  147.        THAT HAPPENS  TO BE  ON THE  SAME LINE OF THE SCREEN AS THE CURSOR WAS
  148.        WHEN YOU HIT ╥┼╘╒╥╬ BECOMES THE COMMAND LINE.
  149.  
  150.          ┬┴╙╔├ DOES  A NICE  JOB OF FETCHING THE COMMAND LINE FROM THE SCREEN
  151.        AND PLACING  IT IN  AN AREA  OF MEMORY  KNOW AS  ┬┴╙╔├'S INPUT BUFFER.
  152.        ┴FTER THIS HAPPENS, THE SHELL GETS FIRST CRACK AT THE COMMAND LINE.
  153.  
  154.          ╘HE FIRST  THING THE  SHELL DOES  IS CHECK  TO SEE IF THE FIRST NON-
  155.        SPACE CHARACTER ON THE COMMAND LINE IS A "*". ╔F SO IT REMOVES THE "*"
  156.        FROM THE  COMMAND LINE  AND SETS  THINGS UP  SO THAT ANY SCREEN OUTPUT
  157.        WILL BE  REDIRECTED TO  THE PRINTER. ╘HIS REDIRECTED OUTPUT REMAINS IN
  158.        EFFECT UNTIL THE NEXT TIME YOU RETURN TO THE ╥┼┴─┘ PROMPT.
  159.  
  160.          ╙INCE THE  SHELL DOESN'T TRUST ┬┴╙╔├, THE NEXT THING IT DOES IS MAKE
  161.        A COPY  OF THE  COMMAND LINE  FOR ITS  OWN USE.  ╔T THEN  SETS OUT  TO
  162.        DETERMINE HOW  MANY PARAMETERS  ARE ON THE COMMAND LINE. ╔T DOES SO BY
  163.        GOING THROUGH  THE COMMAND  LINE FROM  START TO FINISH AND LOOKING FOR
  164.        DELIMITERS. ┬OTH COMMAS AND SPACES CAN BE USED AS DELIMETERS, AND THEY
  165.        CAN BE INTERMIXED. ┴NYTHING IN BETWEEN THE DELIMITERS IS CONSIDERED TO
  166.        BE A PARAMETER. ╞OR EXAMPLE, IF YOU TYPE:
  167.  
  168.             *ARC/L BIGFILE,HIGH, LOW,,,,MEDIUM  ,      SLOW
  169.  
  170.             ╘HEN
  171.  
  172.             "ARC/L"   IS PARAMETER NUMBER 0
  173.             "BIGFILE" IS PARAMETER NUMBER 1
  174.             "HIGH"    IS PARAMETER NUMBER 2
  175.             "LOW"     IS PARAMETER NUMBER 3
  176.             "MEDIUM"  IS PARAMETER NUMBER 4, AND
  177.             "SLOW"    IS PARAMETER NUMBER 5
  178.  
  179.  
  180.          ╔N ORDER  TO ALLOW  FOR FILENAMES THAT DO HAVE SPACES IN THEM, IT IS
  181.        ALSO POSSIBLE  TO ENCLOSE  A PARAMETER WITHIN QUOTES. ╙O THE FOLLOWING
  182.        LINE HAS EXACTLY THE SAME EFFECT AS THE ABOVE:
  183.  
  184.             *ARC/L"BIGFILE","HIGH" LOW      MEDIUM,  ,  ,  , "SLOW
  185.  
  186.          ╘HE NEXT  THING THE SHELL DOES IS CHECK TO SEE IF THE LAST PARAMETER
  187.        ON THE  COMMAND LINE BEGINS WITH A ">" OR A ">>". ╔F SO, OUTPUT IS RE-
  188.        DIRECTED TO  DISK, AND  THE LAST PARAMETER IS REMOVED FROM THE COMMAND
  189.        LINE. ╞INALLY, A CHECK IS MADE FOR ANY COMMAND LINE SWITCHES. ╙WITCHES
  190.        CAN ONLY FOLLOW PARAMETER NUMBER ZERO, AND MUST BE PRECEEDED BY A "/".
  191.        ╔F PRESENT,  COMMAND LINE  SWITCHES WILL  BE PLACED AT $1┬╞├ AND $1┬╞─
  192.        (THERE CAN  BE AT MOST TWO OF THEM) AND IF NOT PRESENT THESE LOCATIONS
  193.        WILL CONTAIN ZEROS.
  194.  
  195.  
  196.          ╙O FOR EXAMPLE, IF YOU ENTERED..
  197.  
  198.             LIST >PROGRAM.BAS
  199.  
  200.          ├╙-─╧╙ WOULD BEHAVE AS IF YOU HAD ENTERED..
  201.  
  202.  
  203.  
  204.             LIST
  205.  
  206.          BUT ANYTHING YOU SEE PRINTED ON THE SCREEN WILL ALSO BE WRITTEN TO A
  207.        DISK FILE CALLED "PROGRAM.BAS".
  208.  
  209.          ╫HAT HAPPENS  NEXT DEPENDS  UPON PARAMETER NUMBER ZERO. ╔F IT BEGINS
  210.        WITH "D:",  THEN THE  SHELL TRIES  TO LOAD  AND  EXECUTE  THE  PROGRAM
  211.        SPECIFIED BY PARAMETER ZERO. ╔F THE LOAD IS SUCCESSFUL, THE PROGRAM IS
  212.        EXECUTED. ╧THERWISE CONTROL GOES BACK TO ┬┴╙╔├ AND YOU'LL GET A SYNTAX
  213.        ERROR.
  214.  
  215.          ╔F PARAMETER  ZERO DOES  NOT BEGIN WITH A "D:", THEN THE SHELL TRIES
  216.        TO FIND  A PROGRAM ON THE INTERNAL ╥┴═ DISK WHOSE NAME IS IDENTICAL TO
  217.        PARAMETER ZERO.  ╔F A  MATCH IS  FOUND THE PROGRAM IS FETCHED FROM THE
  218.        ╥┴═ DISK  AND EXECUTED OTHERWISE CONTROL GOES BACK TO ┬┴╙╔├ AND THINGS
  219.        PROCEED AS NORMAL.
  220.  
  221.  
  222.  
  223.          ╥EDIRECTING ╧UTPUT TO THE ╨RINTER
  224.  
  225.          * IS USED TO RE-DIRECT ANY OUTPUT OF A PROGRAM OR COMMAND THAT WOULD
  226.        NORMALLY BE  SENT TO  THE SCREEN TO BE SENT TO BOTH THE PRINTER AND TO
  227.        THE SCREEN.
  228.  
  229.          ┴NYTHING (ER..ALMOST  ANYTHING) THAT  YOU WOULD  NORMALLY TYPE  AS A
  230.        COMMAND OR  DIRECT MODE  "ONE LINER"  CAN BE PRECEEDED BY A * TO GET A
  231.        HARD COPY OF THE OUTPUT.
  232.  
  233.          * DOESN'T  SEEM TO  GET ALONG  WITH SOME  OF ┬┴╙╔├'S  DISK  ORIENTED
  234.        COMMANDS. ╞OR EXAMPLE:
  235.  
  236.             *CATALOG D0,"*=P
  237.  
  238.          DOES NOT WORK PROPERLY, BUT:
  239.  
  240.             *DIR *=P
  241.  
  242.          WORKS FINE.  ╘HE BEST WAY TO GET YOURSELF FAMILIAR WITH THIS COMMAND
  243.        IS SIMPLY TO WASTE A BIT OF PAPER AND FIDDLE AROUND A BIT AND SEE WHAT
  244.        WORKS AND  WHAT DOESN'T.  ╔F *  DOES NOT  WORK, THEN  CHANCES ARE THAT
  245.        ┬┴╙╔├'S ├═─  COMMAND WILL DO THE JOB. ╚OPEFULLY, WE'LL RECTIFY SOME OF
  246.        THESE PROBLEMS IN FUTURE RELEASES OF THE SHELL.
  247.  
  248.          ╘HERE ARE  A COUPLE  OF ╨╧╦┼S THAT YOU WILL NEED TO PERFORM IN ORDER
  249.        TO GET * WORKING PROPERLY. ╘HE EASIEST THING TO DO WOULD BE TO INCLUDE
  250.        THEM IN YOUR ┴╒╘╧┼╪┼├ FILE (SEE ┼╪┼├). ╧NCE THE SHELL HAS BEEN BOOTED,
  251.        THESE VALUES ARE ONLY READ AND NEVER WRITTEN TO.
  252.  
  253.  
  254.             $1┬┼┼ (7150)   PRINTER DEVICE NUMBER (DEFAULT 4)
  255.             $1┬┼╞ (7151)   PRINTER SECONDARY ADDRESS (DEFAULT 7)
  256.  
  257.          ╔'VE FOUND  THAT *  WORKS FINE  WITH BOTH AN ╔┼┼┼ (4022) PRINTER AND
  258.        WITH THE  SERIAL 1526  PRINTER.  ╒NFORTUNATELY,  THERE  ARE  LITERALLY
  259.        THOUSANDS OF  DIFFERENT PRINTERS  OUT THERE  AND IT  WOULD BE  AWFULLY
  260.        DIFFICULT TO  TEST *  OUT WITH ALL OF THEM. ╔F YOU CAN'T SEEM TO GET *
  261.        WORKING, THEN  YOU MAY  HAVE TO RE-DIRECT TO DISK INSTEAD AND LET YOUR
  262.        FAVORITE WORD PROCESSOR HANDLE THE PRINTER.
  263.  
  264.          ╔F  YOU  CAN'T  GET  THINGS  GOING  WITH  YOUR  PRINTER  OR  PRINTER
  265.        INTERFACE, TRY EXPERIMENTING A BIT WITH THE SECONDARY ADDRESS.
  266.  
  267.          ╥EDIRECTING ╧UTPUT TO A ─ISK ╞ILE
  268.  
  269.          > AND >> ARE USED TO REDIRECT SCREEN OUTPUT TO A ╙┼╤ DISK FILE. ╘HEY
  270.        WORK JUST LIKE * (AND HAVE THE SAME LIMITATIONS) EXCEPT THAT OUTPUT IS
  271.        TO DISK INSTEAD OF TO THE PRINTER.
  272.  
  273.          ╒SE > IF YOU WANT TO CREATE A NEW OUTPUT FILE, AND >> IF YOU WANT TO
  274.        APPEND TO AN EXISTING OUTPUT FILE.
  275.  
  276.          ╥E-DIRECTING OUTPUT  TO DISK  HAS ALOT OF INTERESTING USES. ├OMBINED
  277.        WITH ├╚┼├╦, ╟┼╘, ╨╒╘, AND ─╔╥ ITS NOT A BAD WAY TO CATALOG YOUR DISKS.
  278.        ├OMBINED WITH  ┴╥├/╠, IT CAN BE USED TO SUPPLY A LIST OF WHATS ON-LINE
  279.        ON YOUR  ┬┬╙, AND  COMBINED WITH ├╚┴╬╟┼, ╓─╒═╨, ═╧╬╔╘╧╥ OR ├╧═╨ IT CAN
  280.        BE A VERY HANDY DEBUGGING TOOL.
  281.  
  282.          ╧UTPUT REDIRECTION  IS NOT  AS TRANSPARENT  TO  ┬┴╙╔├  AS  IS  INPUT
  283.        REDIRECTION (┼╪┼├).  ╔F THE  PROGRAM YOU  ARE RUNNING  OPENS A COMMAND
  284.        CHANNEL ON  THE OUTPUT  DRIVE, (OPEN 15,8,15) THEN CLOSING THE COMMAND
  285.        CHANNEL WILL  ALSO CLOSE THE FILE TO WHICH OUTPUT IS BEING REDIRECTED.
  286.        ╔F YOU  HAVE MORE  THAN ONE  DRIVE, YOU CAN GET AROUND THIS BY SENDING
  287.        OUTPUT TO A DIFFERENT DRIVE.
  288.  
  289.          ╥E-DIRECTED OUTPUT (EITHER TO PRINTER OR TO DISK) IS CANCELLED EVERY
  290.        TIME YOU RETURN TO THE ╥┼┴─┘ PROMPT.
  291.  
  292.          ┼XAMPLES:
  293.  
  294.          VDUMP >TEST.EXEC            DUMPS ┬┴╙╔├ VARIABLES TO A ╙┼╤
  295.                                      FILE NAMED "TEST.EXEC"
  296.  
  297.          CHECK A:* >GAMES01.CHK      SENDS A VERBOSE DIRECTORY TO A
  298.                                      SEQ FILE ON THE DEFAULT DRIVE.
  299.  
  300.          CHECK B:* >>GAMES01.CHK     APPENDS TO THE FILE IN THE
  301.                                      PREVIOUS EXAMPLE.
  302.  
  303.          ARC/L RA >86NAV             SENDS A DIRECTORY OF "RA.ARC" ON THE
  304.                                      DEFAULT DRIVE TO A SEQ FILE CALLED
  305.                                      "86NAV"
  306.  
  307.          MONITOR >DEBUG.SESSION      SEND MACHINE LANGUAGE MONITOR
  308.                                      OUTPUT TO DISK.
  309.  
  310.          LIST >MYPROG                CREATES AN ┴╙├╔╔ LISTING OF THE
  311.                                      PROGRAM/TEXT IN MEMORY.
  312.                                      ╘HIS FILE COULD LATER BE ┼╪┼├'D
  313.                                      TO MERGE THE SAVED PROGRAM WITH
  314.                                      ANOTHER ONE IN MEMORY.
  315.  
  316.  
  317. -----------------------------------------------------------------------------
  318.  
  319.  
  320.          ╨┴╘╘┼╥╬╙
  321.  
  322.          ═ANY  OF   THE  COMMANDS   DESCRIBED  IN   THIS  DOCUMENT  REFER  TO
  323.        "PATTERNLIST" AS  ONE OF  THE COMMAND  ARGUMENTS. ╫HAT  THIS MEANS  IS
  324.        SIMPLY A  LIST OF  PATTERNS AS DESCRIBED BELOW. ╙INCE THE COMMAND LINE
  325.        CAN HOLD  AT MOST  20  PARAMETERS,  PATTERNLIST  CAN  BE  AT  MOST  19
  326.        PATTERNS. ╞OR EXAMPLE, IN THE COMMAND:
  327.  
  328.          CHECK A*.B* C:A??*.ASM D:NERD* D:ULTRA* C: >TEMP
  329.  
  330.          PATTERNLIST REFERS  TO EVERYTHING  BETWEEN THE "MOVE " AND THE FINAL
  331.        ">TEMP"
  332.  
  333.          ╞ILENAME PATTERN MATCHING HAS BEEN ENHANCED SOMEWHAT FOR MANY OF THE
  334.        COMMANDS INCLUDED  WITH THE SHELL. ╔N ADDITION TO THE NORMAL WILDCARDS
  335.        USED BY  ├┬═ ─╧╙  THE SHELL HELPS MAKE LIFE EASIER BY INTERPRETING THE
  336.        "*" CHARACTER  A LITTLE DIFFERENTLY, AND ADDING A "WILDCARD" CHARACTER
  337.        OF ITS OWN; THE "&" OR ╬╧╘ OPERATOR.
  338.  
  339.          ╨RECEEDING ANY  FILENAME WITH  AN "&" CHARACTER TELLS THE SHELL THAT
  340.        YOU WANT  TO MATCH  ┴╠╠ ╞╔╠┼╙  ┼╪├┼╨╘ THE  ONE  YOU'VE  SELECTED.  ╞OR
  341.        EXAMPLE,
  342.  
  343.          ARC/A MISCDATA &*=P
  344.  
  345.          WOULD INCLUDE  IN THE  ARCHIVE ALL FILES ON THE DEFAULT DRIVE EXCEPT
  346.        FOR PROGRAM FILES, OR
  347.  
  348.          ARC/A MISC &C:*.ARC
  349.  
  350.          WOULD INCLUDE  ALL FILES  ON DRIVE  C: EXCEPT  THOSE WHOSE NAMES END
  351.        WITH ".ARC"
  352.  
  353.          ╘HE ASTERISK  IS INTERPRETED  AS A SLIDING MATCH. ╘HIS IS BEST SHOWN
  354.        BY EXAMPLE. ╘RY FIDDLING AROUND WITH ├╚┼├╦ TO GET THE FEEL OF THINGS.
  355.  
  356.             *.*       MATCHES ANY FILE WITH A "." IN ITS NAME.
  357.                       ╙OME EXAMPLES WOULD BE:
  358.  
  359.                    HELLO.ARC
  360.                    SUPER.COPY.ASM   OR
  361.                    MEGAMON.
  362.  
  363.             *.*=P     WOULD BE THE SAME, BUT WOULD ONLY
  364.                       MATCH PROGRAM FILES.
  365.  
  366.             *.ARC     WOULD MATCH ANY FILES WHOSE NAMES END
  367.                       WITH ".ARC"
  368.  
  369.             *.??      WOULD MATCH ANY FILES THAT HAVE A "." AS
  370.                       THE THIRD LAST CHARACTER IN THIER NAMES.
  371.  
  372.             JJ*.PIK   WOULD MATCH ANY FILES WHOSE NAMES
  373.                       BEGIN WITH "JJ" AND END WITH ".PIK"
  374.  
  375.             *NOSE*    WOULD MATCH ANY FILES THAT HAVE "NOSE"
  376.                       IMBEDDED IN THIER NAMES.
  377.  
  378.  
  379.          ╬OTE, HOWEVER,  THAT NOT  ALL COMMANDS  WILL SUPPORT  THIS  TYPE  OF
  380.        PATTERN MATCHING (FOR EXAMPLE ─╔╥ AND ─┼╠), BUT FUTURE VERSIONS OF THE
  381.        SHELL WILL  LIKELY BE  USING IT  ALOT MORE.  ╔F THIS  TYPE OF  PATTERN
  382.        MATCHING DOES  NOT WORK,  THEN NORMAL  ─╧╙ PATTERN  MATCHING IS  BEING
  383.        USED.
  384.  
  385.  
  386.