OSDN Git Service

compiled for linux: 3.10.0-957.27.2.el7.x86_64
[eos/base.git] / util / src / TclTk / blt2.5 / man / BLT.n
diff --git a/util/src/TclTk/blt2.5/man/BLT.n b/util/src/TclTk/blt2.5/man/BLT.n
deleted file mode 100644 (file)
index aa606d6..0000000
+++ /dev/null
@@ -1,392 +0,0 @@
-'\"
-'\" Copyright 1991-1997 by Bell Labs Innovations for Lucent Technologies.
-'\"
-'\" Permission to use, copy, modify, and distribute this software and its
-'\" documentation for any purpose and without fee is hereby granted, provided
-'\" that the above copyright notice appear in all copies and that both that the
-'\" copyright notice and warranty disclaimer appear in supporting documentation,
-'\" and that the names of Lucent Technologies any of their entities not be used
-'\" in advertising or publicity pertaining to distribution of the software
-'\" without specific, written prior permission.
-'\"
-'\" Lucent Technologies disclaims all warranties with regard to this software,
-'\" including all implied warranties of merchantability and fitness.  In no event
-'\" shall Lucent Technologies be liable for any special, indirect or
-'\" consequential damages or any damages whatsoever resulting from loss of use,
-'\" data or profits, whether in an action of contract, negligence or other
-'\" tortuous action, arising out of or in connection with the use or performance
-'\" of this software.  
-'\"
-'\" The definitions below are for supplemental macros used in Tcl/Tk
-'\" manual entries.
-'\"
-'\" .AP type name in/out ?indent?
-'\"    Start paragraph describing an argument to a library procedure.
-'\"    type is type of argument (int, etc.), in/out is either "in", "out",
-'\"    or "in/out" to describe whether procedure reads or modifies arg,
-'\"    and indent is equivalent to second arg of .IP (shouldn't ever be
-'\"    needed;  use .AS below instead)
-'\"
-'\" .AS ?type? ?name?
-'\"    Give maximum sizes of arguments for setting tab stops.  Type and
-'\"    name are examples of largest possible arguments that will be passed
-'\"    to .AP later.  If args are omitted, default tab stops are used.
-'\"
-'\" .BS
-'\"    Start box enclosure.  From here until next .BE, everything will be
-'\"    enclosed in one large box.
-'\"
-'\" .BE
-'\"    End of box enclosure.
-'\"
-'\" .CS
-'\"    Begin code excerpt.
-'\"
-'\" .CE
-'\"    End code excerpt.
-'\"
-'\" .VS ?version? ?br?
-'\"    Begin vertical sidebar, for use in marking newly-changed parts
-'\"    of man pages.  The first argument is ignored and used for recording
-'\"    the version when the .VS was added, so that the sidebars can be
-'\"    found and removed when they reach a certain age.  If another argument
-'\"    is present, then a line break is forced before starting the sidebar.
-'\"
-'\" .VE
-'\"    End of vertical sidebar.
-'\"
-'\" .DS
-'\"    Begin an indented unfilled display.
-'\"
-'\" .DE
-'\"    End of indented unfilled display.
-'\"
-'\" .SO
-'\"    Start of list of standard options for a Tk widget.  The
-'\"    options follow on successive lines, in four columns separated
-'\"    by tabs.
-'\"
-'\" .SE
-'\"    End of list of standard options for a Tk widget.
-'\"
-'\" .OP cmdName dbName dbClass
-'\"    Start of description of a specific option.  cmdName gives the
-'\"    option's name as specified in the class command, dbName gives
-'\"    the option's name in the option database, and dbClass gives
-'\"    the option's class in the option database.
-'\"
-'\" .UL arg1 arg2
-'\"    Print arg1 underlined, then print arg2 normally.
-'\"
-'\" RCS: @(#) $Id: man.macros,v 1.1.1.1 2009/05/09 16:27:42 pcmacdon Exp $
-'\"
-'\"    # Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
-.if t .wh -1.3i ^B
-.nr ^l \n(.l
-.ad b
-'\"    # Start an argument description
-.de AP
-.ie !"\\$4"" .TP \\$4
-.el \{\
-.   ie !"\\$2"" .TP \\n()Cu
-.   el          .TP 15
-.\}
-.ta \\n()Au \\n()Bu
-.ie !"\\$3"" \{\
-\&\\$1 \\fI\\$2\\fP    (\\$3)
-.\".b
-.\}
-.el \{\
-.br
-.ie !"\\$2"" \{\
-\&\\$1 \\fI\\$2\\fP
-.\}
-.el \{\
-\&\\fI\\$1\\fP
-.\}
-.\}
-..
-'\"    # define tabbing values for .AP
-.de AS
-.nr )A 10n
-.if !"\\$1"" .nr )A \\w'\\$1'u+3n
-.nr )B \\n()Au+15n
-.\"
-.if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
-.nr )C \\n()Bu+\\w'(in/out)'u+2n
-..
-.AS Tcl_Interp Tcl_CreateInterp in/out
-'\"    # BS - start boxed text
-'\"    # ^y = starting y location
-'\"    # ^b = 1
-.de BS
-.br
-.mk ^y
-.nr ^b 1u
-.if n .nf
-.if n .ti 0
-.if n \l'\\n(.lu\(ul'
-.if n .fi
-..
-'\"    # BE - end boxed text (draw box now)
-.de BE
-.nf
-.ti 0
-.mk ^t
-.ie n \l'\\n(^lu\(ul'
-.el \{\
-.\"    Draw four-sided box normally, but don't draw top of
-.\"    box if the box started on an earlier page.
-.ie !\\n(^b-1 \{\
-\h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
-.\}
-.el \}\
-\h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
-.\}
-.\}
-.fi
-.br
-.nr ^b 0
-..
-'\"    # VS - start vertical sidebar
-'\"    # ^Y = starting y location
-'\"    # ^v = 1 (for troff;  for nroff this doesn't matter)
-.de VS
-.if !"\\$2"" .br
-.mk ^Y
-.ie n 'mc \s12\(br\s0
-.el .nr ^v 1u
-..
-'\"    # VE - end of vertical sidebar
-.de VE
-.ie n 'mc
-.el \{\
-.ev 2
-.nf
-.ti 0
-.mk ^t
-\h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
-.sp -1
-.fi
-.ev
-.\}
-.nr ^v 0
-..
-'\"    # Special macro to handle page bottom:  finish off current
-'\"    # box/sidebar if in box/sidebar mode, then invoked standard
-'\"    # page bottom macro.
-.de ^B
-.ev 2
-'ti 0
-'nf
-.mk ^t
-.if \\n(^b \{\
-.\"    Draw three-sided box if this is the box's first page,
-.\"    draw two sides but no top otherwise.
-.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
-.el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
-.\}
-.if \\n(^v \{\
-.nr ^x \\n(^tu+1v-\\n(^Yu
-\kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
-.\}
-.bp
-'fi
-.ev
-.if \\n(^b \{\
-.mk ^y
-.nr ^b 2
-.\}
-.if \\n(^v \{\
-.mk ^Y
-.\}
-..
-'\"    # DS - begin display
-.de DS
-.RS
-.nf
-.sp
-..
-'\"    # DE - end display
-.de DE
-.fi
-.RE
-.sp
-..
-'\"    # SO - start of list of standard options
-.de SO
-.SH "STANDARD OPTIONS"
-.LP
-.nf
-.ta 4c 8c 12c
-.ft B
-..
-'\"    # SE - end of list of standard options
-.de SE
-.fi
-.ft R
-.LP
-See the \\fBoptions\\fR manual entry for details on the standard options.
-..
-'\"    # OP - start of full description for a single option
-.de OP
-.LP
-.nf
-.ta 4c
-Command-Line Name:     \\fB\\$1\\fR
-Database Name: \\fB\\$2\\fR
-Database Class:        \\fB\\$3\\fR
-.fi
-.IP
-..
-'\"    # CS - begin code excerpt
-.de CS
-.RS
-.nf
-.ta .25i .5i .75i 1i
-.ft CW
-.sp
-..
-'\"    # CE - end code excerpt
-.de CE
-.fi
-.RE
-.ft R
-.sp
-..
-.de UL
-\\$1\l'|0\(ul'\\$2
-..
-.TH intro n 2.5 BLT "BLT Built-In Commands"
-.BS
-'\" Note:  do not modify the .SH NAME line immediately below!
-.SH NAME
-BLT \- Introduction to the BLT library
-.BE
-.SH DESCRIPTION
-BLT is a library of extensions to the Tk library.  It adds new
-commands and variables to the application's interpreter.
-.LP
-.SH COMMANDS
-The following commands are added to the interpreter from the BLT library:
-.TP 15
-\fBtable\fR 
-A table geometry manager for Tk.  You specify window placements as table 
-row,column positions and windows can also span multiple rows or columns. 
-It also has many options for setting and/or bounding window sizes.
-.TP 15
-\fBgraph\fR 
-A 2D plotting widget.  Plots two variable data in a window with an optional 
-legend and annotations.   It has of several components; coordinate axes, 
-crosshairs, a legend, and a collection of elements and tags.
-.TP 15
-\fBbarchart\fR 
-A barchart widget.  Plots two-variable data as rectangular bars in a 
-window.  The x-coordinate values designate the position of the bar along 
-the x-axis, while the y-coordinate values designate the magnitude.
-The \fBbarchart\fR widget has of several components; coordinate axes, 
-crosshairs, a legend, and a collection of elements and tags.
-.TP 15
-\fBvector\fR 
-Creates a vector of floating point values.  The vector's components
-can be manipulated in three ways: through a Tcl array variable, a Tcl
-command, or the C API.
-.TP
-\fBspline\fR
-Computes a spline fitting a set of data points (x and y vectors) and
-produces a vector of the interpolated images (y-coordinates) at a
-given set of x-coordinates.
-.TP 15
-\fBbgexec\fR 
-Like Tcl's \fBexec\fR command, \fBbgexec\fR runs a pipeline of Unix 
-commands in the background.  Unlike \fBexec\fR, the output of the last
-process is collected and a global Tcl variable is set upon its completion.
-\fBbgexec\fR can be used with \fBtkwait\fR to wait for Unix commands
-to finish while still handling expose events.  Intermediate output is
-also available while the pipeline is active.
-.TP 15
-\fBbusy\fR 
-Creates a "busy window" which prevents user-interaction when an
-application is busy.  The busy window also provides an easy way 
-to have temporary busy cursors (such as a watch or hourglass).
-.TP 15
-\fBbitmap\fR 
-Reads and writes bitmaps from Tcl.  New X bitmaps can be defined
-on-the-fly from Tcl, obviating the need to copy around bitmap files.  
-Other options query loaded X bitmap's dimensions and data.
-.TP 15
-\fBdrag&drop\fR 
-Provides a drag-and-drop facility for Tk.  Information (represented
-by a token window) can be dragged to and from any Tk window, including
-those of another Tk application.  \fBdrag&drop\fR acts as a 
-coordinator, directing Tk \fBsend\fR commands between (or within) TCL/Tk 
-applications. 
-.TP 15
-\fBhtext\fR 
-A simple hypertext widget.  Combines text and Tk widgets into a single
-scroll-able window.  Tcl commands can be embedded into text, which are
-invoked as the text is parsed.  In addition, Tk widgets can be
-appended to the window at the current point in the text.  \fBHtext\fR
-can be also used to create scrolled windows of Tk widgets.
-.TP 15
-\fBwinop\fR 
-Raise, lower, map, or, unmap any window.  The raise and lower functions
-are useful for stacking windows above or below "busy windows".
-.TP 15
-\fBwatch\fR 
-Arranges for Tcl procedures to be called before and/or after the execution
-of every Tcl command. This command
-may be used in the logging, profiling, or tracing of Tcl code.
-.TP 15
-\fBbltdebug\fR 
-A simple Tcl command tracing facility useful for debugging Tcl code.  
-Displays each Tcl command before and after substitution along its level 
-in the interpreter on standard error.
-.SH VARIABLES
-.PP
-The following Tcl variables are either set or used by BLT at various times
-in its execution:
-.TP 15
-\fBblt_library\fR
-This variable contains the name of a directory containing a library
-of Tcl scripts and other files related to BLT.  Currently, this 
-directory contains the \fBdrag&drop\fR protocol scripts and the 
-PostScript prolog
-used by \fBgraph\fR and \fBbarchart\fR.
-The value of this variable is taken from the BLT_LIBRARY environment
-variable, if one exists, or else from a default value compiled into
-the \fBBLT\fR library.
-.TP 15
-\fBblt_versions\fR 
-This variable is set in the interpreter for each application. It is an 
-array of the current version numbers for each 
-of the BLT commands in the form \fImajor\fR.\fIminor\fR.  \fIMajor\fR and
-\fIminor\fR are integers.  The major version number increases in
-any command that includes changes that are not backward compatible
-(i.e. whenever existing applications and scripts may have to change to
-work with the new release).  The minor version number increases with
-each new release of a command, except that it resets to zero whenever the
-major version number changes.  The array is indexed by the individual 
-command name.
-.SH ADDING BLT TO YOUR APPLICATIONS
-It's easy to add BLT to an existing Tk application.  BLT requires no 
-patches or edits to the Tcl or Tk libraries.  To add BLT, simply add the 
-following code snippet to your application's tkAppInit.c file.  
-.CS
-if (Blt_Init(interp) != TCL_OK) {
-    return TCL_ERROR;
-}
-.CE
-Recompile and link with the BLT library (libBLT.a) and that's it.
-.PP
-Alternately, you can dynamically load BLT, simply by invoking the
-command
-.CS
-package require BLT
-.CE
-from your Tcl script.
-.SH BUGS
-Send bug reports, requests, suggestions, etc. to 
-gah@siliconmetrics.com or ghowlett@grandecom.net
-.SH KEYWORDS
-BLT