]> git.saurik.com Git - wxWidgets.git/commitdiff
Fix premature truncation of brief descriptions in Doxygen comments.
authorVadim Zeitlin <vadim@wxwidgets.org>
Sat, 1 Dec 2012 00:14:07 +0000 (00:14 +0000)
committerVadim Zeitlin <vadim@wxwidgets.org>
Sat, 1 Dec 2012 00:14:07 +0000 (00:14 +0000)
Don't end the brief description at the first period if it's a period which is
part of "i.e." or "e.g.": escape the space following it to prevent Doxygen
from recognizing it as an end of sentence.

See #14866.

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

41 files changed:
interface/wx/affinematrix2d.h
interface/wx/affinematrix2dbase.h
interface/wx/app.h
interface/wx/buffer.h
interface/wx/calctrl.h
interface/wx/dataview.h
interface/wx/datetime.h
interface/wx/dc.h
interface/wx/dialup.h
interface/wx/dynarray.h
interface/wx/dynlib.h
interface/wx/event.h
interface/wx/filectrl.h
interface/wx/filefn.h
interface/wx/gdicmn.h
interface/wx/iconloc.h
interface/wx/image.h
interface/wx/menu.h
interface/wx/object.h
interface/wx/pickerbase.h
interface/wx/popupwin.h
interface/wx/regex.h
interface/wx/region.h
interface/wx/renderer.h
interface/wx/sizer.h
interface/wx/stdpaths.h
interface/wx/thread.h
interface/wx/timer.h
interface/wx/tipdlg.h
interface/wx/tokenzr.h
interface/wx/toolbar.h
interface/wx/toplevel.h
interface/wx/treectrl.h
interface/wx/unichar.h
interface/wx/url.h
interface/wx/vector.h
interface/wx/vidmode.h
interface/wx/vlbox.h
interface/wx/webview.h
interface/wx/window.h
interface/wx/xlocale.h

index b600494f4c05f3a13bb45d278409129d292e855c..99f84c4371dd39672882170926ae01cf9479998d 100644 (file)
@@ -173,7 +173,7 @@ public:
     void TransformPoint(wxDouble* x, wxDouble* y) const;
 
     /**
     void TransformPoint(wxDouble* x, wxDouble* y) const;
 
     /**
-        Applies the linear part of this matrix, i.e. without translation.
+        Applies the linear part of this matrix, i.e.\ without translation.
 
         @param p
             The source receiving the transformations.
 
         @param p
             The source receiving the transformations.
index efbeb7bd186092a1aa475122314ac44021eafea4..0d18095ce95f3c1562dd16f468abc5a3b3d389b2 100644 (file)
@@ -185,7 +185,7 @@ public:
     void TransformPoint(wxDouble* x, wxDouble* y) const;
 
     /**
     void TransformPoint(wxDouble* x, wxDouble* y) const;
 
     /**
-        Applies the linear part of this matrix, i.e. without translation.
+        Applies the linear part of this matrix, i.e.\ without translation.
 
         @param p
             The source receiving the transformations.
 
         @param p
             The source receiving the transformations.
index 72f31f43195f184a3647c545866a527b62e1aa91..cebd6aeb9fa2baa69ddebcc24897e8dcf8e53619 100644 (file)
@@ -94,7 +94,7 @@ public:
     virtual int FilterEvent(wxEvent& event);
 
     /**
     virtual int FilterEvent(wxEvent& event);
 
     /**
-        Returns the main event loop instance, i.e. the event loop which is started
+        Returns the main event loop instance, i.e.\ the event loop which is started
         by OnRun() and which dispatches all events sent from the native toolkit
         to the application (except when new event loops are temporarily set-up).
         The returned value maybe @NULL. Put initialization code which needs a
         by OnRun() and which dispatches all events sent from the native toolkit
         to the application (except when new event loops are temporarily set-up).
         The returned value maybe @NULL. Put initialization code which needs a
@@ -245,7 +245,7 @@ public:
     static wxAppConsole* GetInstance();
 
     /**
     static wxAppConsole* GetInstance();
 
     /**
-        Returns @true if the main event loop is currently running, i.e. if the
+        Returns @true if the main event loop is currently running, i.e.\ if the
         application is inside OnRun().
 
         This can be useful to test whether events can be dispatched. For example,
         application is inside OnRun().
 
         This can be useful to test whether events can be dispatched. For example,
@@ -260,7 +260,7 @@ public:
     //@{
 
     /**
     //@{
 
     /**
-        This function is called when an assert failure occurs, i.e. the condition
+        This function is called when an assert failure occurs, i.e.\ the condition
         specified in wxASSERT() macro evaluated to @false.
 
         It is only called in debug mode (when @c __WXDEBUG__ is defined) as
         specified in wxASSERT() macro evaluated to @false.
 
         It is only called in debug mode (when @c __WXDEBUG__ is defined) as
@@ -288,7 +288,7 @@ public:
                                  const wxChar *msg);
 
     /**
                                  const wxChar *msg);
 
     /**
-        Called when command line parsing fails (i.e. an incorrect command line option
+        Called when command line parsing fails (i.e.\ an incorrect command line option
         was specified by the user). The default behaviour is to show the program usage
         text and abort the program.
 
         was specified by the user). The default behaviour is to show the program usage
         text and abort the program.
 
@@ -700,7 +700,7 @@ public:
     virtual wxWindow* GetTopWindow() const;
 
     /**
     virtual wxWindow* GetTopWindow() const;
 
     /**
-        Returns @true if the application is active, i.e. if one of its windows is
+        Returns @true if the application is active, i.e.\ if one of its windows is
         currently in the foreground.
 
         If this function returns @false and you need to attract users attention to
         currently in the foreground.
 
         If this function returns @false and you need to attract users attention to
index dedb9d755e20bab8c5c2435dff2f5779370def54..724cadc11588dfb54456d66be11e1eae6892a7a7 100644 (file)
@@ -178,7 +178,7 @@ public:
     wxCharTypeBuffer(const wxScopedCharTypeBuffer<T>& src);
 
     /**
     wxCharTypeBuffer(const wxScopedCharTypeBuffer<T>& src);
 
     /**
-        Assigns @a str to this buffer and takes ownership of it (i.e. the
+        Assigns @a str to this buffer and takes ownership of it (i.e.\ the
         buffer becomes "owned").
      */
     wxCharTypeBuffer& operator=(const CharType *str);
         buffer becomes "owned").
      */
     wxCharTypeBuffer& operator=(const CharType *str);
