nutmeg.txt

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

TEXT: H             Glt   Hor   G<    H(less than)
TEXT: H             Gge   Hor   G>=   H(greater than or equal to)
TEXT: H             Gle   Hor   G<=   H(less than or equal to)
TEXT: H
TEXT:           Note that for this command, < and > do not denote IO
TEXT: H          redirection.
TEXT: H
TEXT: 
SEEALSO: SPICE:step
SEEALSO: SPICE:iplot
SEEALSO: SPICE:delete
SEEALSO: NUTMEG:status

SUBJECT: strcmp
TITLE: strcmp
TEXT: 
TEXT:      Gstrcmp H_v_a_r_n_a_m_e _s_t_r_i_n_g_1 _s_t_r_i_n_g_2
TEXT: H          The value of _v_a_r_n_a_m_e is set to a number that is greater
TEXT: H          than, equal to, or less than 0 according as _s_t_r_i_n_g_1 is
TEXT: H          lexically before, equal to, or after _s_t_r_i_n_g_2.  This
TEXT: H          command is a very bad thing, but there seems to be no
TEXT: H          other way to do string comparisons given the restric-
TEXT: H          tions of the Gnutmeg Hcommand language.
TEXT: H
TEXT: 

SUBJECT: unalias
TITLE: unalias
TEXT: 
TEXT:      Gunalias H[ _w_o_r_d ] ...
TEXT: H          Removes any aliases associated with all the _w_o_r_ds.  The
TEXT: H          argument may be "*", in which case all aliases are
TEXT: H          deleted.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:alias
SEEALSO: NUTMEG:aliases

SUBJECT: undefine
TITLE: undefine
TEXT: 
TEXT:      Gundefine H[ _w_o_r_d ] ...
TEXT: H          Remove all the macro functions defined for the _w_o_r_ds.
TEXT: H          If the argument is "*", then all macro functions are
TEXT: H          deleted.  Note that all functions with the given names
TEXT: H          are removed, so there is no way to delete a function
TEXT: H          with a particular arity without deleting all functions
TEXT: H          with that name.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:define
SEEALSO: NUTMEG:expressions

SUBJECT: unlet
TITLE: unlet
TEXT: 
TEXT:      Gunlet H[ _v_e_c_n_a_m_e ] ...
TEXT: H          All the named vectors are removed from the current
TEXT: H          plot.  If you Gunlet Ha vector which is the default scale
TEXT: H          (e.g. GTIMEH), a random remaining vector will become the
TEXT: H          default scale.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:let

SUBJECT: unset
TITLE: unset
TEXT: 
TEXT:      Gunset H[ _v_a_r_n_a_m_e ] ...
TEXT: H          All the named variables are unset.  The argument may be
TEXT: H          "*", in which case all variables are unset (although
TEXT: H          this is usually not something that you would want to
TEXT: H          do).
TEXT: H
TEXT: 
SEEALSO: NUTMEG:set
SEEALSO: NUTMEG:variablesub
SEEALSO: NUTMEG:variables

SUBJECT: version
TITLE: version
TEXT: 
TEXT:      Gversion H[ _v_e_r_s_i_o_n _n_a_m_e ]
TEXT: H          With no arguments, this command prints out the current
TEXT: H          version of GspiceH.  If there are arguments, it compares
TEXT: H          the current version with the given version and prints a
TEXT: H          warning if they differ.  A Gversion Hcommand is usually
TEXT: H          included in the rawfile.
TEXT: H
TEXT: 

SUBJECT: while
TITLE: while
TEXT: 
TEXT:      Gwhile H_c_o_n_d_i_t_i_o_n
TEXT: H          This command defines a block which is executed while
TEXT: H          the condition is true.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:proglang

