Skip to content

Commit

Permalink
fixed more doxygen issues
Browse files Browse the repository at this point in the history
  • Loading branch information
jakoch committed Jul 26, 2024
1 parent f38248e commit 7d44bdb
Show file tree
Hide file tree
Showing 16 changed files with 26 additions and 19 deletions.
2 changes: 2 additions & 0 deletions include/fifechan/backends/directx3d/directx3dimage.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ namespace fcn
*
* @param surface The surface from which to load.
* @param device The D3D device to use when converting the image to display format.
* @param width The width of the image.
* @param height The height of the image.
* @param autoFree True if the surface should automatically be deleted.
*/
DirectX3DImage(LPDIRECT3DSURFACE9 surface, LPDIRECT3DDEVICE9 device, int width, int height, bool autoFree);
Expand Down
1 change: 1 addition & 0 deletions include/fifechan/backends/sdl/sdlimage.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ namespace fcn
*
* @param surface the surface from which to load.
* @param autoFree true if the surface should automatically be deleted.
* @param renderer the renderer to use for creating the texture.
*/
SDLImage(SDL_Surface* surface, bool autoFree, SDL_Renderer* renderer = nullptr);

Expand Down
2 changes: 1 addition & 1 deletion include/fifechan/backends/sdl/sdltruetypefont.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ namespace fcn
/**
* Sets the use of anti aliasing..
*
* @param antaAlias true for use of anti aliasing.
* @param antiAlias true for use of anti aliasing.
*/
virtual void setAntiAlias(bool antiAlias);

Expand Down
2 changes: 1 addition & 1 deletion include/fifechan/color.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ namespace fcn
* @param out The stream to output to.
* @param color The color to output.
*/
friend std::ostream& operator<<(std::ostream& out, Color const & Color);
friend std::ostream& operator<<(std::ostream& out, Color const & color);

/**
* Holds the red color component (range 0-255).
Expand Down
2 changes: 1 addition & 1 deletion include/fifechan/focushandler.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -246,7 +246,7 @@ namespace fcn
/**
* Sets the last widget with modal mouse input focus.
*
* @param lastMouseWithModalMouseInputFocus The last widget with
* @param lastWidgetWithModalMouseInputFocus The last widget with
* modal mouse input focus.
* @see getLastWidgetWithModalMouseInputFocus
*/
Expand Down
1 change: 1 addition & 0 deletions include/fifechan/gui.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -323,6 +323,7 @@ namespace fcn
/**
* Distributes a mouse event.
*
* @param source The source widget of the event.
* @param type The type of the event to distribute,
* @param button The button of the event (if any used) to distribute.
* @param x The x coordinate of the event.
Expand Down
2 changes: 1 addition & 1 deletion include/fifechan/mouselistener.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ namespace fcn
/**
* Called when the mouse wheel has moved down on the widget area.
*
* @param eEvent Describes the event.
* @param mouseEvent Describes the event.
*/
virtual void mouseWheelMovedDown(MouseEvent& mouseEvent) { }

Expand Down
2 changes: 2 additions & 0 deletions include/fifechan/text.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ namespace fcn
* Sets the content of a row.
*
* @param row The row to set the text of.
* @param content The content of the row.
* @throws Exception when the row does not exist.
*/
virtual void setRow(unsigned int row, std::string const & content);
Expand Down Expand Up @@ -214,6 +215,7 @@ namespace fcn
* present in the text zero will be returned.
*
* @param row The row to get the width of.
* @param font The font to use when calculating the width.
* @return The width in pixels of a row.
*/
virtual int getWidth(int row, Font* font) const;
Expand Down
4 changes: 2 additions & 2 deletions include/fifechan/widget.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -1196,7 +1196,7 @@ namespace fcn
* needed if both a widget in the widget and the widget itself
* should be focused at the same time.
*
* @param focusHandler The internal focus handler to be used.
* @param internalFocusHandler The internal focus handler to be used.
* @see getInternalFocusHandler
*/
void setInternalFocusHandler(FocusHandler* internalFocusHandler);
Expand Down Expand Up @@ -1263,7 +1263,7 @@ namespace fcn
* XML document, a certain widget can be retrieved given that the widget
* has an id.
*
* @param id The id to set to the widget.
* @return The id of the widget.
* @see setId, BasicContainer::findWidgetById
*/
std::string const & getId() const;
Expand Down
3 changes: 2 additions & 1 deletion include/fifechan/widgets/bargraph.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,8 @@ namespace fcn
void setBarPosition(int x, int y);