index 1be8e1db024acb0f36d5d5eafa95b25262c9326f..2f6ab42db5ba2adce271eab5ccb7b4db2785e63b 100644 (file)
@@ -145,7 +145,7 @@ public:
     bool HasBackgroundColour() const;
 
     /**
     bool HasBackgroundColour() const;
 
     /**
-        Returns @true if a non-default (i.e. any) border is set.
+        Returns @true if a non-default (i.e.\ any) border is set.
     */
     bool HasBorder() const;
 
     */
     bool HasBorder() const;
 
index f366299ab16d94359dcf004d7fd0af18b04c1f71..e650262bf2aa6642ec57617bbcac14eb292b488a 100644 (file)
@@ -259,7 +259,7 @@ public:
     bool HasValue(const wxDataViewItem& item, unsigned col) const;
 
     /**
     bool HasValue(const wxDataViewItem& item, unsigned col) const;
 
     /**
-        Override this to indicate of @a item is a container, i.e. if
+        Override this to indicate of @a item is a container, i.e.\ if
         it can have child items.
     */
     virtual bool IsContainer(const wxDataViewItem& item) const = 0;
         it can have child items.
     */
     virtual bool IsContainer(const wxDataViewItem& item) const = 0;
index 9c07d391d6e130fedf367107aa62e53fbd0b5a3c..46106b11bf7ac873d828f9818fc101e5f5d950fb 100644 (file)
@@ -754,7 +754,7 @@ public:
 
     /**
         Returns @true if the date is equal to another one up to the given time
 
     /**
         Returns @true if the date is equal to another one up to the given time
-        interval, i.e. if the absolute difference between the two dates is less
+        interval, i.e.\ if the absolute difference between the two dates is less
         than this interval.
     */
     bool IsEqualUpTo(const wxDateTime& dt, const wxTimeSpan& ts) const;
         than this interval.
     */
     bool IsEqualUpTo(const wxDateTime& dt, const wxTimeSpan& ts) const;
@@ -1214,7 +1214,7 @@ public:
                                       WeekFlags flags = Monday_First);
 
     /**
                                       WeekFlags flags = Monday_First);
 
     /**
-        Sets the date to the day number @a yday in the same year (i.e., unlike
+        Sets the date to the day number @a yday in the same year (i.e.\ unlike
         the other functions, this one does not use the current year). The day
         number should be in the range 1-366 for the leap years and 1-365 for
         the other ones.
         the other functions, this one does not use the current year). The day
         number should be in the range 1-366 for the leap years and 1-365 for
         the other ones.
@@ -1339,7 +1339,7 @@ public:
 
 
     /**
 
 
     /**
-        Converts the year in absolute notation (i.e. a number which can be
+        Converts the year in absolute notation (i.e.\ a number which can be
         negative, positive or zero) to the year in BC/AD notation. For the
         positive years, nothing is done, but the year 0 is year 1 BC and so for
         other years there is a difference of 1.
         negative, positive or zero) to the year in BC/AD notation. For the
         positive years, nothing is done, but the year 0 is year 1 BC and so for
         other years there is a difference of 1.
@@ -1381,7 +1381,7 @@ public:
                                  Country country = Country_Default);
 
     /**
                                  Country country = Country_Default);
 
     /**
-        Get the current century, i.e. first two digits of the year, in given
+        Get the current century, i.e.\ first two digits of the year, in given
         calendar (only Gregorian is currently supported).
     */
     static int GetCentury(int year);
         calendar (only Gregorian is currently supported).
     */
     static int GetCentury(int year);
@@ -1567,7 +1567,7 @@ public:
 
     /**
         Returns the object corresponding to the midnight of the current day
 
     /**
         Returns the object corresponding to the midnight of the current day
-        (i.e. the same as Now(), but the time part is set to 0).
+        (i.e.\ the same as Now(), but the time part is set to 0).
 
         @see Now()
     */
 
         @see Now()
     */
@@ -2016,7 +2016,7 @@ public:
     bool IsEqualTo(const wxTimeSpan& ts) const;
 
     /**
     bool IsEqualTo(const wxTimeSpan& ts) const;
 
     /**
-        Compares two timespans: works with the absolute values, i.e. -2 hours
+        Compares two timespans: works with the absolute values, i.e.\ -2 hours
         is longer than 1 hour. Also, it will return @false if the timespans are
         equal in absolute value.
     */
         is longer than 1 hour. Also, it will return @false if the timespans are
         equal in absolute value.
     */
