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