home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / new / util / cli / dirking / firststeps.doc (.png) < prev    next >
ANSI Art File  |  1994-02-17  |  11KB  |  640x5120
Labels: text | screenshot | font | black and white
OCR: < < <<< DirKING v3.00 >>> > > FIRST STEPS - Release : 16-Feb-94 Copyright -1990-1994 Chris P. Vandierendonck, [AmiSYS]. Preface DirKING is a feature packed directory list program, which over laps the AmigaDOS commands List, Dir and Info. It has all the features of the AmigaDOS commands, but also includes many enhancements. The program supports different filters for reading a directory, allows complex sorting and gives full control on the listing format. irKING is reentrant it can be made resident System Requirements DirKING requires AmigaDOS v1.2 or higher. DirKING fully supports all AmigaDOS v2.x and v3.x innovations. Shareware Registration See "Registration. doc" DirKING usage To get the usage prompt type 'dirking ?', something like the following will appear : Usage: [PATH] [[FID]<path|p>] [QUICK] [ALL] [TOLEVEL <#>] [DIRS] [FILES] [HUNT [FID] <pattern> ] Filters: [READ [FID]<pattern> ] [PASS [FID]<pattern>] [SUB [FID]<string>] [SINCE "[FID]<[DOSdate] [time]>"] [UPTO "[FID]<[DOSdate] [time]>"] [FROMTO [FID]<ch><ch>] [DATATYPE <pattern> ] [FLAGS [FID]<flags>] [COMMENT [FID] <pattern> ] Info: [INCL {nkribladtsocpfhuwyg jnex} ] [EXCL {nkribladtsocpfhywyg jmex} ] [DIRINFO [BASE]] [DISKUSE] [LISTLEVELS <#>] [LOCVALS] [HEXVAL] [DATES] [BINFLAGS ] Sorting: [FDIDFIMIX] [SORT {nkribladtcygme} ] [NOSORT] [DESC] System: [NOREQ] [ASSLATE] [LINKDIRS] [DISKINFO] [FULLPATH] [MULTI] [NOENV] Listing: [HEAD {fdupimtse}] [MAXHEAD] [BARELIST] [NOHEAD] Listin [NOSTAT] [EOD] [NEWPAGE [[{cmhte} ]<#>]] [DISKID <string>] [EXPAND] [MAXWIDTH <#>] DirKING v3.00 First Steps - Page 1 Output : [PRISTYLE {rdlbpes} ] [ Format: [LISTF <0 .. 4>] [SFORMAT <fmt>] [LISTORD <fmt>] [DATEF <0 .. 7>] [DFORMAT <fmt>] [TABLEFMT <fmt>] [TIMEF <0. . 3>] [TFORMAT <fmt>] [EXEC <file> ] [LFORMAT [<fmtstr>]] Don't be put off by the number of available options. Most of them won't be used for general purpose usage. The purpose of this document is to outline the very basic functions of DirKING. The advantage of DirKING is its compatibility with the AmigaDOS command 'List' . If you can use 'List', then you won't have any problems with DirKING. DirKING functions Here's a simple output of DirKING (default) output: Directory of "RAM:" on Tu_15-Feb-94 at 21:02:12. F ile N Dirs Files Blocks Bytes Flags Date Time Disk. info 1 860 f ----- rw-d Today 12:35:29 file 1 418 f ----- rwed Today 18:14:39 filea 1 860 fH ---- rw-d Today 12:35:29 CLIPS 0 d ----- rwed Today 12:35:19 ENU 0 d ----- rwed Today 18:13:37 T 0 d ----- rwed Today 20:16:31 3 Files - 3 Dirs - 1 Links - 3 Blocks - 2138 Bytes (0 bytes free) As you can see, more information is given than the 'List' command, and even with more style. Now let's start reviewing a few of the basic functions that most of these functions are far more powerful than described here!) : <path> The path is the name of a directory or a file you information about. Patterns may be used to only list cer files or directories. ALL By default, DirKING will only show the files and sub-dirs found in the scanned directory. If you also want to view the sub-dirs of the sub-dirs, etc .., then you must use this ALL option. 11 TOLEVEL <#> Has the same function as ALL, but here you can specify how many levels down DirKING may descend. E.g. 'TOLEVEL 1' will only read as far as sub-dirs of sub-dirs of the scanned directory DirKING v3.00 First Steps - Page 2 il TO <file> Instead of showing the directory in the Shell window, save it to file 1 PRT Output the listing to the printer, instead of the Shell window. 11 FILES List files only. 11 DIRS List directories only. 1 READ <pattern> Define which files and dirs you want to view, by giving appropriate namepattern. 11 PASS <pattern> Define which files and dirs you don't want to view, by giving appropriate namepattern. 11 SUB <string> Define which string the file- and dirname must contain in ord to be included in the listing. 1 SINCE <date> Only list files and dirs which were created or modified on or after the given date. The date must be given in the "dd-mmm-yy' format or by a dayname such as 'yesterday', 'monday' , . UPTO <date> Only list files and dirs which were created or modified before or on the given data. The format is the same as with SINCE. INCL {nkribladtsocpfhuwyg.jmex} Specify which fields you want to see by stating their appropriate code: N : list file/dir-nane K : list diskkey R : number of sub-dirs in a dir (prints '-' with files) I : number of files in a dir (prints '-' with files) B : blocks used by a file (prints 'Dir' with dirs) L : bytes used by a file (prints 'Dir' with dirs) A : list file/dir attributes (protectionflags) The first flag reflects if it's a file ('f') or a dir ('d' ). The second flag reflects if it's a hardlink ('H' ), a softlink ('S' ) or a pipe ('P' ), or nothing of the above ('-'). The rest are the usual protection flags. DirKING v3.00 First Steps - P - D : list file/dir datestamp T : list file/dir timestamp - S : file/dir DOS datestamp (days, mins, ticks) 0 : show comment, or empty string when none is present (this comment is shown in its own column in the listing table) - C : show comment if on is present (this comment is shown on a line of its own, thus not in the listing table) P : show the file/dir path relative to the scanned path - F : show the file/dir path, including the scanned path - H : show file and directory links - U : list datatype descriptor - W : list datatype basename - Y : list datatype type - G : list datatype group ID - J : list datatype ID - M : list naked file/dirname (without last extension) - E : list the last file/dirname extension Example: ' INCL nd' will only print the name and date fields. Example: ' INCL nblda' will list the name, the blocks and bytes used, the date and the protection flags. 7 QUICK Only list file and directory names. 11 DATES Forces DirKING to show the correct date, instead of the replacement names like 'today', 'yesterday', 'monday' , . . . 7 NOSORT Don't sort the listing. 11 DESC Sort the listing in a descending way. 1 FDIDF IMIX Use 'FD' to list files first, dirs last; 'DF' dirs first, files last; or 'MIX' to mix files and dirs. 1 MAXHEAD Show a listing head with extensive information on the scanned volume/disk. 11 BARELIST Only print the listing itself, no header or end statictics. 11 HEXVAL Show all values in hexadecimal format. DirKING v3.00 First Steps - Page 4 1 LFORMAT <formatstring> Works in the same way as with the 'List' command. So see your AmigaDOS manual for more information. It's important to note that DirKING supports more information items than the 'List' command. All substitution strings are the same, but for the extra supported items, use those names as listed with the INCL option. E.g. 'H' for links. 7 TEXT Puts the listing completely in text, thus emoving all other print styles. TRACE This exotic feature informs, while DirKING is scanning the directory, what files and dirs it has found yet, and what path is currently scanned. Try it and see what I mean. DirKING UserManual Now that you've tasted some of the basic functions of DirKING, check out the 'UserManual.doc' for a detailed description of all functions. DirKING has a lot more functions concerning the filtering of files and dirs, sorting, formatting, listing and so on ... Just have a look at the 'Features . doc'