From ce4a32fe52ef09d8f5ff1dd22c001110902b60a2 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/common/1.png | Bin 0 -> 236 bytes doc/common/10.png | Bin 0 -> 284 bytes doc/common/2.png | Bin 0 -> 261 bytes doc/common/3.png | Bin 0 -> 265 bytes doc/common/4.png | Bin 0 -> 260 bytes doc/common/5.png | Bin 0 -> 261 bytes doc/common/6.png | Bin 0 -> 278 bytes doc/common/7.png | Bin 0 -> 253 bytes doc/common/8.png | Bin 0 -> 275 bytes doc/common/9.png | Bin 0 -> 284 bytes doc/common/Doxyfile.global | 201 +++++++++++++ doc/common/Makefile.am | 21 ++ doc/common/README.Doxygen | 116 ++++++++ doc/common/appheader.html | 36 +++ doc/common/artistic-license.html | 165 +++++++++++ doc/common/block_title_bottom.png | Bin 0 -> 292 bytes doc/common/block_title_mid.png | Bin 0 -> 202 bytes doc/common/block_title_top.png | Bin 0 -> 323 bytes doc/common/bottom-left.png | Bin 0 -> 665 bytes doc/common/bottom-middle.png | Bin 0 -> 174 bytes doc/common/bottom-right.png | Bin 0 -> 4922 bytes doc/common/bottom1.png | Bin 0 -> 168 bytes doc/common/bottom2.png | Bin 0 -> 6979 bytes doc/common/bsd-license.html | 45 +++ doc/common/docheadergears.png | Bin 0 -> 9282 bytes doc/common/doctop1.png | Bin 0 -> 12235 bytes doc/common/doctop1a-online.png | Bin 0 -> 444 bytes doc/common/doctop1a.png | Bin 0 -> 850 bytes doc/common/doctop1b.png | Bin 0 -> 2313 bytes doc/common/doctop2-online.png | Bin 0 -> 257 bytes doc/common/doctop2.png | Bin 0 -> 260 bytes doc/common/doxygen.css | 96 +++++++ doc/common/favicon.ico | Bin 0 -> 1406 bytes doc/common/fdl-license | 397 ++++++++++++++++++++++++++ doc/common/fdl-license.html | 512 ++++++++++++++++++++++++++++++++++ doc/common/fdl-notice.html | 15 + doc/common/flat.css | 446 +++++++++++++++++++++++++++++ doc/common/footer.html | 64 +++++ doc/common/gpl-license | 340 ++++++++++++++++++++++ doc/common/gpl-license.html | 381 +++++++++++++++++++++++++ doc/common/grad.png | Bin 0 -> 248 bytes doc/common/header.html | 67 +++++ doc/common/headerbg.png | Bin 0 -> 493 bytes doc/common/kde-common.css | 32 +++ doc/common/kde-default.css | 327 ++++++++++++++++++++++ doc/common/kde-localised.css.template | 32 +++ doc/common/kde-web.css | 178 ++++++++++++ doc/common/kde.css | 468 +++++++++++++++++++++++++++++++ doc/common/kde_gear_64.png | Bin 0 -> 6357 bytes doc/common/kde_logo.png | Bin 0 -> 29911 bytes doc/common/kde_logo_bg.png | Bin 0 -> 199 bytes doc/common/kmenu.png | Bin 0 -> 845 bytes doc/common/lgpl-license | 504 +++++++++++++++++++++++++++++++++ doc/common/lgpl-license.html | 502 +++++++++++++++++++++++++++++++++ doc/common/mainfooter.html | 72 +++++ doc/common/mainheader.html | 66 +++++ doc/common/print.css | 455 ++++++++++++++++++++++++++++++ doc/common/qpl-license.html | 164 +++++++++++ doc/common/shadow.png | Bin 0 -> 213 bytes doc/common/tabs.css | 102 +++++++ doc/common/top-kde.jpg | Bin 0 -> 2944 bytes doc/common/top-left.jpg | Bin 0 -> 631 bytes doc/common/top-left.png | Bin 0 -> 15484 bytes doc/common/top-middle.png | Bin 0 -> 233 bytes doc/common/top-right-konqueror.png | Bin 0 -> 16195 bytes doc/common/top-right.jpg | Bin 0 -> 646 bytes doc/common/top-right.png | Bin 0 -> 4248 bytes doc/common/top.jpg | Bin 0 -> 486 bytes doc/common/web-docbottom.png | Bin 0 -> 6762 bytes doc/common/web-doctop.png | Bin 0 -> 14939 bytes doc/common/x11-license.html | 45 +++ doc/common/xml.dcl | 179 ++++++++++++ 72 files changed, 6028 insertions(+) create mode 100644 doc/common/1.png create mode 100644 doc/common/10.png create mode 100644 doc/common/2.png create mode 100644 doc/common/3.png create mode 100644 doc/common/4.png create mode 100644 doc/common/5.png create mode 100644 doc/common/6.png create mode 100644 doc/common/7.png create mode 100644 doc/common/8.png create mode 100644 doc/common/9.png create mode 100644 doc/common/Doxyfile.global create mode 100644 doc/common/Makefile.am create mode 100644 doc/common/README.Doxygen create mode 100644 doc/common/appheader.html create mode 100644 doc/common/artistic-license.html create mode 100644 doc/common/block_title_bottom.png create mode 100644 doc/common/block_title_mid.png create mode 100644 doc/common/block_title_top.png create mode 100644 doc/common/bottom-left.png create mode 100644 doc/common/bottom-middle.png create mode 100644 doc/common/bottom-right.png create mode 100644 doc/common/bottom1.png create mode 100644 doc/common/bottom2.png create mode 100644 doc/common/bsd-license.html create mode 100644 doc/common/docheadergears.png create mode 100644 doc/common/doctop1.png create mode 100644 doc/common/doctop1a-online.png create mode 100644 doc/common/doctop1a.png create mode 100644 doc/common/doctop1b.png create mode 100644 doc/common/doctop2-online.png create mode 100644 doc/common/doctop2.png create mode 100644 doc/common/doxygen.css create mode 100644 doc/common/favicon.ico create mode 100644 doc/common/fdl-license create mode 100644 doc/common/fdl-license.html create mode 100644 doc/common/fdl-notice.html create mode 100644 doc/common/flat.css create mode 100644 doc/common/footer.html create mode 100644 doc/common/gpl-license create mode 100644 doc/common/gpl-license.html create mode 100644 doc/common/grad.png create mode 100644 doc/common/header.html create mode 100644 doc/common/headerbg.png create mode 100644 doc/common/kde-common.css create mode 100644 doc/common/kde-default.css create mode 100644 doc/common/kde-localised.css.template create mode 100644 doc/common/kde-web.css create mode 100644 doc/common/kde.css create mode 100644 doc/common/kde_gear_64.png create mode 100644 doc/common/kde_logo.png create mode 100644 doc/common/kde_logo_bg.png create mode 100644 doc/common/kmenu.png create mode 100644 doc/common/lgpl-license create mode 100644 doc/common/lgpl-license.html create mode 100644 doc/common/mainfooter.html create mode 100644 doc/common/mainheader.html create mode 100644 doc/common/print.css create mode 100644 doc/common/qpl-license.html create mode 100644 doc/common/shadow.png create mode 100644 doc/common/tabs.css create mode 100644 doc/common/top-kde.jpg create mode 100644 doc/common/top-left.jpg create mode 100644 doc/common/top-left.png create mode 100644 doc/common/top-middle.png create mode 100644 doc/common/top-right-konqueror.png create mode 100644 doc/common/top-right.jpg create mode 100644 doc/common/top-right.png create mode 100644 doc/common/top.jpg create mode 100644 doc/common/web-docbottom.png create mode 100644 doc/common/web-doctop.png create mode 100644 doc/common/x11-license.html create mode 100644 doc/common/xml.dcl (limited to 'doc/common') diff --git a/doc/common/1.png b/doc/common/1.png new file mode 100644 index 000000000..608fad359 Binary files /dev/null and b/doc/common/1.png differ diff --git a/doc/common/10.png b/doc/common/10.png new file mode 100644 index 000000000..39e55197c Binary files /dev/null and b/doc/common/10.png differ diff --git a/doc/common/2.png b/doc/common/2.png new file mode 100644 index 000000000..544473884 Binary files /dev/null and b/doc/common/2.png differ diff --git a/doc/common/3.png b/doc/common/3.png new file mode 100644 index 000000000..64b87c715 Binary files /dev/null and b/doc/common/3.png differ diff --git a/doc/common/4.png b/doc/common/4.png new file mode 100644 index 000000000..c308193ac Binary files /dev/null and b/doc/common/4.png differ diff --git a/doc/common/5.png b/doc/common/5.png new file mode 100644 index 000000000..24799f0a4 Binary files /dev/null and b/doc/common/5.png differ diff --git a/doc/common/6.png b/doc/common/6.png new file mode 100644 index 000000000..8919a670c Binary files /dev/null and b/doc/common/6.png differ diff --git a/doc/common/7.png b/doc/common/7.png new file mode 100644 index 000000000..e30e8a70c Binary files /dev/null and b/doc/common/7.png differ diff --git a/doc/common/8.png b/doc/common/8.png new file mode 100644 index 000000000..3e35c8827 Binary files /dev/null and b/doc/common/8.png differ diff --git a/doc/common/9.png b/doc/common/9.png new file mode 100644 index 000000000..ed2f14b4e Binary files /dev/null and b/doc/common/9.png differ diff --git a/doc/common/Doxyfile.global b/doc/common/Doxyfile.global new file mode 100644 index 000000000..a655e7732 --- /dev/null +++ b/doc/common/Doxyfile.global @@ -0,0 +1,201 @@ +OUTPUT_LANGUAGE = English +USE_WINDOWS_ENCODING = NO +BRIEF_MEMBER_DESC = NO +REPEAT_BRIEF = YES +ABBREVIATE_BRIEF = +ALWAYS_DETAILED_SEC = YES +INLINE_INHERITED_MEMB = NO +FULL_PATH_NAMES = NO +STRIP_FROM_PATH = +SHORT_NAMES = NO +JAVADOC_AUTOBRIEF = YES +MULTILINE_CPP_IS_BRIEF = NO +INHERIT_DOCS = YES +DISTRIBUTE_GROUP_DOC = NO +TAB_SIZE = 4 +OPTIMIZE_OUTPUT_FOR_C = NO +OPTIMIZE_OUTPUT_JAVA = NO +SUBGROUPING = YES +EXTRACT_ALL = YES +EXTRACT_PRIVATE = NO +EXTRACT_STATIC = YES +EXTRACT_LOCAL_CLASSES = NO +HIDE_UNDOC_MEMBERS = NO +HIDE_UNDOC_CLASSES = YES +HIDE_FRIEND_COMPOUNDS = YES +HIDE_IN_BODY_DOCS = NO +INTERNAL_DOCS = YES +CASE_SENSE_NAMES = YES +HIDE_SCOPE_NAMES = NO +SHOW_INCLUDE_FILES = YES +INLINE_INFO = YES +SORT_BRIEF_DOCS = YES +SORT_BY_SCOPE_NAME = NO +GENERATE_TESTLIST = NO +GENERATE_BUGLIST = YES +GENERATE_DEPRECATEDLIST= YES +ENABLED_SECTIONS = +MAX_INITIALIZER_LINES = 30 +SHOW_USED_FILES = YES +QUIET = NO +WARNINGS = YES +WARN_IF_UNDOCUMENTED = YES +WARN_IF_DOC_ERROR = YES +WARN_FORMAT = +WARN_LOGFILE = +INPUT = +FILE_PATTERNS = *.h \ + *.cpp \ + *.cc \ + *.hpp \ + *.dox \ + *.c++ \ + *.cxx \ + *.h++ \ + *.hh +RECURSIVE = YES +EXCLUDE = +EXCLUDE_SYMLINKS = NO +EXCLUDE_PATTERNS = */.svn/* \ + */.git/* \ + */cmake/* \ + *.moc.* \ + moc* \ + *.all_cpp.* \ + *unload.* \ + */test/* \ + */tests/* \ + *_p.h *_p.cpp +EXAMPLE_PATH = +EXAMPLE_PATTERNS = +EXAMPLE_RECURSIVE = NO +IMAGE_PATH = +INPUT_FILTER = +FILTER_SOURCE_FILES = NO +SOURCE_BROWSER = YES +INLINE_SOURCES = NO +STRIP_CODE_COMMENTS = YES +REFERENCED_BY_RELATION = YES +REFERENCES_RELATION = YES +VERBATIM_HEADERS = YES +ALPHABETICAL_INDEX = YES +COLS_IN_ALPHA_INDEX = 3 +HTML_OUTPUT = +HTML_FILE_EXTENSION = .html +HTML_HEADER = ../apidocs/common/header.html +HTML_FOOTER = ../apidocs/common/footer.html +HTML_STYLESHEET = ../apidocs/common/doxygen.css +HTML_ALIGN_MEMBERS = YES +GENERATE_HTMLHELP = NO +CHM_FILE = +HHC_LOCATION = +GENERATE_CHI = NO +BINARY_TOC = NO +TOC_EXPAND = NO +DISABLE_INDEX = YES +ENUM_VALUES_PER_LINE = 4 +GENERATE_TREEVIEW = NO +TREEVIEW_WIDTH = 250 +GENERATE_LATEX = NO +LATEX_OUTPUT = +LATEX_CMD_NAME = latex +MAKEINDEX_CMD_NAME = makeindex +COMPACT_LATEX = NO +PAPER_TYPE = a4wide +EXTRA_PACKAGES = +LATEX_HEADER = +PDF_HYPERLINKS = NO +USE_PDFLATEX = NO +LATEX_BATCHMODE = NO +LATEX_HIDE_INDICES = NO +GENERATE_RTF = NO +RTF_OUTPUT = +COMPACT_RTF = NO +RTF_HYPERLINKS = NO +RTF_STYLESHEET_FILE = +RTF_EXTENSIONS_FILE = +GENERATE_MAN = NO +MAN_OUTPUT = +MAN_EXTENSION = .3 +MAN_LINKS = YES +GENERATE_XML = NO +XML_OUTPUT = xml +XML_SCHEMA = +XML_DTD = +XML_PROGRAMLISTING = NO +GENERATE_AUTOGEN_DEF = NO +GENERATE_PERLMOD = NO +PERLMOD_LATEX = NO +PERLMOD_PRETTY = YES +PERLMOD_MAKEVAR_PREFIX = +ENABLE_PREPROCESSING = YES +SEARCH_INCLUDES = YES +INCLUDE_PATH = +INCLUDE_FILE_PATTERNS = +EXPAND_AS_DEFINED = +SKIP_FUNCTION_MACROS = YES +ALLEXTERNALS = NO +EXTERNAL_GROUPS = NO +PERL_PATH = +CLASS_DIAGRAMS = YES +HIDE_UNDOC_RELATIONS = NO +HAVE_DOT = YES +UML_LOOK = NO +TEMPLATE_RELATIONS = YES +INCLUDE_GRAPH = YES +INCLUDED_BY_GRAPH = YES +CALL_GRAPH = NO +GRAPHICAL_HIERARCHY = YES +DOT_IMAGE_FORMAT = png +DOT_PATH = +DOTFILE_DIRS = +MAX_DOT_GRAPH_WIDTH = 800 +MAX_DOT_GRAPH_HEIGHT = 1024 +MAX_DOT_GRAPH_DEPTH = 0 +GENERATE_LEGEND = YES +DOT_CLEANUP = YES +SEARCHENGINE = NO + +### KDE Settings +ALIASES = \ + "intern=\parInternal use only." \ + "reimp=\parReimplemented from superclass." \ + "obsolete=@deprecated" \ + "feature=\xrefitem features \"Feature(s)\" \"Features\"" \ + "unmaintained=\xrefitem unmaintained \"Unmaintained\" \"Unmaintained\"" \ + "requirement=\xrefitem requirements \"Requirement(s)\" \"Requirements\"" \ + "faq=\xrefitem FAQ \"F.A.Q.\" \"F.A.Q.\"" \ + "authors=\xrefitem authors \"Author(s)\" \"Authors\"" \ + "maintainers=\xrefitem maintainers \"Maintainer(s)\" \"Maintainers\"" \ + "port4=\xrefitem port4 \"KDE 4 Porting Guide\" \"KDE 4 Porting Guide\"" \ + "glossary=\xrefitem glossary \"KDE 4 Glossary\" \"KDE 4 Glossary\"" \ + "acronym=\b "\ + "licenses=\xrefitem licenses \"License(s)\" \"Licenses\"" \ + "FIXME=\xrefitem fixme \"Fixme\" \"Fixme\"" \ + "bc=\xrefitem bc \"Binary Compatible\" \"Binary Compatible\"" \ + "threadsafe=\xrefitem threadsafe \"Threadsafe\" \"Threadsafe\"" \ + "artistic=Artistic" \ + "bsd=BSD" \ + "x11=X11" \ + "gpl=GPLv2" \ + "lgpl=LGPLv2" \ + "qpl=QPL" + +HTML_ALIGN_MEMBERS = YES +REFERENCED_BY_RELATION = NO +REFERENCES_RELATION = NO +VERBATIM_HEADERS = NO +SOURCE_BROWSER = YES +GENERATE_AUTOGEN_DEF = NO +DETAILS_AT_TOP = YES +SORT_MEMBER_DOCS = YES +SORT_MEMBERS_CTORS_1ST = YES +GENERATE_TODOLIST = YES +IGNORE_PREFIX = K +CLASS_GRAPH = YES +COLLABORATION_GRAPH = NO + + +MACRO_EXPANSION = YES +EXPAND_ONLY_PREDEF = YES + diff --git a/doc/common/Makefile.am b/doc/common/Makefile.am new file mode 100644 index 000000000..dade6749e --- /dev/null +++ b/doc/common/Makefile.am @@ -0,0 +1,21 @@ +# logotp3.png, logotp3-small.png and kde-localised.css.template +# are not included in the language-specific common directory +# They serve only as `reference' versions. + +commondir = $(kde_htmldir)/en/common + +common_DATA = artistic-license.html bottom1.png bottom2.png bsd-license.html \ + doctop1.png doctop2.png fdl-license fdl-license.html gpl-license \ + gpl-license.html kde-common.css kde-default.css kde-web.css \ + kde-localised.css.template lgpl-license lgpl-license.html \ + qpl-license.html shadow.png web-docbottom.png \ + x11-license.html xml.dcl web-doctop.png \ + doctop1a.png doctop1b.png 1.png 2.png 3.png 4.png 5.png 6.png \ + 7.png 8.png 9.png 10.png \ + doxygen.css header.html footer.html mainheader.html appheader.html \ + mainfooter.html fdl-notice.html \ + favicon.ico kde_gear_64.png \ + docheadergears.png headerbg.png grad.png kmenu.png \ + kde_logo.png kde_logo_bg.png bottom-left.png bottom-middle.png bottom-right.png \ + top-left.png top-middle.png top-right-konqueror.png + diff --git a/doc/common/README.Doxygen b/doc/common/README.Doxygen new file mode 100644 index 000000000..77b6bfe5f --- /dev/null +++ b/doc/common/README.Doxygen @@ -0,0 +1,116 @@ +*** +*** 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=] [--installdir=] + [] + +--recurse Also generate dox in subdirs of the given . If no + is given, --recurse is the default and can be + turned off with --no-recurse. +--modulename By default, apidox are generated in a subdirectory + -apidocs/ . You can use --no-modulename to + suppress the and generate the apidox in + a subdirectory apidocs/ . Modulename is the last part of + the (usually a KDE SVN module name). +--doxdatadir= 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= Locate the directory where apidox from other modules + is installed. Subdirectories named *-apidocs/ under the + named are searched for tag files, for cross-module + cross-referencing. + + + +How to generate dox manually: +Plan to fit these tools into ../Doxyfile.am: +Differences with current dox: + +# 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 +# +# 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 and +# are calculated and replaced. Top directories get an empty +# if any. + diff --git a/doc/common/appheader.html b/doc/common/appheader.html new file mode 100644 index 000000000..817934847 --- /dev/null +++ b/doc/common/appheader.html @@ -0,0 +1,36 @@ + + + + + $title ($projectname) + + +
+ + + + + + +
+ + +

$projectname API Documentation

+
+ + + + + + + + + + + + +
OverviewArchitectureClass HierarchyClassesClasses (annotated)MembersNamespacesSource Files
Search for 
+
+
+
+
diff --git a/doc/common/artistic-license.html b/doc/common/artistic-license.html new file mode 100644 index 000000000..2069b4ed0 --- /dev/null +++ b/doc/common/artistic-license.html @@ -0,0 +1,165 @@ + + + + The "Artistic License" + + + + + + + + + +

The "Artistic License"

+ +

Preamble

+ +

The intent of this document is to state the conditions under + which a Package may be copied, such that the Copyright Holder + maintains some semblance of artistic control over the + development of the package, while giving the users of the + package the right to use and distribute the Package in a + more-or-less customary fashion, plus the right to make + reasonable modifications.

+ +

Definitions

+ + +

"Package" refers to the collection of files distributed by the + Copyright Holder, and derivatives of that collection of files + created through textual modification.

+ +

"Standard Version" refers to such a Package if it has not been + modified, or has been modified in accordance with the wishes of + the Copyright Holder as specified below.

+ +

"Copyright Holder" is whoever is named in the copyright or + copyrights for the package.

+ +

"You" is you, if you're thinking about copying or distributing + this Package.

+ +

"Reasonable copying fee" is whatever you can justify on the + basis of media cost, duplication charges, time of people + involved, and so on. (You will not be required to justify it to + the Copyright Holder, but only to the computing community at + large as a market that must bear the fee.)

+ +

"Freely Available" means that no fee is charged for the item + itself, though there may be fees involved in handling the + item. It also means that recipients of the item may redistribute + it under the same conditions they received it.

+ + +
    +
  1. You may make and give away verbatim copies of the source + form of the Standard Version of this Package without + restriction, provided that you duplicate all of the original + copyright notices and associated disclaimers.
    2. + +
  2. You may apply bug fixes, portability fixes and other + modifications derived from the Public Domain or from the + Copyright Holder. A Package modified in such a way shall still + be considered the Standard Version.
    3. + +
  3. You may otherwise modify your copy of this Package in any + way, provided that you insert a prominent notice in each + changed file stating how and when you changed that file, and + provided that you do at least ONE of the following: +
      +
    1. place your modifications in the Public Domain or + otherwise make them Freely Available, such as by posting + said modifications to Usenet or an equivalent medium, or + placing the modifications on a major archive site such as + uunet.uu.net, or by allowing the Copyright Holder to + include your modifications in the Standard Version of the + Package.
      2. + +
    2. use the modified Package only within your corporation or + organization.
      3. + +
    3. rename any non-standard executables so the names do not + conflict with standard executables, which must also be + provided, and provide a separate manual page for each + non-standard executable that clearly documents how it + differs from the Standard Version. d. make other + distribution arrangements with the Copyright Holder.
      4. +
    +
    4. +
+ +

You may distribute the programs of this Package in object code + or executable form, provided that you do at least ONE of the + following:

+ +
    +
  1. distribute a Standard Version of the executables and library + files, together with instructions (in the manual page or + equivalent) on where to get the Standard Version.
    2. + +
  2. accompany the distribution with the machine-readable source + of the Package with your modifications.
    3. + +
  3. give non-standard executables non-standard names, and + clearly document the differences in manual pages (or + equivalent), together with instructions on where to get the + Standard Version.
    4. + +
  4. make other distribution arrangements with the Copyright + Holder.
    5. +
+ +

You may charge a reasonable copying fee for any distribution of + this Package. You may charge any fee you choose for support of + this Package. You may not charge a fee for this Package + itself. However, you may distribute this Package in aggregate + with other (possibly commercial) programs as part of a larger + (possibly commercial) software distribution provided that you do + not advertise this Package as a product of your own. You may + embed this Package's interpreter within an executable of yours + (by linking); this shall be construed as a mere form of + aggregation, provided that the complete Standard Version of the + interpreter is so embedded.

+ +

The scripts and library files supplied as input to or produced + as output from the programs of this Package do not automatically + fall under the copyright of this Package, but belong to whomever + generated them, and may be sold commercially, and may be + aggregated with this Package. If such scripts or library files + are aggregated with this Package via the so-called "undump" or + "unexec" methods of producing a binary executable image, then + distribution of such an image shall neither be construed as a + distribution of this Package nor shall it fall under the + restrictions of Paragraphs 3 and 4, provided that you do not + represent such an executable image as a Standard Version of this + Package.

+ +

C subroutines (or comparably compiled subroutines in other + languages) supplied by you and linked into this Package in order + to emulate subroutines and variables of the language defined by + this Package shall not be considered part of this Package, but + are the equivalent of input as in Paragraph 6, provided these + subroutines do not change the language in any way that would + cause it to fail the regression tests for the language.

+ +

Aggregation of this Package with a commercial distribution is + always permitted provided that the use of this Package is + embedded; that is, when no overt attempt is made to make this + Package's interfaces visible to the end user of the commercial + distribution. Such use shall not be construed as a distribution + of this Package.

+ +

The name of the Copyright Holder may not be used to endorse or + promote products derived from this software without specific + prior written permission.

+ +

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR + IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR + PURPOSE.

+ +
The End
+ + diff --git a/doc/common/block_title_bottom.png b/doc/common/block_title_bottom.png new file mode 100644 index 000000000..c0c0af512 Binary files /dev/null and b/doc/common/block_title_bottom.png differ diff --git a/doc/common/block_title_mid.png b/doc/common/block_title_mid.png new file mode 100644 index 000000000..f1ce933e9 Binary files /dev/null and b/doc/common/block_title_mid.png differ diff --git a/doc/common/block_title_top.png b/doc/common/block_title_top.png new file mode 100644 index 000000000..234437615 Binary files /dev/null and b/doc/common/block_title_top.png differ diff --git a/doc/common/bottom-left.png b/doc/common/bottom-left.png new file mode 100644 index 000000000..78c9fece3 Binary files /dev/null and b/doc/common/bottom-left.png differ diff --git a/doc/common/bottom-middle.png b/doc/common/bottom-middle.png new file mode 100644 index 000000000..41e52dd8a Binary files /dev/null and b/doc/common/bottom-middle.png differ diff --git a/doc/common/bottom-right.png b/doc/common/bottom-right.png new file mode 100644 index 000000000..ef81b04a8 Binary files /dev/null and b/doc/common/bottom-right.png differ diff --git a/doc/common/bottom1.png b/doc/common/bottom1.png new file mode 100644 index 000000000..cf26bf4f4 Binary files /dev/null and b/doc/common/bottom1.png differ diff --git a/doc/common/bottom2.png b/doc/common/bottom2.png new file mode 100644 index 000000000..051515538 Binary files /dev/null and b/doc/common/bottom2.png differ diff --git a/doc/common/bsd-license.html b/doc/common/bsd-license.html new file mode 100644 index 000000000..422bb339f --- /dev/null +++ b/doc/common/bsd-license.html @@ -0,0 +1,45 @@ + + + + BSD License + + + + + + + + + +

BSD License

+ +

Redistribution and use in source and binary forms, with or + without modification, are permitted provided that the following + conditions are met:

+ +
    +
  1. Redistributions of source code must retain the above + copyright notice, this list of conditions and the following + disclaimer.
    2. + +
  2. Redistributions in binary form must reproduce the above + copyright notice, this list of conditions and the following + disclaimer in the documentation and/or other materials + provided with the distribution.
    3. +
+ +

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY + EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, + THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR + BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF + THE POSSIBILITY OF SUCH DAMAGE.

+ + diff --git a/doc/common/docheadergears.png b/doc/common/docheadergears.png new file mode 100644 index 000000000..d2a64b788 Binary files /dev/null and b/doc/common/docheadergears.png differ diff --git a/doc/common/doctop1.png b/doc/common/doctop1.png new file mode 100644 index 000000000..9ddb33de3 Binary files /dev/null and b/doc/common/doctop1.png differ diff --git a/doc/common/doctop1a-online.png b/doc/common/doctop1a-online.png new file mode 100644 index 000000000..0e7512a97 Binary files /dev/null and b/doc/common/doctop1a-online.png differ diff --git a/doc/common/doctop1a.png b/doc/common/doctop1a.png new file mode 100644 index 000000000..123284c0b Binary files /dev/null and b/doc/common/doctop1a.png differ diff --git a/doc/common/doctop1b.png b/doc/common/doctop1b.png new file mode 100644 index 000000000..428a6e8cd Binary files /dev/null and b/doc/common/doctop1b.png differ diff --git a/doc/common/doctop2-online.png b/doc/common/doctop2-online.png new file mode 100644 index 000000000..9f9e744f3 Binary files /dev/null and b/doc/common/doctop2-online.png differ diff --git a/doc/common/doctop2.png b/doc/common/doctop2.png new file mode 100644 index 000000000..400ed5ff8 Binary files /dev/null and b/doc/common/doctop2.png differ diff --git a/doc/common/doxygen.css b/doc/common/doxygen.css new file mode 100644 index 000000000..48563b473 --- /dev/null +++ b/doc/common/doxygen.css @@ -0,0 +1,96 @@ +#content td.memItemLeft { +text-align: right; +} + +.groupHeader { +font-size: medium; +color: #418ADE; +} + +hr { display: none; } +#content h2 { margin-left: 0px; } + +table.memname { +empty-cells: show; +background-color: #f8f8f8; +outline: .2em solid #d7d7d7; +margin-top: 3em; +margin-bottom: 1em; +} + +td.memname { +white-space: nowrap; +font-weight: bold; +} + +.paramtype { +white-space: nowrap; +font-weight: bold; +} + +.paramname { +white-space: nowrap; +font-weight: bold; +} + +.paramkey { +text-align: right; +} + + +table.mdTable { +background-color: #f8f8f8; +outline: .2em solid #d7d7d7; +width: 80%; +} + +td.mdRow { padding: 8px 20px; } +td.md { font-weight: bold; } +td.mdname1 { font-weight: bold; color: #602020; } +td.mdname { font-weight: bold; color: #602020; } + +div.bic { +border: 2px solid #E72300; +background: #F6CFDD; +padding: 0.5ex 1em; +} + +div.memitem { +} + +div.memproto { +/*background: #F9F9F9; +border: 1px solid #AAAAAA;*/ +font-weight: bold; +} + +div.memproto td { +white-space: nowrap; +padding:0; +margin:0; +} + +table.memname { +border-spacing: 0; +border-collapse:collapse; +} + +td.paramtype { +font-family:monospace; +} + +div.memproto a.el { +font-family:monospace; +} + +div.memproto a.elRef { +font-family:monospace; +} + +SPAN.keyword { color: #008000 } +SPAN.keywordtype { color: #604020 } +SPAN.keywordflow { color: #e08000 } +SPAN.comment { color: #800000 } +SPAN.preprocessor { color: #806020 } +SPAN.stringliteral { color: #002080 } +SPAN.charliteral { color: #008080 } diff --git a/doc/common/favicon.ico b/doc/common/favicon.ico new file mode 100644 index 000000000..3741beba3 Binary files /dev/null and b/doc/common/favicon.ico differ diff --git a/doc/common/fdl-license b/doc/common/fdl-license new file mode 100644 index 000000000..4a0fe1c8d --- /dev/null +++ b/doc/common/fdl-license @@ -0,0 +1,397 @@ + GNU Free Documentation License + Version 1.2, November 2002 + + + Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. + 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + +0. PREAMBLE + +The purpose of this License is to make a manual, textbook, or other +functional and useful document "free" in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. + +This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + +1. APPLICABILITY AND DEFINITIONS + +This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The "Document", below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as "you". You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. + +A "Modified Version" of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall subject +(or to related matters) and contains nothing that could fall directly +within that overall subject. (Thus, if the Document is in part a +textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + +The "Invariant Sections" are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. + +The "Cover Texts" are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. + +A "Transparent" copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not "Transparent" is called "Opaque". + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, LaTeX input format, SGML +or XML using a publicly available DTD, and standard-conforming simple +HTML, PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. + +The "Title Page" means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, "Title Page" means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + +A section "Entitled XYZ" means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as "Acknowledgements", +"Dedications", "Endorsements", or "History".) To "Preserve the Title" +of such a section when you modify the Document means that it remains a +section "Entitled XYZ" according to this definition. + +The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. + + +2. VERBATIM COPYING + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + + +3. COPYING IN QUANTITY + +If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to give +them a chance to provide you with an updated version of the Document. + + +4. MODIFICATIONS + +You may copy and distribute a Modified Version of the Document under +the conditions of sections 2 and 3 above, provided that you release +the Modified Version under precisely this License, with the Modified +Version filling the role of the Document, thus licensing distribution +and modification of the Modified Version to whoever possesses a copy +of it. In addition, you must do these things in the Modified Version: + +A. Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions + (which should, if there were any, be listed in the History section + of the Document). You may use the same title as a previous version + if the original publisher of that version gives permission. +B. List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has fewer than five), + unless they release you from this requirement. +C. State on the Title page the name of the publisher of the + Modified Version, as the publisher. +D. Preserve all the copyright notices of the Document. +E. Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. +F. Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below. +G. Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. +H. Include an unaltered copy of this License. +I. Preserve the section Entitled "History", Preserve its Title, and add + to it an item stating at least the title, year, new authors, and + publisher of the Modified Version as given on the Title Page. If + there is no section Entitled "History" in the Document, create one + stating the title, year, authors, and publisher of the Document as + given on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. +J. Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise + the network locations given in the Document for previous versions + it was based on. These may be placed in the "History" section. + You may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. +K. For any section Entitled "Acknowledgements" or "Dedications", + Preserve the Title of the section, and preserve in the section all + the substance and tone of each of the contributor acknowledgements + and/or dedications given therein. +L. Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers + or the equivalent are not considered part of the section titles. +M. Delete any section Entitled "Endorsements". Such a section + may not be included in the Modified Version. +N. Do not retitle any existing section to be Entitled "Endorsements" + or to conflict in title with any Invariant Section. +O. Preserve any Warranty Disclaimers. + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section Entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties--for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + + +5. COMBINING DOCUMENTS + +You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice, and that you preserve all their Warranty Disclaimers. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections Entitled "History" +in the various original documents, forming one section Entitled +"History"; likewise combine any sections Entitled "Acknowledgements", +and any sections Entitled "Dedications". You must delete all sections +Entitled "Endorsements". + + +6. COLLECTIONS OF DOCUMENTS + +You may make a collection consisting of the Document and other documents +released under this License, and replace the individual copies of this +License in the various documents with a single copy that is included in +the collection, provided that you follow the rules of this License for +verbatim copying of each of the documents in all other respects. + +You may extract a single document from such a collection, and distribute +it individually under this License, provided you insert a copy of this +License into the extracted document, and follow this License in all +other respects regarding verbatim copying of that document. + + +7. AGGREGATION WITH INDEPENDENT WORKS + +A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, is called an "aggregate" if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on +covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic form. +Otherwise they must appear on printed covers that bracket the whole +aggregate. + + +8. TRANSLATION + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + +If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to Preserve +its Title (section 1) will typically require changing the actual +title. + + +9. TERMINATION + +You may not copy, modify, sublicense, or distribute the Document except +as expressly provided for under this License. Any other attempt to +copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, +parties who have received copies, or rights, from you under this +License will not have their licenses terminated so long as such +parties remain in full compliance. + + +10. FUTURE REVISIONS OF THIS LICENSE + +The Free Software Foundation may publish new, revised versions +of the GNU Free Documentation License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See +http://www.gnu.org/copyleft/. + +Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + + +ADDENDUM: How to use this License for your documents + +To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: + + Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.2 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled "GNU + Free Documentation License". + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the "with...Texts." line with this: + + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. diff --git a/doc/common/fdl-license.html b/doc/common/fdl-license.html new file mode 100644 index 000000000..9ce378a30 --- /dev/null +++ b/doc/common/fdl-license.html @@ -0,0 +1,512 @@ + + + + GNU Free Documentation License - version 1.1 + + + + + + + + + +

GNU Free Documentation License

+

+ Version 1.2, November 2002 +

+ +
+  Copyright (C) 2000,2001,2002  Free Software Foundation, Inc.
+  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+  Everyone is permitted to copy and distribute verbatim copies
+  of this license document, but changing it is not allowed.
+
+ +

+ 0. PREAMBLE +

+ +

+ The purpose of this License is to make a manual, textbook, or other + functional and useful document "free" in the sense of freedom: to + assure everyone the effective freedom to copy and redistribute it, + with or without modifying it, either commercially or noncommercially. + Secondarily, this License preserves for the author and publisher a way + to get credit for their work, while not being considered responsible + for modifications made by others. +

+ +

+ This License is a kind of "copyleft", which means that derivative + works of the document must themselves be free in the same sense. It + complements the GNU General Public License, which is a copyleft + license designed for free software. +

+ +

+ We have designed this License in order to use it for manuals for free + software, because free software needs free documentation: a free + program should come with manuals providing the same freedoms that the + software does. But this License is not limited to software manuals; + it can be used for any textual work, regardless of subject matter or + whether it is published as a printed book. We recommend this License + principally for works whose purpose is instruction or reference. +

+ +

+ 1. APPLICABILITY AND DEFINITIONS +

+ +

+ This License applies to any manual or other work, in any medium, that + contains a notice placed by the copyright holder saying it can be + distributed under the terms of this License. Such a notice grants a + world-wide, royalty-free license, unlimited in duration, to use that + work under the conditions stated herein. The "Document", below, + refers to any such manual or work. Any member of the public is a + licensee, and is addressed as "you". You accept the license if you + copy, modify or distribute the work in a way requiring permission + under copyright law. +

+ +

+ A "Modified Version" of the Document means any work containing the + Document or a portion of it, either copied verbatim, or with + modifications and/or translated into another language. +

+ +

+ A "Secondary Section" is a named appendix or a front-matter section of + the Document that deals exclusively with the relationship of the + publishers or authors of the Document to the Document's overall subject + (or to related matters) and contains nothing that could fall directly + within that overall subject. (Thus, if the Document is in part a + textbook of mathematics, a Secondary Section may not explain any + mathematics.) The relationship could be a matter of historical + connection with the subject or with related matters, or of legal, + commercial, philosophical, ethical or political position regarding + them. +

+ +

+ The "Invariant Sections" are certain Secondary Sections whose titles + are designated, as being those of Invariant Sections, in the notice + that says that the Document is released under this License. If a + section does not fit the above definition of Secondary then it is not + allowed to be designated as Invariant. The Document may contain zero + Invariant Sections. If the Document does not identify any Invariant + Sections then there are none. +

+ +

+ The "Cover Texts" are certain short passages of text that are listed, + as Front-Cover Texts or Back-Cover Texts, in the notice that says that + the Document is released under this License. A Front-Cover Text may + be at most 5 words, and a Back-Cover Text may be at most 25 words. +

+ +

+ A "Transparent" copy of the Document means a machine-readable copy, + represented in a format whose specification is available to the + general public, that is suitable for revising the document + straightforwardly with generic text editors or (for images composed of + pixels) generic paint programs or (for drawings) some widely available + drawing editor, and that is suitable for input to text formatters or + for automatic translation to a variety of formats suitable for input + to text formatters. A copy made in an otherwise Transparent file + format whose markup, or absence of markup, has been arranged to thwart + or discourage subsequent modification by readers is not Transparent. + An image format is not Transparent if used for any substantial amount + of text. A copy that is not "Transparent" is called "Opaque". +

+ +

+ Examples of suitable formats for Transparent copies include plain + ASCII without markup, Texinfo input format, LaTeX input format, SGML + or XML using a publicly available DTD, and standard-conforming simple + HTML, PostScript or PDF designed for human modification. Examples of + transparent image formats include PNG, XCF and JPG. Opaque formats + include proprietary formats that can be read and edited only by + proprietary word processors, SGML or XML for which the DTD and/or + processing tools are not generally available, and the + machine-generated HTML, PostScript or PDF produced by some word + processors for output purposes only. +

+ +

+ The "Title Page" means, for a printed book, the title page itself, + plus such following pages as are needed to hold, legibly, the material + this License requires to appear in the title page. For works in + formats which do not have any title page as such, "Title Page" means + the text near the most prominent appearance of the work's title, + preceding the beginning of the body of the text. +

+ +

+ A section "Entitled XYZ" means a named subunit of the Document whose + title either is precisely XYZ or contains XYZ in parentheses following + text that translates XYZ in another language. (Here XYZ stands for a + specific section name mentioned below, such as "Acknowledgements", + "Dedications", "Endorsements", or "History".) To "Preserve the Title" + of such a section when you modify the Document means that it remains a + section "Entitled XYZ" according to this definition. +

+ +

+ The Document may include Warranty Disclaimers next to the notice which + states that this License applies to the Document. These Warranty + Disclaimers are considered to be included by reference in this + License, but only as regards disclaiming warranties: any other + implication that these Warranty Disclaimers may have is void and has + no effect on the meaning of this License. +

+ +

+ 2. VERBATIM COPYING +

+ +

+ You may copy and distribute the Document in any medium, either + commercially or noncommercially, provided that this License, the + copyright notices, and the license notice saying this License applies + to the Document are reproduced in all copies, and that you add no other + conditions whatsoever to those of this License. You may not use + technical measures to obstruct or control the reading or further + copying of the copies you make or distribute. However, you may accept + compensation in exchange for copies. If you distribute a large enough + number of copies you must also follow the conditions in section 3. +

+ +

+ You may also lend copies, under the same conditions stated above, and + you may publicly display copies. +

+ +

+ 3. COPYING IN QUANTITY +

+ +

+ If you publish printed copies (or copies in media that commonly have + printed covers) of the Document, numbering more than 100, and the + Document's license notice requires Cover Texts, you must enclose the + copies in covers that carry, clearly and legibly, all these Cover + Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on + the back cover. Both covers must also clearly and legibly identify + you as the publisher of these copies. The front cover must present + the full title with all words of the title equally prominent and + visible. You may add other material on the covers in addition. + Copying with changes limited to the covers, as long as they preserve + the title of the Document and satisfy these conditions, can be treated + as verbatim copying in other respects. +

+ +

+ If the required texts for either cover are too voluminous to fit + legibly, you should put the first ones listed (as many as fit + reasonably) on the actual cover, and continue the rest onto adjacent + pages. +

+ +

+ If you publish or distribute Opaque copies of the Document numbering + more than 100, you must either include a machine-readable Transparent + copy along with each Opaque copy, or state in or with each Opaque copy + a computer-network location from which the general network-using + public has access to download using public-standard network protocols + a complete Transparent copy of the Document, free of added material. + If you use the latter option, you must take reasonably prudent steps, + when you begin distribution of Opaque copies in quantity, to ensure + that this Transparent copy will remain thus accessible at the stated + location until at least one year after the last time you distribute an + Opaque copy (directly or through your agents or retailers) of that + edition to the public. +

+ +

+ It is requested, but not required, that you contact the authors of the + Document well before redistributing any large number of copies, to give + them a chance to provide you with an updated version of the Document. +

+ +

+ 4. MODIFICATIONS +

+ +

+ You may copy and distribute a Modified Version of the Document under + the conditions of sections 2 and 3 above, provided that you release + the Modified Version under precisely this License, with the Modified + Version filling the role of the Document, thus licensing distribution + and modification of the Modified Version to whoever possesses a copy + of it. In addition, you must do these things in the Modified Version: +

+ +
    +
  • A. Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions + (which should, if there were any, be listed in the History section + of the Document). You may use the same title as a previous version + if the original publisher of that version gives permission.
    • +
  • B. List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has fewer than five), + unless they release you from this requirement.
    • +
  • C. State on the Title page the name of the publisher of the + Modified Version, as the publisher.
    • +
  • D. Preserve all the copyright notices of the Document.
    • +
  • E. Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices.
    • +
  • F. Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below.
    • +
  • G. Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice.
    • +
  • H. Include an unaltered copy of this License.
    • +
  • I. Preserve the section Entitled "History", Preserve its Title, and add + to it an item stating at least the title, year, new authors, and + publisher of the Modified Version as given on the Title Page. If + there is no section Entitled "History" in the Document, create one + stating the title, year, authors, and publisher of the Document as + given on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence.
    • +
  • J. Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise + the network locations given in the Document for previous versions + it was based on. These may be placed in the "History" section. + You may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission.
    • +
  • K. For any section Entitled "Acknowledgements" or "Dedications", + Preserve the Title of the section, and preserve in the section all + the substance and tone of each of the contributor acknowledgements + and/or dedications given therein.
    • +
  • L. Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers + or the equivalent are not considered part of the section titles.
    • +
  • M. Delete any section Entitled "Endorsements". Such a section + may not be included in the Modified Version.
    • +
  • N. Do not retitle any existing section to be Entitled "Endorsements" + or to conflict in title with any Invariant Section.
    • +
  • O. Preserve any Warranty Disclaimers.
    • +
