[Pkg-electronics-commits] [SCM] Packaging for Gnucap branch, master, updated. debian/0.35-1.2-39-gd39d0bd

[Wesley J. Landaker]

The following commit has been merged in the master branch:
commit c2afc868bc6a4ef49d3f8c9bfb0faa319699e85c
Author: Wesley J. Landaker <wjl at icecavern.net>
Date:   Thu Nov 11 17:29:31 2010 -0700

    Applying acs/gnucap patch

diff --git a/doc/Makefile.am b/doc/Makefile.am
index d1ebed1..5645c72 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -5,6 +5,6 @@ dist_man_MANS=	gnucap.1 gnucap-ibis.1
 
 pkgdocsdir= ${docdir}
 dist_pkgdocs_DATA= \
-	acs-tutorial COPYING history INSTALL relnotes.029 \
+	gnucap-tutorial COPYING history INSTALL relnotes.029 \
 	relnotes.030 relnotes.031 relnotes.032 relnotes.033 relnotes.034 whatisit 
 
diff --git a/doc/Makefile.in b/doc/Makefile.in
index 040624d..9387d4a 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -160,7 +160,7 @@ top_srcdir = @top_srcdir@
 dist_man_MANS = gnucap.1 gnucap-ibis.1
 pkgdocsdir = ${docdir}
 dist_pkgdocs_DATA = \
-	acs-tutorial COPYING history INSTALL relnotes.029 \
+	gnucap-tutorial COPYING history INSTALL relnotes.029 \
 	relnotes.030 relnotes.031 relnotes.032 relnotes.033 relnotes.034 whatisit 
 
 all: all-am
diff --git a/doc/acs-tutorial b/doc/gnucap-tutorial
similarity index 95%
rename from doc/acs-tutorial
rename to doc/gnucap-tutorial
index e2c4bc0..b50986b 100644
--- a/doc/acs-tutorial
+++ b/doc/gnucap-tutorial
@@ -1,14 +1,14 @@
-Tutorial for acs V0.02
+Tutorial for gnucap V0.02
 Copyright 1999 Telford Tendys <telford at eng.uts.edu.au>
 
 >>> Introduction
 
-This is not an alternative to reading the acs manual. The manual is
+This is not an alternative to reading the gnucap manual. The manual is
 very nicely presented in LaTeX and you should print it out and keep
-it handy when working with acs. This document is organised starting
+it handy when working with gnucap. This document is organised starting
 from easy and working towards difficult and presumes that you have some
 idea of what electrical circuits are but don't know much about simulators.
-The acs manual is organised in alphabetical order and in groups of concepts
+The gnucap manual is organised in alphabetical order and in groups of concepts
 and it presumes that you know SPICE already.
 
 >>> The basic concept of a nodal analysis.
@@ -34,7 +34,7 @@ implicitly calculated as a result of calculating the node voltages.
 
 >>> The basic concept of a circuit file.
 
-Tradition has it that acs input files have the extension ``.ckt''. The
+Tradition has it that gnucap input files have the extension ``.ckt''. The
 format is similar to that used by version 2 of the SPICE simulator; it
 is a line oriented format with items separated by whitespace. The overall
 file structure is:
@@ -76,14 +76,14 @@ source and ``R1'' is a resistor. Each component has a value, the voltage
 source is 10 volts and the resistor is 1000 ohms. The nodes have the
 numbers ``0'' and ``2''. Note that there is no node ``1'' but this doesn't
 matter, not every node number needs to be used. Like SPICE version 2 (but
-unlike version 3) nodes must be numbered in acs.
+unlike version 3) nodes must be numbered in gnucap.
 
 In order to load this circuit into the simulator the following command
 would be used:
 
-	acs eg1.ckt
+	gnucap eg1.ckt
 
-What happens is that acs loads in the circuit, finds no commands to execute
+What happens is that gnucap loads in the circuit, finds no commands to execute
 (since this file has no command lines) and so enters interactive mode with
 a ``-->'' prompt. From the interactive mode it is possible to exercise the
 circuit model, firstly by putting a probe on the node that needs measuring
@@ -165,7 +165,7 @@ R6	0	5	15k
 
 Run this with:
 
-	acs eg2.ckt
+	gnucap eg2.ckt
 	print dc v(1) v(2) v(3) v(4) v(5)	
 	dc
 	quit
@@ -223,28 +223,28 @@ Notice that this example file contains some lines that begin with a dot.
 These are command lines and behave exactly like the commands you type
 in interactive mode. These command lines are dotted because of the old
 SPICE tradition of executing all of the component lines first and then
-the command lines, acs doesn't bother with this, it executes every line
+the command lines, gnucap doesn't bother with this, it executes every line
 in the order that it sees them, but it still follows the old idea of dotting
 the command lines as a little tribute to SPICE and to make it easier to
 see what is going on when you read a .ckt file.
 
 When you run this example, you might try:
 
