1[comment {-*- tcl -*- doctools manpage}]
2[manpage_begin doctools_lang_faq n 1.0]
3[copyright {2007 Andreas Kupries <andreas_kupries@users.sourceforge.net>}]
4[moddesc   {Documentation tools}]
5[titledesc {doctools language faq}]
6[category  {Documentation tools}]
7[description]
8[para]
9
10[section OVERVIEW]
11
12[subsection {What is this document?}]
13
14This document is currently mainly a placeholder, to be filled with
15commonly asked questions about the doctools markup language and
16companions, and their answers.
17
18[para]
19
20Please report any questions (and, if possible, answers) we should
21consider for this document in the category [emph doctools] of the
22[uri {http://sourceforge.net/tracker/?group_id=12883} {Tcllib SF Trackers}].
23
24[section EXAMPLES]
25
26[subsection {Where do I find doctools examples?}]
27
28The most examples of doctools markup currently known can be found in
29the Tcllib and Tklib package bundles where basically the documentation
30of all packages is written in it.
31
32In Tcllib you will also find the sources for the doctools
33documentation themselves, which makes use of nearly all of the
34available markup commands.
35
36You need one of
37
38[list_begin enumerated]
39
40[enum]
41A CVS snapshot of Tcllib. How to retrieve such a snapshot and the
42tools required for this are described at
43[uri http://sourceforge.net/cvs/?group_id=12883]
44
45[enum]
46A Tcllib release archive. They are available at
47[uri http://sourceforge.net/project/showfiles.php?group_id=12883]
48
49[list_end]
50
51
52[section {BUGS, IDEAS, FEEDBACK}]
53
54This document, will undoubtedly contain bugs and other problems.
55
56Please report any such in the category [emph doctools] of the
57[uri {http://sourceforge.net/tracker/?group_id=12883} {Tcllib SF Trackers}].
58
59Please also report any ideas for enhancements you may have for either
60the package and/or the documentation.
61
62[see_also doctools_lang_intro]
63[see_also doctools_lang_syntax]
64[see_also doctools_lang_cmdref]
65[keywords examples faq markup {semantic markup}]
66[keywords {doctools markup} {doctools language}]
67[keywords {doctools syntax} {doctools commands}]
68[manpage_end]
69