home *** CD-ROM | disk | FTP | other *** search
/ SDN¹ Plus / SDN1_.cdr / sdn / lang / hacker12.sdn / HACKER.DOC < prev    next >
Text File  |  1980-01-02  |  40KB  |  1,116 lines
  2.  
  3.  
  4.                .    %*%*%*%*%*%*%*%*%*%*%*%*%*%*%**%*%*%     .
  5.                            %*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%%*%*%*%
  6.                           %*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%**%*%*%*%
  7.                          %*%*%* .                          . *%*%*%
  8.                         %*%*%*%          H A C K E R         %*%*%*%
  9.                        %*%*%*%*                              *%*%*%*%
  10.                         %*%*%*%            ver 1.2           %*%*%*% 
  11.                          %*%*%* .                          . *%*%*%
  12.                           %*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%**%*%*%*%
  13.                            %*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%%*%*%*%
  14.                        .    %*%*%*%*%*%*%*%*%*%*%*%*%*%*%**%*%*%     .
  15.  
  16.  
  17.  
  18.  
  19.                              H A C K E R   C O M P O N E N T S
  20.  
  21.                                          HACKER.com    
  22.                                          HACKER.doc 
  23.                                         HACKROUN.bat
  24.                                           READ.me
  25.  
  26.  
  27.  
  28.                               S H A R E W A R E   N O T I C E 
  29.  
  30.                 HACKER is distributed as shareware. You may make as many
  31.             copies as you please,  and give them to whomever you please, 
  32.             provided that all four files are included unmodified. 
  33.             However, YOU MAY NOT SELL HACKER, although you may charge a 
  34.             nominal fee for materials and handling.  Unregistered users 
  35.             are granted a limited license to use HACKER to evaluate its 
  36.             usefulness.  Unlicensed use is forbidden.
  37.  
  38.                 If you choose to use  HACKER,   you should register by 
  39.             completing the attached registration form and returning it 
  40.             with your registration fee of $20 to the author:
  41.  
  42.                                        Ted Wray
  43.                                        P.O. Box 344
  44.                                        Narberth, PA
  45.                                               19072-0344
  46.  
  47.                 Registered users are entitled to use  HACKER  in any way 
  48.             they  see fit,  including  incorporating it  into  their own 
  49.             products.  Registered users will receive advance  notice  of 
  50.             upgrades  and other products, whether released as  shareware 
  51.             or as commercial software.
  52.  
  53.  
  54.  
  55.  
  56.                                   D I S C L A I M E R
  57.  
  58.                 The author makes absolutely no warranty of any kind with 
  59.                 respect to this program.  You use this software entirely 
  60.                 at your own risk; the author shall not be liable for any 
  61.                 incidental  or consequential losses  or damages  arising 
  62.                 directly  or indirectly from the use or non-use  of this 
  63.                 program.   By using this program,  you agree to hold the 
  64.                 author blameless with regard to any such loss.
  65.              HACKER ver 1.2 documentation                           
  66.              Copyright (C) 1989 by Ted Wray      
  67.              All Rights Reserved
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                              T A B L E   O F   C O N T E N T S
  76.  
  77.  
  78.  
  79.  
  80.                          INTRODUCTION .........................  1
  81.                          HACKER functions .....................  2
  82.                              Ask ..............................  2
  83.                              Boot .............................  2
  84.                              Clear ............................  2
  85.                              Fix ..............................  3
  86.                              Fix Cursor........................  3
  87.                              Fix File..........................  3
  88.                              Help..............................  3
  89.                              Is ...............................  4
  90.                              Is Dir ...........................  4
  91.                              Is Volume ........................  4
  92.                              Note .............................  4
  93.                              Show .............................  5
  94.                              Show Cursor ......................  5
  95.                              Show Hidden ......................  5
  96.                              Sound ............................  6
  97.                              Wait .............................  6
  98.                              What .............................  7
  99.                              What Date ........................  7
  100.                              What Day .........................  7
  101.                              What Depth .......................  7
  102.                              What Drive .......................  7
  103.                              What Mode ........................  7
  104.                              What Time ........................  7
  105.                          Notes ................................  8
  106.                          Examples .............................  9
  107.                          Index ................................  11
  108.                          Acknowledgments ......................  12
  109.                          Revision History .....................  12
  110.                          Bug Report ...........................  13
  111.                          Registration Form.....................  14
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.              HACKER ver 1.2 documentation                
  133.              Copyright (C) 1989 by Ted Wray      
  134.                         All Rights Reserved      
  135.              HACKER ver 1.2 documentation                    page 1
  136.              Copyright (C) 1989 by Ted Wray      
  137.              All Rights Reserved
  138.  
  139.                                         INTRODUCTION
  140.  
  141.  
  142.                 HACKER is a multi-function utility for programmers.  It 
  143.             communicates with both the user and the system, and performs 
  144.             other useful tasks.  This documentation is intended to give 
  145.             the user an overview of HACKER and an off-line reference to 
  146.             supplement HACKER's extensive on-line help screens.  Examples 
  147.             of most HACKER functions are given by the demonstration 
  148.             program HACKROUN.bat.
  149.  
  150.                   Most HACKER functions are for use within batch files, 
  151.             but a few are more likely to be used at the command level; 
  152.             These are:
  153.                          ?        FIX       HELP        SHOW   
  154.  
  155.                 HELP and ? are distinct help functions, FIX changes the 
  156.             cursor and modifies files, and SHOW displays system 
  157.             information.  Other functions are:
  158.  
  159.                       ASK         CLEAR       NOTE        WAIT
  160.                       BOOT        IS          SOUND       WHAT
  161.                                                             
  162.                 HACKER processes one or more commands passed to it on 
  163.             the command line. Each command consists of a function and 
  164.             qualifiers if the following format:
  165.  
  166.                    HACKER  function  [object]  [parameters]  [/options]
  167.  
  168.                 HACKER returns information to a batch file through DOS's 
  169.             ERRORLEVEL, but note that HACKER reverses usual practice: 
  170.             Zero may indicate an error !
  171.  
  172.                 Separate commands are separated by semicolons. Hacker 
  173.             will accept as many commands as you can squeeze into DOS's 
  174.             127 character command line. The errorlevel returned is the 
  175.             errorlevel of the last function executed that sets the 
  176.             errorlevel.
  177.  
  178.                 The dual help functions HELP and ? describe the action 
  179.             and/or syntax of the specified function, or of HACKER itself 
  180.             if no function is specified. Compound functions require that 
  181.             an object be specified for a complete description.  
  182.             Specifying an object is always optional. Invalid functions 
  183.             and objects are ignored.
  184.  
  185.                        ?     tells what a function does.
  186.                       HELP   tells how to use a function.
  187.  
  188.                 Whenever possible the two help screens have been 
  189.             combined, so both HELP and ? produce the same screen.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.              HACKER ver 1.2 documentation                
  203.              Copyright (C) 1989 by Ted Wray      
  204.                         All Rights Reserved                  page 1
  205.              HACKER ver 1.2 documentation                    page 2
  206.              Copyright (C) 1989 by Ted Wray      
  207.              All Rights Reserved
  208.  
  209.                                       HACKER functions
  210.  
  211.                  ASK     [question] [{options}] [lines]  
  212.                          ErrorLevel is the ordinal of the response.
  213.  
  214.                 ASK displays a question for the operator upon the 
  215.             screen, beeps, awaits a response, then clears the question 
  216.             from the screen and, if LINES was specified, the preceding 
  217.             LINES rows as well. Finally, the question and response are 
  218.             displayed as standard output for use as a log entry.   All 
  219.             parameters are optional.  The default QUESTION is "Press any 
  220.             key..." and the default for LINES is zero. If no OPTIONS are 
  221.             specified, any keystroke will be accepted and the ERRORLEVEL 
  222.             will be zero. If OPTIONS are specified, the pressing of keys 
  223.             that are neither option keys nor break keys is ignored.
  224.  
  225.                 A zero ERRORLEVEL indicates that the user pressed BREAK, 
  226.             ESCAPE, or ^C. Otherwise, an ErrorLevel of  n  indicates 
  227.             that the  n th option was chosen.  Case is irrelevant.  
  228.             Options may be letters or numbers.  Punctuation (/-\,) and 
  229.             spaces are ignored.
  230.             ------------------------------------------------------------
  231.  
  232.  
  233.                 BOOT   [COLD]
  234.                        ErrorLevel does not exist !
  235.  
  236.                 BOOT causes the system to re-boot itself. Unless COLD is 
  237.             specified, a warm boot is always attempted, but if a TSR or 
  238.             some other evil software has violated DOS for its own 
  239.             lustful purposes, the boot will be cold (i.e.: a hardware 
  240.             reset as opposed to a software reset).
  241.  
  242.                BOOT is useful for changing CONFIG, installing or 
  243.             removing VDISK, purging TSR's, et c.
  244.             ------------------------------------------------------------
  245.  
  246.  
  247.                 CLEAR    [lines] 
  248.                          ErrorLevel is not changed.
  249.  
  250.                 CLEAR moves the cursor up LINES rows, erasing the 
  251.             contents of each row crossed.  If Lines is not specified, 
  252.             the default of two lines is assumed.  A negative value for 
  253.             lines causes clearing to procede downward.
  254.  
  255.                 CLEAR erases unneeded output from the display without 
  256.             disturbing more meaningful output;  it also provides an 
  257.             alternative to the standard ECHO OFF / CLS sequence, in 
  258.             which case the default is just dandy, thank you.  With 
  259.             CLEAR, it is no longer necessary to explain that ECHO OFF    
  260.             is not a cybernetic expletive.
  261.             ----------------------------------------------------------
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.              HACKER ver 1.2 documentation                
  273.              Copyright (C) 1989 by Ted Wray      
  274.                         All Rights Reserved                  page 2
  275.              HACKER ver 1.2 documentation                    page 3
  276.              Copyright (C) 1989 by Ted Wray      
  277.              All Rights Reserved
  278.  
  279.                                       HACKER functions       (continued)
  280.  
  281.                 FIX is a compound function that takes the following objects:
  282.                                 CURSOR      changes the cursor definition.
  283.                                 FILE        transforms files.
  284.  
  285.                 FIX CURSOR  [start [stop]] [/ ON | OFF ]
  286.                             ErrorLevel is the former definition.
  287.                             FIX CURSOR and SHOW CURSOR are identical.
  288.  
  289.                 The cursor consists of several horizontal scan lines in 
  290.             a vertical stack, some of which are illuminated. These scan 
  291.             lines are numbered from zero at the top of the character box 
  292.             to the bottom, which is seven on a CGA and thirteen on MDA, 
  293.             EGA, VGA etc.  The return code is (16 * Top) + Bottom. 
  294.  
  295.                 Because some systems do not initialize the BIOS cursor 
  296.             definition, it is possible that an incorrect definition will 
  297.             be reported prior to the first cursor modification.
  298.  
  299.  
  300.                 FIX FILE   [d:] [path] [name] / option
  301.                            ErrorLevel is the number of files fixed.
  302.  
  303.                 The specified files are transformed according to the 
  304.             rule specified by the option(s), at least one of which is 
  305.             REQUIRED. Wild-cards are permitted in file names. The 
  306.             options are:
  307.                      
  308.                     ADD LFS    guarantees that each CR is followed by LF
  309.                     ALL        causes SOFTEN CR to soften all CR's. ALL 
  310.                                is a modifier that does nothing by itself.    
  311.                     SOFTEN CR  for word processing.  Makes CR's within 
  312.                                paragraphs "soft": not paragraph enders.
  313.             -------------------------------------------------------------
  314.  
  315.  
  316.  
  317.                  HELP    [ function  [ object ] ]   
  318.                          ErrorLevel is not changed.
  319.  
  320.                 The dual help functions HELP and ? describes the action 
  321.             and/or syntax of the specified function, or of HACKER itself 
  322.             if no function is specified.  Compound functions require that 
  323.             an object be specified for a complete description.  Specifying 
  324.             an object is always optional. Invalid functions and objects 
  325.             are ignored.
  326.  
  327.                        ?     tells what a function does.
  328.                       HELP   tells how to use a function.
  329.  
  330.                 Whenever possible the two help screens have been 
  331.             combined, so both HELP and ? produce the same screen.
  332.             ------------------------------------------------------
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.              HACKER ver 1.2 documentation                
  343.              Copyright (C) 1989 by Ted Wray      
  344.                         All Rights Reserved                  page 3
  345.              HACKER ver 1.2 documentation                    page 4
  346.              Copyright (C) 1989 by Ted Wray      
  347.              All Rights Reserved
  348.  
  349.                                       HACKER functions       (continued)
  350.  
  351.  
  352.                 IS   object  names    
  353.                      ErrorLevel is bitwise boolean.
  354.  
  355.                 A compound function that takes the following objects:
  356.  
  357.                                 DIR         identifies current directory.
  358.                                 VOLUME      identifies volumes mounted.
  359.  
  360.                 The LAST name sets the low order bit; each higher order 
  361.             bit is set by each of the names progressing toward the LEFT.
  362.  
  363.                 IS DIR   name  [, name [,...]]    
  364.  
  365.                 Bit is set to one if the corresponding NAME matches the 
  366.             current directory.  Up to eight directory names may be 
  367.             specified.  A match is determined by comparing NAME to the 
  368.             rightmost characters of the current directory. Thus OS would 
  369.             match DOS, THAMOS, ROLOS and \X\Y\Z\Mx\LAOS.
  370.  
  371.                 IS VOLUME   [d:][label] [d2:][label2] ...
  372.  
  373.                 Checks the volume label on selected drive(s) and sets 
  374.             the error level bit by bit to one if the volume is mounted, 
  375.             zero otherwise.  Up to eight labels may be checked at once. 
  376.             Wild-cards are permitted in labels.  No specified label 
  377.             matches an unlabeled volume. At least one label is always 
  378.             checked, so if no parameter is specified, the current device 
  379.             is checked for a volume label.
  380.             ------------------------------------------------------------
  381.  
  382.  
  383.  
  384.  
  385.                 NOTE     [message]     
  386.                          ErrorLevel is not changed.
  387.  
  388.                 Note beeps and displays a high visibility message upon 
  389.             the screen to facilitate distant monitoring of progress.
  390.             ------------------------------------------------------------
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.              HACKER ver 1.2 documentation                
  413.              Copyright (C) 1989 by Ted Wray      
  414.                         All Rights Reserved                  page 4
  415.              HACKER ver 1.2 documentation                    page 5
  416.              Copyright (C) 1989 by Ted Wray      
  417.              All Rights Reserved
  418.  
  419.                                       HACKER functions       (continued)
  420.  
  421.  
  422.                 SHOW 
  423.                 A compound function that takes the following objects:
  424.  
  425.                                        CURSOR
  426.                                        HIDDEN
  427.  
  428.                 SHOW CURSOR  [start [stop]] [/ ON | OFF ]
  429.                              ErrorLevel is the former definition.
  430.                              FIX CURSOR and SHOW CURSOR are identical.
  431.  
  432.                 The cursor consists of several horizontal scan lines in 
  433.             a vertical stack, some of which are illuminated. These scan 
  434.             lines are numbered from zero at the top of the character box 
  435.             to the bottom, which is seven on a CGA and thirteen on MDA, 
  436.             EGA, VGA etc.  The return code is (16 * Top) + Bottom.
  437.  
  438.                 Because some systems do not initialize the BIOS cursor 
  439.             definition, it is possible that an incorrect definition will 
  440.             be reported prior to the first cursor modification.
  441.  
  442.  
  443.                 SHOW HIDDEN  [d:] [path]
  444.                          ErrorLevel is the number of files hidden found.
  445.  
  446.                 Displays the names of all hidden files or directories in 
  447.             or within the specified drive and directory.  Defaults are 
  448.             the current drive and ROOT directory. . and .. may be used.
  449.  
  450.             CAUTION:  Tampering with hidden files may be hazardous to 
  451.             your box. However, if you use any MS editor, you may have 
  452.             one or more hidden sub-directories named DELETED which 
  453.             contain files consuming most of your capacity.  These 
  454.             directories may be purged normally.
  455.             ------------------------------------------------------------
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.              HACKER ver 1.2 documentation                
  483.              Copyright (C) 1989 by Ted Wray      
  484.                         All Rights Reserved                  page 5
  485.              HACKER ver 1.2 documentation                    page 6
  486.              Copyright (C) 1989 by Ted Wray      
  487.              All Rights Reserved
  488.                 SOUND   object  [/CONTINUE]       
  489.                          ErrorLevel is zero unless a key was pressed.
  490.  
  491.                 SOUND is a compound function that takes the following objects:
  492.  
  493.                     ALSO    BRINDI  DALILA  DREAM   GATE    LIBERA  RIDE                
  494.                     ALARM   CELESTE DIVE    FLUTE   GIFTS   PIPE    RUFFLE              
  495.                     BENVEN  CHARGE  DONNA   FUR     HORN    RAYS    SIREN               
  496.  
  497.             and makes the sound of the specified OBJECT.  If CONTINUE
  498.             is specified, the sound continues until a key is pressed. 
  499.             Otherwise, the sound stops after one recitation or when a 
  500.             key is pressed.  The sounds vary widely in duration and 
  501.             complexity.
  502.  
  503.                 SOUND might be used to indicate completion of a long 
  504.             task, particularly when a screen blanker is in use. It can 
  505.             also be used to produce audible progress reports.
  506.  
  507.                  CAUTION:  Excessive use of this function may engender 
  508.                            violent hostility among irritated coworkers.
  509.             -------------------------------------------------------------
  510.  
  511.  
  512.                 WAIT  seconds  
  513.                       ErrorLevel is seconds NOT completed.
  514.  
  515.                 Waits SECONDS seconds for a key to be pressed. Useful 
  516.             for displaying operator instructions without risk of stop-
  517.             ping when run unattended.  Also allows break points that 
  518.             permit operator to stop or continue, with a default choice.
  519.             ------------------------------------------------------------
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.              HACKER ver 1.2 documentation                
  553.              Copyright (C) 1989 by Ted Wray      
  554.                         All Rights Reserved                  page 6
  555.              HACKER ver 1.2 documentation                    page 7
  556.              Copyright (C) 1989 by Ted Wray      
  557.              All Rights Reserved
  558.  
  559.                                       HACKER functions       (continued)
  560.  
  561.  
  562.                 WHAT
  563.                 A compound function that takes the following objects:
  564.  
  565.                                 DATE        DEPTH       MODE
  566.                                 DAY         DRIVE       TIME
  567.  
  568.  
  569.                 WHAT DATE       ErrorLevel is day of the month.
  570.  
  571.  
  572.                 WHAT DAY        ErrorLevel is day of the week.
  573.  
  574.                             0 = Sunday,         2 = Tuesday,        5 = Friday
  575.                             1 = Monday,         3 = Wednesday,      6 = Saturday
  576.                                                 4 = Thursday
  577.  
  578.  
  579.                 WHAT DEPTH      ErrorLevel is directory depth.
  580.  
  581.                     The depth of the current directory in the tree structure.
  582.                     That is, in other words, the number of directories that
  583.                     contain the current directory, either directly or
  584.                     indirectly.  The root directory returns zero, primary
  585.                     sub-directories return one, and so forth.
  586.  
  587.  
  588.                 WHAT DRIVE      ErrorLevel is   default drive.
  589.  
  590.                         1 for A:    4 for D:    7 for G:    10 for J:
  591.                         2 for B:    5 for E:    8 for H:    11 for K:
  592.                         3 for C:    6 for F:    9 for I:    12 for L:  
  593.  
  594.  
  595.                 WHAT  MODE       ErrorLevel is video mode.
  596.  
  597.                                 0, 1, 2, 3      CGA text
  598.                                 4, 5, 6         CGA graphics
  599.                                 7               Monochrome
  600.                                 8, & above      EGA / VGA
  601.  
  602.  
  603.                 WHAT TIME        24 hour time of day.
  604.  
  605.                         The return code is ten times the hour
  606.                         plus completed ten minute intervals.
  607.  
  608.                         e.g.:   131 is returned at 1:12 p.m.
  609.                 -------------------------------------------------------
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.              HACKER ver 1.2 documentation                
  623.              Copyright (C) 1989 by Ted Wray      
  624.                         All Rights Reserved                  page 7
  625.              HACKER ver 1.2 documentation                    page 8
  626.              Copyright (C) 1989 by Ted Wray      
  627.              All Rights Reserved
  628.  
  629.                                            NOTES
  630.  
  631.                 The ENVIRONMENT.  The DOS batch processor interprets any 
  632.             string bracketed with percent signs as an environment 
  633.             variable and replaces it with the value of that variable. 
  634.             HACKROUN uses this uses this property to effect local 
  635.             variables.  However, it is easy to run OUT OF STRING SPACE ! 
  636.             Therefor, it is strongly recommended that unneeded 
  637.             environment strings be cleared as soon as possible.  To use 
  638.             software that examines the environment, you may wish to 
  639.             create a batch file that sets the requisite environment 
  640.             strings, runs the program and then clears the strings.  The 
  641.             same applies to paths.  Some people put a statement in their 
  642.             autoexec files that sets a path to every directory;  Not 
  643.             only does this consume a considerable piece of the 
  644.             environment, it also can cause confusion when different 
  645.             files have the same name.  Usually a path is unnecessary.  A 
  646.             better approach is to set and clear paths with a 
  647.             batch file, as before,
  648.  
  649.                 BEEP.  Hacker includes no function or file to make a 
  650.             beep because you can do this already.  All that is necessary 
  651.             is to echo the beep character, ascii 7. (Many printers, also 
  652.             will beep rather than print this character.)  Your favorite 
  653.             editor probably has a way to enter special control 
  654.             characters such as the beep.  Many use this technique: enter 
  655.             7 (or 007) while holding the alt key.  Others recognize 
  656.             Cntrl-G as the beep. Most editors display the beep as either 
  657.             a small dot in the center of the character box, or as ^G.  A 
  658.             sample beep is included in HACKROUN, you can use that one, 
  659.             if you find that to be easier.  Also, see Special Characters 
  660.             below.
  661.  
  662.  
  663.                 A BLANK LINE can be ECHOed by placing an invisible, non-
  664.             blank character on the Echo line.  The two ideal candidates 
  665.             for this are Beep and Backspace.  BACKSPACE is ascii 8 or 
  666.             Cntrl-H.  Keep in mind that the BS must be entered the same 
  667.             way as the Beep, as described above; every decent text 
  668.             editor interprets a press of the Backspace key as "delete 
  669.             the character to the left of the cursor".
  670.  
  671.                 Here are the SPECIAL CHARACTERS Beep and Backspace. If 
  672.             you are TYPEing this, you will hear the beep, but will see 
  673.             nothing of interest.  Likewise if this is hardcopy.
  674.  
  675.                          Space       Beep          BS 
  676.               > <         ><          ><
  677.                            ^           ^            ^
  678.                 One other special character worth knowing about is the 
  679.             Form Feed, ascii 12 (decimal), (or Cntrl-L.  Which causes 
  680.             most printers to perform a form feed (or eject) operation.
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.              HACKER ver 1.2 documentation                
  693.              Copyright (C) 1989 by Ted Wray      
  694.                         All Rights Reserved                  page 8
  695.              HACKER ver 1.2 documentation                    page 9
  696.              Copyright (C) 1989 by Ted Wray      
  697.              All Rights Reserved
  698.  
  699.                                           EXAMPLES
  700.  
  701.                 I.   Let us suppose that your hard disk is well 
  702.             organized. That is, your root directory contains ONLY 
  703.             sub-directories and configuration files.  Let us further 
  704.             suppose that among these sub-directories is one named batch 
  705.             and several application sub-directories for such things as 
  706.             Word processing, spreadsheets, games, accounting, et c., 
  707.             each of which contains its own batch sub-directory.  The 
  708.             following might be a useful, general purpose end routine.
  709.  
  710.                 END.bat
  711.                      echo off
  712.                      Hacker clear
  713.                 :end
  714.                      cd ..
  715.                      cd batch
  716.                      Hacker is dir batch
  717.                      if errorlevel 1 goto exit
  718.                      Hacker what depth
  719.                      if errorlevel 1 goto end       
  720.                 :exit
  721.                      cls
  722.                      type menu.txt
  723.                 -------------------------------------------------------
  724.  
  725.  
  726.  
  727.                 II. The date and time functions of WHAT can be used in 
  728.             AUTOEXEC to schedule regular maintenance routines.
  729.  
  730.                 -------------------------------------------------------
  731.  
  732.                 III. The Add lfs function of FIX FILE can be used to 
  733.             make some captured standard output files readable by your 
  734.             favorite editor. Some programs, such as the Norton 
  735.             utilities, appear to over-write their own output by 
  736.             displaying only display characters, the carriage return (or 
  737.             new line) character, and the back space character; the line 
  738.             feed character only rarely.  If your editor chokes on 5 k 
  739.             lines, try adding line feeds.
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.              HACKER ver 1.2 documentation                
  763.              Copyright (C) 1989 by Ted Wray      
  764.                         All Rights Reserved                  page 9
  765.              HACKER ver 1.2 documentation                    page 10
  766.              Copyright (C) 1989 by Ted Wray      
  767.              All Rights Reserved
  768.  
  769.                                   EXAMPLES   ( continued )
  770.  
  771.  
  772.                 IV.   Let us suppose that you regularly review various 
  773.             software, or occasionally use some hogware that you normally 
  774.             keep archived on floppies.  If you wish to eradicate all the 
  775.             hogware files and sub-directories, try this:
  776.  
  777.                 DESTROY.bat
  778.                      echo off
  779.                      Hacker clear;sound siren
  780.                      Hacker ask Are you SURE about this ?  { y / n }
  781.                      if errorlevel 2 goto exit
  782.                      if errorlevel 1 goto doit
  783.                      goto exit
  784.                 :doit
  785.                      cd \misc\junk\garbage\hogware
  786.                      echo y | del . >nul
  787.                 :deeper
  788.                      for %%a in (*.*) do echo y | del %%a>nul
  789.                      for %%a in (*.*) do rd %%a
  790.                      for %%a in (*.*) do cd %%a
  791.                      for %%a in (*.*) do echo y | del %%a>nul
  792.                      for %%a in (*.*) do rd %%a
  793.                      for %%a in (*.*) do cd %%a
  794.                      cd ..
  795.                      Hacker what depth
  796.                      if errorlevel 5 goto deeper
  797.                 :exit
  798.                      cd \batch
  799.                      cls
  800.                      type menu.txt
  801.  
  802.                 -------------------------------------------------------
  803.  
  804.  
  805.                 V.   You can use IS VOLUME in your own backup and 
  806.             restore routines to choose among various routines based upon 
  807.             the volume id of the diskettes mounted.
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.              HACKER ver 1.2 documentation                
  833.              Copyright (C) 1989 by Ted Wray      
  834.                         All Rights Reserved                  page 10
  835.              HACKER ver 1.2 documentation                    page 11
  836.              Copyright (C) 1989 by Ted Wray      
  837.              All Rights Reserved
  838.  
  839.                                        I N D E X
  840.  
  841.                Add lfs,   . . . .  3           Is,   . . . . . .   4   
  842.                Ask,   . . . . . .  2             Dir,   . . . . .  4   
  843.                                                  Volume,   . . .   4   
  844.                Beep,   . . . . .   8                                   
  845.                Bitwise boolean,    4           Label,   . . . . .  4   
  846.                Blank line echo,    8           License,   . . . .  T   
  847.                Boot,   . . . . .   2           Line feed,   . . .  9   
  848.                  Cold Boot,   . .  2                                   
  849.                  Hardware Reset,   2           Message,   . . . .  4   
  850.                  Software Reset,   2           Minute,   . . . .   7   
  851.                  Warm Boot,   . .  2           Mode,   . . . . .   7   
  852.                Break,   . . . . .  2           Month,   . . . . .  7   
  853.                                                                        
  854.                Carriage return,    9           Note,   . . . . .   4   
  855.                Clear,   . . . . .  2           Object,   . . . .   1   
  856.                Continue,   . . .   6           Options,   . . . .  1   
  857.                Cr,   . . . . . .   3           Parameters,   . .   1   
  858.                Current directory,  4, 7                                
  859.                Cursor,   . . . .   3, 5        Reset                   
  860.                                                  Hardware Reset,   2   
  861.                Date,   . . . . .   7             Software Reset,   2   
  862.                Day,   . . . . . .  7           Re-boot,   . . . .  2   
  863.                Deleted,   . . . .  5                                   
  864.                Depth,   . . . . .  7           Scan lines,   . .   3, 5
  865.                Dir,   . . . . . .  4           Seconds,   . . . .  6   
  866.                Directory,   . . .  4           Semicolons,   . .   1   
  867.                Drive,   . . . . .  4, 7        Show,   . . . . .   5   
  868.                                                  Cursor,   . . .   5   
  869.                Environment,   . .  8             Hidden,   . . .   5   
  870.                ErrorLevel,   . .   1           Soften Cr,   . . .  3   
  871.                Escape,   . . . .   2           Software reset,     2   
  872.                                                Sound,   . . . . .  6   
  873.                Files,   . . . . .  3                                   
  874.                Fix,   . . . . . .  3           Time,   . . . . .   7   
  875.                  Cursor,   . . .   3           Volume,   . . . .   4   
  876.                  File,   . . . .   3                                   
  877.                Form feed,   . . .  8           Wait,   . . . . .   6   
  878.                                                Week,   . . . . .   7   
  879.                Hardware reset,     2           What,   . . . . .   7   
  880.                Help,   . . . . .   1, 3          Date,   . . . .   7   
  881.                Help screens,   .   3             Day,   . . . . .  7   
  882.                Hidden,   . . . .   5             Depth,   . . . .  7   
  883.                Hour,   . . . . .   7             Drive,   . . . .  7   
  884.                                                  Mode,   . . . .   7   
  885.                                                  Time,   . . . .   7   
  886.                                                Wild-cards,   . .   3, 4
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.              HACKER ver 1.2 documentation                
  903.              Copyright (C) 1989 by Ted Wray      
  904.                         All Rights Reserved                  page 11
  905.              HACKER ver 1.2 documentation                    page 12
  906.              Copyright (C) 1989 by Ted Wray      
  907.              All Rights Reserved
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.                            A C K N O W L E D G M E N T
  924.             
  925.                 The author wishes to thank Paul E. Begley of the 
  926.             Philadelphia Area Computer Society, and Paul J. Bodin of 
  927.             Staten Island, NY, without whose efforts testing HACKER, it 
  928.             would be much less satisfactory.  Any bugs, glitches and 
  929.             abominations remaining are solely the responsibility of the 
  930.             author.
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.                               R E V I S I O N   H I S T O R Y
  953.  
  954.  
  955.                 1.0  August 1, 1989    Initial Release
  956.  
  957.  
  958.                 1.1  October 5, 1989   Fixes bugs relating to EGA / VGA 
  959.                                           and 386 installation.
  960.                                        Sounds revised and added.
  961.                                        Internal refinements.
  962.  
  963.                 1.2  December 15, 1989 Fixes bugs relating to display,
  964.                                           and device spefication for Is
  965.                                           and Show; Depth fixed.
  966.                                        Sound returns error level.
  967.                                        Clear can go downward.
  968.  
  969.  
  970.  
  971.  
  972.              HACKER ver 1.2 documentation                
  973.              Copyright (C) 1989 by Ted Wray      
  974.                         All Rights Reserved                  page 12
  975.              HACKER ver 1.2 documentation                    page 13
  976.              Copyright (C) 1989 by Ted Wray      
  977.              All Rights Reserved
  978.  
  979.                                     B U G   R E P O R T
  980.  
  981.  
  982.                 Your registration number: _____________________________
  983.  
  984.  
  985.                 Report of:  Bug ____    Glitch ____   Design flaw _____
  986.  
  987.  
  988.                 Dos version: ______._______    MS-Dos ____  PC-Dos ____
  989.  
  990.  
  991.                 CPU: 8088 ____  8086 ____  186 ____  286 ____  386 ____
  992.  
  993.  
  994.                 Speed: _____________ mHz      Memory:  ______________ Kb
  995.  
  996.  
  997.                 PC make & model: ______________________________________
  998.  
  999.  
  1000.                 BIOS name & date: _____________________  ____/____/____
  1001.  
  1002.  
  1003.                 TSRs installed: ________________________________________
  1004.  
  1005.  
  1006.                 ________________________________________________________
  1007.  
  1008.  
  1009.                 ________________________________________________________
  1010.  
  1011.  
  1012.  
  1013.                 Bug description: _______________________________________
  1014.  
  1015.  
  1016.                 ________________________________________________________
  1017.  
  1018.  
  1019.                 ________________________________________________________
  1020.  
  1021.  
  1022.                 ________________________________________________________
  1023.  
  1024.  
  1025.                 ________________________________________________________
  1026.  
  1027.  
  1028.                 ________________________________________________________
  1029.  
  1030.  
  1031.                 ________________________________________________________
  1032.  
  1033.                          Please continue, if appropriate.
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.              HACKER ver 1.2 documentation                
  1043.              Copyright (C) 1989 by Ted Wray      
  1044.                         All Rights Reserved                  page 13
  1045.              HACKER ver 1.2 documentation                    page 14
  1046.              Copyright (C) 1989 by Ted Wray      
  1047.              All Rights Reserved
  1048.  
  1049.                              R E G I S T R A T I O N   F O R M
  1050.  
  1051.  
  1052.  
  1053.                  Name ______________________________________________
  1054.  
  1055.  
  1056.                  Address ___________________________________________
  1057.  
  1058.  
  1059.                 ____________________________________________________
  1060.  
  1061.  
  1062.  
  1063.                 City _______________________________________________
  1064.  
  1065.  
  1066.  
  1067.                 State ______________   Zip _________________________
  1068.  
  1069.  
  1070.  
  1071.                 Country ____________________________________________
  1072.  
  1073.  
  1074.  
  1075.  
  1076.                 From what BBS, if any, did you obtain HACKER ?
  1077.  
  1078.                      BBS name          City          Phone #
  1079.  
  1080.  
  1081.                 ____________________________________(    )____-_________
  1082.  
  1083.  
  1084.                 ____________________________________(    )____-_________
  1085.  
  1086.  
  1087.                 ____________________________________(    )____-_________
  1088.  
  1089.  
  1090.                 COMMENTS:
  1091.  
  1092.  
  1093.                 ____________________________________________________
  1094.  
  1095.  
  1096.                 ____________________________________________________
  1097.  
  1098.  
  1099.                 ____________________________________________________
  1100.  
  1101.  
  1102.                          Please continue, if appropriate.
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.              HACKER ver 1.2 documentation                
  1113.              Copyright (C) 1989 by Ted Wray      
  1114.                         All Rights Reserved                  page 14
  1115.  
  1116.