From 5562c9a553fe539d0d1fbf05dba89b1b1f577fae Mon Sep 17 00:00:00 2001
From: Vincent Sanders <vince@kyllikki.org>
Date: Sat, 8 Nov 2014 22:08:29 +0000
Subject: Continue doxygen error cleanup.

---
 beos/bitmap.cpp | 23 ++++++++++++++---------
 beos/font.cpp   |  5 ++---
 beos/gui.cpp    | 11 +++++------
 3 files changed, 21 insertions(+), 18 deletions(-)

(limited to 'beos')

diff --git a/beos/bitmap.cpp b/beos/bitmap.cpp
index 93a184356..1524aed0c 100644
--- a/beos/bitmap.cpp
+++ b/beos/bitmap.cpp
@@ -57,18 +57,23 @@ struct bitmap {
 #warning TODO: add correct locking (not strictly required)
 
 
-/** Convert to BeOS RGBA32_LITTLE (strictly BGRA) from NetSurf's favoured ABGR format.
+/**
+ * Convert to BeOS RGBA32_LITTLE (strictly BGRA) from NetSurf's favoured ABGR format.
+ *
  * Copies the converted data elsewhere.  Operation is rotate left 8 bits.
  *
- * \param pixels	Array of 32-bit values, in the form of ABGR.  This will
- *			be overwritten with new data in the form of BGRA.
- * \param width		Width of the bitmap
- * \param height	Height of the bitmap
- * \param rowstride	Number of bytes to skip after each row (this
- *			implementation requires this to be a multiple of 4.)
+ * \param src       Source 32-bit pixels arranged in ABGR order.
+ * \param dst       Output data in BGRA order.
+ * \param width	    Width of the bitmap
+ * \param height    Height of the bitmap
+ * \param rowstride Number of bytes to skip after each row (this implementation
+ *                  requires this to be a multiple of 4.)
  */
-static inline void nsbeos_rgba_to_bgra(void *src, void *dst, int width, int height,
-				size_t rowstride)
+static inline void nsbeos_rgba_to_bgra(void *src,
+                                       void *dst,
+                                       int width,
+                                       int height,
+                                       size_t rowstride)
 {
 	struct abgr { uint8 a, b, g, r; };
 	struct rgba { uint8 r, g, b ,a; };
diff --git a/beos/font.cpp b/beos/font.cpp
index 5b3ef8bce..ba6803f53 100644
--- a/beos/font.cpp
+++ b/beos/font.cpp
@@ -288,10 +288,9 @@ bool nsfont_paint(const plot_font_style_t *fstyle,
 /**
  * Convert a font style to a PangoFontDescription.
  *
- * \param  fstyle	style for this text
- * \return  a new Pango font description
+ * \param font Beos font object.
+ * \param fstyle style for this text
  */
-
 void nsbeos_style_to_font(BFont &font, const plot_font_style_t *fstyle)
 {
 	float size;
diff --git a/beos/gui.cpp b/beos/gui.cpp
index ca895894b..7c0a3c6f2 100644
--- a/beos/gui.cpp
+++ b/beos/gui.cpp
@@ -248,16 +248,15 @@ image_id nsbeos_find_app_path(char *path)
 /**
  * Locate a shared resource file by searching known places in order.
  *
+ * Search order is: ~/config/settings/NetSurf/, ~/.netsurf/, $NETSURFRES/
+ * (where NETSURFRES is an environment variable), and finally the path
+ * specified by the macro at the top of this file.
+ *
  * \param  buf      buffer to write to.  must be at least PATH_MAX chars
  * \param  filename file to look for
  * \param  def      default to return if file not found
- * \return buf
- *
- * Search order is: ~/config/settings/NetSurf/, ~/.netsurf/, $NETSURFRES/
- * (where NETSURFRES is an environment variable), and finally the path
- * specified by the #define at the top of this file.
+ * \return path to resource.
  */
-
 static char *find_resource(char *buf, const char *filename, const char *def)
 {
 	const char *cdir = NULL;
-- 
cgit v1.2.3