1debug::caller(n)                debug narrative               debug::caller(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       debug::caller - debug narrative - caller
9

SYNOPSIS

11       package require Tcl  8.5
12
13       package require debug::caller  ?1.1?
14
15       debug caller ?args...?
16
17______________________________________________________________________________
18

DESCRIPTION

API

21       debug caller ?args...?
22              This  method is useful in a tag-specific prefix to automatically
23              provide caller information for all uses of the tag. Or in a mes‐
24              sage, when only specific places need such detail.
25
26              Beyond  that it recognizing the various internal forms of method
27              calls generated by the snit OO  system  and  rewrites  these  to
28              their  original  form,  for  better  readability.  Similarly for
29              TclOO.
30
31              If args are specified then they are treated as the  integer  in‐
32              dices of command arguments to not show in the output. The refer‐
33              enced arguments are replaced by * instead.  The  main  anticipi‐
34              ated use case for this is the exclusion of arguments expected to
35              contain large Tcl values, i.e. long lists,  large  dictionaries,
36              etc. to prevent them from overwhelming the narrative.
37

BUGS, IDEAS, FEEDBACK

39       This  document,  and the package it describes, will undoubtedly contain
40       bugs and other problems.  Please report such in the category  debug  of
41       the  Tcllib  Trackers  [http://core.tcl.tk/tcllib/reportlist].   Please
42       also report any ideas for enhancements you may have for either  package
43       and/or documentation.
44
45       When proposing code changes, please provide unified diffs, i.e the out‐
46       put of diff -u.
47
48       Note further that  attachments  are  strongly  preferred  over  inlined
49       patches.  Attachments  can  be  made  by  going to the Edit form of the
50       ticket immediately after its creation, and  then  using  the  left-most
51       button in the secondary navigation bar.
52

KEYWORDS

54       debug, log, narrative, trace
55

CATEGORY

57       debugging, tracing, and logging
58
60       Copyright (c) 2012-2015, Andreas Kupries <andreas_kupries@users.sourceforge.net>
61
62
63
64
65tcllib                                1.1                     debug::caller(n)
Impressum