home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / alt / sources / 3086 < prev    next >
Encoding:
Internet Message Format  |  1993-01-25  |  44.9 KB
  1. Path: sparky!uunet!wupost!darwin.sura.net!ukma!cs.widener.edu!dsinc!ub!galileo.cc.rochester.edu!ee.rochester.edu!rbc!al
  2. From: al@rbc.uucp (Al Davis)
  3. Newsgroups: alt.sources
  4. Subject: ACS  circuit simulator  part 02/20
  5. Message-ID: <1993Jan25.052006.4545@rbc.uucp>
  6. Date: 25 Jan 93 05:20:06 GMT
  7. Sender: al@rbc.uucp (Al Davis)
  8. Organization: Huh?
  9. Lines: 1178
  10.  
  11. #! /bin/sh
  12. # This is a shell archive, meaning:
  13. # 1. Remove everything above the #! /bin/sh line.
  14. # 2. Save the resulting text in a file.
  15. # 3. Execute the file with /bin/sh (not csh) to create the files:
  16. #    doc/COPYING
  17. #    doc/FUTURE
  18. #    doc/INSTALLATION
  19. #    doc/acs.hlp
  20. # This archive created: Mon Jan 25 00:17:42 1993
  21. export PATH; PATH=/bin:$PATH
  22. if test -f 'doc/COPYING'
  23. then
  24.     echo shar: will not over-write existing file "'doc/COPYING'"
  25. else
  26. cat << \SHAR_EOF > 'doc/COPYING'
  27.  
  28.             GNU GENERAL PUBLIC LICENSE
  29.              Version 1, February 1989
  30.  
  31.  Copyright (C) 1989 Free Software Foundation, Inc.
  32.                     675 Mass Ave, Cambridge, MA 02139, USA
  33.  Everyone is permitted to copy and distribute verbatim copies
  34.  of this license document, but changing it is not allowed.
  35.  
  36.                 Preamble
  37.  
  38.   The license agreements of most software companies try to keep users
  39. at the mercy of those companies.  By contrast, our General Public
  40. License is intended to guarantee your freedom to share and change free
  41. software--to make sure the software is free for all its users.  The
  42. General Public License applies to the Free Software Foundation's
  43. software and to any other program whose authors commit to using it.
  44. You can use it for your programs, too.
  45.  
  46.   When we speak of free software, we are referring to freedom, not
  47. price.  Specifically, the General Public License is designed to make
  48. sure that you have the freedom to give away or sell copies of free
  49. software, that you receive source code or can get it if you want it,
  50. that you can change the software or use pieces of it in new free
  51. programs; and that you know you can do these things.
  52.  
  53.   To protect your rights, we need to make restrictions that forbid
  54. anyone to deny you these rights or to ask you to surrender the rights.
  55. These restrictions translate to certain responsibilities for you if you
  56. distribute copies of the software, or if you modify it.
  57.  
  58.   For example, if you distribute copies of a such a program, whether
  59. gratis or for a fee, you must give the recipients all the rights that
  60. you have.  You must make sure that they, too, receive or can get the
  61. source code.  And you must tell them their rights.
  62.  
  63.   We protect your rights with two steps: (1) copyright the software, and
  64. (2) offer you this license which gives you legal permission to copy,
  65. distribute and/or modify the software.
  66.  
  67.   Also, for each author's protection and ours, we want to make certain
  68. that everyone understands that there is no warranty for this free
  69. software.  If the software is modified by someone else and passed on, we
  70. want its recipients to know that what they have is not the original, so
  71. that any problems introduced by others will not reflect on the original
  72. authors' reputations.
  73.  
  74.   The precise terms and conditions for copying, distribution and
  75. modification follow.
  76.  
  77.             GNU GENERAL PUBLIC LICENSE
  78.    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  79.  
  80.   0. This License Agreement applies to any program or other work which
  81. contains a notice placed by the copyright holder saying it may be
  82. distributed under the terms of this General Public License.  The
  83. "Program", below, refers to any such program or work, and a "work based
  84. on the Program" means either the Program or any work containing the
  85. Program or a portion of it, either verbatim or with modifications.  Each
  86. licensee is addressed as "you".
  87.  
  88.   1. You may copy and distribute verbatim copies of the Program's source
  89. code as you receive it, in any medium, provided that you conspicuously and
  90. appropriately publish on each copy an appropriate copyright notice and
  91. disclaimer of warranty; keep intact all the notices that refer to this
  92. General Public License and to the absence of any warranty; and give any
  93. other recipients of the Program a copy of this General Public License
  94. along with the Program.  You may charge a fee for the physical act of
  95. transferring a copy.
  96.  
  97.   2. You may modify your copy or copies of the Program or any portion of
  98. it, and copy and distribute such modifications under the terms of Paragraph
  99. 1 above, provided that you also do the following:
  100.  
  101.     a) cause the modified files to carry prominent notices stating that
  102.     you changed the files and the date of any change; and
  103.  
  104.     b) cause the whole of any work that you distribute or publish, that
  105.     in whole or in part contains the Program or any part thereof, either
  106.     with or without modifications, to be licensed at no charge to all
  107.     third parties under the terms of this General Public License (except
  108.     that you may choose to grant warranty protection to some or all
  109.     third parties, at your option).
  110.  
  111.     c) If the modified program normally reads commands interactively when
  112.     run, you must cause it, when started running for such interactive use
  113.     in the simplest and most usual way, to print or display an
  114.     announcement including an appropriate copyright notice and a notice
  115.     that there is no warranty (or else, saying that you provide a
  116.     warranty) and that users may redistribute the program under these
  117.     conditions, and telling the user how to view a copy of this General
  118.     Public License.
  119.  
  120.     d) You may charge a fee for the physical act of transferring a
  121.     copy, and you may at your option offer warranty protection in
  122.     exchange for a fee.
  123.  
  124. Mere aggregation of another independent work with the Program (or its
  125. derivative) on a volume of a storage or distribution medium does not bring
  126. the other work under the scope of these terms.
  127.  
  128.   3. You may copy and distribute the Program (or a portion or derivative of
  129. it, under Paragraph 2) in object code or executable form under the terms of
  130. Paragraphs 1 and 2 above provided that you also do one of the following:
  131.  
  132.     a) accompany it with the complete corresponding machine-readable
  133.     source code, which must be distributed under the terms of
  134.     Paragraphs 1 and 2 above; or,
  135.  
  136.     b) accompany it with a written offer, valid for at least three
  137.     years, to give any third party free (except for a nominal charge
  138.     for the cost of distribution) a complete machine-readable copy of the
  139.     corresponding source code, to be distributed under the terms of
  140.     Paragraphs 1 and 2 above; or,
  141.  
  142.     c) accompany it with the information you received as to where the
  143.     corresponding source code may be obtained.  (This alternative is
  144.     allowed only for noncommercial distribution and only if you
  145.     received the program in object code or executable form alone.)
  146.  
  147. Source code for a work means the preferred form of the work for making
  148. modifications to it.  For an executable file, complete source code means
  149. all the source code for all modules it contains; but, as a special
  150. exception, it need not include source code for modules which are standard
  151. libraries that accompany the operating system on which the executable
  152. file runs, or for standard header files or definitions files that
  153. accompany that operating system.
  154.  
  155.   4. You may not copy, modify, sublicense, distribute or transfer the
  156. Program except as expressly provided under this General Public License.
  157. Any attempt otherwise to copy, modify, sublicense, distribute or transfer
  158. the Program is void, and will automatically terminate your rights to use
  159. the Program under this License.  However, parties who have received
  160. copies, or rights to use copies, from you under this General Public
  161. License will not have their licenses terminated so long as such parties
  162. remain in full compliance.
  163.  
  164.   5. By copying, distributing or modifying the Program (or any work based
  165. on the Program) you indicate your acceptance of this license to do so,
  166. and all its terms and conditions.
  167.  
  168.   6. Each time you redistribute the Program (or any work based on the
  169. Program), the recipient automatically receives a license from the original
  170. licensor to copy, distribute or modify the Program subject to these
  171. terms and conditions.  You may not impose any further restrictions on the
  172. recipients' exercise of the rights granted herein.
  173.  
  174.   7. The Free Software Foundation may publish revised and/or new versions
  175. of the General Public License from time to time.  Such new versions will
  176. be similar in spirit to the present version, but may differ in detail to
  177. address new problems or concerns.
  178.  
  179. Each version is given a distinguishing version number.  If the Program
  180. specifies a version number of the license which applies to it and "any
  181. later version", you have the option of following the terms and conditions
  182. either of that version or of any later version published by the Free
  183. Software Foundation.  If the Program does not specify a version number of
  184. the license, you may choose any version ever published by the Free Software
  185. Foundation.
  186.  
  187.   8. If you wish to incorporate parts of the Program into other free
  188. programs whose distribution conditions are different, write to the author
  189. to ask for permission.  For software which is copyrighted by the Free
  190. Software Foundation, write to the Free Software Foundation; we sometimes
  191. make exceptions for this.  Our decision will be guided by the two goals
  192. of preserving the free status of all derivatives of our free software and
  193. of promoting the sharing and reuse of software generally.
  194.  
  195.                 NO WARRANTY
  196.  
  197.   9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  198. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  199. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  200. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  201. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  202. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  203. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  204. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  205. REPAIR OR CORRECTION.
  206.  
  207.   10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  208. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  209. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  210. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  211. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  212. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  213. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  214. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  215. POSSIBILITY OF SUCH DAMAGES.
  216.  
  217.              END OF TERMS AND CONDITIONS
  218.  
  219.     Appendix: How to Apply These Terms to Your New Programs
  220.  
  221.   If you develop a new program, and you want it to be of the greatest
  222. possible use to humanity, the best way to achieve this is to make it
  223. free software which everyone can redistribute and change under these
  224. terms.
  225.  
  226.   To do so, attach the following notices to the program.  It is safest to
  227. attach them to the start of each source file to most effectively convey
  228. the exclusion of warranty; and each file should have at least the
  229. "copyright" line and a pointer to where the full notice is found.
  230.  
  231.     <one line to give the program's name and a brief idea of what it does.>
  232.     Copyright (C) 19yy  <name of author>
  233.  
  234.     This program is free software; you can redistribute it and/or modify
  235.     it under the terms of the GNU General Public License as published by
  236.     the Free Software Foundation; either version 1, or (at your option)
  237.     any later version.
  238.  
  239.     This program is distributed in the hope that it will be useful,
  240.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  241.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  242.     GNU General Public License for more details.
  243.  
  244.     You should have received a copy of the GNU General Public License
  245.     along with this program; if not, write to the Free Software
  246.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  247.  
  248. Also add information on how to contact you by electronic and paper mail.
  249.  
  250. If the program is interactive, make it output a short notice like this
  251. when it starts in an interactive mode:
  252.  
  253.     Gnomovision version 69, Copyright (C) 19xx name of author
  254.     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  255.     This is free software, and you are welcome to redistribute it
  256.     under certain conditions; type `show c' for details.
  257.  
  258. The hypothetical commands `show w' and `show c' should show the
  259. appropriate parts of the General Public License.  Of course, the
  260. commands you use may be called something other than `show w' and `show
  261. c'; they could even be mouse-clicks or menu items--whatever suits your
  262. program.
  263.  
  264. You should also get your employer (if you work as a programmer) or your
  265. school, if any, to sign a "copyright disclaimer" for the program, if
  266. necessary.  Here a sample; alter the names:
  267.  
  268.   Yoyodyne, Inc., hereby disclaims all copyright interest in the
  269.   program `Gnomovision' (a program to direct compilers to make passes
  270.   at assemblers) written by James Hacker.
  271.  
  272.   <signature of Ty Coon>, 1 April 1989
  273.   Ty Coon, President of Vice
  274.  
  275. That's all there is to it!
  276. SHAR_EOF
  277. fi # end of overwriting check
  278. if test -f 'doc/FUTURE'
  279. then
  280.     echo shar: will not over-write existing file "'doc/FUTURE'"
  281. else
  282. cat << \SHAR_EOF > 'doc/FUTURE'
  283. Future direction of ACS:
  284.  
  285. As of now I have limited time to work in the program.  I have several 
  286. additional features working in other (internal buggy) versions of the
  287. program including:
  288.     Worst case, Monte carlo analysis.
  289.     Level 1 and 3 MOSFET models.
  290.     BJT models.
  291.     Fourier analysis.  (It doesn't work here.  It did.)
  292. Since the program was developed as a research tool, there are several
  293. other loose ends:
  294.     Truncation error checking on capacitors.
  295.     Better matrix ordering.  (Markowitz makes it worse.)
  296.     Full implementation of selective trace.
  297.     Roundoff error in incremental update.
  298.     Bypass of analog code in logic simulation.
  299.     
  300. I appreciate your input.  You can send comments by email
  301. to davis@ee.rochester.edu.
  302. SHAR_EOF
  303. fi # end of overwriting check
  304. if test -f 'doc/INSTALLATION'
  305. then
  306.     echo shar: will not over-write existing file "'doc/INSTALLATION'"
  307. else
  308. cat << \SHAR_EOF > 'doc/INSTALLATION'
  309. Installation notes:
  310.  
  311. Most of the development of ACS was done on a NeXT with Gnu C.
  312. It has also been compiled successfully with Microsoft C version
  313. 5.1.  It should compile with any ANSI C compiler.  It should 
  314. produce no warnings when compiled with the switches in the 
  315. supplied makefiles.
  316.  
  317. On a NeXT, type "make" from the src/Next directory.  This should
  318. build the executable.  Make will follow "VPATH" to find the sources.
  319.  
  320. On a PC, you should have some version of "make".  Copy the file
  321. "Makefile.msc" to "makefile" and type "make" from the directory
  322. containing the sources.
  323.  
  324. Older versions have been compiled and run on Sun, Alliant, and VAX
  325. (under Mt.Xinu).  I believe the only change necessary to compile on
  326. an older compiler is to remove the prototypes.  The best way is to
  327. use an ANSI compiler such as Gnu C.
  328.  
  329. On other systems, if your make supports VPATH, make a directory
  330. for the object files.  Copy "Makefile.base" there.  If your make
  331. supports includes, put the defines for CFLAGS, LDFLAGS, and LIBS
  332. in Makefile.dependencies.  Otherwise insert them in the makefile
  333. to replace the include.
  334.  
  335. You should place the file "acs.hlp" in the same directory with
  336. the executable.
  337.  
  338. The files that start with "_" (underscore) are portability patches.  The
  339. files "version.*" select the appropriate one.  For a new system not
  340. supported, make the files (_newsystem.c and _newsystem.h), modify the files
  341. "version.c" and "version.h" to key on some word to select them.  It is
  342. easiest to make your new files almost copies of files for existing systems.
  343. Look at the differences between them for hints of what might need to be
  344. changed.  Make a new makefile to define that word, and select the
  345. appropriate options for your system.  Then use make to compile it all.
  346.  
  347. Some files that start with "plot" also deal with portability.  If you don't
  348. want graphics, no changes are needed here, but this is where to install new
  349. graphics drivers.  See the code.
  350.  
  351. There should be NO non-portable code anywhere but the underscore files and
  352. plot files.  The use of #ifdef to patch portability problems should be 
  353. restricted to the underscore and plot files.
  354.  
  355. The latest version of the program with executables, source, documentation, 
  356. and test cases is available on the bulletin board at (716)272-1645.  Login
  357. as "guest".
  358.  
  359. If you have questions send email to davis@ee.rochester.edu.  You should 
  360. register (by email) if you want to know about updates and the future of ACS.
  361. SHAR_EOF
  362. fi # end of overwriting check
  363. if test -f 'doc/acs.hlp'
  364. then
  365.     echo shar: will not over-write existing file "'doc/acs.hlp'"
  366. else
  367. cat << \SHAR_EOF > 'doc/acs.hlp'
  368. Commands are:
  369. !, <, >, Ac, Build, ChDir, CLEAR, DC, DELete, Edit, END, EXIt, FAult, 
  370. FOurier, GENerator, GET, Help, IC, Insert, List, LOg, MArk, MErge,
  371. Modify, Network, NODeset, OP, OPTions, PAuse, PLot, PRint, Quit,
  372. SAve, SEt, STatus, SWeep, TItle, TRansient, UNFault, UNMark, Width
  373.  
  374. :DATE
  375. 01/24/93 (ver. 0.05xc)
  376.  
  377. :INSTALLATION
  378. This file (acs.hlp) should be placed in the same directory as the
  379. acs executable.
  380.  
  381. :!
  382. "!" command
  383. Syntax:  ! <command>
  384. Action:  Run a program.
  385.          With no tail, spawns a shell.
  386.  
  387. :<
  388. "<" command .. batch mode.
  389. Syntax:  < file         get commands from file
  390.          <<             same, but clear old ckt first
  391. Action:  Get commands, etc. from a file.
  392.          Return to keyboard when file runs out.
  393. See also: LOg
  394.  
  395. :>
  396. ">" command .. save all output.
  397. Syntax:  > file         Open a file
  398.          >> file        Append to file
  399.          >              Close a file
  400. Action:  Direct program output to a file.
  401. See also: LOg
  402.  
  403. :A
  404. Commands: AC, ALter
  405.  
  406. :AC
  407. Small-signal AC analysis .. sweeps frequency
  408. Syntax: Ac <start> <stop> <stepsize> <options>
  409.   Start and stop are frequency in Hertz.
  410.   Stepsize is in Hertz unless preceded by:
  411.     * or Times : log sweep : a multiplier
  412.     Decade : steps per decade
  413.     Octave : steps per octave
  414. Default file extension is ".ac"
  415. Nonlinearities are set by the most recent op, dc or transient analysis.
  416.  
  417. :ALter
  418. ALter command: not implemented
  419.  
  420. :Build
  421. Build command
  422. Syntax: Build            Add to the end of the list
  423.         Build <device>   Add to list before <device>         
  424. Action: Used to create a circuit, direct from the keyboard.
  425.         If a device already exists with a matching label,
  426.     replaces it.
  427.  
  428. :C
  429. Commands: CD, CHdir, CLear
  430.  
  431. :CAn
  432. Error message: can't open _____
  433. If reading, the file you asked for is not available in the selected directory.
  434. If writing, the system would not create the file you asked for. (permissions?)
  435.  
  436. :CD
  437. CD command
  438. Syntax: CD              Show the name of the default directory.
  439.         CD directory    Change the default directory.
  440. Bugs: doesn't know about ~
  441. Also works: ChDir
  442.  
  443. :CHdir
  444. ChDir command
  445. Syntax: ChDir              Show the name of the default directory.
  446.         ChDir directory    Change the default directory.
  447. Bugs: doesn't know about ~
  448.  
  449. :CLear
  450. Clear command
  451. Clears memory.  Almost the same as "delete all".
  452. but clears title and some internals, also.
  453. Need entire word "clear"
  454.  
  455. :COnverge
  456. Error message: did not converge
  457. The solution did not converge after the allowed number of iterations.
  458. Use the "Watch" option to help troubleshoot it.
  459. There are two possibilities:
  460. 1. Slow convergence
  461.    Watch shows it approaching convergence.
  462.    Set "Iterations" to a higher number, or set the epsilons larger.
  463. 2. Will never converge
  464.    Watch shows it oscillating.
  465.    It may be necessary to change the circuit.
  466.    Try setting initial conditions or sweeping in the opposite direction.
  467.  
  468. :D
  469. Commands: DC, DELete
  470. Elements: DIode
  471.  
  472. :DC
  473. Nonlinear DC analysis .. sweeps input generator.
  474. Syntax: Dc <device> <start> <stop> <stepsize> <options>
  475.   Device is a simple device (usually a voltage source) to sweep.
  476.     (if not specified: output of the signal generator)
  477.   Start and stop are lower and upper limits.
  478.   Stepsize is in volts unless preceeded by:
  479.     * or Times : log sweep : a multiplier
  480.   Default file extension ".dc"
  481. Options: Continue        use last op, dc or transient as first guess
  482.          Loop            sweep up then down
  483.      Reverse     sweep in reverse direction
  484.          Watch           watch the convergence process.
  485.  
  486. :DElete
  487. Delete command
  488. Syntax: DELete <label>            delete a part
  489.     DELete <label> <label> ... delete a list
  490.         DELete ALL         Entire circuit
  491. Action: Deletes part (or all) of the circuit.
  492.         Does not change any node numbers.
  493. Note:   Need first 3 letters "DEL".
  494.         Need entire word "ALL".
  495.     Wild cards supported: ? = any character
  496.                   * = any repeated 0 or more times
  497.     Not case sensitive, but \ makes a letter case sensitive
  498.  
  499. :DIode
  500. Component type: diode
  501. Diode device:
  502. Syntax: Dxxx n+ n- modelname {area} {params}
  503. Params: area  multiplier applied to is, rs, cjo of model
  504.     perim multiplier applied to cjsw of model
  505.     off   initial guess: diode is off **
  506.     ic    initial condition (volts) **
  507.     is    saturation current
  508.     rs    series resistance
  509.     cjo   junction capacitance
  510.     cjsw  sidewall junction capacitance
  511. Note: This rs, is, cjo, cjsw NOT affected by area.
  512.  
  513. Model description:
  514. Syntax:    .MODEL modelname D ( params )
  515. Params:    is   saturation current *
  516.     rs   series resistance *
  517.     n    emission coefficient
  518.     tt   transit time **
  519.     vj   junction potential
  520.     cjo  zero-bias junction capacitance *
  521.     m    grading coefficient
  522.     eg   activation energy
  523.     xti  saturation-current temp. exp.
  524.     kf   flicker noise coefficient **
  525.     af   flicker noise exponent **
  526.     fc   coef for depl cap formula **
  527.     bv   reverse breakdown voltage **
  528.     ibv  current at breakdown voltage**
  529.     cjsw sidewall zero-bias junction capacitance ***
  530.     mjsw sidewall grading coefficient
  531.  
  532. Notes:
  533.  *    is, rs, cjo are multiplied by area to get actual parameter
  534.  **   accepted, but not used
  535.  ***  cjsw is multiplied by perim to get actual parameter
  536.  
  537. :E
  538. Commands: EDit, ENd, EXIt
  539. Other topics: ERrors
  540.  
  541. :EDit
  542. Edit command
  543. Syntax:  Edit
  544.          Edit <file>
  545. Action:  No arguments: call your editor to edit the circuit.
  546.          If a <file>, call your editor to edit <file>.
  547. Errors:  "no editor defined": you must "setenv EDITOR=<your editor>"
  548.          from the operating system, first.
  549.  
  550. :END
  551. End command
  552. Spice END card.  Not implemented
  553.  
  554. :ERrors
  555. Error messages:  (not up to date!!)
  556.  
  557. ^ ? (SYntax)              _____ LINes               out of ORder _____ 
  558. CAn't open _____          log sweep .... ZEro       OVerflow 
  559. did not CONVerge          NEEd line                 SHort circuit _____
  560. help not available        NO circuit                TIMe step = 0
  561.               NO help on _____          too many nodes to MAp ____
  562.               _____ NODes
  563. ILlegal probe _____       OPen circuit _____        type ___ not IMplemented
  564. INternal error _____      out of MEMory _____       ____?  (needs ARgument)
  565.  
  566. Type "Help" followed by the capatilized word for a description of the message.
  567.  
  568. :EXIt
  569. EXIT command.
  570. Exit the program.
  571.  
  572. :F
  573. Commands: FAult, FOurier
  574.  
  575. :FAult
  576. Fault command
  577. Syntax:  FAult  partlabel = newvalue   ....
  578. Action:  Temporarily change the value.  UNFault will bring the old one back.
  579.  
  580. :FOurier
  581. Fourier command
  582. Transient analysis, with results in frequency domain.
  583. Syntax: FOurier <start> <stop> <stepsize> <options>
  584.   Start and stop represent frequency in Hertz
  585.   No entry repeats from the last run, same frequencies,
  586.   but continues in time form where last run ended.
  587. Options: Cold            Zero initial conditions.  (cold start, power-up)
  588.          Plot, Table     graphic or tabular output
  589.          Skip #          Do extra time steps, and hide them.
  590.                          Saved between runs
  591.          STiff           Use backward Euler method instead of trapezoidal.
  592.          TEmperature #   Temperature, degrees C.
  593.          Watch           Observe intermediate (hidden) steps.
  594.  
  595. :G
  596. Commands: GENerator, GET
  597.  
  598. :GENerator
  599. GENerator command
  600. Syntax:  Generator <parameter> <value>     to set a parameter
  601.          Generator                         to view parameter values
  602. Action:  Set, view parameters of the transient analysis function generator.
  603.   "Generator" (the bare command) views the parameters.
  604.   To set any, use "Generator" its name and new value.
  605.  
  606. :GET
  607. Get command
  608. Syntax:  GET file
  609. Action:  Get circuit from disk.  Clears memory first.
  610.      Presets parameters from dot commands, but does not run them.
  611.          Need full word "GET".
  612.          See also: merge
  613.  
  614. :Help
  615. (not up to date)
  616. Additional help topics:
  617. AMbient, DIode, ERrors, IMpedance,
  618. INPut, IO, MCarlo, RAndom, REFtemp, RESistance, 
  619. SHort, TEmperature, TRANSMission, TYpes, WAtch, WOrstcase, Z
  620.  
  621. :I
  622. Commands: INSert
  623. Errors: ILlegal, INternal
  624.  
  625. :ILlegal
  626. Error messages
  627. illegal probe .. xx does not exist
  628. The probe point selected does not exist.
  629.  
  630. :IMPLemented
  631. Error message: type xx not implemented
  632. The type is not defined, or it is not allowed in this type analysis.
  633. (Transmission lines are not allowed in transient analysis.)
  634.  
  635. :INsert
  636. Insert command
  637. Syntax: Insert #   insert one node before this number
  638.         Insert # # insert a few nodes
  639. Action: Renumbers the nodes to make room for additional nodes inside the ckt.
  640.         If two numbers, the second is how many to insert.
  641.  
  642. :INTernal
  643. The "internal error" message means there is an error in the program.
  644. Please notify us if this occurs.
  645.  
  646. :IO
  647. IO redirection options .. supported by most commands.
  648.         < file       get from file
  649.         > file       send to file
  650.         >> file      append to file
  651.         Echo         Echo disk reads to console
  652.         Print        Printer on
  653.         Quiet        Suppress data on screen.
  654.  
  655. :MArk
  656. Mark command
  657. Syntax:  Mark
  658. Action:  Mark the last step data from transient or DC analysis.
  659.          From now on, transient analysis will start from this,
  660.      and AC analysis will use this as its bias point.
  661.          UNMark releases it.
  662.  
  663. :L
  664. Commands: LIst, LOg
  665.  
  666. :LIst
  667. List command
  668. Syntax: List <label>          list a part
  669.     List <label> <label> ... list named parts
  670.         List                 Entire circuit
  671. Action: List the circuit description.
  672. Note:    The list is re-created from internal data,
  673.     so actual parameters used are shown.
  674.     Defaulted values are explicitly listed.
  675.     Calculated values are listed as comments.
  676.     Wild cards supported: ? = any character
  677.                   * = any repeated 0 or more times
  678.     Not case sensitive, but \ makes a letter case sensitive
  679.  
  680. :LOg
  681. Log command
  682. Syntax:  LOg file      Open a file
  683.          LOg >> file   Append to file
  684.          LOg           Close a file
  685. Action:  Sends a copy of keyboard entries to a file.
  686.          This file is suitable for batch operation via the "<" command.
  687. Bugs: it isn't quite suitable for input.  Need to add dots.
  688. See also: "<", ">"
  689.  
  690. :M
  691. Commands: MErge, MOdify
  692.  
  693. :MErge
  694. Merge command
  695. Syntax:  MErge file
  696.          MErge file <options>
  697. Action:  Merge circuit from file with the one in memory.
  698.          Does not clear memory.
  699.          See also: get
  700.  
  701. :Modify
  702. Modify command
  703. Syntax:  MOdify  partlabel = newvalue   ....
  704. Action:  Change the value.
  705.  
  706.  
  707. :N
  708. Commands: NEtwork, NODESEt, NOIse
  709. Errors: NO, NODes
  710.  
  711. :NEtwork
  712. Network command
  713. Syntax:  Network             The entire circuit
  714.          Network #           This node only
  715.          Network #-          This node to the end
  716.          Network -#          Start to this node
  717.          Network # #         Range of nodes
  718. Action:  List all lines showing connections to the specified nodes.
  719.  
  720. :NO
  721. no circuit   error message
  722. There is no circuit in memory.
  723.  
  724. no help on xxxx   error message
  725. The topic xxxx is not defined in the help file.
  726. "Help" lists the commands; "Help ERrors" lists the error messages;
  727. "Help Help" lists everything else that help is available about.
  728.  
  729. :NODes
  730. xx nodes   error message
  731. There are only xx nodes in the circuit.
  732. You have asked for a node numbered higher than this.
  733.  
  734. :NODESEt
  735. Nodeset command
  736. not implemented
  737.  
  738. :NOIse
  739. Noise command
  740. not implemented
  741.  
  742. :O
  743. Commands: OP, OPTions
  744. Errors: OPEn, ORder, OVerflow
  745.  
  746. :OP
  747. Nonlinear DC analysis .. sweeps temperature.
  748. Syntax: OP <start> <stop> <stepsize> <options>
  749.   The signal input is set to zero, usually.
  750.   Start and stop are temperature in degrees Celsius.
  751.   Stepsize is in degrees unless preceded by:
  752.     * or Times : log sweep : a multiplier
  753.   Default file extension is ".bi"
  754. Options: Continue        use last op, dc or transient as first guess
  755.          Temperature #   temperature, degrees C. don't keep.
  756.          Watch           watch the convergence process.
  757.  
  758. :OPEn
  759. Open circuit error  (warning)
  760. A node has been left unconnected, or has a near-infinite impedance to ground.
  761. As a correction, the program has grounded it through an arbitrary resistor.
  762. The solution is usually correct, but will often have small errors.
  763.  
  764. :OPTions
  765. Options command
  766. Syntax:  OPTions <parameter> <value>     to set a parameter
  767.          OPTions                         to view parameter values
  768. Action:  Set, view global variables, program parameters.
  769.  
  770. :ORder
  771. Error message: out of order
  772. In some cases, data must be supplied in increasing order, and were not.
  773. You must change the order, so they are in increasing order.
  774.  
  775. :OVerflow
  776. Error message: overflow
  777. A numerical result exceeds the limits allowed by the program.
  778.    (approaches infinity)
  779. This is unlikely, since the internal range is 1e300.
  780.  
  781. :P
  782. Commands: PAuse, PLot, PRint
  783.  
  784. :PAuse
  785. Pause command.  wait for key hit, in batch mode.
  786.  
  787. :PLot
  788. Plot command.   Set up plotting.
  789.  
  790. :PRint
  791. Print command 
  792.  
  793. :Quit
  794. Quit command.
  795. Exit the program.
  796.  
  797. :S
  798. Commands: SAve, SEt, STatus, SWeep
  799. Errors: SHort, SYntax
  800. Other topics: SHort
  801.  
  802. :SAve
  803. Save command
  804. Syntax:  Save <file>
  805.          Save <file> <options>
  806. Action:  Save the circuit description in a file.
  807.          Default extension ".ckt"
  808. Options: see list command
  809.  
  810. :SEt
  811. Set command
  812. see options command.
  813.  
  814. :SHort
  815. Short circuit error.  (warning)
  816. This program generally cannot model perfect shorts.  The circuit has one.
  817. A low resistance (set short ..) was substituted.
  818.  
  819. :STatus
  820. STatus command
  821.  
  822. Displays the system status, memory utilization, and timing information.
  823.  
  824. :SWeep
  825. Sweep command
  826. Syntax: SWeep  count  label  start finish  ....
  827. Action: Sweeps a component.  Collects commands to apply at each iteration.
  828. The ">>>" prompt indicates that URECA is collecting commands.
  829. "GO" makes it all happen.
  830.  
  831. :SYntax
  832. Syntax error:
  833. Shows as   ^ ?   pointing to the offending word or argument.
  834. The word or argument pointed to is not recognized.
  835. Usually a typographic error.
  836.  
  837. :T
  838. Commands: TEmp, TF, TItle, TRansient
  839. Errors: TIMe, TRANSMission
  840. Other topics: TEMPErature, TRANSMission, TYpes
  841.  
  842. :TEmp
  843. Temp command.
  844. Spice command not implemented,
  845. but function available through set and op commands.
  846.  
  847. :TEMPErature
  848. Temperature: command option on AC, DC, OP, and Transient commands.
  849. Simulate at this temperature, degrees Celsius.
  850.  
  851. All temperatures are entered and shown in degrees Celsius, but internal
  852. calculations are done in degrees Kelvin.
  853.  
  854. :TF
  855. TF command
  856. Spice command not implemented
  857. but function available through dc command,
  858. by selecting points to print
  859.  
  860. :TIMe
  861. time step = 0   error message
  862. You have not specified the step size for a transient analysis.
  863. You must specify a non-zero step size.
  864.  
  865. :TItle
  866. TItle command
  867. Set or view the title (header line) on files.
  868.  
  869. :TRansient
  870. Transient analysis .. sweeps time
  871. Syntax: Transient <start> <stop> <stepsize> <options>
  872.   Start and stop represent time in seconds.
  873.   No entry continues from the last run, same time, same step size.
  874. Options: All         Show all time steps.
  875.      Cold            Zero initial conditions.  (cold start, power-up)
  876.          Skip #          Do extra time steps, and hide them.
  877.                          Saved between runs
  878.          STiff           Use backward Euler method instead of trapezoidal.
  879.          TEmperature #   Temperature, degrees C.
  880.  
  881. :TRANSMission
  882. transmission line
  883. Syntax:  Tn  n1  n2  n3  n4  z0=<impedance>  f=<resonance>
  884. n1, n2 are one end of the line.  n3, n4 are the other.
  885. Resonance is the quarter wave frequency in Hertz.
  886. Impedance is the characteristic impedance in Ohms.
  887. For a shorted stub, connect both nodes at one end to 0.
  888. For an open stub, connect one end to an otherwise unused node.
  889.  
  890. transmission line error   error message
  891. A transmission line is being used too near exact resonance,
  892.    resulting in numeric accuracy problems.  The results are suspect.
  893. The best way around this is to split the line into two non-resonant
  894.    lines in series, so the combination gives you what you want.
  895.  
  896. :TYpes
  897. Built-in component types:
  898. C = Capacitor
  899. D = Diode
  900. E = Voltage controlled voltage source
  901. G = Voltage controlled current source
  902. I = Current source (fixed)
  903. L = Inductance
  904. M = MOSFET
  905. R = Resistance
  906. T = Transmission line (AC analysis only)
  907. V = Voltage source (fixed)
  908. Y = Admittance
  909.  
  910. :Un
  911. Commands: UNFault, UNMark
  912.  
  913. :UNFault
  914. Unfault command
  915. Syntax:  UNFault
  916. Action:  Removes all faults.  Cleans up unfinished sweeps.
  917.  
  918. :UNMark
  919. Unkeep command
  920. Syntax:  UNMark
  921. Action:  Releases kept transient starting data.  Allow time to proceed.
  922.  
  923. :Width
  924. Width command
  925. set terminal width
  926.  
  927. :COPYING
  928. Copyright 1983-1992 Albert Davis
  929.  
  930. This program is free software; you can redistribute it and/or modify
  931. it under the terms of the GNU General Public License as published by
  932. the Free Software Foundation; either version 1, or (at your option)
  933. any later version.
  934.  
  935. The GNU General Public License follows:
  936.  
  937.             GNU GENERAL PUBLIC LICENSE
  938.              Version 1, February 1989
  939.  
  940.  Copyright (C) 1989 Free Software Foundation, Inc.
  941.                     675 Mass Ave, Cambridge, MA 02139, USA
  942.  Everyone is permitted to copy and distribute verbatim copies
  943.  of this license document, but changing it is not allowed.
  944.  
  945.                 Preamble
  946.  
  947.   The license agreements of most software companies try to keep users
  948. at the mercy of those companies.  By contrast, our General Public
  949. License is intended to guarantee your freedom to share and change free
  950. software--to make sure the software is free for all its users.  The
  951. General Public License applies to the Free Software Foundation's
  952. software and to any other program whose authors commit to using it.
  953. You can use it for your programs, too.
  954.  
  955.   When we speak of free software, we are referring to freedom, not
  956. price.  Specifically, the General Public License is designed to make
  957. sure that you have the freedom to give away or sell copies of free
  958. software, that you receive source code or can get it if you want it,
  959. that you can change the software or use pieces of it in new free
  960. programs; and that you know you can do these things.
  961.  
  962.   To protect your rights, we need to make restrictions that forbid
  963. anyone to deny you these rights or to ask you to surrender the rights.
  964. These restrictions translate to certain responsibilities for you if you
  965. distribute copies of the software, or if you modify it.
  966.  
  967.   For example, if you distribute copies of a such a program, whether
  968. gratis or for a fee, you must give the recipients all the rights that
  969. you have.  You must make sure that they, too, receive or can get the
  970. source code.  And you must tell them their rights.
  971.  
  972.   We protect your rights with two steps: (1) copyright the software, and
  973. (2) offer you this license which gives you legal permission to copy,
  974. distribute and/or modify the software.
  975.  
  976.   Also, for each author's protection and ours, we want to make certain
  977. that everyone understands that there is no warranty for this free
  978. software.  If the software is modified by someone else and passed on, we
  979. want its recipients to know that what they have is not the original, so
  980. that any problems introduced by others will not reflect on the original
  981. authors' reputations.
  982.  
  983.   The precise terms and conditions for copying, distribution and
  984. modification follow.
  985.  
  986.             GNU GENERAL PUBLIC LICENSE
  987.    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  988.  
  989.   0. This License Agreement applies to any program or other work which
  990. contains a notice placed by the copyright holder saying it may be
  991. distributed under the terms of this General Public License.  The
  992. "Program", below, refers to any such program or work, and a "work based
  993. on the Program" means either the Program or any work containing the
  994. Program or a portion of it, either verbatim or with modifications.  Each
  995. licensee is addressed as "you".
  996.  
  997.   1. You may copy and distribute verbatim copies of the Program's source
  998. code as you receive it, in any medium, provided that you conspicuously and
  999. appropriately publish on each copy an appropriate copyright notice and
  1000. disclaimer of warranty; keep intact all the notices that refer to this
  1001. General Public License and to the absence of any warranty; and give any
  1002. other recipients of the Program a copy of this General Public License
  1003. along with the Program.  You may charge a fee for the physical act of
  1004. transferring a copy.
  1005.  
  1006.   2. You may modify your copy or copies of the Program or any portion of
  1007. it, and copy and distribute such modifications under the terms of Paragraph
  1008. 1 above, provided that you also do the following:
  1009.  
  1010.     a) cause the modified files to carry prominent notices stating that
  1011.     you changed the files and the date of any change; and
  1012.  
  1013.     b) cause the whole of any work that you distribute or publish, that
  1014.     in whole or in part contains the Program or any part thereof, either
  1015.     with or without modifications, to be licensed at no charge to all
  1016.     third parties under the terms of this General Public License (except
  1017.     that you may choose to grant warranty protection to some or all
  1018.     third parties, at your option).
  1019.  
  1020.     c) If the modified program normally reads commands interactively when
  1021.     run, you must cause it, when started running for such interactive use
  1022.     in the simplest and most usual way, to print or display an
  1023.     announcement including an appropriate copyright notice and a notice
  1024.     that there is no warranty (or else, saying that you provide a
  1025.     warranty) and that users may redistribute the program under these
  1026.     conditions, and telling the user how to view a copy of this General
  1027.     Public License.
  1028.  
  1029.     d) You may charge a fee for the physical act of transferring a
  1030.     copy, and you may at your option offer warranty protection in
  1031.     exchange for a fee.
  1032.  
  1033. Mere aggregation of another independent work with the Program (or its
  1034. derivative) on a volume of a storage or distribution medium does not bring
  1035. the other work under the scope of these terms.
  1036.  
  1037.   3. You may copy and distribute the Program (or a portion or derivative of
  1038. it, under Paragraph 2) in object code or executable form under the terms of
  1039. Paragraphs 1 and 2 above provided that you also do one of the following:
  1040.  
  1041.     a) accompany it with the complete corresponding machine-readable
  1042.     source code, which must be distributed under the terms of
  1043.     Paragraphs 1 and 2 above; or,
  1044.  
  1045.     b) accompany it with a written offer, valid for at least three
  1046.     years, to give any third party free (except for a nominal charge
  1047.     for the cost of distribution) a complete machine-readable copy of the
  1048.     corresponding source code, to be distributed under the terms of
  1049.     Paragraphs 1 and 2 above; or,
  1050.  
  1051.     c) accompany it with the information you received as to where the
  1052.     corresponding source code may be obtained.  (This alternative is
  1053.     allowed only for noncommercial distribution and only if you
  1054.     received the program in object code or executable form alone.)
  1055.  
  1056. Source code for a work means the preferred form of the work for making
  1057. modifications to it.  For an executable file, complete source code means
  1058. all the source code for all modules it contains; but, as a special
  1059. exception, it need not include source code for modules which are standard
  1060. libraries that accompany the operating system on which the executable
  1061. file runs, or for standard header files or definitions files that
  1062. accompany that operating system.
  1063.  
  1064.   4. You may not copy, modify, sublicense, distribute or transfer the
  1065. Program except as expressly provided under this General Public License.
  1066. Any attempt otherwise to copy, modify, sublicense, distribute or transfer
  1067. the Program is void, and will automatically terminate your rights to use
  1068. the Program under this License.  However, parties who have received
  1069. copies, or rights to use copies, from you under this General Public
  1070. License will not have their licenses terminated so long as such parties
  1071. remain in full compliance.
  1072.  
  1073.   5. By copying, distributing or modifying the Program (or any work based
  1074. on the Program) you indicate your acceptance of this license to do so,
  1075. and all its terms and conditions.
  1076.  
  1077.   6. Each time you redistribute the Program (or any work based on the
  1078. Program), the recipient automatically receives a license from the original
  1079. licensor to copy, distribute or modify the Program subject to these
  1080. terms and conditions.  You may not impose any further restrictions on the
  1081. recipients' exercise of the rights granted herein.
  1082.  
  1083.   7. The Free Software Foundation may publish revised and/or new versions
  1084. of the General Public License from time to time.  Such new versions will
  1085. be similar in spirit to the present version, but may differ in detail to
  1086. address new problems or concerns.
  1087.  
  1088. Each version is given a distinguishing version number.  If the Program
  1089. specifies a version number of the license which applies to it and "any
  1090. later version", you have the option of following the terms and conditions
  1091. either of that version or of any later version published by the Free
  1092. Software Foundation.  If the Program does not specify a version number of
  1093. the license, you may choose any version ever published by the Free Software
  1094. Foundation.
  1095.  
  1096.   8. If you wish to incorporate parts of the Program into other free
  1097. programs whose distribution conditions are different, write to the author
  1098. to ask for permission.  For software which is copyrighted by the Free
  1099. Software Foundation, write to the Free Software Foundation; we sometimes
  1100. make exceptions for this.  Our decision will be guided by the two goals
  1101. of preserving the free status of all derivatives of our free software and
  1102. of promoting the sharing and reuse of software generally.
  1103.  
  1104.                 NO WARRANTY
  1105.  
  1106.   9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  1107. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  1108. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  1109. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  1110. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  1111. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  1112. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  1113. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  1114. REPAIR OR CORRECTION.
  1115.  
  1116.   10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  1117. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  1118. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  1119. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  1120. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  1121. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  1122. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  1123. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  1124. POSSIBILITY OF SUCH DAMAGES.
  1125.  
  1126.              END OF TERMS AND CONDITIONS
  1127.  
  1128.     Appendix: How to Apply These Terms to Your New Programs
  1129.  
  1130.   If you develop a new program, and you want it to be of the greatest
  1131. possible use to humanity, the best way to achieve this is to make it
  1132. free software which everyone can redistribute and change under these
  1133. terms.
  1134.  
  1135.   To do so, attach the following notices to the program.  It is safest to
  1136. attach them to the start of each source file to most effectively convey
  1137. the exclusion of warranty; and each file should have at least the
  1138. "copyright" line and a pointer to where the full notice is found.
  1139.  
  1140.     <one line to give the program's name and a brief idea of what it does.>
  1141.     Copyright (C) 19yy  <name of author>
  1142.  
  1143.     This program is free software; you can redistribute it and/or modify
  1144.     it under the terms of the GNU General Public License as published by
  1145.     the Free Software Foundation; either version 1, or (at your option)
  1146.     any later version.
  1147.  
  1148.     This program is distributed in the hope that it will be useful,
  1149.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  1150.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  1151.     GNU General Public License for more details.
  1152.  
  1153.     You should have received a copy of the GNU General Public License
  1154.     along with this program; if not, write to the Free Software
  1155.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  1156.  
  1157. Also add information on how to contact you by electronic and paper mail.
  1158.  
  1159. If the program is interactive, make it output a short notice like this
  1160. when it starts in an interactive mode:
  1161.  
  1162.     Gnomovision version 69, Copyright (C) 19xx name of author
  1163.     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  1164.     This is free software, and you are welcome to redistribute it
  1165.     under certain conditions; type `show c' for details.
  1166.  
  1167. The hypothetical commands `show w' and `show c' should show the
  1168. appropriate parts of the General Public License.  Of course, the
  1169. commands you use may be called something other than `show w' and `show
  1170. c'; they could even be mouse-clicks or menu items--whatever suits your
  1171. program.
  1172.  
  1173. You should also get your employer (if you work as a programmer) or your
  1174. school, if any, to sign a "copyright disclaimer" for the program, if
  1175. necessary.  Here a sample; alter the names:
  1176.  
  1177.   Yoyodyne, Inc., hereby disclaims all copyright interest in the
  1178.   program `Gnomovision' (a program to direct compilers to make passes
  1179.   at assemblers) written by James Hacker.
  1180.  
  1181.   <signature of Ty Coon>, 1 April 1989
  1182.   Ty Coon, President of Vice
  1183.  
  1184. That's all there is to it!
  1185. SHAR_EOF
  1186. fi # end of overwriting check
  1187. #    End of shell archive
  1188. exit 0
  1189.