+ +

+ If the Modified Version includes new front-matter sections or + appendices that qualify as Secondary Sections and contain no material + copied from the Document, you may at your option designate some or all + of these sections as invariant. To do this, add their titles to the + list of Invariant Sections in the Modified Version's license notice. + These titles must be distinct from any other section titles. +

+ +

+ You may add a section Entitled "Endorsements", provided it contains + nothing but endorsements of your Modified Version by various + parties--for example, statements of peer review or that the text has + been approved by an organization as the authoritative definition of a + standard. +

+ +

+ You may add a passage of up to five words as a Front-Cover Text, and a + passage of up to 25 words as a Back-Cover Text, to the end of the list + of Cover Texts in the Modified Version. Only one passage of + Front-Cover Text and one of Back-Cover Text may be added by (or + through arrangements made by) any one entity. If the Document already + includes a cover text for the same cover, previously added by you or + by arrangement made by the same entity you are acting on behalf of, + you may not add another; but you may replace the old one, on explicit + permission from the previous publisher that added the old one. +

+ +

+ The author(s) and publisher(s) of the Document do not by this License + give permission to use their names for publicity for or to assert or + imply endorsement of any Modified Version. +

+ +

+ 5. COMBINING DOCUMENTS +

+ +

+ You may combine the Document with other documents released under this + License, under the terms defined in section 4 above for modified + versions, provided that you include in the combination all of the + Invariant Sections of all of the original documents, unmodified, and + list them all as Invariant Sections of your combined work in its + license notice, and that you preserve all their Warranty Disclaimers. +

