]> git.saurik.com Git - wxWidgets.git/commitdiff
fix miscellaneous Doxygen 1.6.1 warnings
authorFrancesco Montorsi <f18m_cpp217828@yahoo.it>
Sun, 20 Dec 2009 15:07:08 +0000 (15:07 +0000)
committerFrancesco Montorsi <f18m_cpp217828@yahoo.it>
Sun, 20 Dec 2009 15:07:08 +0000 (15:07 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@62958 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/wx/choice.h
interface/wx/clntdata.h
interface/wx/combobox.h
interface/wx/grid.h
interface/wx/html/htmltag.h
interface/wx/mousemanager.h
interface/wx/odcombo.h
interface/wx/stattext.h
interface/wx/textwrapper.h
interface/wx/tokenzr.h
interface/wx/toolbar.h

index 975052193e119e83336ebd19bfb37d093bd4a0bc..20ec50bc12ccfc48d37b7b139e352a4067d6afe6 100644 (file)
@@ -40,7 +40,6 @@ public:
     */
     wxChoice();
 
-    //@{
     /**
         Constructor, creating and showing a choice.
 
@@ -127,7 +126,6 @@ public:
             long style = 0,
             const wxValidator& validator = wxDefaultValidator,
             const wxString& name = wxChoiceNameStr );
-    //@}
 
     /**
         Destructor, destroying the choice item.
index dea129e018fa62bd394679b25d92cb5732219c22..77f3cbe1c9f412c32ba5bd7471cf282f7c29fa1b 100644 (file)
@@ -9,8 +9,8 @@
 /**
     @class wxClientDataContainer
 
-    This class is a mixin that provides storage and management of "client
-    data." This data can either be of type void - in which case the data
+    This class is a mixin that provides storage and management of "client data".
+    This data can either be of type void - in which case the data
     @e container does not take care of freeing the data again or it is of
     type wxClientData or its derivatives. In that case the container will free
     the memory itself later. Note that you @e must not assign both void data
index d8f8392bb11b3fbbd5d3ee367f6daa70f45f3067..67029f392beb81904be14ad5b0c76983d8bd049d 100644 (file)
@@ -83,7 +83,6 @@ public:
     */
     wxComboBox();
 
-    //@{
     /**
         Constructor, creating and showing a combobox.
 
@@ -174,7 +173,6 @@ public:
                long style = 0,
                const wxValidator& validator = wxDefaultValidator,
                const wxString& name = wxComboBoxNameStr);
-    //@}
 
     /**
         Destructor, destroying the combobox.
index 65ae9e76ced68b5657b83928178d85af6ed0856f..136852d45ee2eff3e43bc1fe4ef21c394135468d 100644 (file)
@@ -784,7 +784,7 @@ class wxGridColumnHeaderRenderer : public wxGridHeaderLabelsRenderer
 
     @since 2.9.1
  */
-class wxGridRowHeaderRendererDefault : public wxGridRowHeaderRendererDefault
+class wxGridRowHeaderRendererDefault : public wxGridRowHeaderRenderer
 {
 public:
     /// Implement border drawing for the row labels.
index 10136ab2023a3b9f67b631472282e1ad38677ab5..3745c06d8be9bd6f264ca596613fd92ebef3ae63 100644 (file)
@@ -73,7 +73,7 @@ public:
 
     /**
         Returns tag's name. The name is always in uppercase and it doesn't contain
-        " or '/' characters. (So the name of \<FONT SIZE=+2\> tag is "FONT"
+        &quot; or '/' characters. (So the name of \<FONT SIZE=+2\> tag is "FONT"
         and name of \</table\> is "TABLE").
     */
     wxString GetName() const;
index 154f39064367a742b9ac4f15e4c7a61bf837cc7d..bebd92691f7f34487ad0a659a6baaf9188d6aeb3 100644 (file)
@@ -31,7 +31,7 @@
     (although this is the most common case) -- it can be any value which can
     be used to uniquely identify an item.
 
-    @library{core}
+    @library{wxcore}
     @category{events}
  */
 class wxMouseEventsManager : public wxEvtHandler
index 92c516b9e2645d4127390b937e191c986594a547..7152e2f28a808fc66d0dbeb4fe46c215fa67231c 100644 (file)
@@ -68,7 +68,6 @@ public:
     */
     wxOwnerDrawnComboBox();
 
-    //@{
     /**
         Constructor, creating and showing a owner-drawn combobox.
 
@@ -138,7 +137,6 @@ public:
                          long style = 0,
                          const wxValidator& validator = wxDefaultValidator,
                          const wxString& name = "comboBox");
-    //@}
 
     /**
         Destructor, destroying the owner-drawn combobox.
index 613d99661a3e7d342148ebde71dc3159cf846c95..4e297aabc5495df8ae716b278bc475f9fea1603b 100644 (file)
@@ -89,10 +89,15 @@ public:
                 const wxSize& size = wxDefaultSize, long style = 0,
                 const wxString& name = wxStaticTextNameStr);
 
+    // NB: when writing docs for the following function remember that Doxygen
+    //     will always expand HTML entities (e.g. &quot;) and thus we need to
+    //     write e.g. "&amp;lt;" to have in the output the "&lt;" string.
     /**
-        Escapes all the symbols of @a str that have a special meaning (<tt><>"'&</tt>) for
+        Escapes all the symbols of @a str that have a special meaning (<tt><>&quot;'&</tt>) for
         wxStaticText objects with the @c wxST_MARKUP style.
-        Those symbols are replaced the corresponding entities (&lt; &gt; &quot; &apos; &amp;).
+        
+        Those symbols are replaced the corresponding entities 
+        (&amp;lt; &amp;gt; &amp;quot; &amp;apos; &amp;amp;).
     */
     static wxString EscapeMarkup(const wxString& str);
 
index dd830ed3e35099cef3d02344cdd4fda29840049e..c82b4ff1a291d1ca0c5b708b5e5120cdfed630b8 100644 (file)
 
     Here is an example function using this class which inserts hard line breaks
     into a string of text at the positions where it would be wrapped:
+    
     @code
-wxString WrapText(wxWindow *win, const wxString& text, int widthMax)
-{
-    class HardBreakWrapper : public wxTextWrapper
+    wxString WrapText(wxWindow *win, const wxString& text, int widthMax)
     {
-    public:
-        HardBreakWrapper(wxWindow *win, const wxString& text, int widthMax)
-        {
-            Wrap(win, text, widthMax);
-        }
-
-        wxString const& GetWrapped() const { return m_wrapped; }
-
-    protected:
-        virtual void OnOutputLine(const wxString& line)
+        class HardBreakWrapper : public wxTextWrapper
         {
-            m_wrapped += line;
-        }
-
-        virtual void OnNewLine()
-        {
-            m_wrapped += '\n';
-        }
-
-    private:
-        wxString m_wrapped;
-    };
-
-    HardBreakWrapper wrapper(win, text, widthMax);
-    return wrapper.GetWrapped();
-}
+        public:
+            HardBreakWrapper(wxWindow *win, const wxString& text, int widthMax)
+            {
+                Wrap(win, text, widthMax);
+            }
+
+            wxString const& GetWrapped() const { return m_wrapped; }
+
+        protected:
+            virtual void OnOutputLine(const wxString& line)
+            {
+                m_wrapped += line;
+            }
+
+            virtual void OnNewLine()
+            {
+                m_wrapped += '\n';
+            }
+
+        private:
+            wxString m_wrapped;
+        };
+
+        HardBreakWrapper wrapper(win, text, widthMax);
+        return wrapper.GetWrapped();
+    }
     @endcode
 
