From 0824e369691b4a23a484e1d258b6e4ea021b022a Mon Sep 17 00:00:00 2001 From: Vadim Zeitlin Date: Sat, 1 Dec 2012 00:14:07 +0000 Subject: [PATCH] Fix premature truncation of brief descriptions in Doxygen comments. 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 --- interface/wx/affinematrix2d.h | 2 +- interface/wx/affinematrix2dbase.h | 2 +- interface/wx/app.h | 10 +++++----- interface/wx/buffer.h | 2 +- interface/wx/calctrl.h | 2 +- interface/wx/dataview.h | 2 +- interface/wx/datetime.h | 14 +++++++------- interface/wx/dc.h | 6 +++--- interface/wx/dialup.h | 2 +- interface/wx/dynarray.h | 14 +++++++------- interface/wx/dynlib.h | 10 +++++----- interface/wx/event.h | 4 ++-- interface/wx/filectrl.h | 2 +- interface/wx/filefn.h | 2 +- interface/wx/gdicmn.h | 5 ++--- interface/wx/iconloc.h | 2 +- interface/wx/image.h | 2 +- interface/wx/menu.h | 4 ++-- interface/wx/object.h | 2 +- interface/wx/pickerbase.h | 2 +- interface/wx/popupwin.h | 2 +- interface/wx/regex.h | 2 +- interface/wx/region.h | 2 +- interface/wx/renderer.h | 2 +- interface/wx/sizer.h | 2 +- interface/wx/stdpaths.h | 4 ++-- interface/wx/thread.h | 4 ++-- interface/wx/timer.h | 2 +- interface/wx/tipdlg.h | 2 +- interface/wx/tokenzr.h | 2 +- interface/wx/toolbar.h | 2 +- interface/wx/toplevel.h | 2 +- interface/wx/treectrl.h | 2 +- interface/wx/unichar.h | 2 +- interface/wx/url.h | 2 +- interface/wx/vector.h | 2 +- interface/wx/vidmode.h | 12 ++++++------ interface/wx/vlbox.h | 4 ++-- interface/wx/webview.h | 2 +- interface/wx/window.h | 18 +++++++++--------- interface/wx/xlocale.h | 2 +- 41 files changed, 82 insertions(+), 83 deletions(-) diff --git a/interface/wx/affinematrix2d.h b/interface/wx/affinematrix2d.h index b600494..99f84c4 100644 --- a/interface/wx/affinematrix2d.h +++ b/interface/wx/affinematrix2d.h @@ -173,7 +173,7 @@ public: 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. diff --git a/interface/wx/affinematrix2dbase.h b/interface/wx/affinematrix2dbase.h index efbeb7b..0d18095 100644 --- a/interface/wx/affinematrix2dbase.h +++ b/interface/wx/affinematrix2dbase.h @@ -185,7 +185,7 @@ public: 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. diff --git a/interface/wx/app.h b/interface/wx/app.h index 72f31f4..cebd6ae 100644 --- a/interface/wx/app.h +++ b/interface/wx/app.h @@ -94,7 +94,7 @@ public: 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 @@ -245,7 +245,7 @@ public: 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, @@ -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 @@ -288,7 +288,7 @@ public: 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. @@ -700,7 +700,7 @@ public: 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 diff --git a/interface/wx/buffer.h b/interface/wx/buffer.h index dedb9d7..724cadc 100644 --- a/interface/wx/buffer.h +++ b/interface/wx/buffer.h @@ -178,7 +178,7 @@ public: wxCharTypeBuffer(const wxScopedCharTypeBuffer& 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); diff --git a/interface/wx/calctrl.h b/interface/wx/calctrl.h index 1be8e1d..2f6ab42 100644 --- a/interface/wx/calctrl.h +++ b/interface/wx/calctrl.h @@ -145,7 +145,7 @@ public: 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; diff --git a/interface/wx/dataview.h b/interface/wx/dataview.h index f366299..e650262 100644 --- a/interface/wx/dataview.h +++ b/interface/wx/dataview.h @@ -259,7 +259,7 @@ public: 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; diff --git a/interface/wx/datetime.h b/interface/wx/datetime.h index 9c07d39..46106b1 100644 --- a/interface/wx/datetime.h +++ b/interface/wx/datetime.h @@ -754,7 +754,7 @@ public: /** 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; @@ -1214,7 +1214,7 @@ public: 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. @@ -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. @@ -1381,7 +1381,7 @@ public: 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); @@ -1567,7 +1567,7 @@ public: /** 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() */ @@ -2016,7 +2016,7 @@ public: 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. */ @@ -2038,7 +2038,7 @@ public: 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. */ diff --git a/interface/wx/dc.h b/interface/wx/dc.h index d496f73..0d7e5ab 100644 --- a/interface/wx/dc.h +++ b/interface/wx/dc.h @@ -73,7 +73,7 @@ enum wxMappingMode 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 @@ -1413,7 +1413,7 @@ public: 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. @@ -1427,7 +1427,7 @@ public: 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. */ diff --git a/interface/wx/dialup.h b/interface/wx/dialup.h index 91a96d6..4bf33e3 100644 --- a/interface/wx/dialup.h +++ b/interface/wx/dialup.h @@ -119,7 +119,7 @@ public: 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. diff --git a/interface/wx/dynarray.h b/interface/wx/dynarray.h index f906699..5f9ec73 100644 --- a/interface/wx/dynarray.h +++ b/interface/wx/dynarray.h @@ -254,36 +254,36 @@ public: 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); /** - 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); /** - 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); /** - 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); /** - 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); /** - 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); @@ -376,7 +376,7 @@ public: 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. diff --git a/interface/wx/dynlib.h b/interface/wx/dynlib.h index 6445f9d..3c3baea 100644 --- a/interface/wx/dynlib.h +++ b/interface/wx/dynlib.h @@ -37,19 +37,19 @@ public: 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; /** - 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; /** - 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. */ @@ -138,7 +138,7 @@ public: 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(). */ diff --git a/interface/wx/event.h b/interface/wx/event.h index f00dc12..f9411ad 100644 --- a/interface/wx/event.h +++ b/interface/wx/event.h @@ -224,7 +224,7 @@ public: 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; @@ -2726,7 +2726,7 @@ public: 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). */ diff --git a/interface/wx/filectrl.h b/interface/wx/filectrl.h index 662ea08..f4c120e 100644 --- a/interface/wx/filectrl.h +++ b/interface/wx/filectrl.h @@ -118,7 +118,7 @@ public: 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; diff --git a/interface/wx/filefn.h b/interface/wx/filefn.h index c1f4bbd..4464a36 100644 --- a/interface/wx/filefn.h +++ b/interface/wx/filefn.h @@ -322,7 +322,7 @@ wxString wxPathOnly(const wxString& path); 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} diff --git a/interface/wx/gdicmn.h b/interface/wx/gdicmn.h index 52a0fff..12daa92 100644 --- a/interface/wx/gdicmn.h +++ b/interface/wx/gdicmn.h @@ -954,9 +954,8 @@ public: 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() ) diff --git a/interface/wx/iconloc.h b/interface/wx/iconloc.h index 3e9c9cb..e3690f6 100644 --- a/interface/wx/iconloc.h +++ b/interface/wx/iconloc.h @@ -30,7 +30,7 @@ class wxIconLocation { 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; diff --git a/interface/wx/image.h b/interface/wx/image.h index 864624d..1a2ae82 100644 --- a/interface/wx/image.h +++ b/interface/wx/image.h @@ -1356,7 +1356,7 @@ public: 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. */ diff --git a/interface/wx/menu.h b/interface/wx/menu.h index 823253c..5dedfe9 100644 --- a/interface/wx/menu.h +++ b/interface/wx/menu.h @@ -902,7 +902,7 @@ public: 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() @@ -910,7 +910,7 @@ public: 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() diff --git a/interface/wx/object.h b/interface/wx/object.h index dbe8a5b..90d6655 100644 --- a/interface/wx/object.h +++ b/interface/wx/object.h @@ -262,7 +262,7 @@ public: 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 */ diff --git a/interface/wx/pickerbase.h b/interface/wx/pickerbase.h index c4b2f10..24a00f9 100644 --- a/interface/wx/pickerbase.h +++ b/interface/wx/pickerbase.h @@ -106,7 +106,7 @@ public: 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; diff --git a/interface/wx/popupwin.h b/interface/wx/popupwin.h index f7e6aec..4c1476d 100644 --- a/interface/wx/popupwin.h +++ b/interface/wx/popupwin.h @@ -38,7 +38,7 @@ public: 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 diff --git a/interface/wx/regex.h b/interface/wx/regex.h index b1cb875..cfba7bf 100644 --- a/interface/wx/regex.h +++ b/interface/wx/regex.h @@ -163,7 +163,7 @@ public: 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(). diff --git a/interface/wx/region.h b/interface/wx/region.h index bdf25ba..b0f4f20 100644 --- a/interface/wx/region.h +++ b/interface/wx/region.h @@ -322,7 +322,7 @@ public: 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 diff --git a/interface/wx/renderer.h b/interface/wx/renderer.h index f02c32a..6b7e5ac 100644 --- a/interface/wx/renderer.h +++ b/interface/wx/renderer.h @@ -43,7 +43,7 @@ enum /** 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. */ diff --git a/interface/wx/sizer.h b/interface/wx/sizer.h index 9501317..056c3fa 100644 --- a/interface/wx/sizer.h +++ b/interface/wx/sizer.h @@ -642,7 +642,7 @@ public: 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. */ diff --git a/interface/wx/stdpaths.h b/interface/wx/stdpaths.h index 9cd97ca..29d9c84 100644 --- a/interface/wx/stdpaths.h +++ b/interface/wx/stdpaths.h @@ -115,7 +115,7 @@ public: 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: @@ -159,7 +159,7 @@ public: 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) diff --git a/interface/wx/thread.h b/interface/wx/thread.h index 56d7933..7be2745 100644 --- a/interface/wx/thread.h +++ b/interface/wx/thread.h @@ -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 - (i.e. the thread identifiers may be reused). + (i.e.\ the thread identifiers may be reused). */ wxThreadIdType GetId() const; @@ -1123,7 +1123,7 @@ public: 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 diff --git a/interface/wx/timer.h b/interface/wx/timer.h index 054e890..ba5e239 100644 --- a/interface/wx/timer.h +++ b/interface/wx/timer.h @@ -86,7 +86,7 @@ public: 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; diff --git a/interface/wx/tipdlg.h b/interface/wx/tipdlg.h index 2b8cbf9..98454bc 100644 --- a/interface/wx/tipdlg.h +++ b/interface/wx/tipdlg.h @@ -37,7 +37,7 @@ public: 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 diff --git a/interface/wx/tokenzr.h b/interface/wx/tokenzr.h index f27ba1a..3eeeedc 100644 --- a/interface/wx/tokenzr.h +++ b/interface/wx/tokenzr.h @@ -136,7 +136,7 @@ public: 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. */ diff --git a/interface/wx/toolbar.h b/interface/wx/toolbar.h index 9bd3b16..9f0f867 100644 --- a/interface/wx/toolbar.h +++ b/interface/wx/toolbar.h @@ -319,7 +319,7 @@ public: 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. diff --git a/interface/wx/toplevel.h b/interface/wx/toplevel.h index 0d62940..4cfa892 100644 --- a/interface/wx/toplevel.h +++ b/interface/wx/toplevel.h @@ -214,7 +214,7 @@ public: 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(); diff --git a/interface/wx/treectrl.h b/interface/wx/treectrl.h index db41893..f328935 100644 --- a/interface/wx/treectrl.h +++ b/interface/wx/treectrl.h @@ -726,7 +726,7 @@ public: 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; diff --git a/interface/wx/unichar.h b/interface/wx/unichar.h index e37338f..f23a0c4 100644 --- a/interface/wx/unichar.h +++ b/interface/wx/unichar.h @@ -54,7 +54,7 @@ public: 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; diff --git a/interface/wx/url.h b/interface/wx/url.h index 6a3e800..b1eeef4 100644 --- a/interface/wx/url.h +++ b/interface/wx/url.h @@ -97,7 +97,7 @@ public: 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; diff --git a/interface/wx/vector.h b/interface/wx/vector.h index de47ae0..21aaca5 100644 --- a/interface/wx/vector.h +++ b/interface/wx/vector.h @@ -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() */ diff --git a/interface/wx/vidmode.h b/interface/wx/vidmode.h index ba512f5..0aae95a 100644 --- a/interface/wx/vidmode.h +++ b/interface/wx/vidmode.h @@ -35,17 +35,17 @@ public: 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; /** - 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; /** - 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; @@ -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; /** - The screen height in pixels (e.g. 480), 0 means unspecified. + The screen height in pixels (e.g.\ 480), 0 means unspecified. */ 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; diff --git a/interface/wx/vlbox.h b/interface/wx/vlbox.h index 1dc23d3..693f0ea 100644 --- a/interface/wx/vlbox.h +++ b/interface/wx/vlbox.h @@ -190,7 +190,7 @@ public: 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 @@ -270,7 +270,7 @@ public: 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. diff --git a/interface/wx/webview.h b/interface/wx/webview.h index d74c64c..27ac796 100644 --- a/interface/wx/webview.h +++ b/interface/wx/webview.h @@ -372,7 +372,7 @@ public: 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; diff --git a/interface/wx/window.h b/interface/wx/window.h index f7d3a31..74e2208 100644 --- a/interface/wx/window.h +++ b/interface/wx/window.h @@ -339,8 +339,8 @@ public: /** 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() */ @@ -535,7 +535,7 @@ public: 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. @@ -1401,7 +1401,7 @@ public: 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; @@ -2364,7 +2364,7 @@ public: 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 @@ -2404,7 +2404,7 @@ public: 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() @@ -3223,7 +3223,7 @@ public: 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. @@ -3245,7 +3245,7 @@ public: /** 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. */ @@ -3599,7 +3599,7 @@ protected: 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. */ diff --git a/interface/wx/xlocale.h b/interface/wx/xlocale.h index 1da41dc..95c8472 100644 --- a/interface/wx/xlocale.h +++ b/interface/wx/xlocale.h @@ -82,7 +82,7 @@ public: 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; -- 2.7.4