+ +

+ The combined work need only contain one copy of this License, and + multiple identical Invariant Sections may be replaced with a single + copy. If there are multiple Invariant Sections with the same name but + different contents, make the title of each such section unique by + adding at the end of it, in parentheses, the name of the original + author or publisher of that section if known, or else a unique number. + Make the same adjustment to the section titles in the list of + Invariant Sections in the license notice of the combined work. +

+ +

+ In the combination, you must combine any sections Entitled "History" + in the various original documents, forming one section Entitled + "History"; likewise combine any sections Entitled "Acknowledgements", + and any sections Entitled "Dedications". You must delete all sections + Entitled "Endorsements." +

+ +

+ 6. COLLECTIONS OF DOCUMENTS +

+ +

+ You may make a collection consisting of the Document and other documents + released under this License, and replace the individual copies of this + License in the various documents with a single copy that is included in + the collection, provided that you follow the rules of this License for + verbatim copying of each of the documents in all other respects. +

+ +

+ You may extract a single document from such a collection, and distribute + it individually under this License, provided you insert a copy of this + License into the extracted document, and follow this License in all + other respects regarding verbatim copying of that document. +

+ +

+ 7. AGGREGATION WITH INDEPENDENT WORKS +

+ +

+ A compilation of the Document or its derivatives with other separate + and independent documents or works, in or on a volume of a storage or + distribution medium, is called an "aggregate" if the copyright + resulting from the compilation is not used to limit the legal rights + of the compilation's users beyond what the individual works permit. + When the Document is included in an aggregate, this License does not + apply to the other works in the aggregate which are not themselves + derivative works of the Document. +