-	acs eg3.ckt
+	gnucap eg3.ckt
 
 And (all going well) you will see that node 2 is equivalent to a
 source of 54.343 volts in series with an 0.83888 ohm resistor.
-You should also notice that acs never goes into interactive command mode.
-This is because of the ``.end'' command that tells acs to finish at this point.
+You should also notice that gnucap never goes into interactive command mode.
+This is because of the ``.end'' command that tells gnucap to finish at this point.
 You may want to use this example circuit in interactive mode, to achieve this
 you could either delete the .end command, or (from the system prompt) type:
 
-	acs
+	gnucap
 	get eg3.ckt
 
 Then you can use other interactive commands. Note that you can modify the
 circuit interactively too. Consider adding another resistor by typing the
-following at the acs interactive prompt:
+following at the gnucap interactive prompt:
 
 	build R3
 	R6 3 4 12k
@@ -261,7 +261,7 @@ To put the adjusted topology into a file you use the save command:
 	cat eg3_mod.ckt
 
 Looking at what you have saved you will probably notice a few things:
-firstly, acs has remembered your comment lines and command lines and
+firstly, gnucap has remembered your comment lines and command lines and
 saved them too; secondly, your extra line was inserted into the file
 before the line containing component ``R3'', this is caused by the
 argument on the ``build'' command and allows you to insert your build
@@ -284,7 +284,7 @@ Actually, V2 is very slightly higher than 10 volts so there will be
 some argument between V1 and V2 as to exactly what the final voltage
 at node 1 really is. You should see that huge currents are flowing
 through the supplies (10,000 amps) just due to this small voltage
-difference. Also note that acs does not throw in the towel and give
+difference. Also note that gnucap does not throw in the towel and give
 up, nor does it fail to converge... the answer that it gets for v(1)
 is a compromise, halfway between the two sources.
 
@@ -293,7 +293,7 @@ so that they do have a small internal series resistor. This allows it
 to make the best guess that it can in a difficult situation. How much is
 this resistance? You can find out like so:
 
-	acs
+	gnucap
 	options
 
 Look at the value of the option called ``short'' (near the middle of
@@ -301,7 +301,7 @@ the block of options), this is the value (in ohms) of the internal
 resistance of a voltage source. The ``u'' character means ``micro''
 or 1e-6 so the default value of a short circuit is 1e-5 ohms. You
 might decide that a different short circuit value is more appropriate
-for running the above circuit so you can type (from the acs prompt):
+for running the above circuit so you can type (from the gnucap prompt):
 
 	options short=0.5
 	get eg4.ckt
@@ -326,7 +326,7 @@ I2 1 0 2.0
 ----------------------------------------------------------------------
 
 The case of putting two current sources in series is much the same
-concept as two voltage sources in parallel. However notice that acs
+concept as two voltage sources in parallel. However notice that gnucap
 copes with it in a different manner. It cannot find a compromise current
 that is partway between the two sources and it always gives a huge
 value for the voltage at node 1. At least it doesn't crash and it does
@@ -340,7 +340,7 @@ two current sources in series but you never thought about checking
 the strange node? How would you ever know that the circuit was broken?
 Try this exercise:
 
-	acs
+	gnucap
 	get eg5.ckt
 	alarm dc v(*)(-1e3,1e3)
 	dc
@@ -394,26 +394,26 @@ Rd3 30   0   1k
 
 You can run this example and look at the results like so:
 
-	acs eg6.ckt
+	gnucap eg6.ckt
 	gnuplot
 	set data style lines
 	plot 'eg6.dat' using 1:2, 'eg6.dat' using 1:3, 'eg6.dat' using 1:4
 	exit
 
 You may not like using gnuplot and may prefer some other plotting program
-such as gwave or gle. Acs output can be used by most plotting programs
+such as gwave or gle. Gnucap output can be used by most plotting programs
 in much the same manner as above by using the redirection arrow on the
 command that runs the simulation (``dc'' in this case). Note that it usually
 won't work to redirect the normal output to a file using your shell and then
 cut and paste that output into your plotting program because the normal output
 does not use standard scientific notation, using the internal redirection
-option provided by acs also guarantees you get a nice, portable data file
+option provided by gnucap also guarantees you get a nice, portable data file
 in standard exponential notation.
 
 If the above did work you should have been able to see the node voltages
 as a function of supply voltage and see the diodes move into their conductive
 band one by one. And see the traditional 0.7 volt drop across each diode.
-However, various diodes behave differently so acs needs to know what sort
+However, various diodes behave differently so gnucap needs to know what sort
 of diode you are using. That is what the ``.model'' command line is doing
 for you -- it associated parameters in the diode model with a name that
 you choose to assign to your diodes. (By the way, I have no idea what the
@@ -525,13 +525,13 @@ eg9 --
 
 
 [explain AC analysis here with some bode plots and pole-zero stuff,
-can acs do root-locus?]
+can gnucap do root-locus?]
 
 two examples here eg8.ckt, eg9.ckt
 
 AC Analysis has the limitation that it is a LINEAR analysis only.
 This means that the nonlinear devices (such as diodes) must be regarded
