Revise the description of \programopt, document \longprogramopt.

1 files changed, 10 insertions, 2 deletions

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index 55f93b4..fc99d9c 100644
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -506,7 +506,15 @@ distribution, to create or maintain whole documents or sections.
     \end{macrodesc}
 
     \begin{macrodesc}{programopt}{\p{option}}
-      A command-line option to an executable program.
+      A command-line option to an executable program.  Use this only
+      for ``shot'' options, and include the leading hyphen.
+    \end{macrodesc}
+
+    \begin{macrodesc}{longprogramopt}{\p{option}}
+      A long command-line option to an executable program.  This
+      should only be used for long option names which will be prefixed
+      by two hyphens; the hyphens should not be provided as part of
+      \var{option}.
     \end{macrodesc}
 
     \begin{macrodesc}{refmodule}{\op{key}\p{name}}
@@ -987,7 +995,7 @@ distribution, to create or maintain whole documents or sections.
 	symbolic link to it or run it in place; the actual script file 
 	must be stored as part of the documentation source tree,
 	though it may be used to format documents outside the
-	tree.  Use \program{mkhowto} \programopt{-}\programopt{-help}
+	tree.  Use \program{mkhowto} \longprogramopt{help}
         for a list of
         command line options.