+ +

+ If the Cover Text requirement of section 3 is applicable to these + copies of the Document, then if the Document is less than one half of + the entire aggregate, the Document's Cover Texts may be placed on + covers that bracket the Document within the aggregate, or the + electronic equivalent of covers if the Document is in electronic form. + Otherwise they must appear on printed covers that bracket the whole + aggregate. +

+ +

+ 8. TRANSLATION +

+ +

+ Translation is considered a kind of modification, so you may + distribute translations of the Document under the terms of section 4. + Replacing Invariant Sections with translations requires special + permission from their copyright holders, but you may include + translations of some or all Invariant Sections in addition to the + original versions of these Invariant Sections. You may include a + translation of this License, and all the license notices in the + Document, and any Warranty Disclaimers, provided that you also include + the original English version of this License and the original versions + of those notices and disclaimers. In case of a disagreement between + the translation and the original version of this License or a notice + or disclaimer, the original version will prevail. +

+ +

+ If a section in the Document is Entitled "Acknowledgements", + "Dedications", or "History", the requirement (section 4) to Preserve + its Title (section 1) will typically require changing the actual + title. +

+ +

+ 9. TERMINATION +

+ +

+ You may not copy, modify, sublicense, or distribute the Document except + as expressly provided for under this License. Any other attempt to + copy, modify, sublicense or distribute the Document is void, and will + automatically terminate your rights under this License. However, + parties who have received copies, or rights, from you under this + License will not have their licenses terminated so long as such + parties remain in full compliance. +

