X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/f93647859c02f4bfd5c262e98a58399b660de9aa..9fcd0bf7f313e637e8cd4b5d7f3cd5b294fec033:/docs/tech/tn0003.txt diff --git a/docs/tech/tn0003.txt b/docs/tech/tn0003.txt index bec2e461ab..da54afac8d 100644 --- a/docs/tech/tn0003.txt +++ b/docs/tech/tn0003.txt @@ -1,15 +1,15 @@ - Adding wxWindows class documentation + Adding wxWidgets class documentation ==================================== This note is aimed at people wishing to add documentation for a -class to either the main wxWindows manual, or to their own +class to either the main wxWidgets manual, or to their own manual. -wxWindows uses Tex2RTF to process Latex-like input files (.tex) +wxWidgets uses Tex2RTF to process Latex-like input files (.tex) and output in HTML, WinHelp RTF and Word RTF. Tex2RTF is provided -in the wxWindows distribution and in the CVS archive, under +in the wxWidgets distribution and in the CVS archive, under utils/tex2rtf. Please start by perusing the Tex2RTF manual. -See http://www.wxwindows.org/tex2rtf/index.htm for a browseable +See http://www.wxwidgets.org/tex2rtf/index.htm for a browseable manual and binaries for specific platforms. If adding to the existing manual in docs/latex/wx, you need to @@ -20,7 +20,7 @@ and add the entry to topics.tex. If applicable, also add an entry to category.tex. If compiling a separate manual, copy an existing set of files from the -wxWindows manual or a contribution. Contribution documentation +wxWidgets manual or a contribution. Contribution documentation normally goes in the contrib/docs hierarchy, with the source going in a latex/mycontrib subdirectory. @@ -55,12 +55,12 @@ parameter, and then choose FILE|GO from the menu. For example: tex2rtf manual.tex manual.rtf -rtf -twice -interactive NOTE: You must be using the latest tex2rtf which was released with -v2.2.0 of wxWindows to use the -interactive switch +v2.2.0 of wxWidgets to use the -interactive switch If you wish to generate documentation for wxHTML Help Viewer (or Windows HTML Help), set htmlWorkshopFiles to true in your tex2rtf.ini file. See also the wxHTML Notes section in the -wxWindows manual. To further speed-up HTML help books loading +wxWidgets manual. To further speed-up HTML help books loading in your application, you may use hhp2cached (utils/hhp2cached). src/msw/makefile.vc contains targets for generating various @@ -93,7 +93,7 @@ DO: \end{verbatim} block - check that your changes/additions to any TEX documentation - compiles before checking it in! Use the '-checkcurleybraces' + compiles before checking it in! Use the '-checkcurlybraces' and '-checksyntax' commandline parameters (or the OPTIONS menu if running in GUI mode) to check for some of the more common mistakes. See TROUBLESHOOTING below for more details @@ -154,7 +154,7 @@ here is one important tip: caused the problem. When making changes/additions to the documentation, always use - the '-checkcurleybraces' and '-checksyntax' commandline parameters + the '-checkcurlybraces' and '-checksyntax' commandline parameters (or turn these options on in the GUI version via the OPTIONS menu choice), BEFORE checking in your changes. These two debugging options will catch many of the more common mistakes that are made