/**
* @return The position of the bar.
* Sets the position of the bar.
* @param pos The position of the bar.
*/
void setBarPosition(Point const & pos);

Expand Down
2 changes: 1 addition & 1 deletion include/fifechan/widgets/checkbox.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ namespace fcn
* to fit the caption.
*
* @param caption The caption of the check box.
* @param marked True if the check box is selected, false otherwise.
* @param selected True if the check box is selected, false otherwise.
*/
explicit CheckBox(std::string const & caption, bool selected = false);

Expand Down
4 changes: 2 additions & 2 deletions include/fifechan/widgets/container.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ namespace fcn
/**
* Set the vertical spacing between rows.
*
* @param verticalSpacing spacing in pixels.
* @param spacing spacing in pixels.
* @see getVerticalSpacing
*/
virtual void setVerticalSpacing(unsigned int spacing);
Expand All @@ -207,7 +207,7 @@ namespace fcn
/**
* Set the horizontal spacing between columns.
*
* @param horizontalSpacing spacing in pixels.
* @param spacing spacing in pixels.
* @see getHorizontalSpacing
*/
virtual void setHorizontalSpacing(unsigned int spacing);
Expand Down
2 changes: 1 addition & 1 deletion include/fifechan/widgets/icon.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ namespace fcn
* Sets the image to display. Existing image is freed automatically
* if it was loaded internally.
*
* @param image The image to display.
* @param filename The image to display.
*/
void setImage(std::string const & filename);

Expand Down
2 changes: 1 addition & 1 deletion include/fifechan/widgets/iconprogressbar.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ namespace fcn

/**
* Sets count of icons.
* @param counter The count of the active icons.
* @param icons The count of the active icons.
*/
void setIconCount(int icons);

Expand Down
10 changes: 5 additions & 5 deletions include/fifechan/widgets/tabbedarea.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ namespace fcn
/**
* Removes a tab from the tabbed area.
*
* @param index The tab to remove.
* @param tab The tab to remove.
* @see addTab
*/
virtual void removeTab(Tab* tab);
Expand All @@ -103,7 +103,7 @@ namespace fcn
/**
* Checks if a tab is selected or not.
*
* @param index The tab to check.
* @param tab The tab to check.
* @return True if the tab is selected, false otherwise.
* @see setSelectedTab
*/
Expand All @@ -120,7 +120,7 @@ namespace fcn
/**
* Sets a tab to be selected or not.
*
* @param index The tab to be selected.
* @param tab The tab to be selected.
* @see isTabSelected, getSelectedTab
*/
virtual void setSelectedTab(Tab* tab);
Expand Down Expand Up @@ -210,7 +210,7 @@ namespace fcn
/**
* Set the vertical spacing between rows.
*
* @param verticalSpacing spacing in pixels.
* @param spacing spacing in pixels.
* @see getVerticalSpacing
*/
virtual void setVerticalSpacing(unsigned int spacing);
Expand All @@ -226,7 +226,7 @@ namespace fcn
/**
* Set the horizontal spacing between columns.
*
* @param horizontalSpacing spacing in pixels.
* @param spacing spacing in pixels.
* @see getHorizontalSpacing
*/
virtual void setHorizontalSpacing(unsigned int spacing);
Expand Down
4 changes: 2 additions & 2 deletions include/fifechan/widgets/textbox.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ namespace fcn
/**
* Sets the row where the caret should be currently located.
*
* @param The row where the caret should be currently located.
* @param row The row where the caret should be currently located.
* @see getCaretRow
*/
void setCaretRow(int row);
Expand All @@ -118,7 +118,7 @@ namespace fcn
/**
* Sets the column where the caret should be currently located.
*
* @param The column where the caret should be currently located.
* @param column The column where the caret should be currently located.
* @see getCaretColumn
*/
void setCaretColumn(int column);
Expand Down

0 comments on commit 7d44bdb

Please sign in to comment.