+ +

+ 10. FUTURE REVISIONS OF THIS LICENSE +

+ +

+ The Free Software Foundation may publish new, revised versions + of the GNU Free Documentation License from time to time. Such new + versions will be similar in spirit to the present version, but may + differ in detail to address new problems or concerns. See + http://www.gnu.org/copyleft/. +

+ +

+ Each version of the License is given a distinguishing version number. + If the Document specifies that a particular numbered version of this + License "or any later version" applies to it, you have the option of + following the terms and conditions either of that specified version or + of any later version that has been published (not as a draft) by the + Free Software Foundation. If the Document does not specify a version + number of this License, you may choose any version ever published (not + as a draft) by the Free Software Foundation. +

+ +

How to use this License for your documents

+ +

+ To use this License in a document you have written, include a copy of + the License in the document and put the following copyright and + license notices just after the title page: +

+ +
+  Copyright (c)  YEAR  YOUR NAME.
+  Permission is granted to copy, distribute and/or modify this document
+  under the terms of the GNU Free Documentation License, Version 1.2
+  or any later version published by the Free Software Foundation;
+  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
+  Texts.  A copy of the license is included in the section entitled "GNU
+  Free Documentation License".
+
+ +

+ If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, + replace the "with...Texts." line with this: +

+ +
+  with the Invariant Sections being LIST THEIR TITLES, with the
+  Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+
+ +

