From: karthik alapati <mail@karthek.com>
To: Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Stephen Rothwell <sfr@canb.auug.org.au>
Cc: devel@driverdev.osuosl.org, linux-kernel@vger.kernel.org
Subject: [PATCH] staging: rtl8723bs: fix block comments alignment
Date: Wed, 10 Feb 2021 00:23:17 +0530 [thread overview]
Message-ID: <YCLaHXD/sUKM5HZE@karthik-strix-linux.karthek.com> (raw)
fix checkpatch.pl warning for "block comments should align the * on each line"
Signed-off-by: karthik alapati <mail@karthek.com>
---
.../staging/rtl8723bs/hal/rtl8723b_phycfg.c | 204 +++++++++---------
1 file changed, 102 insertions(+), 102 deletions(-)
diff --git a/drivers/staging/rtl8723bs/hal/rtl8723b_phycfg.c b/drivers/staging/rtl8723bs/hal/rtl8723b_phycfg.c
index cf23414d7..003f954c2 100644
--- a/drivers/staging/rtl8723bs/hal/rtl8723b_phycfg.c
+++ b/drivers/staging/rtl8723bs/hal/rtl8723b_phycfg.c
@@ -20,16 +20,16 @@
#define MAX_DOZE_WAITING_TIMES_9x 64
/**
-* Function: phy_CalculateBitShift
-*
-* OverView: Get shifted position of the BitMask
-*
-* Input:
-* u32 BitMask,
-*
-* Output: none
-* Return: u32 Return the shift bit bit position of the mask
-*/
+ * Function: phy_CalculateBitShift
+ *
+ * OverView: Get shifted position of the BitMask
+ *
+ * Input:
+ * u32 BitMask,
+ *
+ * Output: none
+ * Return: u32 Return the shift bit bit position of the mask
+ */
static u32 phy_CalculateBitShift(u32 BitMask)
{
u32 i;
@@ -43,19 +43,19 @@ static u32 phy_CalculateBitShift(u32 BitMask)
/**
-* Function: PHY_QueryBBReg
-*
-* OverView: Read "specific bits" from BB register
-*
-* Input:
-* struct adapter * Adapter,
-* u32 RegAddr, The target address to be readback
-* u32 BitMask The target bit position in the target address
-* to be readback
-* Output: None
-* Return: u32 Data The readback register value
-* Note: This function is equal to "GetRegSetting" in PHY programming guide
-*/
+ * Function: PHY_QueryBBReg
+ *
+ * OverView: Read "specific bits" from BB register
+ *
+ * Input:
+ * struct adapter * Adapter,
+ * u32 RegAddr, The target address to be readback
+ * u32 BitMask The target bit position in the target address
+ * to be readback
+ * Output: None
+ * Return: u32 Data The readback register value
+ * Note: This function is equal to "GetRegSetting" in PHY programming guide
+ */
u32 PHY_QueryBBReg_8723B(struct adapter *Adapter, u32 RegAddr, u32 BitMask)
{
u32 OriginalValue, BitShift;
@@ -75,22 +75,22 @@ u32 PHY_QueryBBReg_8723B(struct adapter *Adapter, u32 RegAddr, u32 BitMask)
/**
-* Function: PHY_SetBBReg
-*
-* OverView: Write "Specific bits" to BB register (page 8~)
-*
-* Input:
-* struct adapter * Adapter,
-* u32 RegAddr, The target address to be modified
-* u32 BitMask The target bit position in the target address
-* to be modified
-* u32 Data The new register value in the target bit position
-* of the target address
-*
-* Output: None
-* Return: None
-* Note: This function is equal to "PutRegSetting" in PHY programming guide
-*/
+ * Function: PHY_SetBBReg
+ *
+ * OverView: Write "Specific bits" to BB register (page 8~)
+ *
+ * Input:
+ * struct adapter * Adapter,
+ * u32 RegAddr, The target address to be modified
+ * u32 BitMask The target bit position in the target address
+ * to be modified
+ * u32 Data The new register value in the target bit position
+ * of the target address
+ *
+ * Output: None
+ * Return: None
+ * Note: This function is equal to "PutRegSetting" in PHY programming guide
+ */
void PHY_SetBBReg_8723B(
struct adapter *Adapter,
@@ -184,25 +184,25 @@ static u32 phy_RFSerialRead_8723B(
}
/**
-* Function: phy_RFSerialWrite_8723B
-*
-* OverView: Write data to RF register (page 8~)
-*
-* Input:
-* struct adapter * Adapter,
-* RF_PATH eRFPath, Radio path of A/B/C/D
-* u32 Offset, The target address to be read
-* u32 Data The new register Data in the target bit position
-* of the target to be read
-*
-* Output: None
-* Return: None
-* Note: Threre are three types of serial operations:
-* 1. Software serial write
-* 2. Hardware LSSI-Low Speed Serial Interface
-* 3. Hardware HSSI-High speed
-* serial write. Driver need to implement (1) and (2).
-* This function is equal to the combination of RF_ReadReg() and RFLSSIRead()
+ * Function: phy_RFSerialWrite_8723B
+ *
+ * OverView: Write data to RF register (page 8~)
+ *
+ * Input:
+ * struct adapter * Adapter,
+ * RF_PATH eRFPath, Radio path of A/B/C/D
+ * u32 Offset, The target address to be read
+ * u32 Data The new register Data in the target bit position
+ * of the target to be read
+ *
+ * Output: None
+ * Return: None
+ * Note: Threre are three types of serial operations:
+ * 1. Software serial write
+ * 2. Hardware LSSI-Low Speed Serial Interface
+ * 3. Hardware HSSI-High speed
+ * serial write. Driver need to implement (1) and (2).
+ * This function is equal to the combination of RF_ReadReg() and RFLSSIRead()
*
* Note: For RF8256 only
* The total count of RTL8256(Zebra4) register is around 36 bit it only employs
@@ -225,7 +225,7 @@ static u32 phy_RFSerialRead_8723B(
*
*
*
-*/
+ */
static void phy_RFSerialWrite_8723B(
struct adapter *Adapter,
enum RF_PATH eRFPath,
@@ -261,21 +261,21 @@ static void phy_RFSerialWrite_8723B(
/**
-* Function: PHY_QueryRFReg
-*
-* OverView: Query "Specific bits" to RF register (page 8~)
-*
-* Input:
-* struct adapter * Adapter,
-* RF_PATH eRFPath, Radio path of A/B/C/D
-* u32 RegAddr, The target address to be read
-* u32 BitMask The target bit position in the target address
-* to be read
-*
-* Output: None
-* Return: u32 Readback value
-* Note: This function is equal to "GetRFRegSetting" in PHY programming guide
-*/
+ * Function: PHY_QueryRFReg
+ *
+ * OverView: Query "Specific bits" to RF register (page 8~)
+ *
+ * Input:
+ * struct adapter * Adapter,
+ * RF_PATH eRFPath, Radio path of A/B/C/D
+ * u32 RegAddr, The target address to be read
+ * u32 BitMask The target bit position in the target address
+ * to be read
+ *
+ * Output: None
+ * Return: u32 Readback value
+ * Note: This function is equal to "GetRFRegSetting" in PHY programming guide
+ */
u32 PHY_QueryRFReg_8723B(
struct adapter *Adapter,
u8 eRFPath,
@@ -296,23 +296,23 @@ u32 PHY_QueryRFReg_8723B(
}
/**
-* Function: PHY_SetRFReg
-*
-* OverView: Write "Specific bits" to RF register (page 8~)
-*
-* Input:
-* struct adapter * Adapter,
-* RF_PATH eRFPath, Radio path of A/B/C/D
-* u32 RegAddr, The target address to be modified
-* u32 BitMask The target bit position in the target address
-* to be modified
-* u32 Data The new register Data in the target bit position
-* of the target address
-*
-* Output: None
-* Return: None
-* Note: This function is equal to "PutRFRegSetting" in PHY programming guide
-*/
+ * Function: PHY_SetRFReg
+ *
+ * OverView: Write "Specific bits" to RF register (page 8~)
+ *
+ * Input:
+ * struct adapter * Adapter,
+ * RF_PATH eRFPath, Radio path of A/B/C/D
+ * u32 RegAddr, The target address to be modified
+ * u32 BitMask The target bit position in the target address
+ * to be modified
+ * u32 Data The new register Data in the target bit position
+ * of the target address
+ *
+ * Output: None
+ * Return: None
+ * Note: This function is equal to "PutRFRegSetting" in PHY programming guide
+ */
void PHY_SetRFReg_8723B(
struct adapter *Adapter,
u8 eRFPath,
@@ -369,17 +369,17 @@ s32 PHY_MACConfig8723B(struct adapter *Adapter)
}
/**
-* Function: phy_InitBBRFRegisterDefinition
-*
-* OverView: Initialize Register definition offset for Radio Path A/B/C/D
-*
-* Input:
-* struct adapter * Adapter,
-*
-* Output: None
-* Return: None
-* Note: The initialization value is constant and it should never be changes
-*/
+ * Function: phy_InitBBRFRegisterDefinition
+ *
+ * OverView: Initialize Register definition offset for Radio Path A/B/C/D
+ *
+ * Input:
+ * struct adapter * Adapter,
+ *
+ * Output: None
+ * Return: None
+ * Note: The initialization value is constant and it should never be changes
+ */
static void phy_InitBBRFRegisterDefinition(struct adapter *Adapter)
{
struct hal_com_data *pHalData = GET_HAL_DATA(Adapter);
--
2.30.0
next reply other threads:[~2021-02-09 21:13 UTC|newest]
Thread overview: 20+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-02-09 18:53 karthik alapati [this message]
2021-02-09 18:59 ` [PATCH] staging: rtl8723bs: fix block comments alignment Greg Kroah-Hartman
[not found] ` <YCLd2286lLdO0BAE@karthik-strix-linux.karthek.com>
2021-02-09 19:17 ` karthek
2021-02-10 7:27 ` Dan Carpenter
2021-02-10 7:37 ` karthek
-- strict thread matches above, loose matches on Subject: below --
2021-02-07 14:16 karthek
2021-02-07 14:34 ` Greg Kroah-Hartman
[not found] ` <YB/9hS2S1oaCmuDq@karthik-strix-linux.karthek.com>
[not found] ` <YB//EZl0aeLk/y+E@kroah.com>
2021-02-07 15:11 ` karthek
2021-02-07 15:15 ` Greg Kroah-Hartman
2021-02-07 15:19 ` karthek
2021-02-07 15:21 ` Greg Kroah-Hartman
2021-02-07 15:24 ` karthek
2021-02-07 15:26 ` Greg Kroah-Hartman
2021-02-07 15:33 ` karthek
2021-02-09 16:20 ` karthek
2021-02-09 17:23 ` Greg Kroah-Hartman
2021-02-09 17:56 ` karthek
2021-02-09 18:49 ` Greg Kroah-Hartman
2021-02-09 18:52 ` karthek
2021-02-09 18:48 ` karthek
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=YCLaHXD/sUKM5HZE@karthik-strix-linux.karthek.com \
--to=mail@karthek.com \
--cc=devel@driverdev.osuosl.org \
--cc=gregkh@linuxfoundation.org \
--cc=linux-kernel@vger.kernel.org \
--cc=sfr@canb.auug.org.au \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).