.-
help for ^vorder^                                            (STB-40: dm51)
.-

Defining and reordering variable orderings
------------------------------------------

   ^vorder sa^ve ordername [varlist]

   ^vorder or^der ordername

   ^vorder li^st [ordername]

   ^vorder dr^op ordername


Description
-----------

^vorder^ allows named orderings of variables to be attached to a data set so that
any such ordering can be quickly re-established later.  ^vorder^ has four modes,
selected by its first argument.  In ^save^ mode, ^vorder^ records the list of vari-
able names described by varlist; if varlist is absent, ^vorder^ saves the current
ordering of all variables.  In ^order^ mode, ^vorder^ uses the @order@ command to re-
order the variables as prescribed by ordername.  In ^list^ mode, ^vorder^ displays
the definition of an ordername saved in ^save^ mode; if ordername is absent, all
current order definitions are displayed. In ^drop^ mode, an order defined in ^save^
mode is erased; if the keyword ^_all^ is supplied as the ordername, all currently
defined orders are erased.

Ordernames are sequences of letters, digits, and underscores; only the first 6
characters are significant.  More precisely, ^save^ mode creates a characteristic
associated with the data set named "VOx" (i.e., "_dta[VOx]") where "x" is the
ordername supplied.  In all modes, ^vorder^ strips away the initial letters "VO",
if supplied, so that an ordername may be given as "x" or "VOx".  (In ^list^ and
^drop^ modes, the keyword ^_all^ may be used to refer to all currently defined ord-
ernames.)


Examples
--------

 . ^vorder save start^
   (Save the current variable order as _dta[VOstart])

 . ^vorder save mine ht wt age group^
   (Save the varlist ht wt age group as _dta[VOmine])

 . ^vorder save yours group age wt bp1-bp4^
   (Expand the varlist group age wt bp1-bp4 and save as _dta[VOyours])

 . ^vorder order mine^
 . ^vorder order yours^
 . ^vorder order start^
   (Toggle between three orderings of the variables)

 . ^vorder list^
   (Display all defined variable orderings)

 . ^vorder drop _all^
   (Erase all defined orders)


Author
------

      John R. Gleason
      Syracuse University
      email: loesljrg@@ican.net


Also see
--------

    STB:   STB-40 dm51
 Manual:   [U] 19.8 Characteristics
           [R] order
 On-line:  help for @char@, @move@, @order@