+ If you have Invariant Sections without Cover Texts, or some other + combination of the three, merge those two alternatives to suit the + situation. +

+ +

+ If your document contains nontrivial examples of program code, we + recommend releasing these examples in parallel under your choice of + free software license, such as the GNU General Public License, + to permit their use in free software. +

+ + diff --git a/doc/common/fdl-notice.html b/doc/common/fdl-notice.html new file mode 100644 index 000000000..862f09e7b --- /dev/null +++ b/doc/common/fdl-notice.html @@ -0,0 +1,15 @@ + + +FDL Notice + + + + +

Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or any +later version published by the Free Software Foundation; with no Invariant +Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy +of the license is included here.

+ + + diff --git a/doc/common/flat.css b/doc/common/flat.css new file mode 100644 index 000000000..e1db552e9 --- /dev/null +++ b/doc/common/flat.css @@ -0,0 +1,446 @@ +/* +** HTML elements +*/ + +body { + margin: 0; + padding: 0; + text-align: center; + font-size: 0.8em; + font-family: "Bitstream Vera Sans", "Lucida Grande", "Trebuchet MS", sans-serif; + color: #535353; + background: #ffffff; +} + + +/* +** HTML Tags +*/ + +h1, h2, h3, h4 +{ + padding: 0; + text-align: left; + font-weight: bold; + color: #f7800a; + background: transparent; +} +h1 { + margin: 0 0 0.3em 0; + font-size: 1.7em; +} +h2, h3, h4 { + margin: 1.3em 0 0 0.3em +} + +h2 { + font-size: 1.5em; +} + +h3 { + font-size: 1.4em; +} + +h4 { + font-size: 1.3em; +} + +h5 { + font-size: 1.2em; +} + +a:link { + padding-bottom: 0; + text-decoration: none; + color: #0057ae; +} + +a:visited { + padding-bottom: 0; + text-decoration: none; + color: #644A9B; +} + + +a[href]:hover { + text-decoration: underline; +} + +hr { + margin: 0.3em 1em 0.3em 1em; + height: 1px; + border: #dddddd dashed; + border-width: 0 0 1px 0; +} + +pre { + display: block; + margin: 0.3em; + padding: 0.3em; + font-size: 1em; + font-family: Courier, 'Courier New', 'Andale Mono', Monaco, monospace; + color: #000000; + background: #f9f9f9; + border: #2f6fab dashed; + border-width: 1px; + overflow: auto; + line-height: 1.1em; +} + +input, textarea, select { + margin: 0.2em; + padding: 0.1em; + color: #888888; + background: #ffffff; + border: 1px solid; +} + +blockquote { + margin: 0.3em; + padding-left: 2.5em; + background: transparent; +} + +del { + color: #800000; + text-decoration: line-through; +} + +dt { + font-weight: bold; + font-size: 1.05em; + color: #0057ae; +} + +dd { + margin-left: 1em; +} + +p { + margin-top: 0.5em; + margin-bottom: 0.9em; + text-align: justify; +} +fieldset { + border: #cccccc 1px solid; +} + +li { + text-align: left; +} + +fieldset { + margin-bottom: 1em; + padding: .5em; +} + +form { + margin: 0; + padding: 0; +} + +hr { + height: 1px; + border: #888888 1px solid; + background: #888888; + margin: 0.5em 0 0.5em 0 ; +} + +img { + border: 0; +} +table { + border-collapse: collapse; + font-size: 1em; +} +th { + text-align: left; + padding-right: 1em; + border: #cccccc solid; + border-width: 0 0 3px 0; +} + + +/* +** Header +*/ +#header { + color: #535353; + background: #eeeeee; +} + +#header_top { + margin: 0 auto; + padding: 0; + vertical-align: middle; + color: #ffffff; + background: url(top.jpg) repeat-x bottom; +background-color: #0057ae; +} + +#header_top div { + margin: 0 auto; + padding: 0; + background: url(top-left.jpg) no-repeat bottom left; +} + +#header_top div div { + margin: 0 auto; + padding: 0; + vertical-align: middle; + text-align: left; + font-size: 1.7em; + font-weight: bold; + background: url(top-right.jpg) no-repeat bottom right; +} + +#header_top div div img { + margin:8px 0px 9px 18px; + vertical-align: middle; +} + +#header_bottom { + margin: 0 auto; + padding: 0.1em 0em 0.3em 0; + vertical-align: middle; + text-align: right; + background: #eeeeee; +} + +#location { + padding: 0 0 0 1.5em; + text-align: left; + line-height: normal; + font-size: 1.1em; + font-weight:bold; +} + +#location ul { + display: inline; + margin: 0; + padding: 0; + list-style: none; +} + +#location ul li { + display: inline; + white-space : nowrap; + margin: 0; + padding: 0 1em 0 0; +} + +#menu { + margin: 0 1.5em 0 0; + text-align: right; + line-height: normal; + font-size: 1.1em; + font-weight: bold; +} + +#menu ul { + display: inline; + list-style: none; + margin: 0; + padding: 0; + text-align: right; +} + +#menu ul li { + display: inline; + white-space : nowrap; + margin: 0; + padding: 0 0 0 1em; + text-align: right; +} + +.here a:link, .here a:visited { + text-decoration:underline; +} + +.here ul a:link, .here ul a:visited { + text-decoration:none; +} + +#menu ul li a { + font-weight: bold; +} + + +/* +** Content +*/ + +#content { +} + +#main { + /* padding in px not ex because IE messes up 100% width tables otherwise */ + padding: 0 10px 0 10px; + text-align: left; +} + +div.nav { + display: none; +} + +/* The project name (redundant as it is shown in the menu, too) */ +div.clearer+h2 { + display: none; +} + +/* The header on top of a page e.g. "MediaObject Class Reference" */ +#main>h1 { + text-align: center; + margin-top: 1em; + margin-bottom: 2em; +} + +/* The group links below the page header */ +#main>h1>small { + font-size: 60%; +} + +/* Section headers like "Detailed Description" */ +#main>h2 { + margin-left: 0; + margin-top: 1em; + margin-bottom: 1em; +} + +/* The #include line */ +#main>h1+code { + font-size: 120%; + background: #F1F1F1; + border: 1px solid #E7E7E7; + padding: 2px; + display: block; +} + +/* The version number (e.g. '4.0') on Mainpages - reduntant as it's already shown in the main title */ +#main>h1+p+h3 { + display: none; +} + +#body_wrapper { + margin: 0 auto; + border: #dddddd solid; + border-width: 0 0 0 1px; +} + +#body { + margin: 0; + padding: 0; +} + +#right { + margin: 0; + padding: 0; +} + +/* These are date cells on the front page. */ +td.cell_date { +} + +#hotspot, .sideimage { + margin: 1ex 1em; + clear: right; +} + +.belowimage, h1, h2, h3, h4, h5 { + clear: right; +} + + +/* +** Left Menu +*/ + +#left { + margin: 0; + padding: 0; +} + +.menu_box { + padding: 0.7em 0 0 0; +} + +.menu_box ul { + text-align: left; +} + +.menu_box li { + list-style-type: none; + text-align: left; + margin-left: 0.1em; +} + +.menu_box ul ul { +margin: 0; +padding-left: 0; +} + +.menu_box li li { +margin-left: 1em; +} + +.menu_box .active{ + color: #cf4913; +} + +.menutitle { + margin: 0.6em 0 1.2em 0; + padding:0; + color: #ffffff; + background: url(block_title_mid.png) repeat-y right; +background-color: #0057ae; +} +.menutitle div { + margin: 0; + padding:0; + background: url(block_title_top.png) no-repeat top right; +} +.menutitle div h2 { + margin: 0; + padding: 0.2em 0 0.3em 1.3em; + line-height:1.2em; + font-size: 120%; + font-weight: normal; + color: #ffffff; + background: url(block_title_bottom.png) no-repeat bottom right; +} + +.clearer { + clear: both; + height: 1px; +} + + +/* +** Footer +*/ +#footer { + background: #eeeeee; +} + +#footer_text { + margin: 0 auto; + padding: 1em 0 1em 3.5em; + text-align: left; + color: #000000; + background: #eeeeee; +} + +#footer a:link, #footer a:visited { + color: #4d88c3; +} + +#quicklinks { +font-size: 1em; +padding: 1em; +text-align: center; +margin-top: 0.5em; +margin-left: 0.2em; +margin-bottom: 0.5em; +margin-right: 0.2em; +} + diff --git a/doc/common/footer.html b/doc/common/footer.html new file mode 100644 index 000000000..baa2973b5 --- /dev/null +++ b/doc/common/footer.html @@ -0,0 +1,64 @@ +
+ + +
+
+
+ + +

Class Picker

+
+
+ +
+
+ + +
+
+
+
    + +
+ +
+
+
+ +
+ + + +
+ + + + + + + + + diff --git a/doc/common/gpl-license b/doc/common/gpl-license new file mode 100644 index 000000000..93796b60a --- /dev/null +++ b/doc/common/gpl-license @@ -0,0 +1,340 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) 19yy + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) 19yy name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. diff --git a/doc/common/gpl-license.html b/doc/common/gpl-license.html new file mode 100644 index 000000000..26ae3af1f --- /dev/null +++ b/doc/common/gpl-license.html @@ -0,0 +1,381 @@ + + + + GNU General Public License + + + + + + + + + +