-    @library{none}
+    @nolibrary
     @category{gdi}
  */
 class wxTextWrapper
index a609e1557d88646bf012a2f8018b5170e0cf7f48..ac7dcecefcbbf3e8a41742532694e11e739d67d8 100644 (file)
@@ -28,8 +28,8 @@ enum wxStringTokenizerMode
 
     /**
         In this mode, the empty tokens in the middle of the string will be returned,
-        i.e. @c "a::b:" will be tokenized in three tokens @c 'a', " and @c 'b'. Notice
-        that all trailing delimiters are ignored in this mode, not just the last one,
+        i.e. @c "a::b:" will be tokenized in three tokens @c 'a', @c '' and @c 'b'. 
+        Notice that all trailing delimiters are ignored in this mode, not just the last one,
         i.e. a string @c "a::b::" would still result in the same set of tokens.
     */
     wxTOKEN_RET_EMPTY,
index 1ff4d008b9f9b141850fdc1e1669bf9923121732..95b3dbf776484cc03bd074325a0a172e708326b9 100644 (file)
@@ -257,7 +257,7 @@ public:
             The tool to be added.
 
         @remarks After you have added tools to a toolbar, you must call
-            Realize() in order to have the tools appear.
+                 Realize() in order to have the tools appear.
 
         @see AddSeparator(), AddCheckTool(), AddRadioTool(),
              InsertTool(), DeleteTool(), Realize(), SetDropdownMenu()