Files
magic/doc/html/help.html
T
Tim Edwards a816da60f9 Updated the HTML command reference files to refer to magic version 8.3,
since all of the title images still had 8.2, and the title text still
said 7.3 or 7.4, having not been updated for a long time.
2024-01-09 16:37:00 -05:00

80 lines
2.8 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-8.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title8_3.png ALT="Magic VLSI Layout Tool Version 8.3">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>help</H2>
<HR>
Print out synopses for all commands valid in the current window (or
restrict output to those containing the indicated pattern)
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>help</B> [<I>pattern</I>] <BR><BR>
<BLOCKQUOTE>
where <I>pattern</I> is any keyword or text string.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>help</B> command invokes the built-in help function in
<B>magic</B>, which lists the summary usage information that
has been compiled into magic for each command. The summary
help information is usually only a single line of text.
Commands that have complicated sets of options have their
own <B>help</B> option, which is not part of the <B>help</B>
command. <P>
Without arguments, <B>help</B> reports a summary usage for
every command in magic. With arguments, magic filters the
output to report only those commands matching the indicated
text <I>pattern</I>. <P>
The output is divided into
general-purpose and window-specific sections. The window-specfic
section depends on the active window. For instance, with a
single layout window present, <B>help cleanup</B> returns no
information. However, the command <B>specialopen netlist</B>
followed by <B>help cleanup</B> will report the usage of the
command <B>cleanup</B>, which is a command that can only be
invoked from the netlist window. <P>
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>help</B> is implemented as a built-in command in <B>magic</B>.
Note that there is no general-purpose command-line-based help
method for Tcl commands, so the <B>help</B> command will not
provide any information about magic commands written as Tcl
procedures, such as <B>openwrapper</B> or <B>pushstack</B>.
The general convention is for each Tcl procedure to allow the
option <B>help</B> and provide its own usage information.
</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>