GNU General Public License

+

Version 2, June 1991

+ +

Copyright (C) 1989, 1991 Free Software Foundation, Inc. +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed.

+ +

Preamble

+ +

The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too.

+ +

When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things.

+ +

To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it.

+ +

For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights.

+ +

We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software.

+ +

Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations.

+ +

Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all.

+ +

The precise terms and conditions for copying, distribution and +modification follow.

+ +

GNU General Public License
+Terms And Conditions For Copying, Distribution And Modification

+ +

0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you".

+ +

Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does.

+ +

1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program.

+ +

You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee.

+ +

2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions:

+ +
    +
  1. +

    You must cause the modified files to carry prominent notices +stating that you changed the files and the date of any change.

    +
    2. + +
  2. +

    You must cause any work that you distribute or publish, that in +whole or in part contains or is derived from the Program or any +part thereof, to be licensed as a whole at no charge to all third +parties under the terms of this License.

    +
    3. + +
  3. +

    If the modified program normally reads commands interactively +when run, you must cause it, when started running for such +interactive use in the most ordinary way, to print or display an +announcement including an appropriate copyright notice and a +notice that there is no warranty (or else, saying that you provide +a warranty) and that users may redistribute the program under +these conditions, and telling the user how to view a copy of this +License. (Exception: if the Program itself is interactive but +does not normally print such an announcement, your work based on +the Program is not required to print an announcement.)

    +
    4. +
