From c48d615e7dbfa1f50505399b5d7d46da9a250d3f Mon Sep 17 00:00:00 2001
From: sjplimp <sjplimp@f3b2605a-c512-4ea7-a41b-209d697bcdaa>
Date: Sat, 8 Aug 2009 22:03:37 +0000
Subject: [PATCH] git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@3029
 f3b2605a-c512-4ea7-a41b-209d697bcdaa

---
 doc/fix_addforce.html | 21 ++++++++++++++++++---
 doc/fix_addforce.txt  | 17 +++++++++++++----
 doc/fix_aveforce.html | 23 +++++++++++++++++++----
 doc/fix_aveforce.txt  | 19 ++++++++++++++-----
 4 files changed, 64 insertions(+), 16 deletions(-)

diff --git a/doc/fix_addforce.html b/doc/fix_addforce.html
index 9b3fe8f9e9..9017270cbc 100644
--- a/doc/fix_addforce.html
+++ b/doc/fix_addforce.html
@@ -13,11 +13,22 @@
 </H3>
 <P><B>Syntax:</B>
 </P>
-<PRE>fix ID group-ID addforce fx fy fz 
+<PRE>fix ID group-ID addforce fx fy fz keyword value ... 
 </PRE>
-<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
-<LI>addforce = style name of this fix command
+<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command 
+
+<LI>addforce = style name of this fix command 
+
 <LI>fx,fy,fz = force component values (force units) 
+
+<LI>zero or more keyword/value pairs may be appended to args 
+
+<LI>keyword = <I>region</I>  
+
+<PRE>  <I>region</I> value = region-ID
+    region-ID = ID of region atoms must be in to have added force 
+</PRE>
+
 </UL>
 <P><B>Examples:</B>
 </P>
@@ -30,6 +41,10 @@ the group.  This command can be used to give an additional push to
 atoms in a simulation, such as for a simulation of Poiseuille flow in
 a channel.
 </P>
+<P>If the <I>region</I> keyword is used, the atom must also be in the
+specified geometric <A HREF = "region.html">region</A> in order to have force added
+to it.
+</P>
 <P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
 </P>
 <P>No information about this fix is written to <A HREF = "restart.html">binary restart
diff --git a/doc/fix_addforce.txt b/doc/fix_addforce.txt
index 014db2b820..38bc06f834 100644
--- a/doc/fix_addforce.txt
+++ b/doc/fix_addforce.txt
@@ -10,11 +10,16 @@ fix addforce command :h3
 
 [Syntax:]
 
-fix ID group-ID addforce fx fy fz :pre
+fix ID group-ID addforce fx fy fz keyword value ... :pre
 
-ID, group-ID are documented in "fix"_fix.html command
-addforce = style name of this fix command
-fx,fy,fz = force component values (force units) :ul
+ID, group-ID are documented in "fix"_fix.html command :ulb,l
+addforce = style name of this fix command :l
+fx,fy,fz = force component values (force units) :l
+zero or more keyword/value pairs may be appended to args :l
+keyword = {region}  :l
+  {region} value = region-ID
+    region-ID = ID of region atoms must be in to have added force :pre
+:ule
 
 [Examples:]
 
@@ -27,6 +32,10 @@ the group.  This command can be used to give an additional push to
 atoms in a simulation, such as for a simulation of Poiseuille flow in
 a channel.
 
+If the {region} keyword is used, the atom must also be in the
+specified geometric "region"_region.html in order to have force added
+to it.
+
 [Restart, fix_modify, output, run start/stop, minimize info:]
 
 No information about this fix is written to "binary restart
diff --git a/doc/fix_aveforce.html b/doc/fix_aveforce.html
index 00f905165f..36fd348a86 100644
--- a/doc/fix_aveforce.html
+++ b/doc/fix_aveforce.html
@@ -13,16 +13,27 @@
 </H3>
 <P><B>Syntax:</B>
 </P>
-<PRE>fix ID group-ID aveforce fx fy fz 
+<PRE>fix ID group-ID aveforce fx fy fz keyword value ... 
 </PRE>
-<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
-<LI>aveforce = style name of this fix command
+<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command 
+
+<LI>aveforce = style name of this fix command 
+
 <LI>fx,fy,fz = force component values (force units) 
+
+<LI>zero or more keyword/value pairs may be appended to args 
+
+<LI>keyword = <I>region</I>  
+
+<PRE>  <I>region</I> value = region-ID
+    region-ID = ID of region atoms must be in to have added force 
+</PRE>
+
 </UL>
 <P><B>Examples:</B>
 </P>
 <PRE>fix pressdown topwall aveforce 0.0 -1.0 0.0
-fix 2 bottomwall aveforce NULL -1.0 0.0 
+fix 2 bottomwall aveforce NULL -1.0 0.0 region top 
 </PRE>
 <P><B>Description:</B>
 </P>
@@ -41,6 +52,10 @@ dimension are not changed.  Note that this is not the same as
 specifying a 0.0 value, since that sets all forces to the same average
 value without adding in any additional force.
 </P>
+<P>If the <I>region</I> keyword is used, the atom must also be in the
+specified geometric <A HREF = "region.html">region</A> in order to have force added
+to it.
+</P>
 <P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
 </P>
 <P>No information about this fix is written to <A HREF = "restart.html">binary restart
diff --git a/doc/fix_aveforce.txt b/doc/fix_aveforce.txt
index 25bbc939b7..2e4406a684 100644
--- a/doc/fix_aveforce.txt
+++ b/doc/fix_aveforce.txt
@@ -10,16 +10,21 @@ fix aveforce command :h3
 
 [Syntax:]
 
-fix ID group-ID aveforce fx fy fz :pre
+fix ID group-ID aveforce fx fy fz keyword value ... :pre
 
-ID, group-ID are documented in "fix"_fix.html command
-aveforce = style name of this fix command
-fx,fy,fz = force component values (force units) :ul
+ID, group-ID are documented in "fix"_fix.html command :ulb,l
+aveforce = style name of this fix command :l
+fx,fy,fz = force component values (force units) :l
+zero or more keyword/value pairs may be appended to args :l
+keyword = {region}  :l
+  {region} value = region-ID
+    region-ID = ID of region atoms must be in to have added force :pre
+:ule
 
 [Examples:]
 
 fix pressdown topwall aveforce 0.0 -1.0 0.0
-fix 2 bottomwall aveforce NULL -1.0 0.0 :pre
+fix 2 bottomwall aveforce NULL -1.0 0.0 region top :pre
 
 [Description:]
 
@@ -38,6 +43,10 @@ dimension are not changed.  Note that this is not the same as
 specifying a 0.0 value, since that sets all forces to the same average
 value without adding in any additional force.
 
+If the {region} keyword is used, the atom must also be in the
+specified geometric "region"_region.html in order to have force added
+to it.
+
 [Restart, fix_modify, output, run start/stop, minimize info:]
 
 No information about this fix is written to "binary restart