diff options
| author | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-11-16 16:06:07 -0600 |
|---|---|---|
| committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-11-16 16:06:07 -0600 |
| commit | 5fbf99bcc4d03f3001f42905d1217758c4aeac13 (patch) | |
| tree | b61aa3fd6d7b0e8302a8b11a18ef2cab5f404951 /doc/kdevelop/documentation.docbook | |
| parent | 06c48bfff719dedfe6f271fe5a363453e4af6d31 (diff) | |
| download | tdevelop-5fbf99bcc4d03f3001f42905d1217758c4aeac13.tar.gz tdevelop-5fbf99bcc4d03f3001f42905d1217758c4aeac13.zip | |
Finish rename from prior commit
Diffstat (limited to 'doc/kdevelop/documentation.docbook')
| -rw-r--r-- | doc/kdevelop/documentation.docbook | 57 |
1 files changed, 0 insertions, 57 deletions
diff --git a/doc/kdevelop/documentation.docbook b/doc/kdevelop/documentation.docbook deleted file mode 100644 index 2214fed3..00000000 --- a/doc/kdevelop/documentation.docbook +++ /dev/null @@ -1,57 +0,0 @@ -<chapter id="documentation"> -<title>Documentation</title> - -<para> -Documention unfortunately belongs to the most-overlooked programming -issues. Yet, once properly set up and maintained internal and external -documentation provides most valuable help. -</para> - -<para> -Documentation has multiple facets. There is -<itemizedlist> - <listitem><para> - <emphasis>project internal documentation</emphasis>, mainly consisting of - <itemizedlist> - <listitem><para> - <emphasis>comments</emphasis> in header/source files - </para></listitem> - <listitem><para> - <emphasis>internal &API; documentation</emphasis> of your project - generated from the program file by special tools, ⪚ &doxygen; - </para></listitem> - </itemizedlist> - </para></listitem> - <listitem><para> - <emphasis>project external documentation</emphasis>, comprising among others - <itemizedlist> - <listitem><para> - <emphasis>external &API; documentation</emphasis> of ⪚ common system libraries (&kde;, &Qt;, &etc;) - </para></listitem> - <listitem><para> - any other documentation (programming language manuals, general system information, how-to articles and the like) - </para></listitem> - </itemizedlist> - </para></listitem> -</itemizedlist> -</para> -<para> -All this documentation should be easily maintainable and ready at hand whenever you need it. &tdevelop; has provisions for just this. -</para> - -<!-- ### doc browser, notes on internal documentation, how to profit from Doxygen --> - -<sect1 id="docbrowser"> -<title>The Documentation Browser</title> - - -<figure id="screenshot-doctreeview" float="1"> -<title>A Screenshot of the Documentation Tree</title> -<mediaobject> -<imageobject><imagedata fileref="doctreeview.png"/></imageobject> -</mediaobject> -</figure> - -</sect1> <!-- docbrowser --> - -</chapter> <!-- documentation --> |