+ +

These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it.

+ +

Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program.

+ +

In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License.

+ +

3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following:

+ +
    +
  1. +

    Accompany it with the complete corresponding machine-readable +source code, which must be distributed under the terms of Sections +1 and 2 above on a medium customarily used for software interchange; or,

    +
    2. + +
  2. +

    Accompany it with a written offer, valid for at least three +years, to give any third party, for a charge no more than your +cost of physically performing source distribution, a complete +machine-readable copy of the corresponding source code, to be +distributed under the terms of Sections 1 and 2 above on a medium +customarily used for software interchange; or,

    +
    3. + +
  3. +

    Accompany it with the information you received as to the offer +to distribute corresponding source code. (This alternative is +allowed only for noncommercial distribution and only if you +received the program in object code or executable form with such +an offer, in accord with Subsection b above.)

    +
    4. +
+ +

The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable.

+ +

If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code.

+ +

4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance.

+ +

5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it.

+ +

6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License.

+ +

7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program.

+ +

If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances.

+ +

It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice.

+ +

This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License.

+ +

8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License.

+ +

9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns.

+ +

Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation.

+ +

10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally.

+ +

No Warranty

+ +

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION.

+ +

12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES.

+ +
END OF TERMS AND CONDITIONS
+ +
+ +

How to Apply These Terms to Your New Programs

+ +

If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these +terms.

+ + +

To do so, attach the following notices to the program. It is +safest to attach them to the start of each source file to most +effectively convey the exclusion of warranty; and each file should +have at least the "copyright" line and a pointer to where the full +notice is found.

+ + +
    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) 19yy  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ +

Also add information on how to contact you by electronic and paper +mail.

+ +

If the program is interactive, make it output a short notice like this +when it starts in an interactive mode:

+ +
    Gnomovision version 69, Copyright (C) 19yy name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+ +

The hypothetical commands "show w" and "show c" should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than "show w" and "show c"; they could even be +mouse-clicks or menu items--whatever suits your program.

+ +

You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names:

+ +
  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+ +

This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License.

+ + + + + diff --git a/doc/common/grad.png b/doc/common/grad.png new file mode 100644 index 000000000..b0c7f4093 Binary files /dev/null and b/doc/common/grad.png differ diff --git a/doc/common/header.html b/doc/common/header.html new file mode 100644 index 000000000..8c73e7c7b --- /dev/null +++ b/doc/common/header.html @@ -0,0 +1,67 @@ + + + + + + $title + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + +
+
+ + + +

Class Picker

+
+
+ +
+
+ + +
+
+
+
    + +
+ +
+
+
+
+
+
+ + +
+ + +
+ + + + + diff --git a/doc/common/mainheader.html b/doc/common/mainheader.html new file mode 100644 index 000000000..301e5fc5e --- /dev/null +++ b/doc/common/mainheader.html @@ -0,0 +1,66 @@ + + + + + + $title + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+
+ +