.-
help for ^labedit^                                 [STB-43: dm56; STB-51: dm56.1]
.-
.
A visual labels editor (Windows and Macintosh only)
---------------------------------------------------
.
   ^labedit^ [varlist] [^, n^ovalue]
.
.
Description
-----------
.
^labedit^ is a tool for manipulating labels.  Variable labels can be created, al-
tered, and deleted in a scrolling edit window.  The same window can be used to
define, drop, or alter value labels, and assign them to any existing variable.
The dataset label can be altered using another control in the ^labedit^ dialog.
.
The edit window consists of two parallel stacks of 5 edit boxes each; clipboard
cut, copy, and paste operations are available in each edit box. In variable la-
bel mode, the left stack is used to assign value labels to variables, and the
right stack is used to edit variable labels.  In value label mode, the left
stack presents numeric values and the right stack presents the value labels as-
sociated with those numbers.  Only those labels visible in the window are edit-
able at any given time and the window ^autosaves^ its contents: Unless in Browse
mode, clicking any of the 6 Scroll Buttons transfers the contents of the edit
window to the current data.
.
.
Controls
--------
.
^Select Variable^  switches into variable label mode and scrolls the edit window
      so that the variable whose name appears in the edit box above is brought
      into the window.  The variable name can be typed into the edit box or se-
      lected from the drop-down list invoked by clicking the down-arrow button.
      The number of variables in the list appears above the edit box.
.
      The Select Variable button is divided:  There is a tiny sub-button at the
      right edge.  Clicking that tiny button displays any notes associated with
      the selected variable.  (Variables having notes are marked by an asterisk
      (^*^) in the column of variable names in the edit window.)
.
^Select Label^  switches into value label mode and presents the labels assigned
      to the integers 0 .. 4 for the value label whose name appears in the edit
      box above. The value label name can be typed into the edit box or select-
      ed from the drop-down list invoked by clicking the down-arrow button (un-
      less the ^novalue^ option is given). The number of value labels in the list
      appears above the edit box.
.
^Dir^  displays a directory of currently defined value labels, exactly as though
      the command ^lab dir^ were given.  [Value label mode only]
.
^List^  displays the definition of the value label whose name (if any) appears in
      the edit box to its left, exactly as though the command ^lab list^ were
      given.  [Value label mode only]
.
^Query^ looks up the labels assigned by the selected value label to the integers
      in the numeric value edit boxes, and writes them in the edit boxes beside
      their numeric equivalents.  [Value label mode only]
.
^Scroll Buttons^  are the 6 buttons at the left edge of the edit window, used to
      bring value or variable labels into the window.  Unless in Browse mode,
      each scroll button also saves the current contents of the edit window be-
      fore moving a new set of contents into the window (autosave).
.
      In variable label mode, the buttons traverse the drop-down variable list:
      ^Top^ moves to the top of the list; ^PgUp^ shifts 5 positions upward in the
      list; ^Up^ shifts one position upward in the list; ^Dn^ shifts one position
      downward in the list; ^PgDn^ moves 5 positions downward in the list; ^Bottom^
      places the last variable in the bottom position of the edit window.
.
      In value label mode, the buttons present number-value label pairs:  ^Top^
      fills the righthand edit boxes with the numbers 0 .. 4 and any associated
      value labels; ^PgUp^ adds -5 to the righthand numeric values; ^Up^ adds -1 to
      the righthand numeric values; ^Dn^ adds 1 to the righthand numeric values;
      ^PgDn^ adds 5 to the righthand numeric values; ^Bottom^ places in the bottom
      position of the edit window the largest numeric value visited in the cur-
      rent edit.  NOTE: While the Scroll Buttons generate consecutive integers,
      any non-negative integer can be typed into any of the righthand edit box-
      es, and a value label assigned to it by typing in the lefthand box.
.
^Browse^  disables the autosave action of the Scroll Buttons, so that current
      variable and value labels can be viewed, but not altered.  (Changes made
      in any edit box are lost if any Scroll Button is clicked in Browse Mode.)
.
^New Dataset Label^ assigns the text in the edit box below as the dataset label.
.
.
Warning
-------
.
The left-quote (^`^) character must be avoided:  It will be interpreted as the
start of a macro expansion, which usually causes some text to vanish.
.
.
Options
-------
.
^novalue^ omits the step of identifying all currently defined value labels.  The
      drop-down list will then be empty, but existing value labels can still be
      edited and new value labels can still be created by typing the value lab-
      el's name into the box above the Select Label button. (This option exists
      to improve startup speed when the data set is quite large.)
.
.
Author
------
   John R. Gleason, Syracuse University, Syracuse NY, USA
   (loesljrg@@accucom.net)    [This is Version 1.0.4 (01Aug1999).]
.
.
Also see
--------
.
 Manual:  ^[U] 13 Keyboard use^
          ^[U] 15.6 Dataset, variable, and value labels^
          ^[R] labels^
          ^[R] notes^
          ^[R] window^
.
 On-line:  help for @label@, @notes@