Files
magic/doc/html/shell.html
T
Tim Edwards 09577b5636 Updated all of the documentation by copying back from the website.
The website documentation now points to these contents in a clone
of the repository on opencircuitdesign.com, so all future edits of
the command-line documentation will be made directly to the git
repository.  Also:  Changed the precision of box values printed in
microns from 2 to 3 digits after the decimal place, so that 5 nanometer
grids do not get values clipped in the output.
2022-01-21 10:44:13 -05:00

67 lines
2.0 KiB
HTML

<HTML>
<HEAD>
<STYLE type="text/css">
H1 {color: black }
H2 {color: maroon }
H3 {color: #007090 }
A.head:link {color: #0060a0 }
A.head:visited {color: #3040c0 }
A.head:active {color: white }
A.head:hover {color: yellow }
A.red:link {color: red }
A.red:visited {color: maroon }
A.red:active {color: yellow }
</STYLE>
</HEAD>
<TITLE>Magic-7.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>shell</H2>
<HR>
Execute a command in a UNIX subshell
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>shell</B> [<I>command</I>] <BR><BR>
<BLOCKQUOTE>
where <I>command</I> is a valid UNIX command-line command.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>shell</B> command allows UNIX commands to be executed from
the magic command line. This use is superceded by the Tcl
interpreter, which executes shell commands directly from the
interpreter prompt. Differences between the two uses is noted
below.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>shell</B> is implemented as a built-in command in <B>magic</B>.
This is similar to the Tcl interpreter execution of shell commands
directly from the Tcl command-line. The primary difference is that
results from the shell interpreter are printed to the calling
terminal with <B>shell</B>, and are printed to the console when
invoked directly from Tcl. For example, note the difference in
the output target for:
<BLOCKQUOTE>
<B>ls -l</B> <PRE> </PRE> <I>vs.</I><BR>
<B>shell ls -l</B>
</BLOCKQUOTE>
</BLOCKQUOTE>
<P><IMG SRC=graphics/line1.gif><P>
<TABLE BORDER=0>
<TR>
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> March 7, 2020 at 1:06pm <P>
</BODY>
</HTML>