diff --git a/doc/help/BList b/doc/help/BList index 0481e4e..4c70d79 100644 --- a/doc/help/BList +++ b/doc/help/BList @@ -7,10 +7,10 @@ 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 +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 diff --git a/doc/help/Boot b/doc/help/Boot index 5ff5cdc..79e862d 100644 --- a/doc/help/Boot +++ b/doc/help/Boot @@ -6,12 +6,12 @@ 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 +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 +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 diff --git a/doc/help/Bye b/doc/help/Bye index 9882ee8..9b4d0db 100644 --- a/doc/help/Bye +++ b/doc/help/Bye @@ -5,12 +5,12 @@ 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 +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 +(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 4bfbba2..9b1716c 100644 --- a/doc/help/Cat +++ b/doc/help/Cat @@ -11,11 +11,11 @@ ex: cat 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 +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 + -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' @@ -25,10 +25,10 @@ directory.) The following options are available: -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 + -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) diff --git a/doc/help/Cls b/doc/help/Cls index d8e69ae..005d79d 100644 --- a/doc/help/Cls +++ b/doc/help/Cls @@ -6,7 +6,7 @@ syntax: cls ex: cls como &;cls -- new page on printer -Clears the screen. If redirected to the printer, as in the +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 d77ac69..9a3b5ac 100644 --- a/doc/help/CmdLine +++ b/doc/help/CmdLine @@ -11,9 +11,9 @@ 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 +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 diff --git a/doc/help/Combine b/doc/help/Combine index 4fe8014..0588611 100644 --- a/doc/help/Combine +++ b/doc/help/Combine @@ -8,10 +8,10 @@ syntax: combine [] 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. +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. diff --git a/doc/help/ConP b/doc/help/ConP index 36c179f..4edf796 100644 --- a/doc/help/ConP +++ b/doc/help/ConP @@ -77,7 +77,7 @@ Examples: conp -sb5x1i52 -- set boot to slot 5, slot 1 external ("your 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 diff --git a/doc/help/Copy b/doc/help/Copy index c97f5a3..3898343 100644 --- a/doc/help/Copy +++ b/doc/help/Copy @@ -8,16 +8,16 @@ ex: copy thing /otherdisk/blah 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"), +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 +-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 +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.) @@ -26,12 +26,12 @@ 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 +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 +'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 diff --git a/doc/help/Create b/doc/help/Create index 1a39c08..5ad0d89 100644 --- a/doc/help/Create +++ b/doc/help/Create @@ -7,5 +7,5 @@ ex: create mydir create myfile:sys create something:bad -Creates a file with the given filetype or, if no filetype is +Creates a file with the given filetype or, if no filetype is given, of type DIR. diff --git a/doc/help/DT b/doc/help/DT index c6a3e02..c5effee 100644 --- a/doc/help/DT +++ b/doc/help/DT @@ -6,8 +6,8 @@ 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 +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/Date b/doc/help/Date index f566d4f..2b8c42a 100644 --- a/doc/help/Date +++ b/doc/help/Date @@ -14,13 +14,13 @@ 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. +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: +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. @@ -32,12 +32,12 @@ change the current values. Options are as follows: 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 @@ -64,7 +64,7 @@ Notes: If the -p option is included along with the -s option, 'date' will 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. - + 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 b898a0e..9574dee 100644 --- a/doc/help/Delete +++ b/doc/help/Delete @@ -11,7 +11,7 @@ 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 +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 diff --git a/doc/help/Dev b/doc/help/Dev index 369476b..56535d5 100644 --- a/doc/help/Dev +++ b/doc/help/Dev @@ -8,16 +8,16 @@ ex: dev dev -r.62 dev -a.32 -With no options, prints list of device numbers ProDOS scans +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 +-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 +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/Echo b/doc/help/Echo index b30cd8a..469a7ae 100644 --- a/doc/help/Echo +++ b/doc/help/Echo @@ -17,7 +17,7 @@ contains "pg %n", you can use como %n;echo "text here" -to record a message you will see whenever you enter the +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 diff --git a/doc/help/Eject b/doc/help/Eject index 2d63281..ff8d3d2 100644 --- a/doc/help/Eject +++ b/doc/help/Eject @@ -7,8 +7,8 @@ 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 +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 diff --git a/doc/help/Equal b/doc/help/Equal index a36c007..02f08f8 100644 --- a/doc/help/Equal +++ b/doc/help/Equal @@ -8,16 +8,16 @@ ex: = % como my.list;= =:bas = .61prodos -Prints a complete pathname. Wildcards are allowed. The -first example prints the pathname of the Davex directory. -The second builds a complete pathname by appending the given -partial path to the current prefix. The third prints, into -a file called "my.list", complete pathnames for all BAS -files in the current directory. The fourth prints the +Prints a complete pathname. Wildcards are allowed. The +first example prints the pathname of the Davex directory. +The second builds a complete pathname by appending the given +partial path to the current prefix. The third prints, into +a file called "my.list", complete pathnames for all BAS +files in the current directory. The fourth prints the pathname of a file PRODOS in slot 6, drive 1. -When '=' is used without wildcards, as in the fourth -example, files with the printed pathnames do not necessarily +When '=' is used without wildcards, as in the fourth +example, files with the printed pathnames do not necessarily exist. diff --git a/doc/help/Err b/doc/help/Err index f0b0016..3d53b41 100644 --- a/doc/help/Err +++ b/doc/help/Err @@ -6,13 +6,13 @@ syntax: err ex: err 70 err $46 -Prints the ProDOS error message corresponding to the given +Prints the ProDOS error message corresponding to the given error code. 'err 0' prints a list of all the errors in the table. -Davex never prints an error number if a message is available -instead. This command is useful if you get an error code -from a program that doesn't have a table of ProDOS error +Davex never prints an error number if a message is available +instead. This command is useful if you get an error code +from a program that doesn't have a table of ProDOS error messages built in. (Applications created by 'sysalias' will print two-digit error codes if something goes wrong; use "err $xx" to see what they mean.) diff --git a/doc/help/Exec b/doc/help/Exec index 284caa2..1bd2325 100644 --- a/doc/help/Exec +++ b/doc/help/Exec @@ -5,8 +5,8 @@ syntax: exec ex: exec foo.bar -Makes keyboard input come from the specified file until an -error occurs or until end of file is reached. Wildcards are +Makes keyboard input come from the specified file until an +error occurs or until end of file is reached. Wildcards are allowed. The file must be of type TXT ($04), SRC ($B0), or $C6/$8001 (Davex 8 Script). diff --git a/doc/help/Expand b/doc/help/Expand index bb1b38c..0e94ec7 100644 --- a/doc/help/Expand +++ b/doc/help/Expand @@ -3,7 +3,7 @@ expand -- Expand tabs (EXTERNAL) [v1.1] Written by Jeff Ding syntax: expand [-c] [-t] - [-s""] + [-s""] ex: expand file.w.tabs expand merlin.s -c160 -s"14,20,35" @@ -15,7 +15,7 @@ lines are split into multiple lines. Use output redirection on the command line to save output in a file (last example). The second example works great for viewing Merlin source files. -Options are as follows: +Options are as follows: -c: character for tab. Enter the ascii value of the character to use for the tab expansion. The default character is value 9 diff --git a/doc/help/FFind b/doc/help/FFind index 600b75a..3b34c35 100644 --- a/doc/help/FFind +++ b/doc/help/FFind @@ -31,7 +31,7 @@ pathname: Tells 'ffind' where to look. If you leave this out, it meaningful only if you use -n.] -f: Tells 'ffind' what filetype to look for. Example: - ffind -fawp finds AppleWorks Word Processor files. + ffind -fawp finds AppleWorks Word Processor files. -x: Tells 'ffind' what auxiliary type to look for. Example: ffind -fbin -x$800 finds binary files that load at $800. diff --git a/doc/help/FP b/doc/help/FP index a7eea44..ec800e5 100644 --- a/doc/help/FP +++ b/doc/help/FP @@ -12,11 +12,11 @@ than nothing. It isn't cleanly implemented and may have some problems. It isn't going to crash your system or fry your disk, but I wouldn't recommend trying to print your thesis with it.] -Outputs formatted text generated from text and imbedded "dot -commands" in a file. -c prints credits; -1 is the same as +Outputs formatted text generated from text and imbedded "dot +commands" in a file. -c prints credits; -1 is the same as including ".sp1" in the file. -The dot commands 'fp' recognizes are similar to the ones +The dot commands 'fp' recognizes are similar to the ones AppleWriter recognizes. They are (defaults in parentheses): .lm# (10) -- left margin @@ -40,8 +40,8 @@ AppleWriter recognizes. They are (defaults in parentheses): .ff# -- begin new page if fewer than # lines remain on this page -# is a number from 0 to 255. Most values can be ADJUSTED up -or down by putting a "+" or "-" in front of the number. +# is a number from 0 to 255. Most values can be ADJUSTED up +or down by putting a "+" or "-" in front of the number. Example: .lm+5 moves left margin right 5 spaces diff --git a/doc/help/FType b/doc/help/FType index f5ae2f1..e4f2ddb 100644 --- a/doc/help/FType +++ b/doc/help/FType @@ -18,7 +18,7 @@ file, followed by all the filetypes in the internal list. -r removes the given filetype from your list. --a and -v are used together to add one filetype to your list. +-a and -v are used together to add one filetype to your list. Case is unimportant when looking for a filetype in the table, BUT the types are displayed with the case you use in the -a option. diff --git a/doc/help/Filetype b/doc/help/Filetype index 7f2a270..0180674 100644 --- a/doc/help/Filetype +++ b/doc/help/Filetype @@ -6,12 +6,12 @@ syntax: filetype [-x] ex: filetype myfile sys filetype ? bin -x$2000 -Changes the file type (NOT the storage type) of a file. If --x is given, also sets the auxiliary type (subtype) as +Changes the file type (NOT the storage type) of a file. If +-x is given, also sets the auxiliary type (subtype) as specified. -NOTE: Although you can change a DIR file into another type, - and you can change a non-DIR file into a DIR file, - this changes ONLY the file type and will cause much +NOTE: Although you can change a DIR file into another type, + and you can change a non-DIR file into a DIR file, + this changes ONLY the file type and will cause much confusion--it is not recommended. (The storage type is not affected.) diff --git a/doc/help/Find b/doc/help/Find index 0170912..ceab873 100644 --- a/doc/help/Find +++ b/doc/help/Find @@ -28,7 +28,7 @@ string: Specifies what to search for. If this string contains -L: Specifies the number of consecutive lines to display starting with each matching line. If you do not give this option, only - the matching lines are displayed. (If -c is given, no lines + the matching lines are displayed. (If -c is given, no lines are displayed unless you also use -L.) [An additional line printed after a match may itself be a diff --git a/doc/help/Hdr b/doc/help/Hdr index a1a4ee2..f5b818b 100644 --- a/doc/help/Hdr +++ b/doc/help/Hdr @@ -6,9 +6,9 @@ syntax: hdr [-Ln] ex: hdr thatfile hdr %help/= -L2 -Displays lines from the beginning of a file. Wildcards are -allowed. If -L is given, the specified number of lines is -displayed. If -L is omitted, the first 5 lines are +Displays lines from the beginning of a file. Wildcards are +allowed. If -L is given, the specified number of lines is +displayed. If -L is omitted, the first 5 lines are displayed. 'hdr' works for AWP files and for any file type that contains diff --git a/doc/help/IW2 b/doc/help/IW2 index d9cb338..7142fc4 100644 --- a/doc/help/IW2 +++ b/doc/help/IW2 @@ -34,7 +34,7 @@ the printer slot (see 'config'). Each option is explained below: -e # 0: enable ROM character set; 1=enable downloaded charset, low half; 2=enable downloaded charset, high half -Note: -s and -n reset the printer's top of form, so they should be +Note: -s and -n reset the printer's top of form, so they should be used only when the printer is at the top of a page. Note: In version 1.0 of 'iw2', the -f, -x, -i and -e options did diff --git a/doc/help/Info b/doc/help/Info index 5b16cf0..bf1479f 100644 --- a/doc/help/Info +++ b/doc/help/Info @@ -18,7 +18,7 @@ The information printed is: * file type * access (r=read, w=write, n=rename, d=delete, B=changed since backup, I=invisible) - * auxilary type (default load address for BIN, record length for + * auxilary type (default load address for BIN, record length for TXT, saved location for BAS; total blocks for VOLUME) * number of blocks used * date/time created (for a volume, even!) diff --git a/doc/help/Lock b/doc/help/Lock index 0500d6b..c251879 100644 --- a/doc/help/Lock +++ b/doc/help/Lock @@ -6,7 +6,7 @@ syntax: lock ex: lock this lock =:txt -Disallows rename, delete, and write for file. Wildcards are +Disallows rename, delete, and write for file. Wildcards are allowed. (see also: unlock, prot) diff --git a/doc/help/MX80 b/doc/help/MX80 index bbdbe60..859ea5a 100644 --- a/doc/help/MX80 +++ b/doc/help/MX80 @@ -8,10 +8,10 @@ ex: mx80 -z mx80 -p17 -by -in -uy mx80 -s6 -Set print options, assuming an Epson MX80 is connected. Each option +Set print options, assuming an Epson MX80 is connected. Each option is explained below: - -z (zap) set all options to power-up defaults (including top + -z (zap) set all options to power-up defaults (including top of form) -n (normal) turn off special modes and set 10 cpi -1 y|n -1y set unidirectional printing; -1n sets bidirectional @@ -22,7 +22,7 @@ is explained below: -8 y|n eight lines per inch: yes or no (no=6 lines per inch) -s # set number of lines to skip over at end of page -l # set page size in lines (normally 66) - -p # set pitch; may be 5, 8 (really 8.5), 10, or 17 (really + -p # set pitch; may be 5, 8 (really 8.5), 10, or 17 (really 17.16) 'mx80' v1.0 didn't work with recent versions of Davex. diff --git a/doc/help/ModChk b/doc/help/ModChk index 134c002..25d532f 100644 --- a/doc/help/ModChk +++ b/doc/help/ModChk @@ -7,24 +7,24 @@ ex: modchk thisfile thatfile modchk /disk/= /backup/= -o -n modchk =.s = -n -Checks the last-modification dates on a pair of files. Wildcards -are allowed. If none of -o (older), -n (newer), or -s (same) is +Checks the last-modification dates on a pair of files. Wildcards +are allowed. If none of -o (older), -n (newer), or -s (same) is given, a message of the form -is displayed. Relation is "<" (older), "=" (same), or ">" -(newer). If one or more of -o, -n, or -s appears, pathname1 is -displayed only if the files satisfy one of the specified +is displayed. Relation is "<" (older), "=" (same), or ">" +(newer). If one or more of -o, -n, or -s appears, pathname1 is +displayed only if the files satisfy one of the specified conditions. -The second example above displays the names of files on /disk -which are older OR newer than the files with the same names on -/backup. The third example above displays the names of ".s" -files that have been modified since their corresponding files -without the ".s" suffix. This is useful for insuring that you -have not changed an assembly language source file without +The second example above displays the names of files on /disk +which are older OR newer than the files with the same names on +/backup. The third example above displays the names of ".s" +files that have been modified since their corresponding files +without the ".s" suffix. This is useful for insuring that you +have not changed an assembly language source file without recompiling it. -If -q (quiet) is given, no complaint is displayed if the second +If -q (quiet) is given, no complaint is displayed if the second file doesn't exist. diff --git a/doc/help/Mon b/doc/help/Mon index c462a9a..d38dc3d 100644 --- a/doc/help/Mon +++ b/doc/help/Mon @@ -5,10 +5,10 @@ syntax: mon ex: mon -Dumps you into your Apple's monitor. Ctrl-Y or RESET or -3D0G will get you back to Davex. (On an Apple IIgs, Q will +Dumps you into your Apple's monitor. Ctrl-Y or RESET or +3D0G will get you back to Davex. (On an Apple IIgs, Q will do it, too.) -(If the only kind of "monitor" you care about is the one -you're looking at right now, this command isn't for +(If the only kind of "monitor" you care about is the one +you're looking at right now, this command isn't for you--it's for people addicted to machine language.) diff --git a/doc/help/PG b/doc/help/PG index 19bd59b..5ea1298 100644 --- a/doc/help/PG +++ b/doc/help/PG @@ -8,12 +8,12 @@ ex: pg this como newfile;pg oldfile -l pg that -t" " -Types contents of a file (any type, not just TXT). Wildcards are -allowed. -h generates a header giving the date/time the file was last -modified. -f disables filtering of control characters; normally they +Types contents of a file (any type, not just TXT). Wildcards are +allowed. -h generates a header giving the date/time the file was last +modified. -f disables filtering of control characters; normally they are filtered out. --u and -l force all alphabetic characters to display in uppercase or +-u and -l force all alphabetic characters to display in uppercase or lowercase, respectively. -p begins a new page after the file is printed. @@ -26,16 +26,16 @@ At the bottom of each screen, you are prompted --- xx% --- more? (Y/N) -where xx is the percent of the file (calculated by counting +where xx is the percent of the file (calculated by counting characters, not lines) you have read so far. -When output is redirected to a file or to the printer, no prompting +When output is redirected to a file or to the printer, no prompting takes place. -Note: many file types do not contain plain text. This command - knows how to interpret AWP files, but simply displays all other - files byte-for-byte. If you type a SYS file, for example, you - will get a lot of garbage and (probably) a few readable +Note: many file types do not contain plain text. This command + knows how to interpret AWP files, but simply displays all other + files byte-for-byte. If you type a SYS file, for example, you + will get a lot of garbage and (probably) a few readable messages. (see also: type, como, strings, alias) diff --git a/doc/help/PSet b/doc/help/PSet index baa63b5..ec910d3 100644 --- a/doc/help/PSet +++ b/doc/help/PSet @@ -10,7 +10,7 @@ ex: pset -n pset -p12 -by -un pset -sy -1n -l10 -Sets print options, assuming a NEC 8023 or ProWriter or ImageWriter is +Sets print options, assuming a NEC 8023 or ProWriter or ImageWriter is connected. Each option is explained below: -n (normal) turn off special modes and set 10 cpi @@ -23,5 +23,5 @@ connected. Each option is explained below: -p # set pitch; may be 5, 6, 8, 10, 12, or 17 -r y|n reverse formfeed direction; y=reverse, n=forward -Note: -s and -n reset the printer's top of form, so they should be +Note: -s and -n reset the printer's top of form, so they should be used only when the printer is at the top of a page. diff --git a/doc/help/Pathnames b/doc/help/Pathnames index 921d677..f784132 100644 --- a/doc/help/Pathnames +++ b/doc/help/Pathnames @@ -1,7 +1,7 @@ SHORTHAND FOR PATHNAMES -'%' stands for the name of the directory Davex is in. +'%' stands for the name of the directory Davex is in. A period (.) followed by a slot and drive number stands for the name of the volume in the specified slot and drive. diff --git a/doc/help/Prefix b/doc/help/Prefix index a76874c..bb18498 100644 --- a/doc/help/Prefix +++ b/doc/help/Prefix @@ -11,28 +11,28 @@ ex: prefix /disk/dir /mydisk/dir1 .61 -Changes the prefix (which is displayed as your prompt in -Davex). (Typing 'prefix' with no pathname makes your prefix +Changes the prefix (which is displayed as your prompt in +Davex). (Typing 'prefix' with no pathname makes your prefix empty; this is not usually desirable.) Note that an IMPLIED prefix command is done if you type a complete pathname (including one starting with "%" or ".xx"), or if a partial pathname is found in your scan list. -If a partial pathname is given, it is appended to the -current prefix. So "prefix letters" when your prefix is +If a partial pathname is given, it is appended to the +current prefix. So "prefix letters" when your prefix is already "/disk" will make your prefix "/disk/letters". -You can also set your prefix just by typing the name of a -directory. The process is not quite the same--if you type a -partial pathname, Davex uses your scan list to find the -directory. It follows the same rules as for launching SYS -or S16 files, but if it finds a DIR, it just sets your +You can also set your prefix just by typing the name of a +directory. The process is not quite the same--if you type a +partial pathname, Davex uses your scan list to find the +directory. It follows the same rules as for launching SYS +or S16 files, but if it finds a DIR, it just sets your prefix. -For example, if the first entry in your scan list is "*", -you can always change to a subdirectory of the current -directory just by typing the subdirectory's name (unless +For example, if the first entry in your scan list is "*", +you can always change to a subdirectory of the current +directory just by typing the subdirectory's name (unless that name is an internal Davex command!). (see also: origin, up, top, over, scan) diff --git a/doc/help/Prot b/doc/help/Prot index 517f038..4d144d8 100644 --- a/doc/help/Prot +++ b/doc/help/Prot @@ -6,7 +6,7 @@ syntax: prot [-r] [-w] [-n] [-d] ex: prot this prot ? -rwn -Allows only the specified rights to a file: r)ead, w)rite, +Allows only the specified rights to a file: r)ead, w)rite, ren)ame, and d)elete. Wildcards are allowed. prot x -r = lock x diff --git a/doc/help/RAM3 b/doc/help/RAM3 index f5936e3..bbd2af1 100644 --- a/doc/help/RAM3 +++ b/doc/help/RAM3 @@ -28,13 +28,13 @@ Other options are as follows: -f: force removal -- This option used in connection with the -r option will remove the driver even if the volume is not empty. Use this option with caution! - + -a: add -- This option alone will re-install the standard ProDOS 64k /ram driver. This option alone will not work on a II+ because it does not have the necessary auxiliary memory and driver. If you want to install a driver for a third party ram card on a II+, you - must use the -a option in conjunction with the -v option. - + must use the -a option in conjunction with the -v option. + -v: vector -- This option used in connection with the -a option will allow you to install a driver at a specific location xxxxx. This vector points to the entry point of the driver diff --git a/doc/help/Rename b/doc/help/Rename index 5f97147..a28a264 100644 --- a/doc/help/Rename +++ b/doc/help/Rename @@ -7,16 +7,16 @@ ex: rename this that rename /blank /mydisk rename letter= ltr.= -Changes the name of a file, directory, or volume. Wildcards -are allowed, as in the third example. A wildcard in the -second pathname expands to the same text the wildcard in the -first pathname is matching. The third example changes the -names of files beginning with "letter" to begin with "ltr." +Changes the name of a file, directory, or volume. Wildcards +are allowed, as in the third example. A wildcard in the +second pathname expands to the same text the wildcard in the +first pathname is matching. The third example changes the +names of files beginning with "letter" to begin with "ltr." instead. -If you change the name of an AppleWorks file (filetypes AWP, -ADB, and ASP) from Davex, you may find the capitalization to -be strange. This is because AppleWorks stores the -capitalization information in the file's Auxiliary type, -which is not affected by this command. Use Apple-N while +If you change the name of an AppleWorks file (filetypes AWP, +ADB, and ASP) from Davex, you may find the capitalization to +be strange. This is because AppleWorks stores the +capitalization information in the file's Auxiliary type, +which is not affected by this command. Use Apple-N while editing the file in Appleworks to fix the capitalization. diff --git a/doc/help/Rep b/doc/help/Rep index 9f79ec5..24d2ccd 100644 --- a/doc/help/Rep +++ b/doc/help/Rep @@ -6,11 +6,11 @@ syntax: rep ex: rep 10;echo "Ten!" como &;rep 5;type handout= -p -Executes the next command the specified number of times. -'rep 0' has no effect, and the largest number 'rep' accepts +Executes the next command the specified number of times. +'rep 0' has no effect, and the largest number 'rep' accepts is 65535. 'rep' will not repeat another 'rep' command. -The second example prints 5 copies of all files beginning in -"handout" to the printer. All repetitions are executed for -each file matching the wildcard before Davex looks for +The second example prints 5 copies of all files beginning in +"handout" to the printer. All repetitions are executed for +each file matching the wildcard before Davex looks for another wildcard match. diff --git a/doc/help/Scan b/doc/help/Scan index b46fabf..e8eeb8f 100644 --- a/doc/help/Scan +++ b/doc/help/Scan @@ -11,7 +11,7 @@ ex: scan scan -a .62utils scan -r /hard2/sys/ -With no options, prints the list of directories Davex scans when +With no options, prints the list of directories Davex scans when you type something that isn't an internal command. Use the -a and -r options to add or remove a paths from the list. diff --git a/doc/help/Size b/doc/help/Size index 686eda4..0ec45c9 100644 --- a/doc/help/Size +++ b/doc/help/Size @@ -7,21 +7,21 @@ ex: size this size =:sys size .61=:dir -For a non-directory file, prints file size in blocks and in -bytes. For a directory, compute and print the sum of the -sizes of all the files and directories within the directory. +For a non-directory file, prints file size in blocks and in +bytes. For a directory, compute and print the sum of the +sizes of all the files and directories within the directory. Wildcards are allowed. -The total size in BYTES of a directory is often MUCH smaller -than 512 times its size in BLOCKS, even though all blocks -are 512 bytes long. This is because not all the bytes of a -file's last block are used. As an extreme example, a -directory containing 12 files of one byte each would have a -size of 13 blocks (1 for the directory and 1 each for the -files), but only 524 bytes (512 for the directory block and +The total size in BYTES of a directory is often MUCH smaller +than 512 times its size in BLOCKS, even though all blocks +are 512 bytes long. This is because not all the bytes of a +file's last block are used. As an extreme example, a +directory containing 12 files of one byte each would have a +size of 13 blocks (1 for the directory and 1 each for the +files), but only 524 bytes (512 for the directory block and 1 each for the files). -(Note that the size reported for a volume directory includes -actual directory blocks but omits the 2 boot blocks and the -bitmap block(s). There is one bitmap block for every 4096 +(Note that the size reported for a volume directory includes +actual directory blocks but omits the 2 boot blocks and the +bitmap block(s). There is one bitmap block for every 4096 blocks on the volume.) diff --git a/doc/help/Split b/doc/help/Split index b17d267..90554dc 100644 --- a/doc/help/Split +++ b/doc/help/Split @@ -9,7 +9,7 @@ syntax: split [] [-s] ex: split infile outfile -s0 -e1023 split infile -s50 -e100 -bn split file1 -s50 -l100 -bn -m60 - + 'Split' splits off a section of the input file into the output file. If the output file is not specified, output goes to the screen. The input file is never modified. Wildcards are supported. diff --git a/doc/help/Spool b/doc/help/Spool index f7e8257..827a5b7 100644 --- a/doc/help/Spool +++ b/doc/help/Spool @@ -8,14 +8,14 @@ ex: spool ?:txt spool -z spool -x3 -Queues files for background printing. Wildcards are allowed. You -must remain in Davex until the printing completes, and you may not -redirect output to the printer (see 'como'), since that would make a +Queues files for background printing. Wildcards are allowed. You +must remain in Davex until the printing completes, and you may not +redirect output to the printer (see 'como'), since that would make a mess. Use the 'config' command to set the slot 'spool' will print to. -'spool -z' Zaps the spool queue (cancels printing of all spooled +'spool -z' Zaps the spool queue (cancels printing of all spooled files) and formfeeds the printer. 'spool' shows a numbered list of files waiting to print. @@ -23,21 +23,21 @@ Use the 'config' command to set the slot 'spool' will print to. 'spool -x' cancels one file in the queue by number. -NOTE: The text of spooled files is sent directly to the printer. - This is fine for TXT files (and SRC files, and possibly some - other filetypes). It is NOT fine for AWP files (try it if you +NOTE: The text of spooled files is sent directly to the printer. + This is fine for TXT files (and SRC files, and possibly some + other filetypes). It is NOT fine for AWP files (try it if you want...it's sort of entertaining). - A future Davex version will probably support spooling AWP - files. For now, create a temporary file, 'pg' the AWP file + A future Davex version will probably support spooling AWP + files. For now, create a temporary file, 'pg' the AWP file into it, and spool the temporary file. Example: como temp;pg my.awp.file spool temp -Spool does not work well with speech synthesizers; Davex does not have -control while the system is waiting for keyboard input. Speech -synthesizer users can use the 'wait' command to let spooled files +Spool does not work well with speech synthesizers; Davex does not have +control while the system is waiting for keyboard input. Speech +synthesizer users can use the 'wait' command to let spooled files print. (SPOOL stands for Simultaneous Peripheral Operation On-Line.) diff --git a/doc/help/SysAlias b/doc/help/SysAlias index 7263345..a16704e 100644 --- a/doc/help/SysAlias +++ b/doc/help/SysAlias @@ -11,15 +11,15 @@ ex: sysalias /disk/davex/davex.system /disk/dvx.system sysalias /disk1/basic.system basic -s /disk1/tons.o.fun sysalias /awgs.program/appleworks.gs awgs -s /ss/my.budget -Creates a one-block program file (name = alias_to_create) which -runs a given SYS or S16 file (name = existing_program). Wildcards are -allowed. This allows program files to appear to be in more than one +Creates a one-block program file (name = alias_to_create) which +runs a given SYS or S16 file (name = existing_program). Wildcards are +allowed. This allows program files to appear to be in more than one place at a time without taking up much extra disk space. (S16 files are useful only on the Apple IIgs.) -In most cases, you will want to specify a complete pathname for -. If you specify a partial pathname, the -one-block SYS or S16 file created may or may not be able to find the +In most cases, you will want to specify a complete pathname for +. If you specify a partial pathname, the +one-block SYS or S16 file created may or may not be able to find the program it's looking for, depending on the prefix at run time. If you use -p, the file created will set the prefix as specified before diff --git a/doc/help/TR b/doc/help/TR index 16df84e..72b3f54 100644 --- a/doc/help/TR +++ b/doc/help/TR @@ -9,7 +9,7 @@ syntax: tr [] -s ex: tr infile outfile -s^j tr infile temp -s^m -r^m^j -fd tr infile -s" " -r"" -m60 - + 'Tr' looks for every occurrence of the in the input file and replaces it with the . The translated data is saved to the output file. If the is not specified, @@ -32,7 +32,7 @@ With these options, it is possible to specify any byte from 0 to 255. Here are some examples: - "^j^m" - "ctrl-j ctrl-m" (case for control characters is ignored) + "^j^m" - "ctrl-j ctrl-m" (case for control characters is ignored) "~A~B~C" - "ABC" with hi-bits on. "AbC" - "AbC" with hi-bits off. "~^m^~m" - "ctrl-m ctrl-m" with hi-bits on. diff --git a/doc/help/Tail b/doc/help/Tail index 97515f9..fe27131 100644 --- a/doc/help/Tail +++ b/doc/help/Tail @@ -13,16 +13,16 @@ beginning part to scroll by on the screen. This command is useful for quickly displaying the ending of any file that is very long. Wildcards are supported. -Options are as follows: +Options are as follows: -l: number of lines to print. This defaults to 5 lines. You can specify 'tail' to print any number of lines from 1 to 255 off the end of a file. A 0 value has the same effect as not using the option. - -w: wrap margin. Use this option to force the number of lines to + -w: wrap margin. Use this option to force the number of lines to increment at either a specific margin or a space within 9 characters - of the margin. This option is good for files that use a carriage + of the margin. This option is good for files that use a carriage return to specify paragraphs instead of lines. Allowed values are 0 through 255. A 0 value has the same effect as not using the option. The default wrap margin is set to 79. diff --git a/doc/help/Top b/doc/help/Top index a5cc4b7..06d99c8 100644 --- a/doc/help/Top +++ b/doc/help/Top @@ -5,7 +5,7 @@ syntax: top ex: top -'top' performs 0 or more 'up' commands until the prefix is a +'top' performs 0 or more 'up' commands until the prefix is a volume name (or until the prefix is null). (see also: prefix, up, over, origin) diff --git a/doc/help/Topics b/doc/help/Topics index 228a9a3..7c5b142 100644 --- a/doc/help/Topics +++ b/doc/help/Topics @@ -46,7 +46,7 @@ Apple IIgs only: conp gsbuff printers: - pset iw2 spool wait + pset iw2 spool wait mx80 fp como/> cls/home Use 'config' to find out what directory contains your help files. diff --git a/doc/help/Touch b/doc/help/Touch index c62c5ac..ed62d84 100644 --- a/doc/help/Touch +++ b/doc/help/Touch @@ -13,7 +13,7 @@ ex: touch myfile current date and time without actually modifying the file's contents. Wildcards are allowed. -This is intended for use with recently-created files that, for some +This is intended for use with recently-created files that, for some reason, are not properly date- and time-stamped. (Some DOS 3.3-to- ProDOS conversion programs, for example, stamp files with an invalid date and time.) diff --git a/doc/help/Type b/doc/help/Type index 32c9932..911654a 100644 --- a/doc/help/Type +++ b/doc/help/Type @@ -7,25 +7,25 @@ ex: type this type ?:txt -h como that;type this -l -Types contents of a file (any type, not just TXT). Wildcards are -allowed. -h generates a header giving the date/time the file was last -modified. -f disables filtering of control characters; normally they +Types contents of a file (any type, not just TXT). Wildcards are +allowed. -h generates a header giving the date/time the file was last +modified. -f disables filtering of control characters; normally they are filtered out. --u and -l force alphabetic characters to display as uppercase or +-u and -l force alphabetic characters to display as uppercase or lowercase, respectively. --p begins a new page after the file is printed (useful when +-p begins a new page after the file is printed (useful when redirecting to printer) -t lets you specify a string to print in place of each TAB character (Ctrl-I). You may want to make an alias for 'type' with a tab string. -Note: many file types do not contain plain ASCII text. This command - knows how to interpret AWP files, but simply displays all other - files byte-for-byte. If you pg a SYS file, for example, you - will get a lot of garbage and a (probably) few readable +Note: many file types do not contain plain ASCII text. This command + knows how to interpret AWP files, but simply displays all other + files byte-for-byte. If you pg a SYS file, for example, you + will get a lot of garbage and a (probably) few readable messages. (see also: pg, como, strings, alias) diff --git a/doc/help/Unlock b/doc/help/Unlock index ab1da77..acfd587 100644 --- a/doc/help/Unlock +++ b/doc/help/Unlock @@ -6,7 +6,7 @@ syntax: unlock ex: unlock this unlock =:txt -Allows read, write, rename, and delete for file. Wildcards +Allows read, write, rename, and delete for file. Wildcards are allowed. (see also: lock, prot) diff --git a/doc/help/Up b/doc/help/Up index fd01bfc..9100abe 100644 --- a/doc/help/Up +++ b/doc/help/Up @@ -5,8 +5,8 @@ syntax: up ex: up -Removes one segment from the end of the prefix. If the -prefix is a volume directory, 'up' makes the prefix null. +Removes one segment from the end of the prefix. If the +prefix is a volume directory, 'up' makes the prefix null. If the prefix is already null, up has no effect. (see also: over, prefix, origin, top) diff --git a/doc/help/Update b/doc/help/Update index d594212..47d7998 100644 --- a/doc/help/Update +++ b/doc/help/Update @@ -7,9 +7,9 @@ ex: update %help /otherdisk/davex/help -f update /work /backup update /that/? /there/? -'update' takes two pathnames (original path first, target -path second) and updates old files, reporting on its -progress as it goes. If the pathnames are DIRECTORIES, +'update' takes two pathnames (original path first, target +path second) and updates old files, reporting on its +progress as it goes. If the pathnames are DIRECTORIES, update descends into them and updates corresponding files. [Note: If one of the pathnames refers to a directory, the @@ -18,9 +18,9 @@ other one should, too. A command like "update /disk1/dir1/? messages. So use a wildcard on both pathnames or don't use one at all.] -For files, here's what happens. If the target file does not -exist, update asks for permission to create it. If the target -file does exist, three conditions are possible. If the +For files, here's what happens. If the target file does not +exist, update asks for permission to create it. If the target +file does exist, three conditions are possible. If the modification dates and times match exactly, you see "current" and 'update' takes no further action on that pair of files. If the target file is older, you see "outdated" and are asked @@ -28,8 +28,8 @@ for permission to replace the old file. If the target file is NEWER, you get a warning message and update takes no further action on that pair of files. --f (force) bypasses the "Okay to replace" question, just -like for the copy command. (In fact, update USES the copy +-f (force) bypasses the "Okay to replace" question, just +like for the copy command. (In fact, update USES the copy command.) -f also bypasses the "Okay to create new file" questions. diff --git a/doc/help/ViewDHR b/doc/help/ViewDHR index 4a74f61..ebf6fdc 100644 --- a/doc/help/ViewDHR +++ b/doc/help/ViewDHR @@ -1,7 +1,7 @@ viewdhr -- view a double hi-res picture (EXTERNAL) [v1.1] Written by Jeff Ding -syntax: viewdhr [-f] [-r] +syntax: viewdhr [-f] [-r] ex: viewdhr /picture.disk/pic.1 viewdhr /picture.disk/pic.1 -f @@ -11,7 +11,7 @@ ex: viewdhr /picture.disk/pic.1 the Davex command shell. Wildcards are accepted in the pathname.Once the picture is displayed, any key will exit. Ctrl-C will abort wildcard expansions. 'viewdhr' will not work on a II+ or 64k //e because they do -not have the auxiliary memory needed to display double hi-res pictures. +not have the auxiliary memory needed to display double hi-res pictures. This program will work on a //c, //e compatible with an extended 80 column card, and the //gs. diff --git a/doc/help/ViewHR b/doc/help/ViewHR index e39d308..4a80265 100644 --- a/doc/help/ViewHR +++ b/doc/help/ViewHR @@ -1,7 +1,7 @@ viewhr -- view a hi-res picture (EXTERNAL) [v1.1] Written by Jeff Ding -syntax: viewhr +syntax: viewhr ex: viewhr /picture.disk/pic.1 viewhr /picture.disk/pic= diff --git a/doc/help/WC b/doc/help/WC index 0cf9f6b..3d2de52 100644 --- a/doc/help/WC +++ b/doc/help/WC @@ -14,7 +14,7 @@ the given file. The file type is not checked so any file of any type can be given on the command line. Up to five file names can be given on the command line at any one time. AppleWorks word processor files are supported. The standard delimiter between two words is a space. The -standard end of line delimiter is a carriage return. +standard end of line delimiter is a carriage return. If more than one file is given on the command line, 'wc' version 2.0 will print the grand total of characters, words, and lines. If wildcards are @@ -22,7 +22,7 @@ used, the grand total will be printed after every file matching the wildcard starting with the second file. Printing of the grand total is also subject to the -c,-w, and -l options. -Options are as follows: +Options are as follows: -c: print character count. -w: print word count. @@ -36,12 +36,12 @@ Options are as follows: -e: delimiter between words. Enter the ascii value of the character after the -e. - -m: wrap margin. Use this option to force the number of lines to + -m: wrap margin. Use this option to force the number of lines to increment at either a specific margin or a space within 9 characters - of the margin. This option is good for files that use a carriage + of the margin. This option is good for files that use a carriage return to specify paragraphs instead of lines. Allowed values are 0 through 255. A 0 value has the same effect as not using the option. - + Note: You can mix the -c, -w, -l options in different combinations. The hi-bit of each character in the file is ignored. diff --git a/doc/help/Wait b/doc/help/Wait index bc1fe54..4e851f6 100644 --- a/doc/help/Wait +++ b/doc/help/Wait @@ -5,10 +5,10 @@ syntax: wait ex: wait;ej;park -'wait' simply sits there and does nothing until files -spooled with the 'spool' command are done printing. Press +'wait' simply sits there and does nothing until files +spooled with the 'spool' command are done printing. Press any key to abort the wait and return to the command prompt. -(The example assumes that 'park' is available as a SYS or -S16 file or external Davex command; it would presumably park +(The example assumes that 'park' is available as a SYS or +S16 file or external Davex command; it would presumably park the heads on your hard drive.) diff --git a/doc/help/What b/doc/help/What index 201ab33..989f794 100644 --- a/doc/help/What +++ b/doc/help/What @@ -13,7 +13,7 @@ ex: what thatfile 512 bytes and prints whatever interesting information it can about the file. -Wildcards are allowed. Output is, at minimum, the file's +Wildcards are allowed. Output is, at minimum, the file's type and name. For many filetypes, additional information appears. diff --git a/doc/help/como b/doc/help/como index e4f5ec4..bc7b5f9 100644 --- a/doc/help/como +++ b/doc/help/como @@ -7,17 +7,17 @@ ex: como listing;type =:txt -h como &;cat -t como 2;type davex.doc -For commands on the same line only, redirects output that would +For commands on the same line only, redirects output that would normally appear on the screen. If the specified file exists, output will be appended to it. If it does not exist, it will be created as a TXT file. -Output can be redirected to a device by slot number, as in the +Output can be redirected to a device by slot number, as in the third example. '&' (or '0') represents the printer slot set by 'config'. -Even while spooled files are printing, you can redirect output +Even while spooled files are printing, you can redirect output to a slot. (Not to the SAME slot 'spool' is printing to.) Note: If no pathname is specified, output redirection is @@ -30,7 +30,7 @@ you can do things like print help (same as "como &;help") - print;pg foo (same as "como &;;pg foo" + print;pg foo (same as "como &;;pg foo" [extra ";" doesn't matter]) (see also: exec, config)