@@ -2038,7 +2038,7 @@ public:
     bool IsPositive() const;
 
     /**
     bool IsPositive() const;
 
     /**
-        Compares two timespans: works with the absolute values, i.e. 1 hour is
+        Compares two timespans: works with the absolute values, i.e.\ 1 hour is
         shorter than -2 hours. Also, it will return @false if the timespans are
         equal in absolute value.
     */
         shorter than -2 hours. Also, it will return @false if the timespans are
         equal in absolute value.
     */
index d496f73703e48f3e5c217c5fb44f3e95d914618b..0d7e5ab5e6cefd093696a296a409f49fc0b360e1 100644 (file)
@@ -73,7 +73,7 @@ enum wxMappingMode
     wxMM_TWIPS,
 
     /**
     wxMM_TWIPS,
 
     /**
-        Each logical unit is a @e "printer point" i.e. 1/72 of an inch.
+        Each logical unit is a @e "printer point" i.e.\ 1/72 of an inch.
         Equivalent to about 353 micrometers.
     */
     wxMM_POINTS
         Equivalent to about 353 micrometers.
     */
     wxMM_POINTS
@@ -1413,7 +1413,7 @@ public:
     bool IsOk() const;
 
     /**
     bool IsOk() const;
 
     /**
-        Sets the x and y axis orientation (i.e., the direction from lowest to
+        Sets the x and y axis orientation (i.e.\ the direction from lowest to
         highest values on the axis). The default orientation is x axis from
         left to right and y axis from top down.
 
         highest values on the axis). The default orientation is x axis from
         left to right and y axis from top down.
 
@@ -1427,7 +1427,7 @@ public:
     void SetAxisOrientation(bool xLeftRight, bool yBottomUp);
 
     /**
     void SetAxisOrientation(bool xLeftRight, bool yBottomUp);
 
     /**
-        Sets the device origin (i.e., the origin in pixels after scaling has
+        Sets the device origin (i.e.\ the origin in pixels after scaling has
         been applied). This function may be useful in Windows printing
         operations for placing a graphic on a page.
     */
         been applied). This function may be useful in Windows printing
         operations for placing a graphic on a page.
     */
index 91a96d6a1afaaeab2df88731b231f769349fa842..4bf33e33c850742bc2fbbe2ac9f31711222a7a8a 100644 (file)
@@ -119,7 +119,7 @@ public:
     virtual bool HangUp() = 0;
 
     /**
     virtual bool HangUp() = 0;
 
     /**
-        Returns @true if the computer has a permanent network connection (i.e.
+        Returns @true if the computer has a permanent network connection (i.e.\
         is on a LAN) and so there is no need to use Dial() function to go
         online.
 
         is on a LAN) and so there is no need to use Dial() function to go
         online.
 
index f9066994d6702ae14e234ba45570f3178c0cbe9e..5f9ec733d68ec81c89a61787714abf821a65c1d2 100644 (file)
@@ -254,36 +254,36 @@ public:
     wxSortedArray(int (*)(T first, T second)compareFunction);
 
     /**
     wxSortedArray(int (*)(T first, T second)compareFunction);
 
     /**
-        Performs a shallow array copy (i.e. doesn't copy the objects pointed to
+        Performs a shallow array copy (i.e.\ doesn't copy the objects pointed to
         even if the source array contains the items of pointer type).
     */
     wxArray(const wxArray& array);
 
     /**
         even if the source array contains the items of pointer type).
     */
     wxArray(const wxArray& array);
 
     /**
-        Performs a shallow array copy (i.e. doesn't copy the objects pointed to
+        Performs a shallow array copy (i.e.\ doesn't copy the objects pointed to
         even if the source array contains the items of pointer type).
     */
     wxSortedArray(const wxSortedArray& array);
 
     /**
         even if the source array contains the items of pointer type).
     */
     wxSortedArray(const wxSortedArray& array);
 
     /**
-        Performs a deep copy (i.e. the array element are copied too).
+        Performs a deep copy (i.e.\ the array element are copied too).
     */
     wxObjArray(const wxObjArray& array);
 
     /**
     */
     wxObjArray(const wxObjArray& array);
 
     /**
-        Performs a shallow array copy (i.e. doesn't copy the objects pointed to
+        Performs a shallow array copy (i.e.\ doesn't copy the objects pointed to
         even if the source array contains the items of pointer type).
     */
     wxArray& operator=(const wxArray& array);
 
     /**
         even if the source array contains the items of pointer type).
     */
     wxArray& operator=(const wxArray& array);
 
     /**
-        Performs a shallow array copy (i.e. doesn't copy the objects pointed to
+        Performs a shallow array copy (i.e.\ doesn't copy the objects pointed to
         even if the source array contains the items of pointer type).
     */
     wxSortedArray& operator=(const wxSortedArray& array);
 
     /**
         even if the source array contains the items of pointer type).
     */
     wxSortedArray& operator=(const wxSortedArray& array);
 
     /**
-        Performs a deep copy (i.e. the array element are copied too).
+        Performs a deep copy (i.e.\ the array element are copied too).
     */
     wxObjArray& operator=(const wxObjArray& array);
 
     */
     wxObjArray& operator=(const wxObjArray& array);
 
