cleanup seevral doxygen warnings

This commit is contained in:
Vincent Sanders 2016-09-13 09:16:31 +01:00
parent fa5e6fcdf9
commit c830d14d0b
10 changed files with 18 additions and 15 deletions

View File

@ -43,8 +43,8 @@ struct bitmap *ami_bitmap_from_datatype(char *filename);
/**
* Set bitmap URL
*
* \param bm a bitmap, as returned by bitmap_create()
* \param title a pointer to a title string
* \param bm a bitmap, as returned by bitmap_create()
* \param url the url for the bitmap
*
* A reference will be kept by the bitmap object.
* The URL can only ever be set once for a bitmap.

View File

@ -122,7 +122,7 @@ atari_font_split(const plot_font_style_t *fstyle,
* Measure the width of a string.
*
* \param[in] fstyle plot style for this text
* \param[in] string UTF-8 string to measure
* \param[in] str UTF-8 string to measure
* \param[in] length length of string, in bytes
* \param[out] width updated to width of string[0..length)
* \return NSERROR_OK and width updated or appropriate error code on faliure
@ -131,7 +131,7 @@ static nserror
atari_font_width(const plot_font_style_t *fstyle,
const char *str,
size_t length,
int * width)
int *width)
{
float scale = plot_get_scale();

View File

@ -387,7 +387,7 @@ bool plot_copy_rect(GRECT src, GRECT dst)
/**
* Fill the screen info structure.
*
* \param vdhi The handle
* \param vdih The handle
* \param[out] info The infor structure to fill.
*/
static void read_vdi_sysinfo(short vdih, struct s_vdi_sysinfo * info) {

View File

@ -112,7 +112,7 @@ static void die(const char *error)
/**
* Warn the user of an event.
*
* \param[in] message A warning looked up in the message translation table
* \param[in] warning A warning looked up in the message translation table
* \param[in] detail Additional text to be displayed or NULL.
* \return NSERROR_OK on success or error code if there was a
* faliure displaying the message to the user.

View File

@ -48,7 +48,7 @@ void win32_set_quit(bool q);
/**
* Warn the user of an event.
*
* \param[in] message A warning looked up in the message translation table
* \param[in] warning A warning looked up in the message translation table
* \param[in] detail Additional text to be displayed or NULL.
* \return NSERROR_OK on success or error code if there was a
* faliure displaying the message to the user.

View File

@ -148,9 +148,11 @@ void content_invalidate_reuse_data(struct hlcache_handle *h);
/**
* Display content on screen with optional tiling.
*
* \param h The content to redraw
* \param ctx current redraw context
* \return true if successful, false otherwise
* \param h The content to redraw.
* \param data The contents redraw data.
* \param clip The clipping rectangle to use when redrawing the content.
* \param ctx current redraw context.
* \return true if successful otherwise false.
*
* Calls the redraw function for the content.
*/

View File

@ -341,7 +341,7 @@ void box_dump(FILE *stream, struct box *box, unsigned int depth, bool style);
* attempting to read a real URL from "javascript:" links.
*
* \param content html content
* \param ds rel relative URL text taken from page
* \param dsrel relative URL text taken from page
* \param base base for relative URLs
* \param result updated to target URL on heap, unchanged if extract failed
* \return true on success, false on memory exhaustion

View File

@ -1305,13 +1305,13 @@ static bool html_redraw_file(int x, int y, int width, int height,
* \param scale scale for redraw
* \param clip current clip rectangle
* \param background_colour current background colour
* \param background box containing background details (usually ::box)
* \param background box containing background details (usually \a box)
* \param ctx current redraw context
* \return true if successful, false otherwise
*
* The reason for the presence of ::background is the backwards compatibility
* mess that is backgrounds on <body>. The background will be drawn relative
* to ::box, using the background information contained within ::background.
* mess that is backgrounds on &lt;body&gt;. The background will be drawn relative
* to \a box, using the background information contained within \a background.
*/
static bool html_redraw_background(int x, int y, struct box *box, float scale,

View File

@ -45,7 +45,7 @@ bool layout_document(struct html_content *content, int width, int height);
/**
* Layout lines of text or inline boxes with floats.
*
* \param inline_container inline container box
* \param box inline container box
* \param width horizontal space available
* \param cont ancestor box which defines horizontal space, for floats
* \param cx box position relative to cont

View File

@ -57,6 +57,7 @@ nserror messages_add_from_file(const char *path);
* data may be gzip compressed.
*
* \param data The inline message data.
* \param data_size The length of the message data.
* \return NSERROR_OK on success or error code on faliure.
*/
nserror messages_add_from_inline(const uint8_t *data, size_t data_size);