SUBJECT: write
TITLE: write
TEXT: 
TEXT:      Gwrite H[ _f_i_l_e [ _e_x_p_r ] ... ]
TEXT: H          Writes out the _e_x_p_rs to the file.  First vectors are
TEXT: H          grouped together by plots, and written out as such.
TEXT: H          (E.g, if the expression list contained three vectors
TEXT: H          from one plot and two from another, then two plots will
TEXT: H          be written, one with three vectors and one with two.)
TEXT: H          Additionally, if the scale for a vector isn't present,
TEXT: H          it is automatically written out as well.  The default
TEXT: H          format is GasciiH, but this may be changed with Gset file-
TEXT: H          typeH.  The default filename is GrawspiceH, or the argu-
TEXT: H          ment to the G-r Hflag on the command line, if there was
TEXT: H          one, and the default expression list is GallH.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:load
SEEALSO: NUTMEG:expressions

SUBJECT: cshstuff
TITLE: C-shell Like Features
TEXT: 
TEXT:      Various features are available in the Gnutmeg Hparser which
TEXT: H     are derived from the user interface of the C-Shell.  These
TEXT: H     include IO redirection, history substitution, aliases, glo-
TEXT: H     bal substitution, and command completion.
TEXT: H
TEXT: 
SUBTOPIC: NUTMEG:aliases NUTMEG:ccom NUTMEG:glob
SUBTOPIC: NUTMEG:historysub NUTMEG:io NUTMEG:quoting
SUBTOPIC: NUTMEG:semi NUTMEG:unixcomcomm NUTMEG:variablesub


SUBJECT: aliases
TITLE: Aliases
TEXT: 
TEXT:      After history expansion, if the first word on the command
TEXT: H     line has been defined as an alias, the text for which it is
TEXT: H     an alias for is substituted.  The alias may contain refer-
TEXT: H     ences to the arguments provided on the command line, in
TEXT: H     which case the appropriate arguments are substituted in.  If
TEXT: H     there are no such references, any arguments given are
TEXT: H     appended to the end of the alias text.
TEXT: H
TEXT:      In the body if the alias text, any strings of the form
TEXT: H     G!:H_n_u_m_b_e_r are replaced with the _n_u_m_b_e_r'th argument of the
TEXT: H     actual command line.  Note that when the alias is defined
TEXT: H     with the Galias Hcommand, these strings must be quoted to
TEXT: H     prevent history substitution from replacing the G!H's before
TEXT: H     the Galias Hcommand can get to them.
TEXT: H
TEXT:      Thus the command
TEXT: H
TEXT:           Galias Hfoo Gecho H'!:2' '!:1'
TEXT: H
TEXT:      Causes "foo bar baz" to be replaced with "echo baz bar".
TEXT: H     Other G!  Hmodifiers as described in the section on history
TEXT: H     substitution may also be used, always refering to the actual
TEXT: H     command line arguments given.
TEXT: H
TEXT:      If a command line starts with a backslash (`\') any alias
TEXT: H     substitution is inhibited.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:alias
SEEALSO: NUTMEG:unalias

SUBJECT: ccom
TITLE: Command Completion
TEXT: 
TEXT:      With BSD UNIX, Tenex-style command completion is available.
TEXT: H     If GEOF H(control-D) is typed after the first character on the
TEXT: H     line, a list of the commands or possible arguments is
TEXT: H     printed. (If a control-D is typed as the first character on
TEXT: H     a line it will exit the program.) If an escape is typed,
TEXT: H     then the program will try to complete the word being typed
TEXT: H     based on the choices available, or if there is more than one
TEXT: H     posibility, it will complete as much as it can.  Command
TEXT: H     completion knows about commands, most keywords, variable and
TEXT: H     vector names, file names, and several other types of argu-
TEXT: H     ments.
TEXT: H
TEXT: 
SEEALSO: SPICE:dashq

SUBJECT: glob
TITLE: Global Substitution
TEXT: 
TEXT:      The characters `~', `{', and `}' have the same effects as
TEXT: H     they do in the C-Shell, i.e., home directory and alternative
TEXT: H     expansion.  The string ~_u_s_e_r at the beginning of a word is
TEXT: H     replaced by the given user's home directory, or if the first
TEXT: H     component of the pathname is simply ~, the current user's
TEXT: H     directory is used.  The string
TEXT: H     _S_t_u_f_fG{H_S_t_r_i_n_g_1,_S_t_r_i_n_g_2,..._S_t_r_i_n_g_NG}H_M_o_r_e_s_t_u_f_f is replaced by
TEXT: H     the list of words _S_t_u_f_f_S_t_r_i_n_g_1_M_o_r_e_s_t_u_f_f
TEXT: H     _S_t_u_f_f_S_t_r_i_n_g_2_M_o_r_e_s_t_u_f_f ...  _S_t_u_f_f_S_t_r_i_n_g_N_M_o_r_e_s_t_u_f_f.  Curly
TEXT: H     braces may be nested.  It is possible to use the wildcard
TEXT: H     characters G`*'H, G`?'H, G`['H, and G`]' Hto match filenames, where
TEXT: H     G`*' Hdenotes 0 or more characters, G`?' Hdenotes one character,
TEXT: H     and G[] Hdenotes a range of characters, but only if you Gunset
TEXT: H     noglob Hfirst. This makes them rather useless for typing
TEXT: H     algebraic expressions, so you should Gset noglob Hagain after
TEXT: H     you are done with wildcard expansion. Note that the pattern
TEXT: H     G[^abc] Hwill match all characters _e_x_c_e_p_t G`a', `b', Hand G`c'.
TEXT: H     HIdeally the parser should know which commands require
TEXT: H     filename arguments in which positions, and so glob expansion
TEXT: H     for those words only.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:noglob

