diff --git a/docs/doxygen/images/libs.bmp b/docs/doxygen/images/libs.bmp deleted file mode 100644 index fb0f9e3655..0000000000 Binary files a/docs/doxygen/images/libs.bmp and /dev/null differ diff --git a/docs/doxygen/images/libs.gif b/docs/doxygen/images/libs.gif deleted file mode 100644 index 707f2cee86..0000000000 Binary files a/docs/doxygen/images/libs.gif and /dev/null differ diff --git a/docs/doxygen/mainpages/libs.h b/docs/doxygen/mainpages/libs.h index f944d7700e..e0ead95a56 100644 --- a/docs/doxygen/mainpages/libs.h +++ b/docs/doxygen/mainpages/libs.h @@ -6,154 +6,183 @@ // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// - /*! - @page page_libs Libraries list +@page page_libs Library List - wxWidgets can be built either as a single large - library (this is called the monolithic build) or as several smaller - libraries (multilib build}). Multilib build is the default. +wxWidgets can be built either as a single large library (this is called a +monolithic build) or as several smaller libraries +(multilib build). Multilib build is the default. - wxWidgets library is divided into libraries briefly described below. This - diagram show dependencies between them: +wxWidgets library is divided into libraries briefly described below. This +diagram show dependencies between them: - @image html libs.gif +@dot +digraph Dependancies +{ + node [shape = ellipse, fontname = "Courier", fontsize = 10, style = filled]; - Please note that arrows indicate the "depends from" relation and that - all blue boxes depend from @ref page_libs_wxbase library (i.e. they are non-GUI libraries), - and all green boxes depend from @ref page_libs_wxcore library (i.e. they are GUI libraries). + wxBase [URL = "\ref page_libs_wxbase"]; + + wxCore [fillcolor = deepskyblue, URL = "\ref page_libs_wxcore"]; + wxNet [fillcolor = deepskyblue, URL = "\ref page_libs_wxNet"]; + wxXML [fillcolor = deepskyblue, URL = "\ref page_libs_wxxml"]; + + wxAdvanced [fillcolor = green, URL = "\ref page_libs_wxadv"]; + wxAUI [fillcolor = green, URL = "\ref page_libs_wxaui"]; + wxGL [fillcolor = green, URL = "\ref page_libs_wxgl"]; + wxHTML [fillcolor = green, URL = "\ref page_libs_wxhtml"]; + wxMedia [fillcolor = green, URL = "\ref page_libs_wxmedia"]; + wxQA [fillcolor = green, URL = "\ref page_libs_wxqa"]; + wxRichText [fillcolor = green, URL = "\ref page_libs_wxrichtext"]; + wxSTC [fillcolor = green, URL = "\ref page_libs_wxstc"]; + wxXRC [fillcolor = green, URL = "\ref page_libs_wxxrc"]; + + wxCore -> wxBase; + wxNet -> wxBase; + wxXML -> wxBase; + + wxAdvanced -> wxCore; + wxAUI -> wxAdvanced; wxAUI -> wxHTML; wxAUI -> wxXML; + wxGL -> wxCore; + wxHTML -> wxCore; + wxMedia -> wxCore; + wxQA -> wxCore; wxQA -> wxXML; + wxRichText -> wxAdvanced; wxRichText -> wxHTML; wxRichText -> wxXML; + wxSTC -> wxCore; + wxXRC -> wxAdvanced; wxXRC -> wxHTML; wxXRC -> wxXML; +} +@enddot + +Please note that arrows indicate the "depends from" relation and that all blue +boxes depend on the @ref page_libs_wxbase library (i.e. they are non-GUI +libraries), and all green boxes depend on the @ref page_libs_wxcore library +(i.e. they are GUI libraries). - +@section page_libs_wxbase wxBase + +Every wxWidgets application must link against this library. It contains +mandatory classes that any wxWidgets code depends on (e.g. wxString) and +portability classes that abstract differences between platforms. wxBase can be +used to develop console mode applications, it does not require any GUI +libraries or running X Window System on Unix. - @section page_libs_wxbase wxBase +@section page_libs_wxcore wxCore - Every wxWidgets application must link against this library. It contains - mandatory classes that any wxWidgets code depends on (e.g. wxString) and - portability classes that abstract differences between platforms. - wxBase can be used to develop console mode applications, - it does not require any GUI libraries or running X Window System on Unix. +Basic GUI classes such as GDI classes or controls are in this library. All +wxWidgets GUI applications must link against this library, only console mode +applications don't. + +Requires @ref page_libs_wxbase. - @section page_libs_wxcore wxCore +@section page_libs_wxaui wxAui - Basic GUI classes such as GDI classes or controls are in this library. All - wxWidgets GUI applications must link against this library, only console mode - applications don't. +This contains the Advanced User Interface docking library. - Requires @ref page_libs_wxbase. +Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, +@ref page_libs_wxcore, @ref page_libs_wxbase. - @section page_libs_wxaui wxAui +@section page_libs_wxnet wxNet - This contains the Advanced User Interface docking library. +Classes for network access: - Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, - @ref page_libs_wxcore, @ref page_libs_wxbase. +@li wxSocket classes (wxSocketClient, wxSocketServer and related classes) +@li wxSocketOutputStream and wxSocketInputStream +@li sockets-based IPC classes (wxTCPServer, wxTCPClient and wxTCPConnection) +@li wxURL +@li wxInternetFSHandler (a wxFileSystem handler) + +Requires @ref page_libs_wxbase. - @section page_libs_wxnet wxNet +@section page_libs_wxrichtext wxRichText - Classes for network access: +This contains generic rich text control functionality. - @li wxSocket classes (wxSocketClient, wxSocketServer and related classes) - @li wxSocketOutputStream and wxSocketInputStream - @li sockets-based IPC classes (wxTCPServer, wxTCPClient and wxTCPConnection) - @li wxURL - @li wxInternetFSHandler (a wxFileSystem handler) - - Requires @ref page_libs_wxbase. +Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, +@ref page_libs_wxcore, @ref page_libs_wxbase. - @section page_libs_wxrichtext wxRichText +@section page_libs_wxxml wxXML - This contains generic rich text control functionality. +This library contains simple classes for parsing XML documents. - Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, - @ref page_libs_wxcore, @ref page_libs_wxbase. +Requires @ref page_libs_wxbase. - @section page_libs_wxxml wxXML +@section page_libs_wxadv wxAdvanced - This library contains simple classes for parsing XML documents. +Advanced or rarely used GUI classes: - Requires @ref page_libs_wxbase. +@li wxCalendarCtrl +@li wxGrid classes +@li wxJoystick +@li wxLayoutAlgorithm +@li wxSplashScreen +@li wxTaskBarIcon +@li wxSound +@li wxWizard +@li wxSashLayoutWindow +@li wxSashWindow +@li ...others + +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - @section page_libs_wxadv wxAdvanced +@section page_libs_wxmedia wxMedia - Advanced or rarely used GUI classes: +Miscellaneous classes related to multimedia. Currently this library only +contains wxMediaCtrl but more classes will be added in the future. - @li wxCalendarCtrl - @li wxGrid classes - @li wxJoystick - @li wxLayoutAlgorithm - @li wxSplashScreen - @li wxTaskBarIcon - @li wxSound - @li wxWizard - @li wxSashLayoutWindow - @li wxSashWindow - @li ...others - - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - @section page_libs_wxmedia wxMedia +@section page_libs_wxgl wxGL - Miscellaneous classes related to multimedia. Currently this library only - contains wxMediaCtrl but more classes will be added in - the future. +This library contains wxGLCanvas class for integrating OpenGL library with +wxWidgets. Unlike all others, this library is @b not part of the monolithic +library, it is always built as separate library. - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - @section page_libs_wxgl wxGL +@section page_libs_wxhtml wxHTML - This library contains wxGLCanvas class for integrating - OpenGL library with wxWidgets. Unlike all others, this library is {\em not} - part of the monolithic library, it is always built as separate library. +Simple HTML renderer and other @ref overview_html are contained in this +library, as well as wxHtmlHelpController, wxBestHelpController and +wxHtmlListBox. - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +Requires @ref page_libs_wxcore and @ref page_libs_wxbase. - @section page_libs_wxhtml wxHTML +@section page_libs_wxqa wxQA - Simple HTML renderer and other @ref overview_html are contained in this library, - as well as wxHtmlHelpController, wxBestHelpController and wxHtmlListBox. +This is the library containing extra classes for quality assurance. Currently +it only contains wxDebugReport and related classes, but more will be added to +it in the future. - Requires @ref page_libs_wxcore and @ref page_libs_wxbase. +Requires @ref page_libs_wxxml, @ref page_libs_wxcore, @ref page_libs_wxbase. - @section page_libs_wxqa wxQA +@section page_libs_wxxrc wxXRC - This is the library containing extra classes for quality assurance. Currently - it only contains wxDebugReport and related classes, - but more will be added to it in the future. +This library contains wxXmlResource class that provides access to XML resource +files in XRC format. - Requires @ref page_libs_wxxml, @ref page_libs_wxcore, @ref page_libs_wxbase. +Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, +@ref page_libs_wxcore, @ref page_libs_wxbase. - @section page_libs_wxxrc wxXRC +@section page_libs_wxstc wxSTC - This library contains wxXmlResource class that - provides access to XML resource files in XRC format. +STC (Styled Text Control) is a wrapper around Scintilla, a syntax-highlighting +text editor. See for more info about Scintilla. - Requires @ref page_libs_wxadv, @ref page_libs_wxhtml, @ref page_libs_wxxml, - @ref page_libs_wxcore, @ref page_libs_wxbase. - - - @section page_libs_wxstc wxSTC - - STC (Styled Text Control) is a wrapper around Scintilla, a syntax-highlighting text editor. - See http://www.scintilla.org for more info about Scintilla. - - Requires @ref page_libs_wxcore, @ref page_libs_wxbase. +Requires @ref page_libs_wxcore, @ref page_libs_wxbase. */ +