revised st*.h headers

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56148 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/wx/sysopt.h

@@ -14,7 +14,103 @@
     used to optimize behaviour that doesn't deserve a distinct API,
     but is still important to be able to configure.
 
-    These options are currently recognised by wxWidgets.
+    These options are currently recognised by wxWidgets:
+
+
+    @section sysopt_win Windows
+
+    @beginFlagTable
+    @flag{no-maskblt}
+        1 to never use WIN32's MaskBlt function, 0 to allow it to be used where possible.
+        Default: 0. In some circumstances the MaskBlt function can be slower than using
+        the fallback code, especially if using DC cacheing. By default, MaskBlt will be
+        used where it is implemented by the operating system and driver.
+    @flag{msw.remap}
+        If 1 (the default), wxToolBar bitmap colours will be remapped to the current
+        theme's values. Set this to 0 to disable this functionality, for example if
+        you're using more than 16 colours in your tool bitmaps.
+    @flag{msw.window.no-clip-children}
+        If 1, windows will not automatically get the WS_CLIPCHILDREN style.
+        This restores the way windows are refreshed back to the method used in
+        versions of wxWidgets earlier than 2.5.4, and for some complex window
+        hierarchies it can reduce apparent refresh delays.
+        You may still specify wxCLIP_CHILDREN for individual windows.
+    @flag{msw.notebook.themed-background}
+        If set to 0, globally disables themed backgrounds on notebook pages.
+        Note that this won't disable the theme on the actual notebook background
+        (noticeable only if there are no pages).
+    @flag{msw.staticbox.optimized-paint}
+        If set to 0, switches off optimized wxStaticBox painting.
+        Setting this to 0 causes more flicker, but allows applications to paint
+        graphics on the parent of a static box (the optimized refresh causes any
+        such drawing to disappear).
+    @flag{msw.display.directdraw}
+        If set to 1, use DirectDraw-based implementation of wxDisplay.
+        By default the standard Win32 functions are used.
+    @flag{msw.font.no-proof-quality}
+        If set to 1, use default fonts quality instead of proof quality when
+        creating fonts. With proof quality the fonts have slightly better
+        appearance but not all fonts are available in this quality,
+        e.g. the Terminal font in small sizes is not and this option may be
+        used if wider fonts selection is more important than higher quality.
+    @endFlagTable
+
+
+    @section sysopt_gtk GTK+
+
+    @beginFlagTable
+    @flag{gtk.tlw.can-set-transparent}
+        wxTopLevelWindow::CanSetTransparent() method normally tries to detect
+        automatically whether transparency for top level windows is currently
+        supported, however this may sometimes fail and this option allows to
+        override the automatic detection. Setting it to 1 makes the transparency
+        be always available (setting it can still fail, of course) and setting it
+        to 0 makes it always unavailable.
+    @flag{gtk.desktop}
+        This option can be set to override the default desktop environment
+        determination. Supported values are GNOME and KDE.
+    @flag{gtk.window.force-background-colour}
+        If 1, the backgrounds of windows with the wxBG_STYLE_COLOUR background
+        style are cleared forcibly instead of relying on the underlying GTK+
+        window colour. This works around a display problem when running
+        applications under KDE with the gtk-qt theme installed (0.6 and below).
+    @endFlagTable
+
+
+    @section sysopt_mac Mac
+
+    @beginFlagTable
+    @flag{mac.window-plain-transition}
+        If 1, uses a plainer transition when showing a window.
+        You can also use the symbol wxMAC_WINDOW_PLAIN_TRANSITION.
+    @flag{window-default-variant}
+        The default variant used by windows (cast to integer from the wxWindowVariant enum).
+        Also known as wxWINDOW_DEFAULT_VARIANT.
+    flag{mac.listctrl.always_use_generic}
+        Tells wxListCtrl to use the generic control even when it is capable of
+        using the native control instead. Also knwon as wxMAC_ALWAYS_USE_GENERIC_LISTCTRL.
+    @endFlagTable
+
+
+    @section sysopt_mgl MGL
+
+    @beginFlagTable
+    @flag{mgl.aa-threshold}
+        Set this integer option to point size below which fonts are not antialiased. Default: 10.
+    @flag{mgl.screen-refresh}
+        Screen refresh rate in Hz. A reasonable default is used if not specified.
+    @endFlagTable
+
+
+    @section sysopt_motif Motif
+
+    @beginFlagTable
+    @flag{motif.largebuttons}
+        If 1, uses a bigger default size for wxButtons.
+    @endFlagTable
+
+
+    The compile-time option to include or exclude this functionality is wxUSE_SYSTEM_OPTIONS.
 
     @library{wxbase}
     @category{misc}
@@ -26,41 +122,41 @@ class wxSystemOptions : public wxObject
 {
 public:
     /**
-        Default constructor. You don't need to create an instance of wxSystemOptions
-        since all of its functions are static.
+        Default constructor.
+
+        You don't need to create an instance of wxSystemOptions since all
+        of its functions are static.
     */
     wxSystemOptions();
 
     /**
-        Gets an option. The function is case-insensitive to @e name.
+        Gets an option. The function is case-insensitive to @a name.
         Returns empty string if the option hasn't been set.
 
-        @see SetOption(), GetOptionInt(),
-             HasOption()
+        @see SetOption(), GetOptionInt(), HasOption()
     */
     static wxString GetOption(const wxString& name);
 
     /**
-        Gets an option as an integer. The function is case-insensitive to @e name.
+        Gets an option as an integer. The function is case-insensitive to @a name.
         If the option hasn't been set, this function returns 0.
 
-        @see SetOption(), GetOption(),
-             HasOption()
+        @see SetOption(), GetOption(), HasOption()
     */
     static int GetOptionInt(const wxString& name);
 
     /**
-        Returns @true if the given option is present. The function is
-        case-insensitive to @e name.
+        Returns @true if the given option is present.
+        The function is case-insensitive to @a name.
 
-        @see SetOption(), GetOption(),
-             GetOptionInt()
+        @see SetOption(), GetOption(), GetOptionInt()
     */
     static bool HasOption(const wxString& name);
 
     /**
-        Returns @true if the option with the given @a name had been set to 0
-        value. This is mostly useful for boolean options for which you can't use
+        Returns @true if the option with the given @a name had been set to 0 value.
+
+        This is mostly useful for boolean options for which you can't use
         @c GetOptionInt(name) == 0 as this would also be @true if the option
         hadn't been set at all.
     */
@@ -68,7 +164,7 @@ public:
 
     //@{
     /**
-        Sets an option. The function is case-insensitive to @e name.
+        Sets an option. The function is case-insensitive to @a name.
     */
     void SetOption(const wxString& name, const wxString& value);
     void SetOption(const wxString& name, int value);