@@ -376,7 +376,7 @@ public:
     T& Item(size_t index) const;
 
     /**
     T& Item(size_t index) const;
 
     /**
-        Returns the last element in the array, i.e. is the same as calling
+        Returns the last element in the array, i.e.\ is the same as calling
         "Item(GetCount() - 1)". An assert failure is raised in the debug mode
         if the array is empty.
 
         "Item(GetCount() - 1)". An assert failure is raised in the debug mode
         if the array is empty.
 
index 6445f9d425725f6b3af0841b4cf29651b0b4d4e4..3c3baeaadafb539965463cb4d79a9abfaaa35b69 100644 (file)
@@ -37,19 +37,19 @@ public:
     bool GetAddress(void* addr, size_t* len) const;
 
     /**
     bool GetAddress(void* addr, size_t* len) const;
 
     /**
-        Returns the base name of this module, e.g. @c "kernel32.dll" or
+        Returns the base name of this module, e.g.\ @c "kernel32.dll" or
         @c "libc-2.3.2.so".
     */
     wxString GetName() const;
 
     /**
         @c "libc-2.3.2.so".
     */
     wxString GetName() const;
 
     /**
-        Returns the full path of this module if available, e.g.
-        @c "c:\windows\system32\kernel32.dll" or @c "/lib/libc-2.3.2.so".
+        Returns the full path of this module if available, e.g.\ @c "c:\windows\system32\kernel32.dll"
+        or @c "/lib/libc-2.3.2.so".
     */
     wxString GetPath() const;
 
     /**
     */
     wxString GetPath() const;
 
     /**
-        Returns the version of this module, e.g. @c "5.2.3790.0" or @c "2.3.2".
+        Returns the version of this module, e.g.\ @c "5.2.3790.0" or @c "2.3.2".
         The returned string is empty if the version information is not
         available.
     */
         The returned string is empty if the version information is not
         available.
     */
@@ -138,7 +138,7 @@ public:
                                            wxPluginCategory cat = wxDL_PLUGIN_GUI);
 
     /**
                                            wxPluginCategory cat = wxDL_PLUGIN_GUI);
 
     /**
-        Detaches this object from its library handle, i.e. the object will not
+        Detaches this object from its library handle, i.e.\ the object will not
         unload the library any longer in its destructor but it is now the
         callers responsibility to do this using Unload().
     */
         unload the library any longer in its destructor but it is now the
         callers responsibility to do this using Unload().
     */
index f00dc12b0ffa5ee604784c5abe01f41dc4be7738..f9411ad8466b788ba441b3c345683b88204ce189 100644 (file)
@@ -224,7 +224,7 @@ public:
     void SetTimestamp(long timeStamp = 0);
 
     /**
     void SetTimestamp(long timeStamp = 0);
 
     /**
-        Test if this event should be propagated or not, i.e. if the propagation level
+        Test if this event should be propagated or not, i.e.\ if the propagation level
         is currently greater than 0.
     */
     bool ShouldPropagate() const;
         is currently greater than 0.
     */
     bool ShouldPropagate() const;
@@ -2726,7 +2726,7 @@ public:
     int GetLinesPerAction() const;
 
     /**
     int GetLinesPerAction() const;
 
     /**
-        Returns the logical mouse position in pixels (i.e. translated according to the
+        Returns the logical mouse position in pixels (i.e.\ translated according to the
         translation set for the DC, which usually indicates that the window has been
         scrolled).
     */
         translation set for the DC, which usually indicates that the window has been
         scrolled).
     */
index 662ea08d0a279e83b8541997f40297e01100b501..f4c120eccb04d380c8626ccf935ecdcf40fce6c4 100644 (file)
@@ -118,7 +118,7 @@ public:
                 const wxString& name = wxFileCtrlNameStr);
 
     /**
                 const wxString& name = wxFileCtrlNameStr);
 
     /**
-        Returns the current directory of the file control (i.e. the directory shown by it).
+        Returns the current directory of the file control (i.e.\ the directory shown by it).
     */
     virtual wxString GetDirectory() const;
 
     */
     virtual wxString GetDirectory() const;
 
index c1f4bbd9b9ecf3044dc977e6d9500f18fcfcce92..4464a3651ec9e4f3cbaf7c48b297ec725a0e0511 100644 (file)
@@ -322,7 +322,7 @@ wxString wxPathOnly(const wxString& path);
 bool wxIsWild(const wxString& pattern);
 
 /**
 bool wxIsWild(const wxString& pattern);
 
 /**
-    Returns @true if the argument is an absolute filename, i.e. with a slash
+    Returns @true if the argument is an absolute filename, i.e.\ with a slash
     or drive name at the beginning.
 
     @header{wx/filefn.h}
     or drive name at the beginning.
 
     @header{wx/filefn.h}
index 52a0fffe8479c36e218ade48e02cc25fbd59a352..12daa92904c44e51ed84f474cbfe28bc85d59a9d 100644 (file)
@@ -954,9 +954,8 @@ public:
     void Set(int width, int height);
 
     /**
     void Set(int width, int height);
 
     /**
-        Combine this size object with another one replacing the default (i.e.
-        equal to -1) components of this object with those of the other. It is
-        typically used like this:
+        Combine this size object with another one replacing the default (i.e.\ equal to -1)
+        components of this object with those of the other. It is typically used like this:
 
         @code
         if ( !size.IsFullySpecified() )
 
         @code
         if ( !size.IsFullySpecified() )
index 3e9c9cbe47ac53a9d5ba24e5d3bb98b2211e12d8..e3690f6bdb3f79c0c75bdc83fed2cb9e7648fab6 100644 (file)
@@ -30,7 +30,7 @@ class wxIconLocation
 {
 public:
     /**
 {
 public:
     /**
-        Returns @true if the object is valid, i.e. was properly initialized, and
+        Returns @true if the object is valid, i.e.\ was properly initialized, and
         @false otherwise.
     */
     bool IsOk() const;
         @false otherwise.
     */
     bool IsOk() const;
