nutmeg.txt

支持数字元件仿真的SPICE插件

SUBJECT: main
TITLE: Help System
TEXT:      This is the nutmeg _h_e_l_p system.  To chose a subtopic or
TEXT:      see-also topic, click a mouse button in the appropriate box
TEXT:      below,  or type the number of the topic that you want if you
TEXT:      are using an ASCII terminal.
TEXT: 
SUBTOPIC: SPICE:analyses NUTMEG:arguments SPICE:batchmode
SUBTOPIC: NUTMEG:bugs NUTMEG:caveats NUTMEG:commands
SUBTOPIC: SPICE:convergence NUTMEG:cshstuff SPICE:elements
SUBTOPIC: SPICE:examples NUTMEG:expressions NUTMEG:graphics
SUBTOPIC: NUTMEG:hpux NUTMEG:input SPICE:models
SUBTOPIC: SPICE:options NUTMEG:pc NUTMEG:proglang
SUBTOPIC: NUTMEG:refs NUTMEG:sconvert SPICE:spice
SUBTOPIC: NUTMEG:variables NUTMEG:vms

SUBJECT: arguments
TITLE: Command Line Arguments
TEXT: 
TEXT:      GNutmeg Hand Gspice Htake the following command line options.
TEXT: H     Additional arguments are taken to be circuit files in the
TEXT: H     case of GspiceH, or raw data files to be loaded in the case of
TEXT: H     GnutmegH.
TEXT: H
TEXT: 
SUBTOPIC: NUTMEG:dash SPICE:dashb SPICE:dashi
SUBTOPIC: NUTMEG:dashn NUTMEG:dasho SPICE:dashq
SUBTOPIC: NUTMEG:dashr SPICE:dashs NUTMEG:dasht

SUBJECT: dash
TITLE: -
TEXT: 
TEXT:      G-    HDon't try load a rawfile (Gnutmeg Honly).  The default
TEXT: H          rawfile name is GrawspiceH, which will be loaded in if no
TEXT: H          other filenames are given on the command line.
TEXT: H
TEXT: 

SUBJECT: dashn
TITLE: -n
TEXT: 
TEXT:      G-n   HDon't try to source the file ".spiceinit" upon startup.
TEXT: H          Normally the program tries to find the file in the
TEXT: H          current directory, and if it is not found then it
TEXT: H          checks in the user's home directory.
TEXT: H
TEXT: 

SUBJECT: dasho
TITLE: -o
TEXT: 
TEXT:      G-o outfile
TEXT: H          HOpen the given file for output, instead of sending out-
TEXT: H          put to the terminal.
TEXT: H
TEXT: 

SUBJECT: dashr
TITLE: -r
TEXT: 
TEXT:      G-r   HUse the named file for dumping data if this is Gspice Hin
TEXT: H          batch mode, and use it as the default rawfile for the
TEXT: H          Gwrite Hcommand.  Note that if the program is GnutmegH,
TEXT: H          this option will not cause the named file to be loaded.
TEXT: H
TEXT: 

SUBJECT: dasht
TITLE: -t
TEXT: 
TEXT:      G-t term
TEXT: H          HThe program is being run on a terminal with MFB name
TEXT: H          GtermH.  (MFB is the graphics package used for dumb
TEXT: H          graphics terminals.) Note that MFB names are often not
TEXT: H          the same as _t_e_r_m_c_a_p names, so this option is needed to
TEXT: H          override the TERM environment variable.
TEXT: H
TEXT: 

