.-
help for ^copydesc^
.-

Copy description of variable ----------------------------

^copydesc^ fromvar tovar [ ^, w^arn ^r^estrain ]

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

^copydesc^ copies the format of fromvar, any variable label of fromvar, any value labels of fromvar, and any characteristics of fromvar, so that they also pertain to tovar.

Any attempt to copy a numeric format to a string variable, or vice versa, or to attach value labels to a string variable is by default captured gracefully.

If fromvar has no variable label, the name of fromvar becomes the variable label of tovar.

Remarks -------

^copydesc^ is primarily for use by programmers. For example, it may be desirable that a temporary variable appear to the user as if it were one of the variables specified.

However, interactive uses also occur. For example, tovar might be a slightly modified copy of fromvar: an outlier might be placed in a separate variable and all values but the outlier in tovar.

Some of the code of ^copydesc^ is stolen from the official but undocumented command ^_crcslbl^, but the position of the arguments is reversed.

Options -------

^warn^ specifies that a warning message is to be issued if one variable specified is numeric and the other is string.

^restrain^ specifies that no action is to be taken if one variable specified is numeric and the other is string.

Examples -------- . ^tempvar plotvar^ . ^copydesc myvar `plotvar'^ Author ------

Nicholas J. Cox, University of Durham, U.K. n.j.cox@@durham.ac.uk

Acknowledgments ---------------

Michael Blasnik and Ken Higbee made very helpful comments.