index 864624d1dd7de7c0a95d0981b64064c6cda22f55..1a2ae82c79a5ab1580398ad9936c13e5120c2838 100644 (file)
@@ -1356,7 +1356,7 @@ public:
     bool IsOk() const;
 
     /**
     bool IsOk() const;
 
     /**
-        Returns @true if the given pixel is transparent, i.e. either has the mask
+        Returns @true if the given pixel is transparent, i.e.\ either has the mask
         colour if this image has a mask or if this image has alpha channel and alpha
         value of this pixel is strictly less than @a threshold.
     */
         colour if this image has a mask or if this image has alpha channel and alpha
         value of this pixel is strictly less than @a threshold.
     */
index 823253c4d2abab393dbe07afaea3f7f5d57df137..5dedfe92906b7a9b71e5939b5d6a6207d3903b8b 100644 (file)
@@ -902,7 +902,7 @@ public:
     bool IsEnabled(int id) const;
 
     /**
     bool IsEnabled(int id) const;
 
     /**
-        Inserts the given @a item at position 0, i.e. before all the other
+        Inserts the given @a item at position 0, i.e.\ before all the other
         existing items.
 
         @see Append(), Insert()
         existing items.
 
         @see Append(), Insert()
@@ -910,7 +910,7 @@ public:
     wxMenuItem* Prepend(wxMenuItem* item);
 
     /**
     wxMenuItem* Prepend(wxMenuItem* item);
 
     /**
-        Inserts the given @a item at position 0, i.e. before all the other
+        Inserts the given @a item at position 0, i.e.\ before all the other
         existing items.
 
         @see Append(), Insert()
         existing items.
 
         @see Append(), Insert()
index dbe8a5bfbadb4a39f07ac8d8513cc587cec2dff4..90d6655767c019e7154f2b3fc4e85eaa4aee971e 100644 (file)
@@ -262,7 +262,7 @@ public:
     virtual wxClassInfo* GetClassInfo() const;
 
     /**
     virtual wxClassInfo* GetClassInfo() const;
 
     /**
-        Returns the wxObject::m_refData pointer, i.e. the data referenced by this object.
+        Returns the wxObject::m_refData pointer, i.e.\ the data referenced by this object.
 
         @see Ref(), UnRef(), wxObject::m_refData, SetRefData(), wxObjectRefData
     */
 
         @see Ref(), UnRef(), wxObject::m_refData, SetRefData(), wxObjectRefData
     */
index c4b2f108f5732ffa65a316246a09563f7b28758e..24a00f9ab6a97037f8d9c14e17c0ba63bf7b17d3 100644 (file)
@@ -106,7 +106,7 @@ public:
     int GetTextCtrlProportion() const;
 
     /**
     int GetTextCtrlProportion() const;
 
     /**
-        Returns @true if this window has a valid text control (i.e. if the @c
+        Returns @true if this window has a valid text control (i.e.\ if the @c
         wxPB_USE_TEXTCTRL style was given when creating this control).
     */
     bool HasTextCtrl() const;
         wxPB_USE_TEXTCTRL style was given when creating this control).
     */
     bool HasTextCtrl() const;
index f7e6aec56e176759f54d3ca868883ba9260d1cee..4c1476d1712b1ad42c030e6cbb68e99c47a4417c 100644 (file)
@@ -38,7 +38,7 @@ public:
     bool Create(wxWindow *parent, int flags = wxBORDER_NONE);
 
     /**
     bool Create(wxWindow *parent, int flags = wxBORDER_NONE);
 
     /**
-        Move the popup window to the right position, i.e. such that it is
+        Move the popup window to the right position, i.e.\ such that it is
         entirely visible.
 
         The popup is positioned at ptOrigin + size if it opens below and to the
         entirely visible.
 
         The popup is positioned at ptOrigin + size if it opens below and to the
index b1cb87505b5972d382b5bcd42bd92406fd05aa6f..cfba7bf245ac965131b4bd6283207569e1c43a2a 100644 (file)
@@ -163,7 +163,7 @@ public:
     wxString  GetMatch(const wxString& text, size_t index = 0) const;
 
     /**
     wxString  GetMatch(const wxString& text, size_t index = 0) const;
 
     /**
-        Returns the size of the array of matches, i.e. the number of bracketed
+        Returns the size of the array of matches, i.e.\ the number of bracketed
         subexpressions plus one for the expression itself, or 0 on error.
 
         May only be called after successful call to Compile().
         subexpressions plus one for the expression itself, or 0 on error.
 
         May only be called after successful call to Compile().
index bdf25ba38469c00461ba47d69444c4c8ac8e6004..b0f4f20606dfed4009327499482c57be8174857a 100644 (file)
@@ -322,7 +322,7 @@ public:
     virtual bool IsEmpty() const;
 
     /**
     virtual bool IsEmpty() const;
 
     /**
-        Returns @true if the region is equal to, i.e. covers the same area as,
+        Returns @true if the region is equal to, i.e.\ covers the same area as,
         another one.
 
         If both this region and @a region are both invalid, they are considered
         another one.
 
         If both this region and @a region are both invalid, they are considered
index f02c32a666a8714a9188d430c258aa2cfcce2517..6b7e5ac5fa8865f180edca61567aad30fea3400d 100644 (file)
@@ -43,7 +43,7 @@ enum
     /** Mouse is currently over the control. */
     wxCONTROL_CURRENT    = 0x00000010,
 
     /** Mouse is currently over the control. */
     wxCONTROL_CURRENT    = 0x00000010,
 
-    /** Selected item in e.g. listbox. */
+    /** Selected item in e.g.\ listbox. */
     wxCONTROL_SELECTED   = 0x00000020,
 
     /** (Check/radio button) is checked. */
     wxCONTROL_SELECTED   = 0x00000020,
 
     /** (Check/radio button) is checked. */