-as behaving like linear devices. In order to achieve this, acs finds
+as behaving like linear devices. In order to achieve this, gnucap finds
 the DC operating point first and then presumes that the AC signal is
 some small value that will slightly perturb the DC operating point
 but will not be large enough for any nonlinear effect to be visible.
@@ -555,7 +555,7 @@ series with an inductor, this is being driven by a sinusoidal supply but the
 supply is only switched on for half a cycle.
 
 Here in Australia, the mains supply is 240V RMS AC at 50Hz. Thus, one half
-cycle lasts for 10 miliseconds. The ``generator'' device provided by acs is
+cycle lasts for 10 miliseconds. The ``generator'' device provided by gnucap is
 the ideal thing to create a pulse such as this.
 
 --------------------------------------------------------------------- eg10.ckt
@@ -658,7 +658,7 @@ Note that the switch too is given an initial condition (OFF).
 
 Run the simulation in batch mode as follows:
 
-	acs eg19.ckt
+	gnucap eg19.ckt
 	gnuplot
 	set data style lines
 	plot 'eg11.dat', 'eg11.dat' using 1:3, 'eg11.dat' using 1:4
@@ -691,7 +691,7 @@ capacitance in D1 and the inductance of L1. This is a property of using
 diodes to switch a coil and does occur in real circuits too. The simulator
 does not know the junction capacitance of D1 because it has not been specified
 in the ``.model'' line (actually with no junction capacitance specified,
-acs drops the capacitor out of the diode model completely) so the oscillation
+gnucap drops the capacitor out of the diode model completely) so the oscillation
 flips back and forth with each time step and the magnitude of the swing
 at node 3 is dependent on the size of the timestep used (try a longer timestep
 and see that node 3 shows a larger voltage swing at this point).
diff --git a/doc/whatisit b/doc/whatisit
index e275bd4..94a35e6 100644
--- a/doc/whatisit
+++ b/doc/whatisit
@@ -1,4 +1,4 @@
-ACS is a general purpose circuit simulator.  It performs nonlinear
+Gnucap is a general purpose circuit simulator.  It performs nonlinear
 dc and transient analyses, fourier analysis, and ac analysis
 linearized at an operating point.  It is fully interactive and
 command driven.  It can also be run in batch mode or as a server.
@@ -6,7 +6,7 @@ The output is produced as it simulates.  Spice compatible models
 for the MOSFET (level 1-7) and diode are included in this
 release.
 
-ACS is not based on Berkeley Spice, but some of the models have been
+Gnucap is not based on Berkeley Spice, but some of the models have been
 derived from the Berleley models.
 
 Since it is fully interactive, it is possible to make changes and
@@ -19,7 +19,7 @@ undergraduate teaching and courses in MOS design, but not for
 bipolar design.
 
 In batch mode it is mostly Spice compatible, so it is often possible
-to use the same file for both ACS and Spice.
+to use the same file for both Gnucap and Spice.
 
 The analog simulation is based on traditional nodal analysis with
 iteration by Newton's method and LU decomposition.  An event queue
@@ -36,11 +36,11 @@ simulator, even with behavioral models.  The digital mode is
 experimental and needs work.  There will be substantial improvements
 in future releases.
 
-ACS also has a simple behavioral modeling language that allows
+Gnucap also has a simple behavioral modeling language that allows
 simple behavioral descriptions of most components including capacitors
 and inductors.
 
-ACS uses an object oriented approach to modeling.  Complex models like
+Gnucap uses an object oriented approach to modeling.  Complex models like
 MOSFETS are made of simpler ones like resistors, capacitors, diodes,
 and any other models that may already exist.  The model designer does
 not need to worry about details like convergence checking, bypass
@@ -54,17 +54,13 @@ model, compared to Spice.
 If you are tired of Spice and want a second opinion, you want to
 play with the circuit and want a simulator that is interactive, or
 you want to study the source code and want something easier to
-follow than Spice, try ACS.
+follow than Spice, try Gnucap.
 
-ACS is an ongoing research project.  It is being released in a
+Gnucap is an ongoing research project.  It is being released in a
 preliminary phase in hopes that it will be useful and that others
 will use it as a thrust or base for their research.  I also hope
 for some comments that may help me direct my research.
 
-ACS ftp sites:
-	ftp://sunsite.unc.edu/pub/Linux/apps/circuits/acs-0.27.tar.gz
-	ftp://ftp.geda.seul.org/pub/geda/dist/acs-0.27.tar.gz
-	http://www.geda.seul.org/dist/acs-0.27.tar.gz
 
 Albert Davis
 aldavis at ieee.org

-- 
Packaging for Gnucap