SUBJECT: bugs
TITLE: Bugs
TEXT: 
TEXT:      The label entry facilities are very primitive - after all,
TEXT: H     Gnutmeg Hisn't a graphics editor (yet).  You must be careful
TEXT: H     to type very slowly when entering labels -- Gnutmeg Hchecks
TEXT: H     the GX Hevent queue once every second, and can get very con-
TEXT: H     fused if characters arrive faster than that.
TEXT: H
TEXT:      When defining aliases like
TEXT: H
TEXT:           Galias Hpdb Gplot dbH( '!:1' - '!:2' )
TEXT: H
TEXT:      you must be careful to quote the argument list substitutions
TEXT: H     in this manner. If you quote the whole argument it might not
TEXT: H     work properly.
TEXT: H
TEXT:      In a user-defined function, the arguments cannot be part of
TEXT: H     a name that uses the _p_l_o_t._v_e_c syntax.  I.e,
TEXT: H
TEXT:           Gdefine Hpoke(duck) GcosH(tran1.duck)
TEXT: H
TEXT:      won't do the right thing.
TEXT: H
TEXT:      If you type Gplot all allH, or otherwise use a wildcard refer-
TEXT: H     ence for one plot twice in a command, bad things will hap-
TEXT: H     pen.
TEXT: H
TEXT:      The Gasciiplot Hcommand doesn't deal with log scales or most
TEXT: H     of the keywords that Gplot Hrecognises.  Don't expect it to
TEXT: H     ever do smith charts.
TEXT: H
TEXT:      When a new vector is created with the G[ ] Hand G[[ ]] Hopera-
TEXT: H     tions, a subset of the old scale should also be created for
TEXT: H     it that includes the same elements, so that it may be plot-
TEXT: H     ted, etc.
TEXT: H
TEXT:      When substitutions are done with the ^_o_l_d^_n_e_w^ syntax, there
TEXT: H     may be no spaces in either _o_l_d or _n_e_w.
TEXT: H
TEXT:      If the user erases text in an X plot window by typing spaces
TEXT: H     over it, and then dumps it to a file with the Ghardcopy Hcom-
TEXT: H     mand, the erased text will re-appear.
TEXT: H
TEXT:      If an X plot window is created and then resized to be much
TEXT: H     larger, or the Ghardcopy Hcommand is used to dump it to a file
TEXT: H     and it is then printed on a device with much higher resolu-
TEXT: H     tion than the X display, the "automatic manhattanization"
TEXT: H     feature (i.e, round-off error) will cause the picture to
TEXT: H     look very funny.
TEXT: H
TEXT:      SPICE3 will recognise all the notations used in SPICE2 G.plot
TEXT: H     Hcards, and will translate Gvp(1) Hinto Gph(v(1))H, and so forth.
TEXT: H     However, if there are spaces in these names it won't work.
TEXT: H     Hence Gv(1, 2) Hand G(-.5, .5) Haren't recognised.
TEXT: H
TEXT:      The "nutmeg programming language" should serve as a lesson
TEXT: H     on why a language designer should understand that he is
TEXT: H     creating a language before he has already implemented it.
TEXT: H
TEXT:      If a command is implemented as a script, the Ghelp Hcommand
TEXT: H     won't say anything about it and it won't be available for
TEXT: H     command and argument completion.
TEXT: H
TEXT:      If you plot an expression containing the function GrndH, and
TEXT: H     then zoom in or out in the window, you will get different
TEXT: H     random numbers in the new window.
TEXT: H
TEXT:      Global filename expansion has some problems.  In particular,
TEXT: H     G*/* Hmay give a result of "No match" when there is a file in
TEXT: H     the current directory.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:caveats

SUBJECT: caveats
TITLE: Caveats
TEXT: 
TEXT:      Often the names of terminals recognised by GMFB Hare different
TEXT: H     from those in /etc/termcap. Thus you may have to reset your
TEXT: H     terminal type with the command
TEXT: H
TEXT:           Gset Hterm = _t_e_r_m_n_a_m_e
TEXT: H
TEXT:      where _t_e_r_m_n_a_m_e is the name in the Gmfbcap Hfile.
TEXT: H
TEXT:      The Ghardcopy Hcommand is useless on VMS and other systems
TEXT: H     without the UNIX Gplot Hcommand, unless the user has a program
TEXT: H     that understands _p_l_o_t(_5) format.
TEXT: H
TEXT:      GSpice Hinput files specified on the command line are read in
TEXT: H     before theG.spiceinit Hfile is read. Thus if you define
TEXT: H     aliases there that you call in a Gspice Hsource file mentioned
TEXT: H     on the command line, they won't be recognised.
TEXT: H
TEXT:      If you interrupt a simulation and then load in a new deck,
TEXT: H     or Gsetcirc Hto a different one, and run a simulation on that,
TEXT: H     it will not be possible to Gresume Hthe old simulation.
TEXT: H
TEXT:      Don't trust command completion too much.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:bugs

SUBJECT: commands
TITLE: Built-in Commands
TEXT: 
TEXT:      When a command is typed, it is interpreted as one of several
TEXT: H     things.  First, it may be an alias, in which case the line
TEXT: H     is replaced with the result after alias substitution, and
TEXT: H     the line is re-parsed.  Second, it may be a pre-defined com-
TEXT: H     mand, in which case it is executed (see below for a list of
TEXT: H     available commands).  Third, it may be the name of a circuit
TEXT: H     file, in which case it is loaded (if the program is GspiceH)
TEXT: H     as if with a Gsource Hcommand.  Fourth, it may be the name of
TEXT: H     a command script - Gnutmeg Hsearches the current Gsourcepath
TEXT: H     Hfor the file and executes it when it is found.  The effect
TEXT: H     of this is identical to the effect of Gsouce fileH, except
TEXT: H     that the variables Gargc Hand Gargv Hare set.  Fifth, it may be
TEXT: H     an assignment statement, which consists of a vector name, an
TEXT: H     G= Hsymbol, and an expression (see the syntax for the Glet Hcom-
TEXT: H     mand), in which case it is executed as if it were preceeded
TEXT: H     by the word GletH.  Finally, it may be a UNIX command, in
TEXT: H     which case if the variable Gunixcom His set, it is executed as
TEXT: H     though it were typed to the shell.  (This is only available
TEXT: H     on BSD UNIX systems.)
TEXT: H
TEXT:      The following is a list of the built-in commands available.
TEXT: H     Some may be command scripts - the only difference between a
TEXT: H     built-in and a script that is visible to the user is that a
TEXT: H     script will not be mentioned in the quick help summary, and
TEXT: H     will not be visible to command completion.
TEXT: H
TEXT: 
SUBTOPIC: SPICE:ac NUTMEG:alias NUTMEG:alter
SUBTOPIC: NUTMEG:asciiplot SPICE:aspice NUTMEG:break
SUBTOPIC: NUTMEG:bug NUTMEG:cd NUTMEG:cdump
SUBTOPIC: NUTMEG:compose NUTMEG:continue NUTMEG:cross
SUBTOPIC: SPICE:dc NUTMEG:define NUTMEG:deftype
SUBTOPIC: SPICE:delete NUTMEG:destroy NUTMEG:diff
SUBTOPIC: NUTMEG:display NUTMEG:dowhile NUTMEG:dump
SUBTOPIC: NUTMEG:echo NUTMEG:edit NUTMEG:else
SUBTOPIC: NUTMEG:end NUTMEG:foreach NUTMEG:fourier
SUBTOPIC: NUTMEG:goto NUTMEG:hardcopy NUTMEG:help
SUBTOPIC: NUTMEG:historycomm NUTMEG:if SPICE:iplot
SUBTOPIC: NUTMEG:jobs NUTMEG:label NUTMEG:let
SUBTOPIC: NUTMEG:linearize SPICE:listing NUTMEG:load
SUBTOPIC: NUTMEG:oldhelp SPICE:op NUTMEG:plot
SUBTOPIC: NUTMEG:print SPICE NUTMEG:quit
SUBTOPIC: NUTMEG:rehash NUTMEG:repeat SPICE:reset
SUBTOPIC: SPICE:resume SPICE:rspice SPICE:run
SUBTOPIC: NUTMEG:rusage SPICE:save NUTMEG:set
SUBTOPIC: SPICE:setcirc NUTMEG:setplot NUTMEG:settype
SUBTOPIC: NUTMEG:shell NUTMEG:shift NUTMEG:show
SUBTOPIC: NUTMEG:source NUTMEG:state NUTMEG:status
SUBTOPIC: SPICE:step SPICE:stop NUTMEG:strcmp
SUBTOPIC: SPICE:trace SPICE:tran NUTMEG:unalias
SUBTOPIC: NUTMEG:undefine NUTMEG:unlet NUTMEG:unset
SUBTOPIC: NUTMEG:version NUTMEG:while NUTMEG:write

SEEALSO: NUTMEG:proglang

SUBJECT: alias
TITLE: alias
TEXT: 
TEXT:      Galias H[ _w_o_r_d ] [ _t_e_x_t ]
TEXT: H          Cause _w_o_r_d to be aliased to _t_e_x_t.  Whenever a command
TEXT: H          line beginning with _w_o_r_d is typed, _t_e_x_t is substituted.
TEXT: H          Arguments are either appended to the end, or substi-
TEXT: H          tuted in if history characters are present in the _t_e_x_t.
TEXT: H          See the description of "C-shell like features".
TEXT: H
TEXT: 
SEEALSO: NUTMEG:unalias
SEEALSO: NUTMEG:aliases

SUBJECT: alter
TITLE: alter
TEXT: 
TEXT:      Galter H_a_r_g_s...
TEXT: H          Change the parameters of a device while a simulation is
TEXT: H          in progress.  This command is not yet implemented.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:show

SUBJECT: asciiplot
TITLE: asciiplot
TEXT: 
TEXT:      Gasciiplot H_p_l_o_t_a_r_g_s
TEXT: H          Produce a line printer plot of the vectors.  See the
TEXT: H          description of the Gplot Hcommand for the syntax of _p_l_o_-
TEXT: H          _t_a_r_g_s.  The plot is sent to the standard output, so you
TEXT: H          can put it into a file with Gasciiplot H_a_r_g_s G> H_f_i_l_e.  The
TEXT: H          variables Gwidth, height, Hand Gnobreak Hdetermine the
TEXT: H          width and height of the plot, and whether there are
TEXT: H          page breaks, respectively. Note that you will have
TEXT: H          problems if you try to Gasciiplot Hsomething with an X-
TEXT: H          scale that isn't monotonic (i.e, something like
TEXT: H          _s_i_n(_T_I_M_E) ), because Gasciiplot Huses a simple-minded
TEXT: H          sort of linear interpolation.  Also, most of the key-
TEXT: H          words that Gplot Hrecognises aren't used by GasciiplotH.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:plot
SEEALSO: NUTMEG:hardcopy
SEEALSO: NUTMEG:width
SEEALSO: NUTMEG:height
SEEALSO: NUTMEG:noasciiplotvalue
SEEALSO: NUTMEG:nobreak
SEEALSO: NUTMEG:expressions

SUBJECT: break
TITLE: break
TEXT: 
TEXT:      Gbreak H[ _n_u_m_b_e_r ]
TEXT: H          If there is a Gwhile, dowhile, Hor Gforeach Hblock enclos-
TEXT: H          ing this statement, control passes out of the block.
TEXT: H          Otherwise an error results.  If a _n_u_m_b_e_r is given, that
TEXT: H          number of enclosing blocks are exited.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:proglang

SUBJECT: bug
TITLE: bug
TEXT: 
TEXT:      Gbug  HThis sends a bug report to the maintainer of SPICE3, if
TEXT: H          it has been compiled with the BUGADDR option.
TEXT: H
TEXT: 

SUBJECT: cd
TITLE: cd
TEXT: 
TEXT:      Gcd H[ _d_i_r_e_c_t_o_r_y ]
TEXT: H          Change the current working directory to _d_i_r_e_c_t_o_r_y, or
TEXT: H          the user's home directory if none is given.
TEXT: H
TEXT: 

SUBJECT: cdump
TITLE: cdump
TEXT: 
TEXT:      Gcdump
TEXT: H          HThis is a debugging command for printing out the con-
TEXT: H          tents of the currently active control structures.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:proglang

SUBJECT: compose
TITLE: compose
TEXT: 
TEXT:      Gcompose H_v_e_c_n_a_m_e [ _p_a_r_a_m = _v_a_l_u_e ] ...
TEXT: H          or
TEXT: H
TEXT:      Gcompose H_v_e_c_n_a_m_e Gvalues H_v_a_l_u_e ...
TEXT: H          Both forms of this command create a new vector called
TEXT: H          _v_e_c_n_a_m_e.  In the first form, the values in the vector