


     Skip (V1.3 in C:) (2.x/3.x internal) 


     NAME
          Skip - Skip to the appropriate label.

     SYNOPSIS
          Skip string [BACK]

     DESCRIPTION
            Skip moves the currently executing script file ahead 
        until it finds a lab declaration which matches its own 
        argument.  If Skip is used without an argument, it looks 
        for a null string designated by LAB.

            If you run skip without a label string or a LAB 
        command then you will get the error message declaring 
        'label not found by SKIP'.

            To Skip backwards in a file, you use the BACK 
        keyword.

            If at any point in its search for a label Skip 
        encounters the EndSkip command, it will abort the Skip 
        and return an error of WARN.


            By using the idiom "Skip ?", you can request a user 
        to give you a label, and jump to that portion of the 
        batch file.

            CAUTION: With the 1.3 version of SKIP, you should NOT 
        indent a "Lab" statement or that label will not be found.



            Note that 2.x/3.x contains this command as a builtin.

     KEYWORDS
          string
            The text attached to a LAB command which SKIP 
        searches for. The search always starts on the line 
        following skip and continues downwoard toward the end of 
        the file. SKIP always looks for the LAB keyword command 
        preceding the Skip command, it will not goto a LAB 
        command before the Skip unless the BACK keyword is used.


          back
            Added with 1.3, it starts at the Skip and searches 
        back up the file towards the beginning. You may not skip 
        backwards in an EXECUTE statement.

     EXAMPLE
          1. To skip to Lab Dodah


           Skip Dodah 


          2. To skip down to the next LAB statement in the current
             command file.

           Skip

          3. To skip to the LAB statement 'Here' before the current
             skip statement in the current command file:

           Skip Here Back


