2 '\" Copyright 1991-1997 by Bell Labs Innovations for Lucent Technologies.
4 '\" Permission to use, copy, modify, and distribute this software and its
5 '\" documentation for any purpose and without fee is hereby granted, provided
6 '\" that the above copyright notice appear in all copies and that both that the
7 '\" copyright notice and warranty disclaimer appear in supporting documentation,
8 '\" and that the names of Lucent Technologies any of their entities not be used
9 '\" in advertising or publicity pertaining to distribution of the software
10 '\" without specific, written prior permission.
12 '\" Lucent Technologies disclaims all warranties with regard to this software,
13 '\" including all implied warranties of merchantability and fitness. In no event
14 '\" shall Lucent Technologies be liable for any special, indirect or
15 '\" consequential damages or any damages whatsoever resulting from loss of use,
16 '\" data or profits, whether in an action of contract, negligence or other
17 '\" tortuous action, arising out of or in connection with the use or performance
20 '\" The definitions below are for supplemental macros used in Tcl/Tk
23 '\" .AP type name in/out ?indent?
24 '\" Start paragraph describing an argument to a library procedure.
25 '\" type is type of argument (int, etc.), in/out is either "in", "out",
26 '\" or "in/out" to describe whether procedure reads or modifies arg,
27 '\" and indent is equivalent to second arg of .IP (shouldn't ever be
28 '\" needed; use .AS below instead)
31 '\" Give maximum sizes of arguments for setting tab stops. Type and
32 '\" name are examples of largest possible arguments that will be passed
33 '\" to .AP later. If args are omitted, default tab stops are used.
36 '\" Start box enclosure. From here until next .BE, everything will be
37 '\" enclosed in one large box.
40 '\" End of box enclosure.
43 '\" Begin code excerpt.
48 '\" .VS ?version? ?br?
49 '\" Begin vertical sidebar, for use in marking newly-changed parts
50 '\" of man pages. The first argument is ignored and used for recording
51 '\" the version when the .VS was added, so that the sidebars can be
52 '\" found and removed when they reach a certain age. If another argument
53 '\" is present, then a line break is forced before starting the sidebar.
56 '\" End of vertical sidebar.
59 '\" Begin an indented unfilled display.
62 '\" End of indented unfilled display.
65 '\" Start of list of standard options for a Tk widget. The
66 '\" options follow on successive lines, in four columns separated
70 '\" End of list of standard options for a Tk widget.
72 '\" .OP cmdName dbName dbClass
73 '\" Start of description of a specific option. cmdName gives the
74 '\" option's name as specified in the class command, dbName gives
75 '\" the option's name in the option database, and dbClass gives
76 '\" the option's class in the option database.
79 '\" Print arg1 underlined, then print arg2 normally.
81 '\" RCS: @(#) $Id: man.macros,v 1.1.1.1 2009/05/09 16:27:42 pcmacdon Exp $
83 '\" # Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
87 '\" # Start an argument description
91 . ie !"\\$2"" .TP \\n()Cu
96 \&\\$1 \\fI\\$2\\fP (\\$3)
109 '\" # define tabbing values for .AP
112 .if !"\\$1"" .nr )A \\w'\\$1'u+3n
115 .if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
116 .nr )C \\n()Bu+\\w'(in/out)'u+2n
118 .AS Tcl_Interp Tcl_CreateInterp in/out
119 '\" # BS - start boxed text
120 '\" # ^y = starting y location
128 .if n \l'\\n(.lu\(ul'
131 '\" # BE - end boxed text (draw box now)
136 .ie n \l'\\n(^lu\(ul'
138 .\" Draw four-sided box normally, but don't draw top of
139 .\" box if the box started on an earlier page.
141 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
144 \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
151 '\" # VS - start vertical sidebar
152 '\" # ^Y = starting y location
153 '\" # ^v = 1 (for troff; for nroff this doesn't matter)
157 .ie n 'mc \s12\(br\s0
160 '\" # VE - end of vertical sidebar
168 \h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
175 '\" # Special macro to handle page bottom: finish off current
176 '\" # box/sidebar if in box/sidebar mode, then invoked standard
177 '\" # page bottom macro.
184 .\" Draw three-sided box if this is the box's first page,
185 .\" draw two sides but no top otherwise.
186 .ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
187 .el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
190 .nr ^x \\n(^tu+1v-\\n(^Yu
191 \kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
204 '\" # DS - begin display
210 '\" # DE - end display
216 '\" # SO - start of list of standard options
218 .SH "STANDARD OPTIONS"
224 '\" # SE - end of list of standard options
229 See the \\fBoptions\\fR manual entry for details on the standard options.
231 '\" # OP - start of full description for a single option
236 Command-Line Name: \\fB\\$1\\fR
237 Database Name: \\fB\\$2\\fR
238 Database Class: \\fB\\$3\\fR
242 '\" # CS - begin code excerpt
250 '\" # CE - end code excerpt
260 .TH bltdebug n 2.5 BLT "BLT Built-In Commands"
262 '\" Note: do not modify the .SH NAME line immediately below!
264 bltdebug \- print Tcl commands before execution
266 \fBbltdebug\fR ?\fIlevel\fR?
269 The \fBbltdebug\fR command is a simple tracing facility for Tcl commands.
270 Each command line is printed before it is executed on standard error.
271 The output consists of the command line both before and after
272 substitutions have occurred. \fILevel\fR indicates at what level to
273 stop tracing commands. If \fIlevel\fR is \fB0\fR, no tracing is
274 performed. This is the default. If no \fIlevel\fR argument is given,
275 the current level is printed.