index 9501317cfac0344242ac58e117b1128a0eaa7d49..056c3fa13c62d6b0d408e70596b9b6a749de6a7d 100644 (file)
@@ -642,7 +642,7 @@ public:
     bool IsShown(size_t index) const;
 
     /**
     bool IsShown(size_t index) const;
 
     /**
-        Call this to force layout of the children anew, e.g. after having added a child
+        Call this to force layout of the children anew, e.g.\ after having added a child
         to or removed a child (window, other sizer or space) from the sizer while
         keeping the current dimension.
     */
         to or removed a child (window, other sizer or space) from the sizer while
         keeping the current dimension.
     */
index 9cd97ca9175443342fa6ee2cbdebd09bf76e5718..29d9c849e3928d50c5f02573c141d44e42838a93 100644 (file)
@@ -115,7 +115,7 @@ public:
     virtual wxString GetConfigDir() const;
 
     /**
     virtual wxString GetConfigDir() const;
 
     /**
-        Return the location of the applications global, i.e. not user-specific,
+        Return the location of the applications global, i.e.\ not user-specific,
         data files.
 
         Example return values:
         data files.
 
         Example return values:
@@ -159,7 +159,7 @@ public:
     virtual wxString GetExecutablePath() const;
 
     /**
     virtual wxString GetExecutablePath() const;
 
     /**
-        Return the program installation prefix, e.g. @c /usr, @c /opt or @c /home/zeitlin.
+        Return the program installation prefix, e.g.\ @c /usr, @c /opt or @c /home/zeitlin.
 
         If the prefix had been previously by SetInstallPrefix(), returns that
         value, otherwise tries to determine it automatically (Linux only right now)
 
         If the prefix had been previously by SetInstallPrefix(), returns that
         value, otherwise tries to determine it automatically (Linux only right now)
index 56d79333ccbb9f023fe80e480f32e9dba9c4b91c..7be2745d133868d9a94cc8ad79d91fbb70c7d1fb 100644 (file)
@@ -1092,7 +1092,7 @@ public:
     /**
         Gets the thread identifier: this is a platform dependent number that uniquely
         identifies the thread throughout the system during its existence
     /**
         Gets the thread identifier: this is a platform dependent number that uniquely
         identifies the thread throughout the system during its existence
-        (i.e. the thread identifiers may be reused).
+        (i.e.\ the thread identifiers may be reused).
     */
     wxThreadIdType GetId() const;
 
     */
     wxThreadIdType GetId() const;
 
@@ -1123,7 +1123,7 @@ public:
     unsigned int GetPriority() const;
 
     /**
     unsigned int GetPriority() const;
 
     /**
-        Returns @true if the thread is alive (i.e. started and not terminating).
+        Returns @true if the thread is alive (i.e.\ started and not terminating).
 
         Note that this function can only safely be used with joinable threads, not
         detached ones as the latter delete themselves and so when the real thread is
 
         Note that this function can only safely be used with joinable threads, not
         detached ones as the latter delete themselves and so when the real thread is
index 054e890057f9bf26988e56d96c5e2a148aa7bd50..ba5e2394a9b64d16c0193fc21b8d26a70f8a9dd5 100644 (file)
@@ -86,7 +86,7 @@ public:
     wxEvtHandler* GetOwner() const;
 
     /**
     wxEvtHandler* GetOwner() const;
 
     /**
-        Returns @true if the timer is one shot, i.e. if it will stop after firing
+        Returns @true if the timer is one shot, i.e.\ if it will stop after firing
         the first notification automatically.
     */
     bool IsOneShot() const;
         the first notification automatically.
     */
     bool IsOneShot() const;
index 2b8cbf984a3d7dec946e7d530d7d9868b8e0c426..98454bc632926e1b39b797f6bcb1690c34777597 100644 (file)
@@ -37,7 +37,7 @@ public:
     virtual ~wxTipProvider();
 
     /**
     virtual ~wxTipProvider();
 
     /**
-        Returns the index of the current tip (i.e. the one which would be returned by GetTip()).
+        Returns the index of the current tip (i.e.\ the one which would be returned by GetTip()).
 
         The program usually remembers the value returned by this function after calling
         wxShowTip(). Note that it is not the same as the value which was passed to
 
         The program usually remembers the value returned by this function after calling
         wxShowTip(). Note that it is not the same as the value which was passed to
index f27ba1a5f62a0b5e3051ba7fdb20393707a971a1..3eeeedc143dca00d372d643305c7f596ab45090b 100644 (file)
@@ -136,7 +136,7 @@ public:
     wxString GetNextToken();
 
     /**
     wxString GetNextToken();
 
     /**
-        Returns the current position (i.e. one index after the last returned
+        Returns the current position (i.e.\ one index after the last returned
         token or 0 if GetNextToken() has never been called) in the original
         string.
     */
         token or 0 if GetNextToken() has never been called) in the original
         string.
     */
index 9bd3b169aeb7941598b43bcc24ae456736f6853c..9f0f8674cec146f33c79cd18ad1e71d3e32bfcc6 100644 (file)
@@ -319,7 +319,7 @@ public:
                                     wxObject* clientData = NULL);
 
     /**
                                     wxObject* clientData = NULL);
 
     /**
-        Adds any control to the toolbar, typically e.g. a wxComboBox.
+        Adds any control to the toolbar, typically e.g.\ a wxComboBox.
 
         @param control
             The control to be added.
 
         @param control
             The control to be added.
index 0d6294021a61aab0f3272fbedf2aebd119794983..4cfa892bb7030ca31b9b669328351d25fadad8dd 100644 (file)
@@ -214,7 +214,7 @@ public:
     virtual void Iconize(bool iconize = true);
 
     /**
     virtual void Iconize(bool iconize = true);
 
     /**
-        Returns @true if this window is currently active, i.e. if the user is
+        Returns @true if this window is currently active, i.e.\ if the user is
         currently working with it.
     */
     virtual bool IsActive();
         currently working with it.
     */
     virtual bool IsActive();
