# -*- shell-script -*-
# "info functions" debugger command
#
#   Copyright (C) 2010, 2011 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_sub info functions \
'**info functions** [*pattern*]

Show functions matching regular expression PATTERN.
If pattern is empty, list all functions.

Examples:
---------

  info functions       \# list of all functions
  info functions s     \# functions containing an \"s\"
  info function  \^s    \# functions starting with an \"s\"

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

**info variables**.' 1

# list functions and break condition.
# If $1 is given just list those associated for that line.
proc _Dbg_do_info_functions {
    typeset pat=$1

    typeset -a fns_a
    global fns_a := '('$(_Dbg_get_functions 0 "$pat"))
    typeset -i i
    for (( i=0; i < ${#fns_a[@]}; i++ )) ; do
	_Dbg_msg ${fns_a[$i]}
    done
    return 0
}
(CommandList
  children: [
    (C {(_Dbg_help_add_sub)} {(info)} {(functions)} 
      {
        (SQ <"**info functions** [*pattern*]\n"> <"\n"> 
          <"Show functions matching regular expression PATTERN.\n"> <"If pattern is empty, list all functions.\n"> <"\n"> <"Examples:\n"> <"---------\n"> <"\n"> 
          <"  info functions       \\# list of all functions\n"> <"  info functions s     \\# functions containing an \\\"s\\\"\n"> 
          <"  info function  \\^s    \\# functions starting with an \\\"s\\\"\n"> <"\n"> <"See also:\n"> <"---------\n"> <"\n"> <"**info variables**.">
        )
      } {(1)}
    )
    (FuncDef
      name: _Dbg_do_info_functions
      body: 
        (BraceGroup
          children: [
            (C {(typeset)} {(Lit_VarLike "pat=") ($ VSub_Number "$1")})
            (C {(typeset)} {(-a)} {(fns_a)})
            (Assignment
              keyword: Assign_None
              pairs: [
                (assign_pair
                  lhs: (LhsName name:fns_a)
                  op: Equal
                  rhs: 
                    {
                      (ArrayLiteralPart
                        words: [
                          {
                            (CommandSubPart
                              command_list: 
                                (CommandList
                                  children: [
                                    (C {(_Dbg_get_functions)} {(0)} {(DQ ($ VSub_Name "$pat"))})
                                  ]
                                )
                              left_token: <Left_CommandSub "$(">
                              spids: [116 124]
                            )
                          }
                        ]
                      )
                    }
                  spids: [114]
                )
              ]
              spids: [114]
            )
            (C {(typeset)} {(-i)} {(i)})
            (ForExpr
              init: 
                (BinaryAssign
                  op_id: Arith_Equal
                  left: (LhsName name:i)
                  right: (ArithWord w:{(Lit_Digits 0)})
                )
              cond: 
                (ArithBinary
                  op_id: Arith_Less
                  left: (ArithVarRef name:i)
                  right: 
                    (ArithWord
                      w: 
                        {
                          (BracedVarSub
                            token: <VSub_Name fns_a>
                            prefix_op: VSub_Pound
                            bracket_op: (WholeArray op_id:Lit_At)
                            spids: [148 154]
                          )
                        }
                    )
                )
              update: (UnaryAssign op_id:Node_PostDPlus child:(LhsName name:i))
              body: 
                (DoGroup
                  children: [
                    (C {(_Dbg_msg)} 
                      {
                        (BracedVarSub
                          token: <VSub_Name fns_a>
                          bracket_op: (ArrayIndex expr:(ArithWord w:{($ VSub_Name "$i")}))
                          spids: [170 175]
                        )
                      }
                    )
                  ]
                  spids: [165 178]
                )
            )
            (ControlFlow token:<ControlFlow_Return return> arg_word:{(0)})
          ]
          spids: [97]
        )
      spids: [93 96]
    )
  ]
)