Attachment "527025.diff" to
ticket [527025ffff]
added by
andreas_kupries
2002-04-24 06:35:06.
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 <[email protected]>
+
+ * format.man: Added descriptions for all the commands performing
+ semantic markup. This closes bug #527025.
+
2002-04-10 Andreas Kupries <[email protected]>
* 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]]