index db418931e08bebbf9eb646f38bad3c7f07d0bf2a..f328935b7e25a119383055ce61338a7f263ef158 100644 (file)
@@ -726,7 +726,7 @@ public:
     virtual bool IsBold(const wxTreeItemId& item) const;
 
     /**
     virtual bool IsBold(const wxTreeItemId& item) const;
 
     /**
-        Returns @true if the control is empty (i.e. has no items, even no root
+        Returns @true if the control is empty (i.e.\ has no items, even no root
         one).
     */
     bool IsEmpty() const;
         one).
     */
     bool IsEmpty() const;
index e37338f9d0a4c7559217f3787d2389e7bd98c3aa..f23a0c45b3b5b3febf9ecdced68c22e0b7ac960b 100644 (file)
@@ -54,7 +54,7 @@ public:
     value_type GetValue() const;
 
     /**
     value_type GetValue() const;
 
     /**
-        Returns true if the character is an ASCII character (i.e. if its value is less than 128).
+        Returns true if the character is an ASCII character (i.e.\ if its value is less than 128).
     */
     bool IsAscii() const;
 
     */
     bool IsAscii() const;
 
index 6a3e800567d70d826f8812f280daa50c45723333..b1eeef4334a2eb6d33fe2a08311ae31fa9341cc7 100644 (file)
@@ -97,7 +97,7 @@ public:
     wxProtocol& GetProtocol();
 
     /**
     wxProtocol& GetProtocol();
 
     /**
-        Returns @true if this object is correctly initialized, i.e. if
+        Returns @true if this object is correctly initialized, i.e.\ if
         GetError() returns ::wxURL_NOERR.
     */
     bool IsOk() const;
         GetError() returns ::wxURL_NOERR.
     */
     bool IsOk() const;
index de47ae03721b6227f6090d9c777b1fd85ab0f404..21aaca576308d45ab74bedb41c603adefafcc182 100644 (file)
@@ -112,7 +112,7 @@ public:
 
 
     /**
 
 
     /**
-        Returns vector's current capacity, i.e. how much memory is allocated.
+        Returns vector's current capacity, i.e.\ how much memory is allocated.
 
         @see reserve()
     */
 
         @see reserve()
     */
index ba512f52ceee2884465398401db18f850b06deb9..0aae95a4f318e46fcc5894f6efe4f0858dc848ff 100644 (file)
@@ -35,17 +35,17 @@ public:
     bool Matches(const wxVideoMode& other) const;
 
     /**
     bool Matches(const wxVideoMode& other) const;
 
     /**
-        Returns the screen width in pixels (e.g. 640), 0 means unspecified.
+        Returns the screen width in pixels (e.g.\ 640), 0 means unspecified.
     */
     int GetWidth() const;
 
     /**
     */
     int GetWidth() const;
 
     /**
-        Returns the screen height in pixels (e.g. 480), 0 means unspecified.
+        Returns the screen height in pixels (e.g.\ 480), 0 means unspecified.
     */
     int GetHeight() const;
 
     /**
     */
     int GetHeight() const;
 
     /**
-        Returns bits per pixel (e.g. 32), 1 is monochrome and 0 means
+        Returns bits per pixel (e.g.\ 32), 1 is monochrome and 0 means
         unspecified/known.
     */
     int GetDepth() const;
         unspecified/known.
     */
     int GetDepth() const;
@@ -62,17 +62,17 @@ public:
 
 
     /**
 
 
     /**
-        The screen width in pixels (e.g. 640), 0 means unspecified.
+        The screen width in pixels (e.g.\ 640), 0 means unspecified.
     */
     int w;
 
     /**
     */
     int w;
 
     /**
-        The screen height in pixels (e.g. 480), 0 means unspecified.
+        The screen height in pixels (e.g.\ 480), 0 means unspecified.
     */
     int h;
 
     /**
     */
     int h;
 
     /**
-        Bits per pixel (e.g. 32), 1 is monochrome and 0 means
+        Bits per pixel (e.g.\ 32), 1 is monochrome and 0 means
         unspecified/known.
     */
     int bpp;
         unspecified/known.
     */
     int bpp;
index 1dc23d35992c6da8d7575f3f00235324481d34f2..693f0ea379508a133b860599237529cfac484728 100644 (file)
@@ -190,7 +190,7 @@ public:
     bool IsSelected(size_t item) const;
 
     /**
     bool IsSelected(size_t item) const;
 
     /**
-        Selects or deselects the specified item which must be valid (i.e. not
+        Selects or deselects the specified item which must be valid (i.e.\ not
         equal to @c wxNOT_FOUND).
 
         @return @true if the items selection status has changed or @false
         equal to @c wxNOT_FOUND).
 
         @return @true if the items selection status has changed or @false
@@ -270,7 +270,7 @@ public:
     void SetSelectionBackground(const wxColour& col);
 
     /**
     void SetSelectionBackground(const wxColour& col);
 
     /**
-        Toggles the state of the specified @a item, i.e. selects it if it was
+        Toggles the state of the specified @a item, i.e.\ selects it if it was
         unselected and deselects it if it was selected.
 
         This method is only valid for multi selection listboxes.
         unselected and deselects it if it was selected.
 
         This method is only valid for multi selection listboxes.
index d74c64cb88de954f621efbc1d281fe1d8cc728d6..27ac796d416f57dd2b3930cd817fc4d0fbbbbd5b 100644 (file)
@@ -372,7 +372,7 @@ public:
     virtual wxString GetPageText() const = 0;
 
     /**
     virtual wxString GetPageText() const = 0;
 
     /**
-        Returns whether the web control is currently busy (e.g. loading a page).
+        Returns whether the web control is currently busy (e.g.\ loading a page).
     */
     virtual bool IsBusy() const = 0;
 
     */
     virtual bool IsBusy() const = 0;
 
