staging: sm750fb: format description of parameters in accel.c

Formatting comments in file drivers/staging/sm750fb/sm750_accel.c.

Signed-off-by: Gabriela Bittencourt <gabrielabittencourt00@gmail.com>
Link: https://lore.kernel.org/r/20191023163016.30217-2-gabrielabittencourt00@gmail.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

diff --git a/drivers/staging/sm750fb/sm750_accel.c b/drivers/staging/sm750fb/sm750_accel.c
index dbcbbd1055da377a6e020dca8c5fa978426b59c0..645813a87490a0345ae292529a8d36ed192e2061 100644 (file)
--- a/drivers/staging/sm750fb/sm750_accel.c
+++ b/drivers/staging/sm750fb/sm750_accel.c
@@ -130,20 +130,28 @@ int sm750_hw_fillrect(struct lynx_accel *accel,
        return 0;
 }
 
-int sm750_hw_copyarea(
-struct lynx_accel *accel,
-unsigned int sBase,  /* Address of source: offset in frame buffer */
-unsigned int sPitch, /* Pitch value of source surface in BYTE */
-unsigned int sx,
-unsigned int sy,     /* Starting coordinate of source surface */
-unsigned int dBase,  /* Address of destination: offset in frame buffer */
-unsigned int dPitch, /* Pitch value of destination surface in BYTE */
-unsigned int Bpp,    /* Color depth of destination surface */
-unsigned int dx,
-unsigned int dy,     /* Starting coordinate of destination surface */
-unsigned int width,
-unsigned int height, /* width and height of rectangle in pixel value */
-unsigned int rop2)   /* ROP value */
+/**
+ * sm750_hm_copyarea
+ * @sBase: Address of source: offset in frame buffer
+ * @sPitch: Pitch value of source surface in BYTE
+ * @sx: Starting x coordinate of source surface
+ * @sy: Starting y coordinate of source surface
+ * @dBase: Address of destination: offset in frame buffer
+ * @dPitch: Pitch value of destination surface in BYTE
+ * @Bpp: Color depth of destination surface
+ * @dx: Starting x coordinate of destination surface
+ * @dy: Starting y coordinate of destination surface
+ * @width: width of rectangle in pixel value
+ * @height: height of rectangle in pixel value
+ * @rop2: ROP value
+ */
+int sm750_hw_copyarea(struct lynx_accel *accel,
+                     unsigned int sBase, unsigned int sPitch,
+                     unsigned int sx, unsigned int sy,
+                     unsigned int dBase, unsigned int dPitch,
+                     unsigned int Bpp, unsigned int dx, unsigned int dy,
+                     unsigned int width, unsigned int height,
+                     unsigned int rop2)
 {
        unsigned int nDirection, de_ctrl;
 
@@ -288,20 +296,28 @@ static unsigned int deGetTransparency(struct lynx_accel *accel)
        return de_ctrl;
 }
 
-int sm750_hw_imageblit(struct lynx_accel *accel,
-                const char *pSrcbuf, /* pointer to start of source buffer in system memory */
-                u32 srcDelta,          /* Pitch value (in bytes) of the source buffer, +ive means top down and -ive mean button up */
-                u32 startBit, /* Mono data can start at any bit in a byte, this value should be 0 to 7 */
-                u32 dBase,    /* Address of destination: offset in frame buffer */
-                u32 dPitch,   /* Pitch value of destination surface in BYTE */
-                u32 bytePerPixel,      /* Color depth of destination surface */
-                u32 dx,
-                u32 dy,       /* Starting coordinate of destination surface */
-                u32 width,
-                u32 height,   /* width and height of rectangle in pixel value */
-                u32 fColor,   /* Foreground color (corresponding to a 1 in the monochrome data */
-                u32 bColor,   /* Background color (corresponding to a 0 in the monochrome data */
-                u32 rop2)     /* ROP value */
+/**
+ * sm750_hw_imageblit
+ * @pSrcbuf: pointer to start of source buffer in system memory
+ * @srcDelta: Pitch value (in bytes) of the source buffer, +ive means top down
+ *           and -ive mean button up
+ * @startBit: Mono data can start at any bit in a byte, this value should be
+ *           0 to 7
+ * @dBase: Address of destination: offset in frame buffer
+ * @dPitch: Pitch value of destination surface in BYTE
+ * @bytePerPixel: Color depth of destination surface
+ * @dx: Starting x coordinate of destination surface
+ * @dy: Starting y coordinate of destination surface
+ * @width: width of rectangle in pixel value
+ * @height: height of rectangle in pixel value
+ * @fColor: Foreground color (corresponding to a 1 in the monochrome data
+ * @bColor: Background color (corresponding to a 0 in the monochrome data
+ * @rop2: ROP value
+ */
+int sm750_hw_imageblit(struct lynx_accel *accel, const char *pSrcbuf,
+                      u32 srcDelta, u32 startBit, u32 dBase, u32 dPitch,
+                      u32 bytePerPixel, u32 dx, u32 dy, u32 width,
+                      u32 height, u32 fColor, u32 bColor, u32 rop2)
 {
        unsigned int ulBytesPerScan;
        unsigned int ul4BytesPerScan;