help viewresults
-------------------------------------------------------------------------------

Title

    viewresults -- Display results of a command in the Viewer


Syntax

        viewresults [, nonew name(viewername) nocmd ] : command


        dview [varlist] [using filename] [, name(viewername) nocmd
                 describe_options ]


    options               Description
    -------------------------------------------------------------------------
    nonew                 display results in the currently active Viewer
                            window
    name(viewername)      display results in a Viewer window named viewername
    nocmd                 suppress displaying the command line
    -------------------------------------------------------------------------


Description

    In interactive work it would sometimes be convenient to be able to hold
    on to some piece of console output (i.e. output appearing in Stata's
    Results window) in a separate window. For example, it might be helpful to
    keep describe's output, i.e. a description of the data in memory, in a
    separate window.

    viewresults executes command and displays a copy of the command's results
    in the Viewer.

    dview displays the results of Stata's describe command in a Viewer named
    "describe". It is a shorthand for

        . viewresults, name(describe) : describe


Options

    nonew specifies that a new Viewer window not be opened for the results if
        a Viewer window is already open.  The default is for a new Viewer
        window to be opened each time viewresults is issued so that multiple
        results may be viewed at once. nonew causes the results to be
        displayed in the topmost open Viewer. nonew is not allowed with
        dview.  dview's default is to display the results in a window named
        "describe".

    name(viewername) specifies that the results be displayed in a Viewer
        window named viewername.  If the named window already exists, its
        contents will be replaced.  If the named window does not exist, it
        will be created.

    nocmd causes the command line to be excluded from the displayed results.


Examples

        . sysuse auto, clear

        . dview

        . regress price weight

        . viewresults: estimates table


Author

    Ben Jann, ETH Zurich, jannb@ethz.ch

    Thanks for citing this software as follows:

        Jann, B. (2006). viewresults: Stata module to display results of a
        command in the Viewer. Available from 
        http://ideas.repec.org/c/boc/bocode/s456704.html.


Also see

    Online:  describe, viewer, saveresults (if installed)