index f7d3a319388b4c9bc8b352a68de37237389c7101..74e220863eea30f8f4feec68d00b8515e1afe251 100644 (file)
@@ -339,8 +339,8 @@ public:
 
     /**
         This method may be overridden in the derived classes to return @false to
 
     /**
         This method may be overridden in the derived classes to return @false to
-        indicate that this control doesn't accept input at all (i.e. behaves like
-        e.g. wxStaticText) and so doesn't need focus.
+        indicate that this control doesn't accept input at all (i.e.\ behaves like
+        e.g.\ wxStaticText) and so doesn't need focus.
 
         @see AcceptsFocusFromKeyboard()
     */
 
         @see AcceptsFocusFromKeyboard()
     */
@@ -535,7 +535,7 @@ public:
     bool IsDescendant(wxWindowBase* win) const;
 
     /**
     bool IsDescendant(wxWindowBase* win) const;
 
     /**
-        Reparents the window, i.e. the window will be removed from its
+        Reparents the window, i.e.\ the window will be removed from its
         current parent window (e.g. a non-standard toolbar in a wxFrame)
         and then re-inserted into another.
 
         current parent window (e.g. a non-standard toolbar in a wxFrame)
         and then re-inserted into another.
 
@@ -1401,7 +1401,7 @@ public:
     virtual wxPoint GetClientAreaOrigin() const;
 
     /**
     virtual wxPoint GetClientAreaOrigin() const;
 
     /**
-       Get the client rectangle in window (i.e. client) coordinates
+       Get the client rectangle in window (i.e.\ client) coordinates
     */
     wxRect GetClientRect() const;
 
     */
     wxRect GetClientRect() const;
 
@@ -2364,7 +2364,7 @@ public:
     virtual bool HideWithEffect(wxShowEffect effect,
                                 unsigned int timeout = 0);
     /**
     virtual bool HideWithEffect(wxShowEffect effect,
                                 unsigned int timeout = 0);
     /**
-        Returns @true if the window is enabled, i.e. if it accepts user input,
+        Returns @true if the window is enabled, i.e.\ if it accepts user input,
         @false otherwise.
 
         Notice that this method can return @false even if this window itself hadn't
         @false otherwise.
 
         Notice that this method can return @false even if this window itself hadn't
@@ -2404,7 +2404,7 @@ public:
     virtual bool IsShown() const;
 
     /**
     virtual bool IsShown() const;
 
     /**
-        Returns @true if the window is physically visible on the screen, i.e. it
+        Returns @true if the window is physically visible on the screen, i.e.\ it
         is shown and all its parents up to the toplevel window are shown as well.
 
         @see IsShown()
         is shown and all its parents up to the toplevel window are shown as well.
 
         @see IsShown()
@@ -3223,7 +3223,7 @@ public:
     virtual void InitDialog();
 
     /**
     virtual void InitDialog();
 
     /**
-        Returns @true if the window contents is double-buffered by the system, i.e. if
+        Returns @true if the window contents is double-buffered by the system, i.e.\ if
         any drawing done on the window is really done on a temporary backing surface
         and transferred to the screen all at once later.
 
         any drawing done on the window is really done on a temporary backing surface
         and transferred to the screen all at once later.
 
@@ -3245,7 +3245,7 @@ public:
 
     /**
         Returns @true if this window is intrinsically enabled, @false otherwise,
 
     /**
         Returns @true if this window is intrinsically enabled, @false otherwise,
-        i.e. if @ref Enable() Enable(@false) had been called. This method is
+        i.e.\ if @ref Enable() Enable(@false) had been called. This method is
         mostly used for wxWidgets itself, user code should normally use
         IsEnabled() instead.
     */
         mostly used for wxWidgets itself, user code should normally use
         IsEnabled() instead.
     */
@@ -3599,7 +3599,7 @@ protected:
     virtual int DoGetBestClientWidth(int height) const;
 
     /**
     virtual int DoGetBestClientWidth(int height) const;
 
     /**
-        Sets the initial window size if none is given (i.e. at least one of the
+        Sets the initial window size if none is given (i.e.\ at least one of the
         components of the size passed to ctor/Create() is wxDefaultCoord).
         @deprecated Use SetInitialSize() instead.
     */
         components of the size passed to ctor/Create() is wxDefaultCoord).
         @deprecated Use SetInitialSize() instead.
     */
index 1da41dc998bbeea3ba952d0cbb05de65c0194595..95c8472fb5d2674bf61d1bd9cd3c770a9c3abe10 100644 (file)
@@ -82,7 +82,7 @@ public:
     static wxXLocale& GetCLocale();
 
     /**
     static wxXLocale& GetCLocale();
 
     /**
-        Returns @true if this object is initialized, i.e. represents a valid locale
+        Returns @true if this object is initialized, i.e.\ represents a valid locale
         or @false otherwise.
     */
     bool IsOk() const;
         or @false otherwise.
     */
     bool IsOk() const;