added multi_punch example

git-svn-id: svn://136.177.114.72/svn_GW/IPhreeqc/trunk@8225 1feff8c3-07ed-0310-ac33-dd36852eb9cd

doc/TOC.hhc

@@ -175,6 +175,10 @@
 			<param name="Name" value="GetSelectedOutputFileOn">
 			<param name="Local" value="html\IPhreeqc_8h.html#a8f57d33809b84174e2cc6b69d000e096">
 			</OBJECT>
+		<LI> <OBJECT type="text/sitemap">
+			<param name="Name" value="GetSelectedOutputRowCount">
+			<param name="Local" value="html\IPhreeqc_8h.html#a6e428ca1628248708ebbd1925a50837a">
+			</OBJECT>
 		<LI> <OBJECT type="text/sitemap">
 			<param name="Name" value="GetSelectedOutputString">
 			<param name="Local" value="html\IPhreeqc_8h.html#ad2f63040ff41e6e313417a2e3aa56660">
@@ -191,10 +195,6 @@
 			<param name="Name" value="GetSelectedOutputStringOn">
 			<param name="Local" value="html\IPhreeqc_8h.html#a28f04f8405b3274b39a047b7c01352de">
 			</OBJECT>
-		<LI> <OBJECT type="text/sitemap">
-			<param name="Name" value="GetSelectedOutputRowCount">
-			<param name="Local" value="html\IPhreeqc_8h.html#a6e428ca1628248708ebbd1925a50837a">
-			</OBJECT>
 		<LI> <OBJECT type="text/sitemap">
 			<param name="Name" value="GetSelectedOutputValue">
 			<param name="Local" value="html\IPhreeqc_8h.html#a9f0ffd11e25a7e8f05d800623b14acf5">

doc/examples/multi_punch

@@ -0,0 +1,105 @@
+SOLUTION 1
+	pH      7 charge
+	Na	1
+	Cl	1
+	Ca	1
+	C	  2
+END
+CALCULATE_VALUES
+TOTAL_C
+-start
+10 save TOT("C")
+-end
+END
+EQUILIBRIUM_PHASES 1
+	CO2(g) -2
+	Dolomite 0
+END
+REACTION 1
+	HCl 1
+	0.1 mmol
+END
+GAS_PHASE
+	-fixed_volume
+	N2(g)	1.2
+END
+KINETICS
+	Calcite
+		-tol    1e-8
+		-m0	 3.e-3
+		-m	3.e-3
+		-parms	50	  0.6
+END
+SOLID_SOLUTION
+Sulfate
+	-comp 	Anhydrite	1.0
+	-comp	Barite		1.0
+END
+RUN_CELLS
+	-cell 1
+SELECTED_OUTPUT 
+	-file multi_punch_1.sel
+	-reset false
+	-sim
+	-state
+	-solution
+	-dist
+	-time
+	-step
+	-pH
+	-pe
+	-reaction
+	-temperature
+	-alkalinity
+	-ionic_strength
+	-water
+	-charge_balance
+	-percent_error
+	-totals			Na	Ca
+	-molalities		Na+	HCO3-
+	-activities		Ca+2	CO3-2
+	-equilibrium_phases	CO2(g)	dolomite
+	-saturation_indices	Halite
+	-gases			N2(g)
+	-kinetics		Calcite
+	-solid_solutions	Anhydrite	Barite
+	-calculate_values       TOTAL_C
+	-inverse                false
+SELECTED_OUTPUT 2
+	-file multi_punch_2.sel
+	-si Halite Calcite
+USER_PUNCH 20
+-heading Dummy
+10 PUNCH "Dummy"
+END
+USER_PUNCH 2
+-heading DUMMY_1 DUMMY_2
+10 PUNCH "Dummy1", "Dummy2"
+RUN_CELLS
+	-cell 1
+SELECTED_OUTPUT 1
+	-active false
+END
+RUN_CELLS
+	-cell 1
+SELECTED_OUTPUT 1
+	-active true
+END
+SOLUTION 2
+	pH 7 charge
+END
+SOLUTION 3
+	pH 7 charge
+	Na	1
+	Cl	1
+END
+INVERSE_MODELING
+	-solution  2 3
+	-phases
+		Halite
+SELECTED_OUTPUT 3
+	-reset false
+	-file multi_punch_3.sel
+END
+RUN_CELLS
+	-cell 1

src/IPhreeqc.h

@@ -1693,6 +1693,8 @@ Headings
  *  @anchor SetCurrentSelectedOutputUserNumber_c
  *  @par C Example:
  *  @include SetCurrentSelectedOutputUserNumber.c
+ *  @par File multi_punch :
+ *  @include multi_punch
  */
 	IPQ_DLL_EXPORT IPQ_RESULT  SetCurrentSelectedOutputUserNumber(int id, int n);