SUBJECT: historysub
TITLE: History Substitution
TEXT: 
TEXT:      History substitutions are prefixed by the character G!H, or at
TEXT: H     the beginning of a line, the character G^H. Briefly, the
TEXT: H     string G!! His replaced by the previous command, the string
TEXT: H     G!H_p_r_e_f_i_x is replaced by the last command with that prefix,
TEXT: H     the string G!?H_p_a_t_t_e_r_n is replaced by the last command con-
TEXT: H     taining that pattern, the string G!H_n_u_m_b_e_r is replaced by the
TEXT: H     event with that number, and G^H_o_l_d_p_a_t_t_e_r_nG^H_n_e_w_p_a_t_t_e_r_n is
TEXT: H     replaced by the previous command with _n_e_w_p_a_t_t_e_r_n substituted
TEXT: H     for _o_l_d_p_a_t_t_e_r_n.
TEXT: H
TEXT:      Additionally, a G!H_s_t_r_i_n_g sequence may be followed by a modif-
TEXT: H     ier prefixed with a G:H.  This modifier may select one or more
TEXT: H     words from the event - :_1 selects the first word, :_2-_5
TEXT: H     selects the second through the fifth word, :$ selects the
TEXT: H     last word, and :$-_0 selects all of the words but reverses
TEXT: H     their order.
TEXT: H
TEXT:      Two other G: Hmodifiers are supported: :_p will cause the com-
TEXT: H     mand to be printed but not executed, and :_s^_o_l_d^_n_e_w will
TEXT: H     replace the pattern _o_l_d with the pattern _n_e_w.  (The sequence
TEXT: H     ^_o_l_d^_n_e_w is synonymous with !!:_s^_o_l_d^_n_e_w.)
TEXT: H
TEXT:      All the commands typed by the user are saved on the _h_i_s_t_o_r_y
TEXT: H     _l_i_s_t.  This may be examined with the Ghistory Hcommand, and
TEXT: H     its maximum length changed by changing the value of the Ghis-
TEXT: H     tory Hvariable.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:historyvar

