From 66d5e28a5704deb3fd15d2e4d2cb9f1b30f983ba Mon Sep 17 00:00:00 2001 From: David Robillard Date: Fri, 30 Nov 2007 22:00:00 +0000 Subject: Build/install man pages. git-svn-id: http://svn.drobilla.net/lad/slv2@928 a436a847-0d15-0410-975c-d299462d15a1 --- doc/mainpage.dox | 83 +++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 58 insertions(+), 25 deletions(-) (limited to 'doc/mainpage.dox') diff --git a/doc/mainpage.dox b/doc/mainpage.dox index dd5b986..6f0a37a 100644 --- a/doc/mainpage.dox +++ b/doc/mainpage.dox @@ -1,27 +1,60 @@ -/** @mainpage - -@section Overview - -SLV2 is a host library to simplify the discovery, loading, and use of LV2 -plugins (http://lv2plug.in). - -SLV2 is written in standard C99, and depends only on the Redland RDF library -(http://librdf.org). It should be portable to any system, and is tested on various -GNU/Linux distributions (often), and Mac OSX (occasionally). - -The public interface of SLV2 is documented in several sections. The RDF and shared -library functionality is strictly divided so it is simple to understand when each is -being used (e.g. it is possible to discover/investigate plugins and related data -without loading any shared libraries, avoiding the associated risks). +/* This duplication sucks :( */ -\li \link world World \endlink - Global library initialisation, state, plugin discovery, etc. +/* HTML */ -\li \link util Util \endlink - Generally useful utility functions - -\li \link collections Collections \endlink - Collections of values (literals and URIs) and objects - -\li \link data Data \endlink - Access to plugin RDF data - -\li \link lib Library \endlink - Access to plugin shared libraries - -*/ +/** @mainpage + * @section Overview + * + * SLV2 is a host library to simplify the discovery, loading, and use of LV2 + * plugins (http://lv2plug.in). + * + * SLV2 is written in standard C99, and depends only on the Redland RDF library + * (http://librdf.org). It should be portable to any system with Redland, and + * is tested on various GNU/Linux distributions (often), and MacOS X (occasionally). + * + * The Data (RDF) and code (shared library) functionality in SLV2 is strictly + * separated so it is simple to control where each is used (e.g. it is + * possible to discover/investigate plugins and related data without loading + * any shared libraries, avoiding the associated risks). + * + * The SLV2 documentation is broken into several pages: + * + * \li \link slv2_world slv2_world \endlink - Global library initialisation, state, plugin discovery, etc. + * + * \li \link slv2_util slv2_util \endlink - Generally useful utility functions + * + * \li \link slv2_collections slv2_collections \endlink - Collections of values (literals and URIs) and objects + * + * \li \link slv2_data slv2_data \endlink - Access to plugin RDF data + * + * \li \link slv2_library slv2_library \endlink - Access to plugin shared libraries + */ + + +/* man page */ + +/** @defgroup slv2 SLV2 + * SLV2 is a host library to simplify the discovery, loading, and use of LV2 + * plugins (http://lv2plug.in). + * + * SLV2 is written in standard C99, and depends only on the Redland RDF library + * (http://librdf.org). It should be portable to any system with Redland, and + * is tested on various GNU/Linux distributions (often), and MacOS X (occasionally). + * + * The Data (RDF) and code (shared library) functionality in SLV2 is strictly + * separated so it is simple to control where each is used (e.g. it is + * possible to discover/investigate plugins and related data without loading + * any shared libraries, avoiding the associated risks). + * + * The SLV2 documentation is broken into several pages: + * + * \li \link slv2_world slv2_world \endlink - Global library initialisation, state, plugin discovery, etc. + * + * \li \link slv2_util slv2_util \endlink - Generally useful utility functions + * + * \li \link slv2_collections slv2_collections \endlink - Collections of values (literals and URIs) and objects + * + * \li \link slv2_data slv2_data \endlink - Access to plugin RDF data + * + * \li \link slv2_library slv2_library \endlink - Access to plugin shared libraries + */ -- cgit v1.2.1