Documentation updates.

git-svn-id: svn://svn.code.sf.net/p/irrlicht/code/trunk@3042 dfc29bdd-3216-0410-991c-e03cc46cb475

include/IGUIContextMenu.h

@@ -39,7 +39,7 @@ namespace gui
 		//! set behaviour when menus are closed
 		virtual void setCloseHandling(ECONTEXT_MENU_CLOSE onClose) = 0;
 
-		//! get current behaviour when the menue will be closed
+		//! get current behaviour when the menu will be closed
 		virtual ECONTEXT_MENU_CLOSE getCloseHandling() const = 0;
 
 		//! Get amount of menu items
@@ -53,7 +53,7 @@ namespace gui
 		set to whatever you want.
 		\param enabled: Specifies if the menu item should be enabled.
 		\param hasSubMenu: Set this to true if there should be a submenu
-		at this item. You can acess this submenu via getSubMenu().
+		at this item. You can access this submenu via getSubMenu().
 		\param checked: Specifies if the menu item should be initially checked.
 		\return Returns the index of the new item */
 		virtual u32 addItem(const wchar_t* text, s32 commandId=-1, bool enabled=true,
@@ -69,7 +69,7 @@ namespace gui
 		set to whatever you want.
 		\param enabled: Specifies if the menu item should be enabled.
 		\param hasSubMenu: Set this to true if there should be a submenu
-		at this item. You can acess this submenu via getSubMenu().
+		at this item. You can access this submenu via getSubMenu().
 		\param checked: Specifies if the menu item should be initially checked.
 		\return Returns the index of the new item */
 		virtual u32 insertItem(u32 idx, const wchar_t* text, s32 commandId=-1, bool enabled=true,

include/IGUIEditBox.h

@@ -38,7 +38,7 @@ namespace gui
 		\param color: New color of the text. */
 		virtual void setOverrideColor(video::SColor color) = 0;
 
-		//! Sets if the text should use the overide color or the color in the gui skin.
+		//! Sets if the text should use the override color or the color in the gui skin.
 		/** \param enable: If set to true, the override color, which can be set
 		with IGUIEditBox::setOverrideColor is used, otherwise the
 		EGDC_BUTTON_TEXT color of the skin. */
@@ -70,7 +70,7 @@ namespace gui
 		virtual void setMultiLine(bool enable) = 0;
 
 		//! Checks if multi line editing is enabled
-		/** \return true if mult-line is enabled, false otherwise */
+		/** \return true if multi-line is enabled, false otherwise */
 		virtual bool isMultiLineEnabled() const = 0;
 
 		//! Enables or disables automatic scrolling with cursor position

include/IGUIElementFactory.h

@@ -15,7 +15,7 @@ namespace gui
 {
 	class IGUIElement;
 
-	//! Interface making it possible to dynamicly create GUI elements
+	//! Interface making it possible to dynamically create GUI elements
 	/** To be able to add custom elements to Irrlicht and to make it possible for the
 	scene manager to save and load them, simply implement this interface and register it
 	in your gui environment via IGUIEnvironment::registerGUIElementFactory.

include/IGUIEnvironment.h

@@ -209,7 +209,7 @@ public:
 	\param id Id with which the gui element can be identified.
 	\param text Text displayed on the button.
 	\param tooltiptext Text displayed in the tooltip.
-	\return Pointer to the created button. Returns 0 if an error occured.
+	\return Pointer to the created button. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUIButton* addButton(const core::rect<s32>& rectangle,
@@ -223,7 +223,7 @@ public:
 	\param text Text displayed as the window title.
 	\param parent Parent gui element of the window.
 	\param id Id with which the gui element can be identified.
-	\return Pointer to the created window. Returns 0 if an error occured.
+	\return Pointer to the created window. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUIWindow* addWindow(const core::rect<s32>& rectangle, bool modal = false,
@@ -233,7 +233,7 @@ public:
 	/** This control stops its parent's members from being able to receive
 	input until its last child is removed, it then deletes itself.
 	\param parent Parent gui element of the modal.
-	\return Pointer to the created modal. Returns 0 if an error occured.
+	\return Pointer to the created modal. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUIElement* addModalScreen(IGUIElement* parent) = 0;
@@ -251,7 +251,7 @@ public:
 	\param id Id with which the gui element can be identified.
 	\param image Optional texture which will be displayed beside the text as an image
 	\return Pointer to the created message box. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIWindow* addMessageBox(const wchar_t* caption, const wchar_t* text=0,
 		bool modal = true, s32 flags = EMBF_OK, IGUIElement* parent=0, s32 id=-1, video::ITexture* image=0) = 0;
@@ -263,7 +263,7 @@ public:
 	\param parent Parent gui element of the scroll bar.
 	\param id Id to identify the gui element.
 	\return Pointer to the created scrollbar. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIScrollBar* addScrollBar(bool horizontal, const core::rect<s32>& rectangle,
 		IGUIElement* parent=0, s32 id=-1) = 0;
@@ -278,7 +278,7 @@ public:
 	\param id Id to identify the gui element.
 	\param text Title text of the image.
 	\return Pointer to the created image element. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIImage* addImage(video::ITexture* image, core::position2d<s32> pos,
 		bool useAlphaChannel=true, IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;
@@ -290,7 +290,7 @@ public:
 	\param id Id to identify the gui element.
 	\param text Title text of the image.
 	\return Pointer to the created image element. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIImage* addImage(const core::rect<s32>& rectangle,
 		IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;
@@ -302,7 +302,7 @@ public:
 	\param id Id to identify the gui element.
 	\param text Title text of the check box.
 	\return Pointer to the created check box. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUICheckBox* addCheckBox(bool checked, const core::rect<s32>& rectangle,
 		IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;
@@ -312,7 +312,7 @@ public:
 	\param parent Parent gui element of the list box.
 	\param id Id to identify the gui element.
 	\param drawBackground Flag whether the background should be drawn.
-	\return Pointer to the created list box. Returns 0 if an error occured.
+	\return Pointer to the created list box. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUIListBox* addListBox(const core::rect<s32>& rectangle,
@@ -325,7 +325,7 @@ public:
 	\param drawBackground Flag whether the background should be drawn.
 	\param scrollBarVertical Flag whether a vertical scrollbar should be used
 	\param scrollBarHorizontal Flag whether a horizontal scrollbar should be used
-	\return Pointer to the created list box. Returns 0 if an error occured.
+	\return Pointer to the created list box. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUITreeView* addTreeView(const core::rect<s32>& rectangle,
@@ -338,7 +338,7 @@ public:
 	\param id Id to identify the gui element.
 	\param text Title text of the mesh viewer.
 	\return Pointer to the created mesh viewer. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIMeshViewer* addMeshViewer(const core::rect<s32>& rectangle,
 			IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;
@@ -351,7 +351,7 @@ public:
 	\param parent Parent gui element of the dialog.
 	\param id Id to identify the gui element.
 	\return Pointer to the created file open dialog. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIFileOpenDialog* addFileOpenDialog(const wchar_t* title = 0,
 		bool modal=true, IGUIElement* parent=0, s32 id=-1) = 0;
@@ -364,7 +364,7 @@ public:
 	\param parent The parent of the dialog.
 	\param id The ID of the dialog.
 	\return Pointer to the created file open dialog. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIColorSelectDialog* addColorSelectDialog(const wchar_t* title = 0,
 		bool modal=true, IGUIElement* parent=0, s32 id=-1) = 0;
@@ -379,7 +379,7 @@ public:
 	\param fillBackground Enable if the background shall be filled.
 	Defaults to false.
 	\return Pointer to the created static text. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIStaticText* addStaticText(const wchar_t* text, const core::rect<s32>& rectangle,
 		bool border=false, bool wordWrap=true, IGUIElement* parent=0, s32 id=-1,
@@ -397,7 +397,7 @@ public:
 	\param parent Parent item of the element, e.g. a window.
 	Set it to 0 to place the edit box directly in the environment.
 	\param id The ID of the element.
-	\return Pointer to the created edit box. Returns 0 if an error occured.
+	\return Pointer to the created edit box. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUIEditBox* addEditBox(const wchar_t* text, const core::rect<s32>& rectangle,
@@ -411,7 +411,7 @@ public:
 	\param parent Parent item of the element, e.g. a window.
 	Set it to 0 to place the spin box directly in the environment.
 	\param id The ID of the element.
-	\return Pointer to the created spin box. Returns 0 if an error occured.
+	\return Pointer to the created spin box. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUISpinBox* addSpinBox(const wchar_t* text, const core::rect<s32>& rectangle,
@@ -423,7 +423,7 @@ public:
 	\param parent Parent item of the element, e.g. a window.
 	\param id An identifier for the fader.
 	\return Pointer to the created in-out-fader. Returns 0 if an error
-	occured. This pointer should not be dropped. See
+	occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIInOutFader* addInOutFader(const core::rect<s32>* rectangle=0, IGUIElement* parent=0, s32 id=-1) = 0;
 
@@ -438,7 +438,7 @@ public:
 	the environment without a window as parent.
 	\param id An identifier for the tab control.
 	\return Pointer to the created tab control element. Returns 0 if an
-	error occured. This pointer should not be dropped. See
+	error occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUITabControl* addTabControl(const core::rect<s32>& rectangle,
 		IGUIElement* parent=0, bool fillbackground=false,
@@ -453,7 +453,7 @@ public:
 	Set it to 0 to place the tab directly in the environment.
 	\param id An identifier for the tab.
 	\return Pointer to the created tab. Returns 0 if an
-	error occured. This pointer should not be dropped. See
+	error occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUITab* addTab(const core::rect<s32>& rectangle,
 		IGUIElement* parent=0, s32 id=-1) = 0;
@@ -465,7 +465,7 @@ public:
 	Set it to 0 to place the menu directly in the environment.
 	\param id An identifier for the menu.
 	\return Pointer to the created context menu. Returns 0 if an
-	error occured. This pointer should not be dropped. See
+	error occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIContextMenu* addContextMenu(const core::rect<s32>& rectangle,
 		IGUIElement* parent=0, s32 id=-1) = 0;
@@ -477,7 +477,7 @@ public:
 	Set it to 0 to place the menu directly in the environment.
 	\param id An identifier for the menu.
 	\return Pointer to the created menu. Returns 0 if an
-	error occured. This pointer should not be dropped. See
+	error occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIContextMenu* addMenu(IGUIElement* parent=0, s32 id=-1) = 0;
 
@@ -488,7 +488,7 @@ public:
 	Set it to 0 to place the tool bar directly in the environment.
 	\param id An identifier for the tool bar.
 	\return Pointer to the created tool bar. Returns 0 if an
-	error occured. This pointer should not be dropped. See
+	error occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIToolBar* addToolBar(IGUIElement* parent=0, s32 id=-1) = 0;
 
@@ -498,7 +498,7 @@ public:
 	Set it to 0 to place the combo box directly in the environment.
 	\param id An identifier for the combo box.
 	\return Pointer to the created combo box. Returns 0 if an
-	error occured. This pointer should not be dropped. See
+	error occurred. This pointer should not be dropped. See
 	IReferenceCounted::drop() for more information. */
 	virtual IGUIComboBox* addComboBox(const core::rect<s32>& rectangle,
 		IGUIElement* parent=0, s32 id=-1) = 0;
@@ -509,7 +509,7 @@ public:
 	to place the element directly in the environment.
 	\param id An identifier for the table.
 	\param drawBackground Flag whether the background should be drawn.
-	\return Pointer to the created table. Returns 0 if an error occured.
+	\return Pointer to the created table. Returns 0 if an error occurred.
 	This pointer should not be dropped. See IReferenceCounted::drop() for
 	more information. */
 	virtual IGUITable* addTable(const core::rect<s32>& rectangle,

include/IGUIFont.h

@@ -44,7 +44,7 @@ public:
 	/** \param text: Text to draw
 	\param position: Rectangle specifying position where to draw the text.
 	\param color: Color of the text
-	\param hcenter: Specifiies if the text should be centered horizontally into the rectangle.
+	\param hcenter: Specifies if the text should be centered horizontally into the rectangle.
 	\param vcenter: Specifies if the text should be centered vertically into the rectangle.
 	\param clip: Optional pointer to a rectangle against which the text will be clipped.
 	If the pointer is null, no clipping will be done. */

include/IGUIInOutFader.h

@@ -44,14 +44,14 @@ namespace gui
 		/** In the beginning the whole rect is drawn by the set color
 		(black by default) and at the end of the overgiven time the
 		color has faded out.
-		\param time: Time specifing how long it should need to fade in,
+		\param time: Time specifying how long it should need to fade in,
 		in milliseconds. */
 		virtual void fadeIn(u32 time) = 0;
 
 		//! Starts the fade out process.
 		/** In the beginning everything is visible, and at the end of
 		the time only the set color (black by the fault) will be drawn.
-		\param time: Time specifing how long it should need to fade out,
+		\param time: Time specifying how long it should need to fade out,
 		in milliseconds. */
 		virtual void fadeOut(u32 time) = 0;
 

include/IGUISpriteBank.h

@@ -40,7 +40,7 @@ struct SGUISprite
 
 //! Sprite bank interface.
 /** See http://irrlicht.sourceforge.net/phpBB2/viewtopic.php?t=25742&highlight=spritebank
-* for more einformation how to use the spritebank.
+* for more information how to use the spritebank.
 */
 class IGUISpriteBank : public virtual IReferenceCounted
 {

include/IGUITabControl.h

@@ -13,7 +13,8 @@ namespace irr
 {
 namespace gui
 {
-	//! A tab, onto which other gui elements could be added.
+	//! A tab-page, onto which other gui elements could be added.
+	/** IGUITab refers to the page itself, not to the tab in the tabbar of an IGUITabControl. */
 	class IGUITab : public IGUIElement
 	{
 	public:

include/IGUIWindow.h

@@ -24,12 +24,15 @@ namespace gui
 			: IGUIElement(EGUIET_WINDOW, environment, parent, id, rectangle) {}
 
 		//! Returns pointer to the close button
+		/** You can hide the button by calling setVisible(false) on the result. */
 		virtual IGUIButton* getCloseButton() const = 0;
 
 		//! Returns pointer to the minimize button
+		/** You can hide the button by calling setVisible(false) on the result. */
 		virtual IGUIButton* getMinimizeButton() const = 0;
 
 		//! Returns pointer to the maximize button
+		/** You can hide the button by calling setVisible(false) on the result. */
 		virtual IGUIButton* getMaximizeButton() const = 0;
 
 		//! Returns true if the window can be dragged with the mouse, false if not