You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdelibs/doc/common
tpearson 10308be19e
Revert automated changes
14 years ago
..
1.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
2.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
3.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
4.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
5.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
6.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
7.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
8.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
9.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
10.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
CMakeLists.txt [kdelibs] added initial cmake support 14 years ago
Doxyfile.global Revert automated changes 14 years ago
Makefile.am Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
README.Doxygen Revert automated changes 14 years ago
appheader.html Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
artistic-license.html Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
block_title_bottom.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
block_title_mid.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
block_title_top.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
bottom-left.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
bottom-middle.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
bottom-right.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
bottom1.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
bottom2.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
bsd-license.html Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
docheadergears.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
doctop1.png Revert automated changes 14 years ago
doctop1a-online.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
doctop1a.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
doctop1b.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
doctop2-online.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
doctop2.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
doxygen.css Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
favicon.ico Bugfix batch 1/2 14 years ago
fdl-license Revert automated changes 14 years ago
fdl-license.html Revert automated changes 14 years ago
fdl-notice.html Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
flat.css Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
footer.html Fixed documentation for Trinity project 14 years ago
gpl-license Revert automated changes 14 years ago
gpl-license.html Revert automated changes 14 years ago
grad.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
header.html Fixed documentation for Trinity project 14 years ago
headerbg.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kde-common.css Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kde-default.css Revert automated changes 14 years ago
kde-localised.css.template Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kde-web.css Revert automated changes 14 years ago
kde.css Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kde_gear_64.png Bugfix batch 1/2 14 years ago
kde_logo.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kde_logo_bg.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kmenu.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
lgpl-license Revert automated changes 14 years ago
lgpl-license.html Revert automated changes 14 years ago
mainfooter.html Fixed documentation for Trinity project 14 years ago
mainheader.html Fixed documentation for Trinity project 14 years ago
print.css Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
qpl-license.html Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
shadow.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
tabs.css Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
top-left.jpg Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
top-left.png Bugfix batch 1/2 14 years ago
top-middle.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
top-right-konqueror.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
top-right.jpg Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
top-right.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
top-trinity.jpg Bugfix batch 1/2 14 years ago
top.jpg Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
web-docbottom.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
web-doctop.png Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
x11-license.html Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
xml.dcl Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago

README.Doxygen

***
*** README for KDE's Doxygen tools
***

This directory contains tools and data files for Doxygen
generation. These are the GENERIC files; any module may
override them by putting specific replacements in doc/api/ .
This allows modules to customize their appearance as desired.
The files that may be overridden are:

- doxygen.css      Stylesheet.
- mainheader.html  Header for front page of dox. This should
                   not be terribly different from header.html.
		   It might contain special CSS for the footer.
- mainfooter.html  Footer for front page of dox. This should at
                   least credit Doxygen [1] and point to the dox
		   guidelines [2].
- header.html      Header file for regular pages.
- footer.html      Footer file for regular pages.
- Doxyfile.global  The global (brief) Doxyfile. For a long-style
                   Doxyfile, see KDE PIM's doc/api/Doxyfile.pim.

The tool for generating dox lives in admin/ :

- doxygen.sh       Script that does all the dox generation work.
                   See below for usage information.


In a configured build directory, you can use "make apidox" to
generate the API dox for the module -- assuming it has any, of course.
Writing dox is beyond the scope of this README -- see the notes at
http://techbase.kde.org/Policies/Library_Documentation_Policy .
You can generate dox by hand -- without even having a configured
build directory -- as explained below. There is also documentation
for the special tags you can enter in Makefile.am anywhere
in a module to modify dox generation.



***
*** Tool usage.
***

Usage:

doxygen.sh [--recurse] [--modulename] [--doxdatadir=<dir>] [--installdir=<dir>]
           <top_srcdir> [<subdir>]

--recurse     Also generate dox in subdirs of the given <subdir>. If no
              <subdir> is given, --recurse is the default and can be
              turned off with --no-recurse.
--modulename  By default, apidox are generated in a subdirectory 
              <modulename>-apidocs/ . You can use --no-modulename to
              suppress the <modulename> and generate the apidox in
              a subdirectory apidocs/ . Modulename is the last part of
              the <top_srcdir> (usually a KDE SVN module name).
--doxdatadir=<dir> Locate the HTML header files and support graphics.
              In kdelibs, the subdirectory doc/common/ contains these
              files (and this README). In an installed KDE system, 
              $KDEDIR/share/doc/HTML/en/common/ contains a copy.
              This argument is mandatory if doxygen.sh can't guess where
              the doxdata lives.
--installdir=<dir> Locate the directory where apidox from other modules
              is installed. Subdirectories named *-apidocs/ under the
              named <dir> are searched for tag files, for cross-module
              cross-referencing.



How to generate dox manually: <TODO>
Plan to fit these tools into ../Doxyfile.am: <TODO>
Differences with current dox: <TODO>

# A shell script that builds dox without all the tedious mucking about with
# autoconf and configure. Run it in the "top builddir" with one argument,
# the "top srcdir". Something like this:
#
# cd /mnt/build/kdepim
# sh /mnt/src/kdepim/doc/api/doxygen.sh /mnt/src/kdepim
#
# You can also build single subdirs (for instance, after updating some
# dox and you don't want to rebuild for the enitre module) by giving the
# subdirectory _relative to the top srcdir_ as a second argument:
#
# sh /mnt/src/kdepim/doc/api/doxygen.sh /mnt/src/kdepim kpilot/lib
# 
# When generating dox for kdelibs, a tag file for Qt is also created.
# The location of Qt is specified indirectly through $QTDOCDIR or,
# if that is not set, $QTDIR, or otherwise guessed. You may explicitly
# set the location of a pre-generated tag file with $QTDOCTAG. One
# typical approach might be:
#
# QTDOCTAG=$QTDIR/doc/qt.tag QTDOCDIR=http://doc.trolltech.com/3.3/
#
# Finally, there is a --no-recurse option for top-level generation
# that avoids generating all the subdirectories as well. It also
# suppresses cleaning up (rm -rf) of the dox direction beforehand.
#
# Post-finally, there is a --no-modulename option that builds the
# dox in "apidocs/" instead of "modulename-apidocs". The former is
# compatible with the KDE 3.4 build system, the latter is more convenient
# for the installed dox.

#
# A shell script to post-process doxy-generated files; the purpose
# is to make the menu on the left in the file match the actually
# generated files (ie. leave out namespaces if there are none).
#
# Usage: doxyndex.sh <toplevel-apidocs-dir> <relative-html-output-directory>
#
# Typically, this means $(top_builddir)/apidocs and something like
# libfoo/html for the output. For the top-level dig, set relative-html
# to "." . In non-top directories, both <!-- menu --> and <!-- gmenu -->
# are calculated and replaced. Top directories get an empty <!-- menu -->
# if any.