Replaced /*! with /** in remaining Doxygen headers, and removed intentation of overvi...

[wxWidgets.git] / docs / doxygen / overviews / aui.h

diff --git a/docs/doxygen/overviews/aui.h b/docs/doxygen/overviews/aui.h
index 7b72441dcb44e039bf304e4c901f06090960eb81..dde12147595eb7dbf70984a1daaa248071f2f608 100644 (file)
--- a/docs/doxygen/overviews/aui.h
+++ b/docs/doxygen/overviews/aui.h
@@ -6,62 +6,68 @@
 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 
-/*!
+/**
 
- @page overview_aui wxAUI overview
+@page overview_aui wxAUI Overview
 
- Class: wxAuiManager, wxAuiPaneInfo
+Classes:
+@li wxAuiManager
+@li wxAuiPaneInfo
+@li wxAuiNotebook
+@li wxAuiDockArt
+@li wxAuiTabArt
 
- wxAUI stands for Advanced User Interface and the wxAUI framework
- aims to give its user a cutting edge interface for use with the
- wxWidgets based applications. The original wxAUI sources have
- kindly been made available under the wxWindows licence
- by Kirix Corp. and they have since then been integrated into
- wxWidgets CVS and further improved.
+wxAUI stands for Advanced User Interface. It aims to give the user a cutting
+edge interface with floatable windows, and a user-customizable layout. The
+original wxAUI sources have kindly been made available under the wxWindows
+licence by Kirix Corp. and they have since then been integrated into wxWidgets
+and further improved.
 
- wxAUI attempts to encapsulate the following aspects of the user interface:
+wxAUI attempts to encapsulate the following aspects of the user interface:
 
- @li @ref overview_aui_frame
- @li @ref overview_aui_toolbar
- @li @ref overview_aui_modeless
- @li @ref overview_aui_lnf
+@li @ref overview_aui_frame
+@li @ref overview_aui_toolbar
+@li @ref overview_aui_modeless
+@li @ref overview_aui_lnf
 
- <hr>
 
+<hr>
 
- @section overview_aui_frame Frame Management
 
- Frame management provides the means to open, move and hide common
- controls that are needed to interact with the document, and allow these
- configurations to be saved into different perspectives and loaded at a
- later time.
+@section overview_aui_frame Frame Management
 
- @subsection overview_aui_toolbar Toolbars
+Frame management provides the means to open, move and hide common controls that
+are needed to interact with the document, and allow these configurations to be
+saved into different perspectives and loaded at a later time.
 
- Toolbars are a specialized subset of the frame management system and
- should behave similarly to other docked components. However, they also
- require additional functionality, such as "spring-loaded" rebar support,
- "chevron" buttons and end-user customizability.
 
- @subsection overview_aui_modeless Modeless Controls
+@section overview_aui_toolbar Toolbars
 
- Modeless controls expose a tool palette or set of options that float
- above the application content while allowing it to be accessed. Usually
- accessed by the toolbar, these controls disappear when an option is
- selected, but may also be "torn off" the toolbar into a floating frame
- of their own.
+Toolbars are a specialized subset of the frame management system and should
+behave similarly to other docked components. However, they also require
+additional functionality, such as "spring-loaded" rebar support, "chevron"
+buttons and end-user customizability.
 
- @subsection overview_aui_lnf Look and Feel
 
- Look and feel encompasses the way controls are drawn, both when shown
- statically as well as when they are being moved. This aspect of user
- interface design incorporates "special effects" such as transparent
- window dragging as well as frame animation.
+@section overview_aui_modeless Modeless Controls
 
- wxAUI adheres to the following principles:
- Use native floating frames to obtain a native look and feel for all
- platforms. Use existing wxWidgets code where possible, such as sizer
- implementation for frame management. Use classes included in wxCore
- and wxBase only. Use standard wxWidgets coding conventions.
+Modeless controls expose a tool palette or set of options that float above the
+application content while allowing it to be accessed. Usually accessed by the
+toolbar, these controls disappear when an option is selected, but may also be
+"torn off" the toolbar into a floating frame of their own.
+
+
+@section overview_aui_lnf Look and Feel
+
+Look and feel encompasses the way controls are drawn, both when shown
+statically as well as when they are being moved. This aspect of user interface
+design incorporates "special effects" such as transparent window dragging as
+well as frame animation.
+
+wxAUI adheres to the following principles: Use native floating frames to obtain
+a native look and feel for all platforms. Use existing wxWidgets code where
+possible, such as sizer implementation for frame management. Use classes
+included in @ref page_libs_wxcore and @ref page_libs_wxbase only.
 
 */
+