You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

99 lines
2.9 KiB
Plaintext

{smcl}
{* Nov2005}{...}
{cmd:help shellout}
{hline}
{title:Title}
{p2colset 5 17 22 2}{...}
{p2col :{hi: shellout} {hline 2}}Opens documents and their programs from inside Stata. {p_end}
{p2colreset}{...}
{title:Multiple Syntax}
{p 4 8 2}
{cmdab:shellout} {it:application} [, cd] {p_end}
{pstd}
where {it:application} is the name of a software application to be opened. {p_end}
{p 4 8 2}
{cmdab:shellout} [using] {it:filename} [, cd] {p_end}
{pstd}
where {it:filename} takes the form of a document with a known extension, such as .doc,
.do, .dta, .txt, .xls, .xml, etc. {p_end}
{title:Options}
{pstd}{opt cd} should not be used, except to tell Stata that the program
in question is located in the current directory. {p_end}
{title:Description}
{pstd}{cmd:shellout} opens a document from inside Stata without having to specify the exact
file path of the program. It also opens an application with or without specifying a file
document to be opened.
{pstd}{cmd:shellout} is a {help shell} wrapper designed for Windows XP/NT. Unlike {help shell}, implements a nested DOS command. The DOS Window is told to close itself.
{pstd}{cmd:shellout} was originally written to accompany {helpb outreg2} for automatic opening
of non-Stata documents.
{title:Examples}
{phang}{cmd:shellout} wsestata.exe {p_end}
{phang}{cmd:shellout} using myfile.xml {p_end}
{phang}{cmd:shellout} using "c:\myfolder\myfile.doc" {p_end}
{phang}{cmd:shellout} myfile.xml {p_end}
{phang}{cmd:shellout} me.do {p_end}
{pstd}The first line will open another Stata executable. {p_end}
{pstd}The second line will open a document named myfile.xml in Excel. {p_end}
{pstd}The third line will open a document named myfile.doc in Word. {p_end}
{pstd}The fourth line will do the same thing without invoking the "using" syntax. {p_end}
{pstd}The fifth line is the equivalent of -do me- in another Stata executable, or was it -run me-.... {p_end}
{title:Parameters}
{pstd}A parameter is any value passed into a batch script. {cmd:shellout} will work with
parameters in the following examples (assuming you have Stata SE) {p_end}
{phang}{cmd:shellout} shellout wsestata.exe shellout wsestata.exe shellout wsestata.exe {p_end}
{phang}{cmd:shellout} wsestata di "Bite Me" {p_end}
{phang}{cmd:shellout} notepad "Bite Me" {p_end}
{pstd}The first line will open three Stata executables in a daisy-chain. {p_end}
{pstd}The second line will open a Stata executable with a "Bite Me" message. {p_end}
{pstd}The third line will open a (new) notepad file called "Bite Me". {p_end}
{title:Advanced Parameters}
{pstd}You can save a batch of parameters in a file and invoke it under {cmd:shellout}
much like calling upon a do-file. Learn some DOS commands if you want to implement it. {p_end}
{title:Author}
Roy Wada
roywada@hotmail.com
{title:Also see}
{p 9}{bf:[D] Shell} {p_end}