SUBJECT: io
TITLE: I/O Redirection
TEXT: 
TEXT:      The input to or output from commands may be changed from the
TEXT: H     terminal to a file by including an IO redirection on the
TEXT: H     command line.  The possible redirections are:
TEXT: H
TEXT:      > _f_i_l_e
TEXT: H          Sends the output of the command into the _f_i_l_e.
TEXT: H
TEXT:      >> _f_i_l_e
TEXT: H          Appends output to the _f_i_l_e or creates it if it doesn't
TEXT: H          exist.
TEXT: H
TEXT:      >& _f_i_l_e
TEXT: H          Sends both the output and the error messages to the
TEXT: H          _f_i_l_e.
TEXT: H
TEXT:      >>& _f_i_l_e
TEXT: H          Appends both the output and the error messages to the
TEXT: H          _f_i_l_e.
TEXT: H
TEXT:      < _f_i_l_e
TEXT: H          Reads input from the _f_i_l_e.
TEXT: H
TEXT:      Both an input redirection and an output redirection may be
TEXT: H     present on a command line.  More than one of each may not be
TEXT: H     present, however.  IO redirections must be at the end of the
TEXT: H     command line.
TEXT: H
TEXT: 

SUBJECT: quoting
TITLE: Quoting
TEXT: 
TEXT:      Words may be quoted with the characters " (double quote), '
TEXT: H     (single quote), and ` (back quote).   A word enclosed by any
TEXT: H     of these quotes may contain white space.  A string enclosed
TEXT: H     by double quotes may have further special-character substi-
TEXT: H     tutions done on it, but it will be considered one word by
TEXT: H     the program.  A number so quoted is considered a string.  A
TEXT: H     string enclosed by single quotes also has all its special
TEXT: H     characters protected.  Thus no glob expansion (*, ?, etc),
TEXT: H     variable expansion ($), or history substitution (^, !) will
TEXT: H     be done.  Numbers are still considered numbers though.  A
TEXT: H     string enclosed by backquotes is considered a command to the
TEXT: H     shell and is executed, and the output of the command
TEXT: H     repalaces the text.  Obviously the command should not gen-
TEXT: H     erate too much output.  This only works on UNIX systems.
TEXT: H
TEXT: 

SUBJECT: semi
TITLE: Multiple Commands
TEXT: 
TEXT:      More than one command may be put on one line, seperated by
TEXT: H     semicolins (;).  The semicolins must be isolated by white
TEXT: H     space, however.  Thus a multi-command alias might be written
TEXT: H     _a_l_i_a_s _w_o_r_d '_c_o_m_m_a_n_d_1 ; _c_o_m_m_a_n_d_2 ; ...'.
TEXT: H
TEXT: 

SUBJECT: unixcomcomm
TITLE: UNIX Commands
TEXT: 
TEXT:      If the variable Gunixcom His set and the operating system is
TEXT: H     BSD UNIX, commands which are not built-ins are considered
TEXT: H     UNIX commands and executed as if the program were a shell.
TEXT: H     However, using this option increases the start-up time of
TEXT: H     the program a lot.  Probably Gspice Hshould not be used as a
TEXT: H     login shell.
TEXT: H
TEXT: 
SEEALSO: NUTMEG:unixcom
SEEALSO: NUTMEG:commands

SUBJECT: variablesub
TITLE: Variable Substitution
TEXT: 
TEXT:      The values of variables may be used in commands by writing
TEXT: H     G$varname Hwhere the value of the variable is to appear.  The
TEXT: H     special variables $$ and $< refer to the process ID of the
TEXT: H     program and a line of input which is read from the terminal
TEXT: H     when the variable is evaluated, respectively.  If a variable
TEXT: H     has a name of the form $&_w_o_r_d, then _w_o_r_d is considered a
TEXT: H     vector, and its value is taken to be the value of the vari-
TEXT: H     able.  If $_f_o_o is a valid variable, and is of type GlistH,
TEXT: H     then the expression $_f_o_o[_l_o_w-_h_i