Revise the description of \programopt, document \longprogramopt.
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 @@
\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 @@
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.