# -*- shell-script -*-
# gdb-like "skip" (step over) commmand.
#
#   Copyright (C) 2010, 2011, 2017 Rocky Bernstein <rocky@gnu.org>
#
#   This program is free software; you can redistribute it and/or
#   modify it under the terms of the GNU General Public License as
#   published by the Free Software Foundation; either version 2, or
#   (at your option) any later version.
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
#   General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program; see the file COPYING.  If not, write to
#   the Free Software Foundation, 59 Temple Place, Suite 330, Boston,
#   MA 02111 USA.

_Dbg_help_add skip \
"**skip** [*count*]

Skip (don't run) the next *count* command(s).

If *count* is given, stepping occurs that many times before
stopping. Otherwise *count* is one. *count* can be an arithmetic
expression.

Note that skipping doesn't change the value of \$?. This has
consequences in some compound statements that test on \$?. For example
in:

   if grep foo bar.txt ; then
      echo not skipped
   fi

skipping the *if* statement will in effect skip running the *grep*
command. Since the return code is 0 when skipped, the *if* body is
entered. Similarly the same thing can  happen in a *while* statement
test.

See http://lists.gnu.org/archive/html/bug-bash/2017-04/msg00004.html

See also:
---------

**next** and **step**.
"

proc _Dbg_do_skip {
    global _Dbg_last_cmd := ''skip''
    _Dbg_next_skip_common 1 $ifsjoin(Argv)
    return $?
}
(CommandList
  children: [
    (C {(_Dbg_help_add)} {(skip)} 
      {
        (DQ ("**skip** [*count*]\n") ("\n") ("Skip (don't run) the next *count* command(s).\n") ("\n") 
          ("If *count* is given, stepping occurs that many times before\n") ("stopping. Otherwise *count* is one. *count* can be an arithmetic\n") ("expression.\n") ("\n") 
          ("Note that skipping doesn't change the value of ") (EscapedLiteralPart token:<Lit_EscapedChar "\\$">) ("?. This has\n") 
          ("consequences in some compound statements that test on ") (EscapedLiteralPart token:<Lit_EscapedChar "\\$">) ("?. For example\n") ("in:\n") ("\n") 
          ("   if grep foo bar.txt ; then\n") ("      echo not skipped\n") ("   fi\n") ("\n") 
          ("skipping the *if* statement will in effect skip running the *grep*\n") ("command. Since the return code is 0 when skipped, the *if* body is\n") 
          ("entered. Similarly the same thing can  happen in a *while* statement\n") ("test.\n") ("\n") ("See http://lists.gnu.org/archive/html/bug-bash/2017-04/msg00004.html\n") ("\n") 
          ("See also:\n") ("---------\n") ("\n") ("**next** and **step**.\n")
        )
      }
    )
    (FuncDef
      name: _Dbg_do_skip
      body: 
        (BraceGroup
          children: [
            (Assignment
              keyword: Assign_None
              pairs: [
                (assign_pair
                  lhs: (LhsName name:_Dbg_last_cmd)
                  op: Equal
                  rhs: {(SQ <skip>)}
                  spids: [105]
                )
              ]
              spids: [105]
            )
            (C {(_Dbg_next_skip_common)} {(1)} {($ VSub_Star "$*")})
            (ControlFlow token:<ControlFlow_Return return> arg_word:{($ VSub_QMark "$?")})
          ]
          spids: [102]
        )
      spids: [98 101]
    )
  ]
)