Index: Makefile.in
===================================================================
RCS file: /cvsroot/tcllib/tcllib/Makefile.in,v
retrieving revision 1.69
diff -u -r1.69 Makefile.in
--- Makefile.in	16 Apr 2002 18:22:38 -0000	1.69
+++ Makefile.in	23 Apr 2002 23:33:19 -0000
@@ -392,8 +392,9 @@
 ## * DOC_FLAGS  additional flags, or empty
 ## * DOC_EXT	extension for the generated file
 ## * DOC_MODE   which set of manpages to convert. default to 'user'.
-##              other sets: all, dev
+##              other sets: all, dev, single
 ##              all = user + dev, dev = internal manpages for developers.
+##              single = file is explicitly specified (DOC_FILE)
 #
 # Internal target ...
 #
@@ -406,6 +407,8 @@
 	    Xdev)   files=`ls $(srcdir)/modules/$$mod/*.dev.man 2>/dev/null` ; \
 		;; \
 	    Xall)   files=`ls $(srcdir)/modules/$$mod/*.man 2>/dev/null` ; \
+		;; \
+	    Xsingle) files=$$DOC_FILE ; \
 		;; \
             *)	echo ERROR, invalid mode $$DOC_MODE ; \
 		;; \
Index: modules/doctools/ChangeLog
===================================================================
RCS file: /cvsroot/tcllib/tcllib/modules/doctools/ChangeLog,v
retrieving revision 1.19
diff -u -r1.19 ChangeLog
--- modules/doctools/ChangeLog	10 Apr 2002 18:22:51 -0000	1.19
+++ modules/doctools/ChangeLog	23 Apr 2002 23:33:19 -0000
@@ -1,3 +1,8 @@
+2002-04-23  Andreas Kupries  <andreas_kupries@users.sourceforge.net>
+
+	* format.man: Added descriptions for all the commands performing
+	  semantic markup. This closes bug #527025.
+
 2002-04-10  Andreas Kupries  <andreas_kupries@users.sourceforge.net>
 
 	* mpexpand: Fixed error in checker of plain text.
Index: modules/doctools/format.man
===================================================================
RCS file: /cvsroot/tcllib/tcllib/modules/doctools/format.man,v
retrieving revision 1.3
diff -u -r1.3 format.man
--- modules/doctools/format.man	10 Mar 2002 02:49:52 -0000	1.3
+++ modules/doctools/format.man	23 Apr 2002 23:33:19 -0000
@@ -174,24 +174,84 @@
 
 [call [cmd arg] [arg text]]
 
-Declares that the marked text is the name of a command argument.
+Declares that the marked [arg text] is the name of a command argument.
 
 [call [cmd cmd] [arg text]]
 
-Declares that the marked text is the name of a command.
+Declares that the marked [arg text] is the name of a command.
 
 [call [cmd opt] [arg text]]
 
-Declares that the marked text is something optional. Most often used
+Declares that the marked [arg text] is something optional. Most often used
 in conjunction with [cmd arg] to denote optional command arguments.
 
 [call [cmd emph] [arg text]]
 
-One way to emphasize text in a general manner.
+One way to emphasize [arg text] in a general manner.
 
 [call [cmd strong] [arg text]]
 
-Another way to emphasize text in a general manner.
+Another way to emphasize [arg text] in a general manner.
+
+[call [cmd comment] [arg text]]
+
+Declares that the marked [arg text] is a comment.
+
+[call [cmd sectref] [arg text]]
+
+Declares that the marked [arg text] is a section reference.
+
+[call [cmd syscmd] [arg text]]
+
+Declares that the marked [arg text] is a system command.
+
+[call [cmd method] [arg text]]
+
+Declares that the marked [arg text] is a object method.
+
+[call [cmd option] [arg text]]
+
+Declares that the marked [arg text] is a option.
+
+[call [cmd widget] [arg text]]
+
+Declares that the marked [arg text] is a widget.
+
+[call [cmd fun] [arg text]]
+
+Declares that the marked [arg text] is a function.
+
+[call [cmd type] [arg text]]
+
+Declares that the marked [arg text] is a data type.
+
+[call [cmd package] [arg text]]
+
+Declares that the marked [arg text] is a package.
+
+[call [cmd class] [arg text]]
+
+Declares that the marked [arg text] is a class.
+
+[call [cmd var] [arg text]]
+
+Declares that the marked [arg text] is a variable.
+
+[call [cmd file] [arg text]]
+
+Declares that the marked [arg text] is a file .
+
+[call [cmd uri] [arg text]]
+
+Declares that the marked [arg text] is a uri.
+
+[call [cmd term] [arg text]]
+
+Declares that the marked [arg text] is a unspecific terminology.
+
+[call [cmd const] [arg text]]
+
+Declares that the marked [arg text] is a constant value.
 
 [call [cmd nl]]
 
