revised b* headers; moved wxPenList and wxBrushList to the correct places; partially revised wxPen docs

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

interface/busyinfo.h

@@ -17,27 +17,27 @@
     For example:
 
     @code
-    wxBusyInfo wait("Please wait, working...");
+        wxBusyInfo wait("Please wait, working...");
 
-        for (int i = 0; i  100000; i++)
+        for (int i = 0; i < 100000; i++)
         {
             DoACalculation();
         }
     @endcode
 
-    It works by creating a window in the constructor,
-    and deleting it in the destructor.
+    It works by creating a window in the constructor, and deleting it
+    in the destructor.
 
     You may also want to call wxTheApp-Yield() to refresh the window
     periodically (in case it had been obscured by other windows, for
     example) like this:
 
     @code
-    wxWindowDisabler disableAll;
+        wxWindowDisabler disableAll;
 
         wxBusyInfo wait("Please wait, working...");
 
-        for (int i = 0; i  100000; i++)
+        for (int i = 0; i < 100000; i++)
         {
             DoACalculation();
 
@@ -47,21 +47,20 @@
     @endcode
 
     but take care to not cause undesirable reentrancies when doing it (see
-    wxApp::Yield for more details). The simplest way to do
-    it is to use wxWindowDisabler class as illustrated
-    in the above example.
+    wxApp::Yield for more details). The simplest way to do it is to use
+    wxWindowDisabler class as illustrated in the above example.
 
     @library{wxcore}
-    @category{FIXME}
+    @category{cmndlg}
 */
 class wxBusyInfo
 {
 public:
     /**
-        Constructs a busy info window as child of @a parent and displays @e msg
-        in it.
-        @b NB: If @a parent is not @NULL you must ensure that it is not
-        closed while the busy info is shown.
+        Constructs a busy info window as child of @a parent and displays @e msg in it.
+
+        @note If @a parent is not @NULL you must ensure that it is not
+              closed while the busy info is shown.
     */
     wxBusyInfo(const wxString& msg, wxWindow* parent = NULL);