From b09d40cb245bf556891c480d6eabc90a8edb01ff Mon Sep 17 00:00:00 2001 From: Dave Lyons Date: Tue, 18 Aug 2020 00:23:30 -0700 Subject: [PATCH] Change carriage returns into linefeeds in all the Help files, without making any edits yet. --- doc/help/Alias | 36 +++++++++- doc/help/BList | 25 ++++++- doc/help/BRun | 36 +++++++++- doc/help/Boot | 20 +++++- doc/help/Bye | 17 ++++- doc/help/Cat | 56 ++++++++++++++- doc/help/Cls | 14 +++- doc/help/CmdLine | 36 +++++++++- doc/help/Combine | 47 ++++++++++++- doc/help/ConP | 170 ++++++++++++++++++++++++++++++++++++++++++++- doc/help/Config | 58 +++++++++++++++- doc/help/Copy | 42 ++++++++++- doc/help/Create | 12 +++- doc/help/DOSCat | 24 ++++++- doc/help/DT | 14 +++- doc/help/DU | 21 +++++- doc/help/Date | 71 ++++++++++++++++++- doc/help/Delete | 21 +++++- doc/help/Deschw | 31 ++++++++- doc/help/Dev | 24 ++++++- doc/help/Dump | 32 ++++++++- doc/help/Echo | 32 ++++++++- doc/help/Eject | 20 +++++- doc/help/Equal | 51 +++++++++++++- doc/help/Err | 19 ++++- doc/help/Exec | 24 ++++++- doc/help/Expand | 31 ++++++++- doc/help/FFind | 78 ++++++++++++++++++++- doc/help/FP | 48 ++++++++++++- doc/help/FType | 29 +++++++- doc/help/Filetype | 18 ++++- doc/help/Find | 57 ++++++++++++++- doc/help/GSBuff | 40 ++++++++++- doc/help/Hdr | 16 ++++- doc/help/Help | 34 ++++++++- doc/help/IW2 | 44 +++++++++++- doc/help/Index | 25 ++++++- doc/help/Info | 28 +++++++- doc/help/Init | 32 ++++++++- doc/help/Lock | 13 +++- doc/help/MX80 | 29 +++++++- doc/help/ModChk | 31 ++++++++- doc/help/Mon | 15 +++- doc/help/Move | 18 ++++- doc/help/Num | 11 ++- doc/help/Online | 17 ++++- doc/help/Origin | 14 +++- doc/help/Over | 13 +++- doc/help/PG | 42 ++++++++++- doc/help/PSet | 28 +++++++- doc/help/PType | 13 +++- doc/help/Pathnames | 20 +++++- doc/help/Prefix | 40 ++++++++++- doc/help/Prot | 16 ++++- doc/help/RAM3 | 47 ++++++++++++- doc/help/Rename | 23 +++++- doc/help/Rep | 17 ++++- doc/help/Scan | 30 +++++++- doc/help/SetDate | 21 +++++- doc/help/SetStart | 34 ++++++++- doc/help/Shareware | 12 +++- doc/help/Size | 28 +++++++- doc/help/Split | 70 ++++++++++++++++++- doc/help/Spool | 44 +++++++++++- doc/help/Strings | 17 ++++- doc/help/SysAlias | 63 ++++++++++++++++- doc/help/TR | 83 +++++++++++++++++++++- doc/help/Tail | 34 ++++++++- doc/help/Top | 12 +++- doc/help/Topics | 57 ++++++++++++++- doc/help/Touch | 38 +++++++++- doc/help/Type | 32 ++++++++- doc/help/Unlock | 13 +++- doc/help/Up | 13 +++- doc/help/Update | 39 ++++++++++- doc/help/VRestore | 34 ++++++++- doc/help/VStore | 42 ++++++++++- doc/help/Version | 15 +++- doc/help/ViewDHR | 37 +++++++++- doc/help/ViewHR | 18 ++++- doc/help/WC | 48 ++++++++++++- doc/help/Wait | 15 +++- doc/help/What | 71 ++++++++++++++++++- doc/help/como | 37 +++++++++- 84 files changed, 2713 insertions(+), 84 deletions(-) diff --git a/doc/help/Alias b/doc/help/Alias index 34cc46d..09cf7f7 100644 --- a/doc/help/Alias +++ b/doc/help/Alias @@ -1 +1,35 @@ - alias -- display or modify command aliases syntax: alias [-s] [-l] [-r] ex: alias alias foo "cat -am" alias -r foo alias -s alias -l With no parameters, displays a list of all current aliases. These are stored in the file %aliases (which you can edit with a text editor if you want). Given two strings, 'alias' creates a new alias so that the first string, when used as a command, expands into the second string. If there are blanks in the second string, you need to put quotation marks around it. If the named alias already exists, 'alias' asks for permission to replace it. Given -r and a single string, 'alias' removes an existing alias. Creating or removing an alias does not automatically save it to disk. To save your aliases to %aliases, use 'alias -s'. (Note that if you create or remove an alias and use -s in the same command, the saving happens -after- any changes to your aliases.) To re-load your aliases from %aliases, use 'alias -l'. Davex automatically loads aliases from there, so this is not normally needed. See Davex.Doc for an explanation of aliases and a description of the pre-made aliases provided. \ No newline at end of file + +alias -- display or modify command aliases + +syntax: alias [-s] [-l] [-r] + +ex: alias + alias foo "cat -am" + alias -r foo + alias -s + alias -l + +With no parameters, displays a list of all current aliases. +These are stored in the file %aliases (which you can edit +with a text editor if you want). + +Given two strings, 'alias' creates a new alias so that the +first string, when used as a command, expands into the second +string. If there are blanks in the second string, you need +to put quotation marks around it. If the named alias already +exists, 'alias' asks for permission to replace it. + +Given -r and a single string, 'alias' removes an existing +alias. + +Creating or removing an alias does not automatically save it to +disk. To save your aliases to %aliases, use 'alias -s'. (Note +that if you create or remove an alias and use -s in the same +command, the saving happens -after- any changes to your aliases.) + +To re-load your aliases from %aliases, use 'alias -l'. Davex +automatically loads aliases from there, so this is not normally +needed. + +See Davex.Doc for an explanation of aliases and a description +of the pre-made aliases provided. diff --git a/doc/help/BList b/doc/help/BList index 7d053e5..0481e4e 100644 --- a/doc/help/BList +++ b/doc/help/BList @@ -1 +1,24 @@ - blist -- list a BAS file in ASCII (EXTERNAL) [v1.2] syntax: blist [-w ] ex: blist this como &;blist ?:bas -w70 como edit.this;blist myprog List a BAS file in readable form. Wildcards are allowed. Intended for redirecting to a TXT file to allow editing with a word processor. The edited file can then be EXECed in BASIC.SYSTEM, turning it back into an Applesoft program which can be SAVEd and RUN. The -w option specifies the wrap margin. 'blist' will start a new line and indent 6 spaces when this margin is hit, or when a blank is printed within 10 columns of the margin. If you are using 'blist' to send a listing to your printer, you may need to use -w to prevent long lines from overprinting themselves. Version 1.2 fixes a spacing bug in REM and DATA statements that didn't begin with a blank. \ No newline at end of file + +blist -- list a BAS file in ASCII (EXTERNAL) [v1.2] + +syntax: blist [-w ] + +ex: blist this + como &;blist ?:bas -w70 + como edit.this;blist myprog + +List a BAS file in readable form. Wildcards are allowed. +Intended for redirecting to a TXT file to allow editing with +a word processor. The edited file can then be EXECed in +BASIC.SYSTEM, turning it back into an Applesoft program +which can be SAVEd and RUN. + +The -w option specifies the wrap margin. 'blist' will start +a new line and indent 6 spaces when this margin is hit, or +when a blank is printed within 10 columns of the margin. +If you are using 'blist' to send a listing to your printer, +you may need to use -w to prevent long lines from overprinting +themselves. + +Version 1.2 fixes a spacing bug in REM and DATA statements that +didn't begin with a blank. diff --git a/doc/help/BRun b/doc/help/BRun index 3a17bf4..a64a3e8 100644 --- a/doc/help/BRun +++ b/doc/help/BRun @@ -1 +1,35 @@ - brun -- run a BIN file syntax: brun pathname ex: brun myprogram 'brun' is a SYS file that accepts a parameter (in its startup buffer). The pathname must specify a BIN file. 'brun' will load and execute the BIN file at its auxiliary type address. Many BIN files are intended to be executed in a certain environment, such as BASIC.SYSTEM. 'brun' is useful only for BIN files that do NOT expect an environment to be set up for them. Kyan Pascal programs, for example, can be run with 'brun'. Be careful! Not all BIN files are suitable for running with 'brun'. If you're not sure if a particular BIN file will run OK or not, write-protect your disks (turn off a hard drive, save RAM disks to real disks, etc) before trying to run it. If a ProDOS error occurs while 'brun' is loading the BIN file, a two-digit error code is displayed, and you will be returned to Davex (if you ran 'brun' from there) when you hit a key. To find out what the error was, you can type "err $xx" from Davex. If the specified file is not a BIN file, error $FF is reported. Note: 'brun' with a last-modified date of 12-Dec-87 or later supports BIN files that RTS or JMP to $3D0, $3D3, or $BE00 rather than doing a ProDOS QUIT. Previous versions worked only with BIN files that did a QUIT. Also, 'brun' stores a BRK instruction at $BE03 and $BE70. If you get dropped into the monitor at $BE03 or $BE70, the BIN file you were trying to run probably requires BASIC.SYSTEM. \ No newline at end of file + +brun -- run a BIN file + +syntax: brun pathname + +ex: brun myprogram + +'brun' is a SYS file that accepts a parameter (in its startup buffer). +The pathname must specify a BIN file. 'brun' will load and execute the +BIN file at its auxiliary type address. Many BIN files are intended +to be executed in a certain environment, such as BASIC.SYSTEM. 'brun' +is useful only for BIN files that do NOT expect an environment to be +set up for them. Kyan Pascal programs, for example, can be run with +'brun'. + +Be careful! Not all BIN files are suitable for running with 'brun'. +If you're not sure if a particular BIN file will run OK or not, +write-protect your disks (turn off a hard drive, save RAM disks to +real disks, etc) before trying to run it. + +If a ProDOS error occurs while 'brun' is loading the BIN file, a +two-digit error code is displayed, and you will be returned to +Davex (if you ran 'brun' from there) when you hit a key. To find +out what the error was, you can type "err $xx" from Davex. + +If the specified file is not a BIN file, error $FF is reported. + +Note: 'brun' with a last-modified date of 12-Dec-87 or later +supports BIN files that RTS or JMP to $3D0, $3D3, or $BE00 rather +than doing a ProDOS QUIT. Previous versions worked only with +BIN files that did a QUIT. + +Also, 'brun' stores a BRK instruction at $BE03 and $BE70. If you +get dropped into the monitor at $BE03 or $BE70, the BIN file you +were trying to run probably requires BASIC.SYSTEM. diff --git a/doc/help/Boot b/doc/help/Boot index f7f2b0f..5ff5cdc 100644 --- a/doc/help/Boot +++ b/doc/help/Boot @@ -1 +1,19 @@ - boot -- boot the system syntax: boot [-s] [-i] ex: boot boot -s6 Boots the system. If -s is given, boots from the specified slot, which should contain a disk controller. Otherwise the system scans for a startup device the same way it does at power-up. The -i option is meaningful only on a IIgs. If present, an ICE COLD reboot is done, erasing everything in RAM (including /RAM5). -s is ignored when -i is used. [NOTE--'boot -i' takes advantage of an undocumented aspect of the keyboard microcontroller and is NOT guarranteed to work in the future. Test it with any hardware or system software upgrades before trusting it.] \ No newline at end of file + +boot -- boot the system + +syntax: boot [-s] [-i] + +ex: boot + boot -s6 + +Boots the system. If -s is given, boots from the specified +slot, which should contain a disk controller. Otherwise the +system scans for a startup device the same way it does at +power-up. + +The -i option is meaningful only on a IIgs. If present, an ICE +COLD reboot is done, erasing everything in RAM (including /RAM5). +-s is ignored when -i is used. [NOTE--'boot -i' takes advantage +of an undocumented aspect of the keyboard microcontroller and is +NOT guarranteed to work in the future. Test it with any hardware +or system software upgrades before trusting it.] diff --git a/doc/help/Bye b/doc/help/Bye index 6bffbcf..9882ee8 100644 --- a/doc/help/Bye +++ b/doc/help/Bye @@ -1 +1,16 @@ - bye -- quit Davex syntax: bye ex: bye Quits Davex. (Does a ProDOS QUIT to whatever Quit code was in place when you entered Davex.) If you have different copies of Davex in different directories, you can run one copy from another one, and Quit will return you to the one you were in previously. (The old quit code is stored in %config when you enter Davex. When you quit, it loads the old quit code from %config, so you need to have your Davex disk online.) \ No newline at end of file + +bye -- quit Davex + +syntax: bye + +ex: bye + +Quits Davex. (Does a ProDOS QUIT to whatever Quit code was +in place when you entered Davex.) If you have different +copies of Davex in different directories, you can run one +copy from another one, and Quit will return you to the one +you were in previously. + +(The old quit code is stored in %config when you enter +Davex. When you quit, it loads the old quit code from +%config, so you need to have your Davex disk online.) diff --git a/doc/help/Cat b/doc/help/Cat index 9d1bb6b..4bfbba2 100644 --- a/doc/help/Cat +++ b/doc/help/Cat @@ -1 +1,55 @@ - cat -- display directory syntax: cat [pathname] [-t] [-s] [-f filetype] [-a sort_keys] [-i] ex: cat cat -a cat /disk -it cat -fbas cat /mydisk -tfSYS cat .62 -s cat ?:dir Displays the contents of the directory specified by pathname; wildcards are allowed. (If no pathname is given, displays the contents of the current directory.) The following options are available: -t: tree format--show contents of directories indented under the directory names -i: show files and directories even if they are invisible (use the 'touch' command to make a file visible or invisible) -s: short form--display name and filetype only -f: show only files of given type (if -t is given, DIRs are also shown) -a: arrange--sort the listing according to the characters following '-a'. If no characters follow, the listing is sorted alphabetically by filename. The following sorting keys may be combined by listing the most significant keys first. Capitalizing a letter reverses the order of the sort on that key. n: name (a to z) m: modified date/time (newest to oldest) f: filetype ($00 to $ff) t: same as f s: size in bytes (largest to smallest) x: auxiliary type ($0000 to $ffff) b: list files needing backup before files not needing backup Examples: cat -a cat -an arrange by name from a to z cat -aN arrange by name from z to a cat -afX arrange by increasing filetype and decreasing auxiliary type within each filetype Note that '-t' is ignored when '-a' is used. \ No newline at end of file + +cat -- display directory + +syntax: cat [pathname] [-t] [-s] [-f filetype] [-a sort_keys] [-i] + +ex: cat + cat -a + cat /disk -it + cat -fbas + cat /mydisk -tfSYS + cat .62 -s + cat ?:dir + +Displays the contents of the directory specified by pathname; wildcards are +allowed. (If no pathname is given, displays the contents of the current +directory.) The following options are available: + + -t: tree format--show contents of directories indented under the directory + names + + -i: show files and directories even if they are invisible (use the 'touch' + command to make a file visible or invisible) + + -s: short form--display name and filetype only + + -f: show only files of given type (if -t is given, DIRs are also shown) + + -a: arrange--sort the listing according to the characters following '-a'. + If no characters follow, the listing is sorted alphabetically by + filename. The following sorting keys may be combined by listing the + most significant keys first. Capitalizing a letter reverses the order + of the sort on that key. + + n: name (a to z) + m: modified date/time (newest to oldest) + f: filetype ($00 to $ff) + t: same as f + s: size in bytes (largest to smallest) + x: auxiliary type ($0000 to $ffff) + b: list files needing backup before files not needing backup + + Examples: + + cat -a + cat -an + arrange by name from a to z + + cat -aN + arrange by name from z to a + + cat -afX + arrange by increasing filetype and decreasing auxiliary type within + each filetype + +Note that '-t' is ignored when '-a' is used. diff --git a/doc/help/Cls b/doc/help/Cls index 2e21fe0..d8e69ae 100644 --- a/doc/help/Cls +++ b/doc/help/Cls @@ -1 +1,13 @@ - cls -- clear screen syntax: cls ex: cls como &;cls -- new page on printer Clears the screen. If redirected to the printer, as in the last example, begins a new page. ('cls' just outputs a Ctrl-L.) \ No newline at end of file + +cls -- clear screen + +syntax: cls + +ex: cls + como &;cls -- new page on printer + +Clears the screen. If redirected to the printer, as in the +last example, begins a new page. + +('cls' just outputs a Ctrl-L.) + diff --git a/doc/help/CmdLine b/doc/help/CmdLine index 2de1599..d77ac69 100644 --- a/doc/help/CmdLine +++ b/doc/help/CmdLine @@ -1 +1,35 @@ - The following features are available during line input: Ctrl-B = move to beginning of line Ctrl-D = delete character at cursor Ctrl-E/Ctrl-N = move to end of line Ctrl-F = find forward; press ESC to exit Ctrl-H (left arrow) = move left Ctrl-I (tab) = insert (cancelled by arrows or Ctrl-D) Ctrl-J (down arrow) = move down on the list of previous commands Ctrl-K (up arrow) = move up on the list of previous commands Ctrl-L = toggle Caps-lock on/off for Apple II+ Ctrl-M = return (accept whole line, even the part after the cursor) Ctrl-O = if the following character is a control character, inserts it (control characters can't normally be entered). If the following character is "K" to "O" or "k" to "o", a special character is inserted (useful only on the II+ keyboard): K L M N O k l m n o [ \ ] ^ _ { | } ~ DEL Ctrl-Q = accept portion of line before cursor Ctrl-R = re-edit previous input Ctrl-U (right arrow) = move cursor right Ctrl-X = cancel input Ctrl-Y = erase from cursor to end of line DELETE = erase character before cursor Apple-< = move to beginning of line Apple-> = move to end of line Apple-E = switch between insert and overstrike ("exchange") Apple-Y = erase from cursor to end of line (same as Ctrl-Y) Apple-H = print hardcopy of screen Apple-Space = advance printer one line Apple-Return = advance printer to next page \ No newline at end of file + +The following features are available during line input: + +Ctrl-B = move to beginning of line +Ctrl-D = delete character at cursor +Ctrl-E/Ctrl-N = move to end of line +Ctrl-F = find forward; press ESC to exit +Ctrl-H (left arrow) = move left +Ctrl-I (tab) = insert (cancelled by arrows or Ctrl-D) +Ctrl-J (down arrow) = move down on the list of previous commands +Ctrl-K (up arrow) = move up on the list of previous commands +Ctrl-L = toggle Caps-lock on/off for Apple II+ +Ctrl-M = return (accept whole line, even the part after the cursor) +Ctrl-O = if the following character is a control character, inserts it + (control characters can't normally be entered). If the + following character is "K" to "O" or "k" to "o", a special + character is inserted (useful only on the II+ keyboard): + + K L M N O k l m n o + [ \ ] ^ _ { | } ~ DEL + +Ctrl-Q = accept portion of line before cursor +Ctrl-R = re-edit previous input +Ctrl-U (right arrow) = move cursor right +Ctrl-X = cancel input +Ctrl-Y = erase from cursor to end of line +DELETE = erase character before cursor + +Apple-< = move to beginning of line +Apple-> = move to end of line +Apple-E = switch between insert and overstrike ("exchange") +Apple-Y = erase from cursor to end of line (same as Ctrl-Y) +Apple-H = print hardcopy of screen +Apple-Space = advance printer one line +Apple-Return = advance printer to next page diff --git a/doc/help/Combine b/doc/help/Combine index 42e3c63..4fe8014 100644 --- a/doc/help/Combine +++ b/doc/help/Combine @@ -1 +1,46 @@ - combine -- combine files together (EXTERNAL) [v1.0] Written by Jeff Ding syntax: combine [] [-o] [-w] ex: combine text -m60 combine game.part1 game.part2 game.3 -o game combine =.header =.doc -o documents 'Combine' combines files together. The input file is always appended to the output file. A total of 5 input files on the same command line is supported. Wildcards are supported in the first two input files only. When using an output pathname, it is sometimes useful to use a wildcard in the input pathname. This allows you to append several files onto one output pathname. A special case happens when using two wildcards in the input files. The text matching the first wildcard is substituted into the second wildcard. This makes it possible to include a special header or footer file for each actual input file. The third example above demonstrates the use of a header file. Combine will work with any file type, but the files are treated only as raw collections of bytes. This means, for example, that if you combine two complete AWP files you will get a big mess. However, you can always use 'combine' to reconstruct files that have been split up using 'split'. Options are as follows: -o : Copy of input file gets saved to this file. If not specified, output goes to the screen. If the file exists, the data will be appended and the type not modified. If the output file does not exist, it will be created with the same type as the original file. -w : wrap margin. Affects output to the screen only. This forces a carriage return when either the margin or a space within 9 characters of the margin is reached. Allowed values are 0 through 255. A 0 value has the same effect as not using the option. (see also: split) \ No newline at end of file + +combine -- combine files together (EXTERNAL) [v1.0] + Written by Jeff Ding + +syntax: combine [] + [-o] [-w] + +ex: combine text -m60 + combine game.part1 game.part2 game.3 -o game + combine =.header =.doc -o documents + +'Combine' combines files together. The input file is always appended to +the output file. A total of 5 input files on the same command line is +supported. Wildcards are supported in the first two input files only. +When using an output pathname, it is sometimes useful to use a wildcard in +the input pathname. This allows you to append several files onto one +output pathname. + +A special case happens when using two wildcards in the input files. The +text matching the first wildcard is substituted into the second wildcard. +This makes it possible to include a special header or footer file for each +actual input file. The third example above demonstrates the use of a +header file. + +Combine will work with any file type, but the files are treated only +as raw collections of bytes. This means, for example, that if you +combine two complete AWP files you will get a big mess. However, +you can always use 'combine' to reconstruct files that have been +split up using 'split'. + +Options are as follows: + + -o : Copy of input file gets saved to this file. If + not specified, output goes to the screen. If the + file exists, the data will be appended and the type + not modified. If the output file does not exist, + it will be created with the same type as the original + file. + + -w : wrap margin. Affects output to the screen only. This + forces a carriage return when either the margin or + a space within 9 characters of the margin is reached. + Allowed values are 0 through 255. A 0 value has the + same effect as not using the option. + +(see also: split) diff --git a/doc/help/ConP b/doc/help/ConP index 468f768..36c179f 100644 --- a/doc/help/ConP +++ b/doc/help/ConP @@ -1 +1,169 @@ - conp -- display or change IIgs Control Panel information (EXTERNAL) syntax: conp [-k pathname] [-l pathname] [-a audio] [-s slots] [-1 port1] [-2 port2] [-r RAMdisk] [-o options] [-d display] [-f fast] [-c clock] ex: conp -- display all settings conp -a -r -- display audio and RAMdisk settings conp -ap13v>2 -- set pitch to 13, increase volume by 2 conp -k my.bram -- keep all settings in a file conp -l %?.bram -- load all settings from a file conp -rs8 -- set RAMdisk size to 8 chunks of 32K=256K [more examples below] 'conp' can display and set all the options the IIgs's control panel desk accessory can. ('conp' is especially useful to voice synthesizer users. Other users will find the -k and -l options handy, and may want to include other 'conp' commands in exec files (see "exec").) Options set with 'conp' are stored in the IIgs's 256 bytes of battery RAM, in exactly the same format the Control Panel stores them. Note that RAMdisk and Slots settings do not take effect until the next power-up or "boot -i". 'conp' has 11 parameters. All of them are optional. If no parameters are given, all settings are displayed. -k requires the name of a file (which will be created if it doesn't exist); it saves all the battery RAM settings into the file. -l also requires the name of a file; it restores all battery RAM settings from the file. (If the file contains invalid information, battery RAM will revert to defaults.) The remaining options are categories of options. The categories are: audio, RAMdisk, options, display, clock, fast, slots, port 1, and port 2. For any category that is given, settings may or may not appear after it. If no settings are found after a category, the current settings for that category are displayed. The settings allowed in each category are listed below. Note on numeric values: in almost all cases, you can put a "<" or ">" before a number. This decreases or increases the existing value for a setting, instead of specifying the new value from scratch. For example, conp -av>1 bumps the Volume up one notch. ----- Category: audio (-a) Settings: v volume value: 0 to 14 p pitch value: 0 to 14 Sets the system volume and the pitch of the standard bell tone. Note: If no value appears after v or p, the volume or pitch can be set interactively. Use the left and right arrows to adjust the volume, and press RETURN to finish. Examples: conp -avp --sets volume and then pitch, interactively conp -ap>2v<1 --bump pitch up 2 notches, volume down 1 ----- Category: slots (-s) Settings: i internal (followed by slot numbers) x external (followed by slot numbers) b boot 0 to 9 (0=scan, 8=RAMdisk, 9=ROMdisk) Examples: conp -sb5x1i52 -- set boot to slot 5, slot 1 external ("your card"), and slots 5 and 2 internal conp -sb0 -- scan (boot from highest bootable device) ----- Category: port 1 (-1) (normally printer port) Settings: (value) dv device connected m or p (modem/printer) l line length u=unlimited, 40, 72, 80, 132 dl delete 1st LF after CR y/n al add LF after CR y/n e echo y/n bf buffer y/n br baud rate 0 to 14 (%%% fix this) ds data/stop bits 5/1, 5/2 to 8/1, 8/2 p parity e (even), o (odd), n (none) ch Carrier handshake (DCD) y/n dh DSR/DTR handshake y/n xh X-on/X-off handshake y/n Examples: conp -1bfyds8/1pn -- buffering on, 8 data bits, 1 stop bit, no parity ----- Category: port 2 (-2) (normally modem port) Settings: same as for printer port Examples: conp -2luxhn -- line length unlimited, X-off handshake off ----- Category: fast (-f) Well, this isn't really a category. A simple "y" or "n" is expected. "Y" sets fast mode (2.8 MHz); "N" sets slow mode (1.0 MHz). Examples: conp -fn -- slow conp -fy -- fast ----- Category: RAMdisk (r) Settings: s size -- sets minimum and maximum size a minimum -- sets minimum size b maximum -- sets maximum size All values refer to a number of 32K chunks. Examples: conp -rs0 -- set RAMdisk size to 0 conp -rs4 -- set RAMdisk size to 128K (=4x32K) conp -ra10b20 -- set minimum size to 320K, max to 640K (Note that the new size does not take effect until a power-up or a "boot -i".) ----- Category: clock (c) Settings: NONE YET (NOT DONE) ----- Category: display (d) Settings: tx text color 0 to 15 bk text background color 0 to 15 bd border color 0 to 15 80 80 columns on RESET and power-up? y/n m monochrome monitor? y/n Examples: conp -dtx15 -- show white text conp -dbd0 -- black border conp -d80ymn -- 80 columns on RESET, color monitor Note: the "m" option has no effect on the display of an RGB monitor. Some programs do not work properly when the "80" option is on. ----- Category: options (-o) Settings: tl text language 0 to 31 (MOST VALUES ILLEGAL? %%%) kl keyboard language 0 to 31 (MOST VALUES ILLEGAL? %%%) kb keyboard buffering y/n rs repeat speed 0 to 7 rd repeat delay 0 to 4 (4=no repeat) dc double click time 0 to 4 fr flash rate 0 to 4 cs caps+shift = lower case y/n fs fast space/delete y/n ds dual-speed keys y/n hm high-speed mouse y/n Notes: The keyboard buffering is 16 characters within the IIgs (provided by the Keyboard Microcontroller), plus an additional 3 characters within the keyboard itself, if you have the external Apple Desktop Bus keyboard. Some programs don't work properly with keyboard buffering turned on. When keyboard buffering is on, Ctrl-Apple-DELETE empties the buffer. ----- end of 'conp' help (finally!) \ No newline at end of file + +conp -- display or change IIgs Control Panel information (EXTERNAL) + +syntax: conp [-k pathname] [-l pathname] + [-a audio] [-s slots] [-1 port1] + [-2 port2] [-r RAMdisk] [-o options] + [-d display] [-f fast] [-c clock] + +ex: conp -- display all settings + conp -a -r -- display audio and RAMdisk settings + conp -ap13v>2 -- set pitch to 13, increase volume by 2 + conp -k my.bram -- keep all settings in a file + conp -l %?.bram -- load all settings from a file + conp -rs8 -- set RAMdisk size to 8 chunks of 32K=256K + [more examples below] + +'conp' can display and set all the options the IIgs's control panel +desk accessory can. ('conp' is especially useful to voice synthesizer +users. Other users will find the -k and -l options handy, and may +want to include other 'conp' commands in exec files (see "exec").) + +Options set with 'conp' are stored in the IIgs's 256 bytes of battery +RAM, in exactly the same format the Control Panel stores them. Note +that RAMdisk and Slots settings do not take effect until the next +power-up or "boot -i". + +'conp' has 11 parameters. All of them are optional. If no parameters +are given, all settings are displayed. -k requires the name of a file +(which will be created if it doesn't exist); it saves all the battery +RAM settings into the file. -l also requires the name of a file; it +restores all battery RAM settings from the file. (If the file +contains invalid information, battery RAM will revert to defaults.) + +The remaining options are categories of options. The categories are: +audio, RAMdisk, options, display, clock, fast, slots, port 1, and port +2. + +For any category that is given, settings may or may not appear after +it. If no settings are found after a category, the current settings +for that category are displayed. The settings allowed in each +category are listed below. + +Note on numeric values: in almost all cases, you can put a "<" or ">" +before a number. This decreases or increases the existing value for +a setting, instead of specifying the new value from scratch. For +example, + + conp -av>1 + +bumps the Volume up one notch. + +----- +Category: audio (-a) +Settings: v volume value: 0 to 14 + p pitch value: 0 to 14 + +Sets the system volume and the pitch of the standard bell tone. +Note: If no value appears after v or p, the volume or pitch can +be set interactively. Use the left and right arrows to adjust the +volume, and press RETURN to finish. + +Examples: conp -avp --sets volume and then pitch, interactively + conp -ap>2v<1 --bump pitch up 2 notches, volume down 1 + +----- +Category: slots (-s) +Settings: i internal (followed by slot numbers) + x external (followed by slot numbers) + b boot 0 to 9 (0=scan, 8=RAMdisk, 9=ROMdisk) + +Examples: conp -sb5x1i52 -- set boot to slot 5, slot 1 external ("your + card"), and slots 5 and 2 internal + + conp -sb0 -- scan (boot from highest bootable device) + +----- +Category: port 1 (-1) (normally printer port) + +Settings: (value) + + dv device connected m or p (modem/printer) + l line length u=unlimited, 40, 72, 80, 132 + dl delete 1st LF after CR y/n + al add LF after CR y/n + e echo y/n + bf buffer y/n + br baud rate 0 to 14 (%%% fix this) + ds data/stop bits 5/1, 5/2 to 8/1, 8/2 + p parity e (even), o (odd), n (none) + ch Carrier handshake (DCD) y/n + dh DSR/DTR handshake y/n + xh X-on/X-off handshake y/n + +Examples: conp -1bfyds8/1pn -- buffering on, 8 data bits, 1 stop bit, + no parity + +----- +Category: port 2 (-2) (normally modem port) +Settings: same as for printer port + +Examples: conp -2luxhn -- line length unlimited, X-off handshake off + +----- +Category: fast (-f) + +Well, this isn't really a category. A simple "y" or "n" is expected. +"Y" sets fast mode (2.8 MHz); "N" sets slow mode (1.0 MHz). + +Examples: conp -fn -- slow + conp -fy -- fast + +----- +Category: RAMdisk (r) +Settings: s size -- sets minimum and maximum size + a minimum -- sets minimum size + b maximum -- sets maximum size + +All values refer to a number of 32K chunks. + +Examples: conp -rs0 -- set RAMdisk size to 0 + conp -rs4 -- set RAMdisk size to 128K (=4x32K) + conp -ra10b20 -- set minimum size to 320K, max to 640K + +(Note that the new size does not take effect until a power-up or a +"boot -i".) +----- +Category: clock (c) +Settings: NONE YET (NOT DONE) + +----- +Category: display (d) +Settings: tx text color 0 to 15 + bk text background color 0 to 15 + bd border color 0 to 15 + 80 80 columns on RESET and power-up? y/n + m monochrome monitor? y/n + +Examples: conp -dtx15 -- show white text + conp -dbd0 -- black border + conp -d80ymn -- 80 columns on RESET, color monitor + +Note: the "m" option has no effect on the display of an RGB monitor. +Some programs do not work properly when the "80" option is on. + +----- +Category: options (-o) + +Settings: + + tl text language 0 to 31 (MOST VALUES ILLEGAL? %%%) + kl keyboard language 0 to 31 (MOST VALUES ILLEGAL? %%%) + kb keyboard buffering y/n + rs repeat speed 0 to 7 + rd repeat delay 0 to 4 (4=no repeat) + dc double click time 0 to 4 + fr flash rate 0 to 4 + cs caps+shift = lower case y/n + fs fast space/delete y/n + ds dual-speed keys y/n + hm high-speed mouse y/n + +Notes: The keyboard buffering is 16 characters within the IIgs (provided +by the Keyboard Microcontroller), plus an additional 3 characters within +the keyboard itself, if you have the external Apple Desktop Bus keyboard. +Some programs don't work properly with keyboard buffering turned on. When +keyboard buffering is on, Ctrl-Apple-DELETE empties the buffer. + +----- +end of 'conp' help (finally!) diff --git a/doc/help/Config b/doc/help/Config index bf869e8..c116f3b 100644 --- a/doc/help/Config +++ b/doc/help/Config @@ -1 +1,57 @@ - config -- display or change Davex configuration syntax: config [-p slot] [-b y|n] [-4 y|n] [-c y|n] [-h string] [-q integer] ex: config -- show current settings config -p1 -- printer slot 1 config -by -- use system bell config -p7 -bn -- printer slot 7, "blat" bell config -4n -cy -- 80 columns, show IIgs clock config -h .62help -- set location of help directory config -q2 -- don't print "welcome" message 'config' with no parameters displays the current values of all options that you can set with this command. The -p option sets the default printer slot. This slot number is used when you specify "&" as the pathname for a "como" or ">" command. Also, 'spool' and Apple-H (hardcopy of screen) always print to the slot you set with 'config'. -b is a yes/no option that determines whether the system beep will be used. If -bn is given, the standard ProDOS buzz is used. IIgs users especially may want to use -by, since the pitch is configurable through the control panel (or through the 'conp' external command). -4 is a yes/no option. When set to yes, it restricts your display to 40 columns (while in Davex) even if you have an 80-column card. Note that some things are not formatted well in 40 columns--most notably, the help files. (The new display setting takes effect when you hit RESET or re-enter Davex.) -c is a yes/no option that has effect only on an Apple IIgs. When set to Yes, the date and time that appear when you hit Return without typing a command will include seconds and will be in the format you have selected in the Control Panel. -h sets the pathname of the Help directory. The default is "%help". The string can be a full pathname, or it can start with "%" or with a slot/ drive specification (ex: ".62help"). This option is useful if several people are running Davex from separate directories on the same hard drive and want to keep just one copy of the help files. -q controls whether the "welcome" message is printed when you enter Davex. The default is 0, and the message is always printed. Set to 2 and the message will not be printed; set to 1 and it will be printed only if no speech synthesizer is being used. IIgs users: If your machine is on an AppleTalk network with a LaserWriter and you have the appropriate files in your SYSTEM/SYSTEM.SETUP directory and you have run CHOOSER.II (supplied on your system disk) to download the ImageWriter emulator to the LaserWriter, you can treat the LaserWriter as an ImageWriter in slot 7. (Slot 7 must be set to "Built-in Appletalk," not "Your card.") (see also: como, spool) \ No newline at end of file + +config -- display or change Davex configuration + +syntax: config [-p slot] [-b y|n] [-4 y|n] [-c y|n] + [-h string] [-q integer] + +ex: config -- show current settings + config -p1 -- printer slot 1 + config -by -- use system bell + config -p7 -bn -- printer slot 7, "blat" bell + config -4n -cy -- 80 columns, show IIgs clock + config -h .62help -- set location of help directory + config -q2 -- don't print "welcome" message + +'config' with no parameters displays the current values of all options +that you can set with this command. + +The -p option sets the default printer slot. This slot number is used +when you specify "&" as the pathname for a "como" or ">" command. Also, +'spool' and Apple-H (hardcopy of screen) always print to the slot you +set with 'config'. + +-b is a yes/no option that determines whether the system beep will be +used. If -bn is given, the standard ProDOS buzz is used. IIgs users +especially may want to use -by, since the pitch is configurable through +the control panel (or through the 'conp' external command). + +-4 is a yes/no option. When set to yes, it restricts your display to +40 columns (while in Davex) even if you have an 80-column card. Note +that some things are not formatted well in 40 columns--most notably, the +help files. (The new display setting takes effect when you hit RESET or +re-enter Davex.) + +-c is a yes/no option that has effect only on an Apple IIgs. When set +to Yes, the date and time that appear when you hit Return without typing +a command will include seconds and will be in the format you have selected +in the Control Panel. + +-h sets the pathname of the Help directory. The default is "%help". The +string can be a full pathname, or it can start with "%" or with a slot/ +drive specification (ex: ".62help"). This option is useful if several +people are running Davex from separate directories on the same hard drive +and want to keep just one copy of the help files. + +-q controls whether the "welcome" message is printed when you enter Davex. +The default is 0, and the message is always printed. Set to 2 and the +message will not be printed; set to 1 and it will be printed only if no +speech synthesizer is being used. + +IIgs users: If your machine is on an AppleTalk network with a LaserWriter +and you have the appropriate files in your SYSTEM/SYSTEM.SETUP directory +and you have run CHOOSER.II (supplied on your system disk) to download the +ImageWriter emulator to the LaserWriter, you can treat the LaserWriter as an +ImageWriter in slot 7. (Slot 7 must be set to "Built-in Appletalk," not +"Your card.") + +(see also: como, spool) diff --git a/doc/help/Copy b/doc/help/Copy index 4c41560..c97f5a3 100644 --- a/doc/help/Copy +++ b/doc/help/Copy @@ -1 +1,41 @@ - copy -- copy files or directories syntax: copy [-f] [-d] [-b] ex: copy thing /otherdisk/blah copy this /backup copy %= /backup/= -fb copy /system.disk/system /ram5/system Copies files from first path to second path. Unless -f (force) is given, ask for permission to replace the old copy. If the old file is LOCKED (access is not "rwnd"), copy asks for permission even if you use -f. -d deletes the original after a successful copy. -b clears the backup bit of the original after a successful copy. If the first pathname refers to a file and the second pathname refers to a directory, 'copy' puts the file INTO the directory. (It does not replace the directory with the file.) If you omit the second pathname completely, 'copy' behaves as though you supplied the current prefix. Result: "copy pathname" copies a file into the current directory, using the original file's filename. If the first pathname refers to a DIRECTORY, the directory and everything in it (files and/or directories) is copied to the second pathname. The second pathname must not refer to an existing directory ("ProDOS error: duplicate file" results). 'copy' will copy sparse files, but the new files will no longer be sparse. 'copy' can't copy extended files (storage type 5). You get a "bad storage type" error for trying. (Extended files have two forks and are created under GS/OS.) (see also: update) \ No newline at end of file + +copy -- copy files or directories + +syntax: copy [-f] [-d] [-b] + +ex: copy thing /otherdisk/blah + copy this /backup + copy %= /backup/= -fb + copy /system.disk/system /ram5/system + +Copies files from first path to second path. Unless -f +(force) is given, ask for permission to replace the old +copy. If the old file is LOCKED (access is not "rwnd"), +copy asks for permission even if you use -f. + +-d deletes the original after a successful copy. -b clears +the backup bit of the original after a successful copy. + +If the first pathname refers to a file and the second +pathname refers to a directory, 'copy' puts the file INTO +the directory. (It does not replace the directory with the +file.) + +If you omit the second pathname completely, 'copy' behaves +as though you supplied the current prefix. Result: "copy +pathname" copies a file into the current directory, using +the original file's filename. + +If the first pathname refers to a DIRECTORY, the directory +and everything in it (files and/or directories) is copied to +the second pathname. The second pathname must not refer to +an existing directory ("ProDOS error: duplicate file" results). + +'copy' will copy sparse files, but the new files will no +longer be sparse. + +'copy' can't copy extended files (storage type 5). You get +a "bad storage type" error for trying. (Extended files have +two forks and are created under GS/OS.) + +(see also: update) diff --git a/doc/help/Create b/doc/help/Create index 28e6236..1a39c08 100644 --- a/doc/help/Create +++ b/doc/help/Create @@ -1 +1,11 @@ - create -- create a directory or other file syntax: create [:] ex: create mydir create myfile:sys create something:bad Creates a file with the given filetype or, if no filetype is given, of type DIR. \ No newline at end of file + +create -- create a directory or other file + +syntax: create [:] + +ex: create mydir + create myfile:sys + create something:bad + +Creates a file with the given filetype or, if no filetype is +given, of type DIR. diff --git a/doc/help/DOSCat b/doc/help/DOSCat index 3affaf0..9c88752 100644 --- a/doc/help/DOSCat +++ b/doc/help/DOSCat @@ -1 +1,23 @@ - doscat -- catalog a DOS 3.3 disk (EXTERNAL) by Kevin Cooper and Dave Lyons syntax: doscat [-v] [-f filetypes] [-l y|n] [-o string] ex: doscat .61 doscat .62 -v -fTA -ly 'doscat' displays the catalog listing of a 5.25" DOS 3.3 disk. -v stops the volume number from appearing. -f restricts the listing to files of the specified types (the eight possible filetypes are called T, I, A, B, S, R, X, and Y). -ly ("locked yes") restricts the listing to files that are locked, and -ln ("locked no") restricts the listing to files that are not locked. -o takes a string and prints it for each filename selected, substituting the filename for all "=" signs in the string. See "help =" to see how this can be useful. \ No newline at end of file + +doscat -- catalog a DOS 3.3 disk (EXTERNAL) + by Kevin Cooper and Dave Lyons + +syntax: doscat [-v] [-f filetypes] [-l y|n] [-o string] + +ex: doscat .61 + doscat .62 -v -fTA -ly + +'doscat' displays the catalog listing of a 5.25" DOS 3.3 disk. + +-v stops the volume number from appearing. + +-f restricts the listing to files of the specified types (the +eight possible filetypes are called T, I, A, B, S, R, X, and Y). + +-ly ("locked yes") restricts the listing to files that are locked, +and -ln ("locked no") restricts the listing to files that are +not locked. + +-o takes a string and prints it for each filename selected, +substituting the filename for all "=" signs in the string. +See "help =" to see how this can be useful. diff --git a/doc/help/DT b/doc/help/DT index 9dfdda0..c6a3e02 100644 --- a/doc/help/DT +++ b/doc/help/DT @@ -1 +1,13 @@ - dt -- print date and time (if available) syntax: dt ex: dt como %log;dt Prints date and time. This is fairly useless used alone, since you can get the same information by just hitting RETURN. But it may be handy if output is redirected. The second example above, if placed in %AUTOEXEC, will keep a log of all times Davex was entered. \ No newline at end of file + +dt -- print date and time (if available) + +syntax: dt + +ex: dt + como %log;dt + +Prints date and time. This is fairly useless used alone, +since you can get the same information by just hitting +RETURN. But it may be handy if output is redirected. The +second example above, if placed in %AUTOEXEC, will keep a +log of all times Davex was entered. diff --git a/doc/help/DU b/doc/help/DU index 348ed52..b4ccdeb 100644 --- a/doc/help/DU +++ b/doc/help/DU @@ -1 +1,20 @@ - du -- summarize disk usage (EXTERNAL) [v1.4] syntax: du [pathname] ex: du du /mydisk du .61 du % When used without the optional pathname, 'du' prints a table showing K free and percent used for all online volumes; then totals the K free and % used and prints the number of volumes online. If a pathname is given, du prints the name of the volume specified in the pathname; then it prints the number of free blocks, used blocks, and total blocks on the volume. Note that a "K" is 1024 bytes (characters) of storage space, which is the same as 2 blocks on a ProDOS disk; a block is 512 bytes. \ No newline at end of file + +du -- summarize disk usage (EXTERNAL) [v1.4] + +syntax: du [pathname] + +ex: du + du /mydisk + du .61 + du % + +When used without the optional pathname, 'du' prints a table showing +K free and percent used for all online volumes; then totals the K +free and % used and prints the number of volumes online. + +If a pathname is given, du prints the name of the volume specified +in the pathname; then it prints the number of free blocks, used +blocks, and total blocks on the volume. + +Note that a "K" is 1024 bytes (characters) of storage space, which is +the same as 2 blocks on a ProDOS disk; a block is 512 bytes. diff --git a/doc/help/Date b/doc/help/Date index d8a454e..f566d4f 100644 --- a/doc/help/Date +++ b/doc/help/Date @@ -1 +1,70 @@ - date -- interactive date and time setting program (EXTERNAL) [v1.2] Written by Jeff Ding syntax: date [-p] {[-s] [-d] [-t]} [-f] ex: date date -p date -s -t date -s -t -f"%time.stamp" 'Date' is a program to set the date and time of your computer if you do not have a clock built in to your computer. This program will not change the date on your clock but only change the bytes in ProDOS. This program was designed to be included in the %autoexec file. For example, add the following line to your file: "date -s." See below for the explanation of the -s option. With no options, 'date' will print the current date and time and ask for the new date and the new time. The format for the date is DD-MMM-YY. The format for the time is HH:MM in 24 hour format. If the date or time is entered incorrectly, or you just press return when prompted, 'date' will not change the current values. Options are as follows: -p: print only -- When this option is used, 'date' will only print the date and time currently on the system. -s: set date/time only if not already set -- This option will only prompt you to set the date and time if the date and time have not already been set. This option is useful in the %autoexec startup file. You will be prompted once on bootup to set the date and time. When you re-enter Davex after quitting from an application, 'date' will not ask you to change the date since you already set it on bootup. -d: date -- Use this option in conjunction with the -s option. This will force the program to always set the date even if the date has already been set. Time setting remains the same as with the -s option. -t: time -- Use this option in conjunction with the -s option. This will force the program to always set the time even if the time has already been set. Date setting remains the same as with the -s option. -f: get date/time stamp from file -- This option will set your system's date and time equal to the last modification date and time field from the file given after the option. This option is only effective when the date and time is not set. Use this option in your autoexec file to set the your system time on bootup. Example autoexec file: date -s -t -f"%time.stamp" touch %time.stamp The first line will grab the time from the file "time.stamp" in the Davex directory when first booting up the computer. Every time you rerun Davex after exiting from a sys program, you will be prompted to change only the time. The second line keeps the date current on the file "time.stamp" so it reads in the most current date when you reboot the computer. Notes: If the -p option is included along with the -s option, 'date' will ignore the -s option and only print the date and time. When you use the -t option and the newly entered hour is less than the current hour, 'date' version 1.2 will increment the date by one day, changing the month and year if necessary. The command 'date -s -d -t' performs the same functions as the command 'date' with no options. \ No newline at end of file + +date -- interactive date and time setting program (EXTERNAL) [v1.2] + Written by Jeff Ding + +syntax: date [-p] {[-s] [-d] [-t]} [-f] + +ex: date + date -p + date -s -t + date -s -t -f"%time.stamp" + +'Date' is a program to set the date and time of your computer if you do +not have a clock built in to your computer. This program will not change +the date on your clock but only change the bytes in ProDOS. This program +was designed to be included in the %autoexec file. For example, add the +following line to your file: "date -s." See below for the explanation of +the -s option. + +With no options, 'date' will print the current date and time and ask for +the new date and the new time. The format for the date is DD-MMM-YY. The +format for the time is HH:MM in 24 hour format. If the date or time is +entered incorrectly, or you just press return when prompted, 'date' will not +change the current values. Options are as follows: + + -p: print only -- When this option is used, 'date' will only print + the date and time currently on the system. + + -s: set date/time only if not already set -- This option will only + prompt you to set the date and time if the date and time have not + already been set. This option is useful in the %autoexec startup + file. You will be prompted once on bootup to set the date and time. + When you re-enter Davex after quitting from an application, 'date' + will not ask you to change the date since you already set it on + bootup. + + -d: date -- Use this option in conjunction with the -s option. + This will force the program to always set the date even if the + date has already been set. Time setting remains the same as + with the -s option. + + -t: time -- Use this option in conjunction with the -s option. + This will force the program to always set the time even if the + time has already been set. Date setting remains the same as + with the -s option. + + -f: get date/time stamp from file -- This option will set your system's + date and time equal to the last modification date and time field + from the file given after the option. This option is only effective + when the date and time is not set. Use this option in your autoexec + file to set the your system time on bootup. Example autoexec file: + + date -s -t -f"%time.stamp" + touch %time.stamp + + The first line will grab the time from the file "time.stamp" in the + Davex directory when first booting up the computer. Every time you + rerun Davex after exiting from a sys program, you will be prompted + to change only the time. The second line keeps the date current + on the file "time.stamp" so it reads in the most current date when + you reboot the computer. + +Notes: If the -p option is included along with the -s option, 'date' will + ignore the -s option and only print the date and time. + + When you use the -t option and the newly entered hour is less + than the current hour, 'date' version 1.2 will increment the + date by one day, changing the month and year if necessary. + + The command 'date -s -d -t' performs the same functions as the + command 'date' with no options. diff --git a/doc/help/Delete b/doc/help/Delete index 58e7f3e..b898a0e 100644 --- a/doc/help/Delete +++ b/doc/help/Delete @@ -1 +1,20 @@ - delete -- destroy files or directories syntax: delete [-u] ex: delete this delete =.0 -u delete ?:dir Permanently destroys the specified file or directory. Wildcards are allowed. Before destroying a directory, the 'size' command is automatically used to compute the total size of the directory and everything in it, and you are given a chance NOT to destroy the directory. -u unlocks a file before trying to destroy it. When deleting a directory, -u unlocks each file before it is destroyed; otherwise any locked file in a directory will cause delete to stop with only some of the files deleted. \ No newline at end of file + +delete -- destroy files or directories + +syntax: delete [-u] + +ex: delete this + delete =.0 -u + delete ?:dir + +Permanently destroys the specified file or directory. Wildcards +are allowed. + +Before destroying a directory, the 'size' command is automatically +used to compute the total size of the directory and everything in +it, and you are given a chance NOT to destroy the directory. + +-u unlocks a file before trying to destroy it. When deleting a +directory, -u unlocks each file before it is destroyed; otherwise +any locked file in a directory will cause delete to stop with only +some of the files deleted. diff --git a/doc/help/Deschw b/doc/help/Deschw index 929e612..fce0c7d 100644 --- a/doc/help/Deschw +++ b/doc/help/Deschw @@ -1 +1,30 @@ - deschw -- describe hardware (EXTERNAL) [v1.2] syntax: deschw [-c] [-s] [-t] ex: deschw deschw -t deschw -ct deschw -s Describes system hardware. Giving no options has the same effect as giving them all. -t displays the system type. Possible types are: Apple IIgs; ROM version $xx [Machine ID = $xx] (reports total RAM, too) Apple IIe (enhanced) Apple IIe (unenhanced) Apple ][+ Apple /// (in emulation mode) Apple IIc (version 1: original) Apple IIc (version 2: 3.5" disk ROM) Apple IIc (version 3: memory expandable) Apple IIc (version 4: revised mem. expandable) Apple IIc Plus -c tries to identify the cards (and/or ports) in your system. -s displays information about all SmartPort (=Protocol Converter) cards/ports in your system, and all devices in their chains. \ No newline at end of file + +deschw -- describe hardware (EXTERNAL) [v1.2] + +syntax: deschw [-c] [-s] [-t] + +ex: deschw + deschw -t + deschw -ct + deschw -s + +Describes system hardware. Giving no options has the same +effect as giving them all. + +-t displays the system type. Possible types are: + Apple IIgs; ROM version $xx [Machine ID = $xx] + (reports total RAM, too) + Apple IIe (enhanced) + Apple IIe (unenhanced) + Apple ][+ + Apple /// (in emulation mode) + Apple IIc (version 1: original) + Apple IIc (version 2: 3.5" disk ROM) + Apple IIc (version 3: memory expandable) + Apple IIc (version 4: revised mem. expandable) + Apple IIc Plus + +-c tries to identify the cards (and/or ports) in your system. + +-s displays information about all SmartPort (=Protocol Converter) + cards/ports in your system, and all devices in their chains. diff --git a/doc/help/Dev b/doc/help/Dev index 803a0e9..369476b 100644 --- a/doc/help/Dev +++ b/doc/help/Dev @@ -1 +1,23 @@ - dev -- list, add, or remove ProDOS devices syntax: dev [-r] [-a] [-z] ex: dev dev -z dev -r.62 dev -a.32 With no options, prints list of device numbers ProDOS scans when looking for an unknown volume. With -r, removes the specified device from the list. With -a, adds the specified device to the list. -z (zap) scans all devices in the device list and REMOVES the ones that don't have ProDOS volumes mounted. This is especially useful if you have Disk IIs that you will not use for a while. (The next time you re-enter ProDOS 8, all your disk devices will again be present in ProDOS's scan list.) Note: with -a, the low nybble of the device number is always set to 0. This is not usually a problem. \ No newline at end of file + +dev -- list, add, or remove ProDOS devices + +syntax: dev [-r] [-a] [-z] + +ex: dev + dev -z + dev -r.62 + dev -a.32 + +With no options, prints list of device numbers ProDOS scans +when looking for an unknown volume. With -r, removes the +specified device from the list. With -a, adds the specified +device to the list. + +-z (zap) scans all devices in the device list and REMOVES +the ones that don't have ProDOS volumes mounted. This is +especially useful if you have Disk IIs that you will not use +for a while. (The next time you re-enter ProDOS 8, all your +disk devices will again be present in ProDOS's scan list.) + +Note: with -a, the low nybble of the device number is +always set to 0. This is not usually a problem. diff --git a/doc/help/Dump b/doc/help/Dump index e5cd16b..25c2e57 100644 --- a/doc/help/Dump +++ b/doc/help/Dump @@ -1 +1,31 @@ - dump -- display file contents in hex/ASCII (EXTERNAL) [v1.2] syntax: dump [-a] [-h] [-o] [-s ] [-e ] ex: dump that.file dump ?:sys -o dump my.file -s$100 -e512 'dump' displays the contents of a file in hex and/or ASCII. Wildcards are allowed. -h display in hex -a display in ASCII If neither -h nor -a is given, the dump is in BOTH hex and ASCII. Non-printable characters in the ASCII dump are displayed as periods. Each line begins with an "offset" in hex from the beginning of the file (the first byte has offset 0). Use -o to stop the offsets from appearing. You can use the -s option to begin the dump somewhere other than the beginning of the file (offset 0), and you can use -e to end the dump somewhere other than the end of the file. Note: 'dump' is useful for looking at the exact contents of directories (both subdirectories and volume directories), not just for standard files. (This is no extra work for 'dump'; ProDOS simply allows directories to be opened and read the same way as other files.) \ No newline at end of file + +dump -- display file contents in hex/ASCII (EXTERNAL) [v1.2] + +syntax: dump [-a] [-h] [-o] [-s ] [-e ] + +ex: dump that.file + dump ?:sys -o + dump my.file -s$100 -e512 + +'dump' displays the contents of a file in hex and/or ASCII. Wildcards +are allowed. + + -h display in hex + -a display in ASCII + +If neither -h nor -a is given, the dump is in BOTH hex and ASCII. +Non-printable characters in the ASCII dump are displayed as periods. + +Each line begins with an "offset" in hex from the beginning of the +file (the first byte has offset 0). Use -o to stop the offsets from +appearing. + +You can use the -s option to begin the dump somewhere other than the +beginning of the file (offset 0), and you can use -e to end the dump +somewhere other than the end of the file. + +Note: 'dump' is useful for looking at the exact contents of + directories (both subdirectories and volume directories), + not just for standard files. (This is no extra work for + 'dump'; ProDOS simply allows directories to be opened and + read the same way as other files.) diff --git a/doc/help/Echo b/doc/help/Echo index a543b7c..13be90c 100644 --- a/doc/help/Echo +++ b/doc/help/Echo @@ -1 +1,31 @@ - echo -- echo string to output syntax: echo [-n] ex: echo "This is a test of ECHO" como %n;echo "Don't forget to feed the dog!" echo "scan -a" -n; = % 'echo' just outputs the same string you give it. The -n option prevents a carriage-return from being printed after the string. 'echo' is useful only when output is redirected to a file or to a printer. For example, if your %autoexec file contains "pg %n", you can use como %n;echo "text here" to record a message you will see whenever you enter the shell. If you do something like that, you may want to create an alias called "note" (for example) that stands for como %n;echo " This alias could be used like this: note Finish report for saturday! [No closing quote is necessary.] (see also: como, alias) \ No newline at end of file + +echo -- echo string to output + +syntax: echo [-n] + +ex: echo "This is a test of ECHO" + como %n;echo "Don't forget to feed the dog!" + echo "scan -a" -n; = % + +'echo' just outputs the same string you give it. The -n +option prevents a carriage-return from being printed after +the string. + +'echo' is useful only when output is redirected to a file +or to a printer. For example, if your %autoexec file +contains "pg %n", you can use + + como %n;echo "text here" + +to record a message you will see whenever you enter the +shell. If you do something like that, you may want to +create an alias called "note" (for example) that stands +for + como %n;echo " + +This alias could be used like this: + note Finish report for saturday! + +[No closing quote is necessary.] + +(see also: como, alias) diff --git a/doc/help/Eject b/doc/help/Eject index 81b15a3..2d63281 100644 --- a/doc/help/Eject +++ b/doc/help/Eject @@ -1 +1,19 @@ - eject -- eject a volume or all volumes from SmartPort syntax: eject [pathname] ex: eject eject /mydisk eject .52 Ejects the specified 3.5" volume from a UniDisk 3.5 or Apple 3.5 drive. If no volume name is given, all 3.5" disks are ejected. Note that the parameter is a PATHNAME, so a command like "eject .52" makes Davex try to find the name of the volume in slot 5, drive 2 before searching all drives to find that volume. So 'eject' will not help you eject individual non-ProDOS disks or individual plastic shipping disks. \ No newline at end of file + +eject -- eject a volume or all volumes from SmartPort + +syntax: eject [pathname] + +ex: eject + eject /mydisk + eject .52 + +Ejects the specified 3.5" volume from a UniDisk 3.5 or Apple +3.5 drive. If no volume name is given, all 3.5" disks are +ejected. + +Note that the parameter is a PATHNAME, so a command like +"eject .52" makes Davex try to find the name of the volume in +slot 5, drive 2 before searching all drives to find that volume. +So 'eject' will not help you eject individual non-ProDOS disks +or individual plastic shipping disks. + diff --git a/doc/help/Equal b/doc/help/Equal index a456eec..a36c007 100644 --- a/doc/help/Equal +++ b/doc/help/Equal @@ -1 +1,50 @@ - = -- print a complete pathname or a string built from a template syntax: = [