X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/15b6757b26a0277472a4f6b071b52050abd922da..fbfe2d4e7caa118e1b609151bc72e7e5c7ac0f32:/docs/doxygen/overviews/referencenotes.h diff --git a/docs/doxygen/overviews/referencenotes.h b/docs/doxygen/overviews/referencenotes.h index ded0bdc1b5..21dd2d496e 100644 --- a/docs/doxygen/overviews/referencenotes.h +++ b/docs/doxygen/overviews/referencenotes.h @@ -1,32 +1,31 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: referencenotes +// Name: referencenotes.h // Purpose: topic overview // Author: wxWidgets team // RCS-ID: $Id$ // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// -/*! - - @page referencenotes_overview Notes on using the reference - - In the descriptions of the wxWidgets classes and their member - functions, note that descriptions of inherited member functions are not - duplicated in derived classes unless their behaviour is different. So in - using a class such as wxScrolledWindow, be aware that wxWindow functions may be - relevant. - Note also that arguments with default values may be omitted from a - function call, for brevity. Size and position arguments may usually be - given a value of -1 (the default), in which case wxWidgets will choose a - suitable value. - Most strings are returned as wxString objects. However, for remaining - char * return values, the strings are allocated and - deallocated by wxWidgets. Therefore, return values should always be - copied for long-term use, especially since the same buffer is often - used by wxWidgets. - The member functions are given in alphabetical order except for - constructors and destructors which appear first. - - */ - - +/** + +@page overview_referencenotes Notes on Using the Reference + +In the descriptions of the wxWidgets classes and their member functions, note +that descriptions of inherited member functions are not duplicated in derived +classes unless their behaviour is different. So in using a class such as +wxScrolledWindow, be aware that wxWindow functions may be relevant. + +Note also that arguments with default values may be omitted from a function +call, for brevity. Size and position arguments may usually be given a value of +-1 (the default), in which case wxWidgets will choose a suitable value. + +Most strings are returned as wxString objects. However, for remaining char * +return values, the strings are allocated and deallocated by wxWidgets. +Therefore, return values should always be copied for long-term use, especially +since the same buffer is often used by wxWidgets. + +The member functions are given in alphabetical order except for constructors +and destructors which appear first. + +*/ +