From: wolf Date: Wed, 9 Feb 2000 18:05:59 +0000 (+0000) Subject: Some more words about example programs. X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c389d880671c2db453d6921492f22d95b8ee63e8;p=dealii-svn.git Some more words about example programs. git-svn-id: https://svn.dealii.org/trunk@2353 0785d39b-7218-0410-832d-ea1e28bc413d --- diff --git a/deal.II/doc/development/writing-documentation.html b/deal.II/doc/development/writing-documentation.html index 592b90d062..3cbc26a7cd 100644 --- a/deal.II/doc/development/writing-documentation.html +++ b/deal.II/doc/development/writing-documentation.html @@ -231,9 +231,30 @@

+

Writing example programs

+

+ At present, the tools that extract information from the example + programs are rather dumb. They are, to be precise, two Perl + scripts located in the directory of the + deal.II/doc/tutorial tree, where the HTML files are + generated. In principle, they extract plain text from all comments + in the programs that start with a double slash (C++ style + comment). Everything else is interpreted as program text and is + copied verbatim into the output. +

+ +

+ In the future, it would certainly help if the scripts understood + something like a title or section tag + (preferably something similar to the DocBook SGML commands for + that) in the comments, which could help to better structure the + output, especially for the longer programs. One would probably + like to put a section break before each new function or class, or + something along these lines. +