diff --git a/doc/Section_modify.html b/doc/Section_modify.html
index 83b0eaf93c..271f2f777d 100644
--- a/doc/Section_modify.html
+++ b/doc/Section_modify.html
@@ -56,11 +56,15 @@ command like
 </P>
 <PRE>pair_style foo 0.1 3.5 
 </PRE>
-<P>then these lines should appear at the top of your pair_foo.h file:
+<P>then your pair_foo.h file should be structured as follows:
 </P>
 <PRE>#ifdef PAIR_CLASS
 PairStyle(foo,PairFoo)
-#else 
+#else
+...
+(class definition for PairFoo)
+...
+#endif 
 </PRE>
 <P>where "foo" is the style keyword in the pair_style command, and
 PairFoo is the class name defined in your pair_foo.cpp and pair_foo.h
diff --git a/doc/Section_modify.txt b/doc/Section_modify.txt
index c4eef5771d..fe81eaefa2 100644
--- a/doc/Section_modify.txt
+++ b/doc/Section_modify.txt
@@ -53,11 +53,15 @@ command like
 
 pair_style foo 0.1 3.5 :pre
 
-then these lines should appear at the top of your pair_foo.h file:
+then your pair_foo.h file should be structured as follows:
 
 #ifdef PAIR_CLASS
 PairStyle(foo,PairFoo)
-#else :pre
+#else
+...
+(class definition for PairFoo)
+...
+#endif :pre
 
 where "foo" is the style keyword in the pair_style command, and
 PairFoo is the class name defined in your pair_foo.cpp and pair_foo.h