Changeset 1023

Timestamp:

Jul 15, 2012 9:10:49 PM (11 years ago)

Author:

jemian

Message:

work-in-progress

File:

• specdomain/trunk/src/specdomain/doc/howto-markup.rst (modified) (2 diffs)

specdomain/trunk/src/specdomain/doc/howto-markup.rst

@@ -361 +361 @@
 Be sure to test your changes as you progress, until you are confident with reST markup.
 The *make* process is efficient, only rebuilding the documentation from affected
-.rst souce file changes.  However, you might need to make sure changes in the .mac files
+.rst souce file changes.  Usually, this also considers changes in the .mac files.
+This command is usually all it takes to rebuild the HTML documentation::
+
+        make html
+
+However, you might wish to make sure changes in the .mac files
 cause documentation to be rebuilt.  It might be easier, although less efficient,
-to rebuild your documentation each time.  
-
-::
+to rebuild your HTML documentation each time using this command::
         
         make clean html
 
-
-This is usually very fast (seconds).
+The builds are usually very fast (seconds).
 
 
@@ -408 +410 @@
 
 
+
+
 -----------------