staging: rtl8192u: clean up comments in r8192U_dm.c
v3 cover staging: rtl8192u: clean up comments in r8192U_dm.c
Clean up several comments in file r8192U_dm.c
Changes in v3:
- Split patch 3 in two patches, one for '*' on subsequent lines and one for '*/' on separate line, as suggested by Dan.
- Add spaces after '*' in patch 3
Changes in v2:
- Remove the 'commented code' and 'revision history' before reformatting the block comments, as suggested by Greg. There is no use in fixing comments, only to remove them in the next commits
- Patch 1: Changed the description and removed extra blank lines under the change history
- Patch 2: Changed the subject and description
This patchset was created after reviewer feedback on an initial patch. The feedback suggested additional cleanup comments. Link to the first patch:
https://lore.kernel.org/outreachy/ZB2a5zwYpBZ%2F6qwU@khadija-virtual-machine/
Khadija Kamran (4):
staging: rtl8192u: remove change history from comments
staging: rtl8192u: remove commented out code
staging: rtl8192u: add '*' on subsequent lines in block comment
staging: rtl8192u: add '*/' on separate line in block comments
drivers/staging/rtl8192u/r8192U_dm.c | 206 +++------------------------ 1 file changed, 23 insertions(+), 183 deletions(-)
Signature · 1 line
2.34.1
PATCH v3 1/4 staging: rtl8192u: remove change history from comments
Remove the change history information as it is not required in the comments.
--- drivers/staging/rtl8192u/r8192U_dm.c | 45 ---------------------------- 1 file changed, 45 deletions(-)
drivers/staging/rtl8192u/r8192U_dm.c +0 -45
@@ -7,12 +7,6 @@ Module Name:Abstract: HW dynamic mechanism. - -Major Change History: -When Who What ----------- --------------- ------------------------------- -2008-05-14 amy create version 0 porting from windows code. ---*/ #include "r8192U.h" #include "r8192U_dm.h"
@@ -274,11 +268,6 @@ void init_rate_adaptive(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/26/08 amy Create version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_rate_adaptive (struct net_device *dev) {
@@ -1589,11 +1578,6 @@ static void dm_bb_initialgain_backup(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/15/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_dig_init (struct net_device *dev) {
@@ -1634,10 +1618,6 @@ static void dm_dig_init(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/27/2008 amy Create Version 0 porting from windows code. *---------------------------------------------------------------------------*/ static void dm_ctrl_initgain_byrssi (struct net_device *dev) {
@@ -1850,11 +1830,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_ctrl_initgain_byrssi_highpwr (struct net_device *dev)
@@ -2269,11 +2244,6 @@ static void dm_ctstoself(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_pbc_gpio (struct net_device *dev) {
@@ -2303,11 +2273,6 @@ static void dm_check_pbc_gpio(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 01/30/2008 MHC Create Version 0. -* *---------------------------------------------------------------------------*/ void dm_rf_pathcheck_workitemcallback (struct work_struct *work) {
@@ -2552,11 +2517,6 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_rx_path_selection (struct net_device *dev) {
@@ -2871,11 +2831,6 @@ void dm_check_fsync(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 03/06/2008 Jacken Create Version 0. -* *--------------------------------------------------------------------------- */ static void dm_init_dynamic_txpower (struct net_device *dev)
Signature · 1 line
2.34.1
Re: [PATCH v3 1/4] staging: rtl8192u: remove change history from comments
Quoted 2 lines · Khadija Kamran
Remove the change history information as it is not required in the comments.
(also Cc: original driver author)
What about below?
``` Remove obsolete change history info as developers can simply use git to browse commit history of the driver. ```
Quoted 108 lines
Signed-off-by Khadija Kamran <[email protected]>--- drivers/staging/rtl8192u/r8192U_dm.c | 45 ---------------------------- 1 file changed, 45 deletions(-)drivers/staging/rtl8192u/r8192U_dm.c +0
-40@@ -7,12 +7,6 @@ Module Name:Abstract: HW dynamic mechanism. - -Major Change History: -When Who What ----------- --------------- ------------------------------- -2008-05-14 amy create version 0 porting from windows code. ---*/ #include "r8192U.h" #include "r8192U_dm.h" @@ -274,11 +268,6 @@ void init_rate_adaptive(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/26/08 amy Create version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_rate_adaptive (struct net_device *dev) {@@ -1589,11 +1578,6 @@ static void dm_bb_initialgain_backup(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/15/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_dig_init (struct net_device *dev) {@@ -1634,10 +1618,6 @@ static void dm_dig_init(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/27/2008 amy Create Version 0 porting from windows code. *---------------------------------------------------------------------------*/ static void dm_ctrl_initgain_byrssi (struct net_device *dev) {@@ -1850,11 +1830,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_ctrl_initgain_byrssi_highpwr (struct net_device *dev)@@ -2269,11 +2244,6 @@ static void dm_ctstoself(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_pbc_gpio (struct net_device *dev) {@@ -2303,11 +2273,6 @@ static void dm_check_pbc_gpio(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 01/30/2008 MHC Create Version 0. -* *---------------------------------------------------------------------------*/ void dm_rf_pathcheck_workitemcallback (struct work_struct *work) {@@ -2552,11 +2517,6 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_rx_path_selection (struct net_device *dev) {@@ -2871,11 +2831,6 @@ void dm_check_fsync(struct net_device *dev)* Output: NONE
drivers/staging/rtl8192u/r8192U_dm.c void dm_check_fsync(struct net_device *dev) · line 2836
Quoted 10 lines
drivers/staging/rtl8192u/r8192U_dm.c +0
-5* * Return: NONE -* -* Revised History: -* When Who Remark -* 03/06/2008 Jacken Create Version 0. -* *--------------------------------------------------------------------------- */ static void dm_init_dynamic_txpower (struct net_device *dev)
The rest is LGTM, thanks!
Signature · 1 line
An old man doll... just what I always wanted! - Clara
Re: [PATCH v3 1/4] staging: rtl8192u: remove change history from comments
Quoted 4 lines · Bagas Sanjaya
Quoted 2 lines · Khadija Kamran
Remove the change history information as it is not required in the comments.
Quoted 8 lines
(also Cc: original driver author)
What about below?
``` Remove obsolete change history info as developers can simply use git to browse commit history of the driver. ```
But the information that is being removed is not part of the git history, since it predates the introduction of the driver into the Linux kernel.
julia
Quoted 125 lines
Quoted 109 lines
Signed-off-by Khadija Kamran <[email protected]>--- drivers/staging/rtl8192u/r8192U_dm.c | 45 ---------------------------- 1 file changed, 45 deletions(-)drivers/staging/rtl8192u/r8192U_dm.c +0
-40@@ -7,12 +7,6 @@ Module Name:Abstract: HW dynamic mechanism. - -Major Change History: -When Who What ----------- --------------- ------------------------------- -2008-05-14 amy create version 0 porting from windows code. ---*/ #include "r8192U.h" #include "r8192U_dm.h" @@ -274,11 +268,6 @@ void init_rate_adaptive(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/26/08 amy Create version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_rate_adaptive (struct net_device *dev) {@@ -1589,11 +1578,6 @@ static void dm_bb_initialgain_backup(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/15/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_dig_init (struct net_device *dev) {@@ -1634,10 +1618,6 @@ static void dm_dig_init(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/27/2008 amy Create Version 0 porting from windows code. *---------------------------------------------------------------------------*/ static void dm_ctrl_initgain_byrssi (struct net_device *dev) {@@ -1850,11 +1830,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_ctrl_initgain_byrssi_highpwr (struct net_device *dev)@@ -2269,11 +2244,6 @@ static void dm_ctstoself(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_pbc_gpio (struct net_device *dev) {@@ -2303,11 +2273,6 @@ static void dm_check_pbc_gpio(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 01/30/2008 MHC Create Version 0. -* *---------------------------------------------------------------------------*/ void dm_rf_pathcheck_workitemcallback (struct work_struct *work) {@@ -2552,11 +2517,6 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)* Output: NONE * * Return: NONE -* -* Revised History: -* When Who Remark -* 05/28/2008 amy Create Version 0 porting from windows code. -* *---------------------------------------------------------------------------*/ static void dm_check_rx_path_selection (struct net_device *dev) {@@ -2871,11 +2831,6 @@ void dm_check_fsync(struct net_device *dev)* Output: NONE drivers/staging/rtl8192u/r8192U_dm.c void dm_check_fsync(struct net_device *dev) · line 2836
Quoted 10 lines
drivers/staging/rtl8192u/r8192U_dm.c +0
-5* * Return: NONE -* -* Revised History: -* When Who Remark -* 03/06/2008 Jacken Create Version 0. -* *--------------------------------------------------------------------------- */ static void dm_init_dynamic_txpower (struct net_device *dev)The rest is LGTM, thanks!
--
An old man doll... just what I always wanted! - Clara
PATCH v3 2/4 staging: rtl8192u: remove commented out code
In reply to Khadija KamranRemove all of the commented out code lines as they are not being used and can be brought back in the future if they are ever needed again.
--- drivers/staging/rtl8192u/r8192U_dm.c | 123 --------------------------- 1 file changed, 123 deletions(-)
drivers/staging/rtl8192u/r8192U_dm.c +0 -123
@@ -48,12 +48,8 @@ static void dm_init_bandwidth_autoswitch(struct net_device *dev);static void dm_bandwidth_autoswitch (struct net_device *dev);/* DM --> TX power control */ -/*static void dm_initialize_txpower_tracking(struct net_device *dev);*/ -static void dm_check_txpower_tracking (struct net_device *dev); -/*static void dm_txpower_reset_recovery(struct net_device *dev);*/ -/* DM --> Dynamic Init Gain by RSSI */ static void dm_dig_init (struct net_device *dev);static void dm_ctrl_initgain_byrssi (struct net_device *dev);
@@ -68,7 +64,6 @@ static void dm_init_ctstoself(struct net_device *dev);/* DM --> EDCA turbo mode control */ static void dm_check_edca_turbo (struct net_device *dev); -/*static void dm_gpio_change_rf(struct net_device *dev);*/ /* DM --> Check PBC */ static void dm_check_pbc_gpio (struct net_device *dev);
@@ -115,7 +110,6 @@ void init_hal_dm(struct net_device *dev)/* Initial TX Power Control for near/far range , add by amy 2008/05/15, porting from windows code. */ dm_init_dynamic_txpower (dev);init_rate_adaptive (dev); -/*dm_initialize_txpower_tracking(dev);*/ dm_dig_init (dev);dm_init_edca_turbo (dev);dm_init_bandwidth_autoswitch (dev);
@@ -140,21 +134,6 @@ void dm_CheckRxAggregation(struct net_device *dev)unsigned long curTxOkCnt =0 ;unsigned long curRxOkCnt =0 ; -/* -if (pHalData->bForcedUsbRxAggr) { -if (pHalData->ForcedUsbRxAggrInfo == 0) { -if (pHalData->bCurrentRxAggrEnable) { -Adapter->HalFunc.HalUsbRxAggrHandler(Adapter, FALSE); -} -} else { -if (!pHalData->bCurrentRxAggrEnable || (pHalData->ForcedUsbRxAggrInfo != pHalData->LastUsbRxAggrInfoSetting)) { -Adapter->HalFunc.HalUsbRxAggrHandler(Adapter, TRUE); -} -} -return; -} - -*/ curTxOkCnt = priv->stats.txbytesunicast - lastTxOkCnt; curRxOkCnt = priv->stats.rxbytesunicast - lastRxOkCnt;
@@ -188,10 +167,6 @@ void dm_CheckRxAggregation(struct net_device *dev)void hal_dm_watchdog (struct net_device *dev) { -/*struct r8192_priv *priv = ieee80211_priv(dev);*/ - -/*static u8 previous_bssid[6] ={0};*/ -/*Add by amy 2008/05/15 ,porting from windows code.*/ dm_check_rate_adaptive (dev);dm_dynamic_txpower (dev);
@@ -293,7 +268,6 @@ static void dm_check_rate_adaptive(struct net_device *dev)return ;if (priv->ieee80211->state ==IEEE80211_LINKED ) { -/*RT_TRACE(COMP_RATE, "dm_CheckRateAdaptive(): \t");*/ /* Check whether Short GI is enabled */ bshort_gi_enabled = (pHTInfo->bCurTxBW40MHz && pHTInfo->bCurShortGI40MHz) ||
@@ -340,36 +314,27 @@ static void dm_check_rate_adaptive(struct net_device *dev) (pra->low_rssi_thresh_for_ra40M):(pra->low_rssi_thresh_for_ra20M); } -/*DbgPrint("[DM] THresh H/L=%d/%d\n\r", RATR.HighRSSIThreshForRA, RATR.LowRSSIThreshForRA);*/ if (priv->undecorated_smoothed_pwdb >= (long )HighRSSIThreshForRA) { -/*DbgPrint("[DM] RSSI=%d STA=HIGH\n\r", pHalData->UndecoratedSmoothedPWDB);*/ pra->ratr_state =DM_RATR_STA_HIGH ; targetRATR = pra->upper_rssi_threshold_ratr; }else if (priv->undecorated_smoothed_pwdb >= (long )LowRSSIThreshForRA) { -/*DbgPrint("[DM] RSSI=%d STA=Middle\n\r", pHalData->UndecoratedSmoothedPWDB);*/ pra->ratr_state =DM_RATR_STA_MIDDLE ; targetRATR = pra->middle_rssi_threshold_ratr; }else { -/*DbgPrint("[DM] RSSI=%d STA=LOW\n\r", pHalData->UndecoratedSmoothedPWDB);*/ pra->ratr_state =DM_RATR_STA_LOW ; targetRATR = pra->low_rssi_threshold_ratr; }/* cosa add for test */ if (pra->ping_rssi_enable) { -/*pHalData->UndecoratedSmoothedPWDB = 19;*/ if (priv->undecorated_smoothed_pwdb < (long )(pra->ping_rssi_thresh_for_ra+5 )) {if ((priv->undecorated_smoothed_pwdb < (long )pra->ping_rssi_thresh_for_ra) || ping_rssi_state) { -/*DbgPrint("TestRSSI = %d, set RATR to 0x%x\n", pHalData->UndecoratedSmoothedPWDB, pRA->TestRSSIRATR);*/ pra->ratr_state =DM_RATR_STA_LOW ; targetRATR = pra->ping_rssi_ratr; ping_rssi_state =1 ; } -/*else -DbgPrint("TestRSSI is between the range.\n");*/ }else { -/*DbgPrint("TestRSSI Recover to 0x%x\n", targetRATR);*/ ping_rssi_state =0 ; } }
@@ -491,7 +456,6 @@ static void dm_TXPowerTrackingCallback_TSSI(struct net_device *dev)u32 Value;u8 Pwr_Flag;u16 Avg_TSSI_Meas, TSSI_13dBm, Avg_TSSI_Meas_from_driver =0 ; -/*RT_STATUS rtStatus = RT_STATUS_SUCCESS;*/ bool rtStatus = true;u32 delta =0 ;
@@ -513,7 +477,6 @@ static void dm_TXPowerTrackingCallback_TSSI(struct net_device *dev)if (rtStatus ==RT_STATUS_FAILURE )RT_TRACE (COMP_POWER_TRACKING ,"Set configuration with tx cmd queue fail!\n" );usleep_range (1000 ,2000 ); -/*DbgPrint("hi, vivi, strange\n");*/ for (i =0 ; i <=30 ; i++) {read_nic_byte (dev,0x1ba , &Pwr_Flag);
@@ -559,8 +522,6 @@ static void dm_TXPowerTrackingCallback_TSSI(struct net_device *dev) TSSI_13dBm = priv->TSSI_13dBm;RT_TRACE (COMP_POWER_TRACKING ,"TSSI_13dBm = %d\n" , TSSI_13dBm); -/*if (abs(Avg_TSSI_Meas_from_driver - TSSI_13dBm) <= E_FOR_TX_POWER_TRACK)*/ -/* For MacOS-compatible */ if (Avg_TSSI_Meas_from_driver > TSSI_13dBm) delta = Avg_TSSI_Meas_from_driver - TSSI_13dBm;else
@@ -664,7 +625,6 @@ static void dm_TXPowerTrackingCallback_ThermalMeter(struct net_device *dev) } } priv->btxpower_trackingInit = true; -/*pHalData->TXPowercount = 0;*/ return ; }
@@ -708,9 +668,6 @@ static void dm_TXPowerTrackingCallback_ThermalMeter(struct net_device *dev) } tmpCCK40Mindex =0 ; } -/*DbgPrint("%ddb, tmpOFDMindex = %d, tmpCCK20Mindex = %d, tmpCCK40Mindex = %d", -((u1Byte)tmpRegA - pHalData->ThermalMeter[0]), -tmpOFDMindex, tmpCCK20Mindex, tmpCCK40Mindex);*/ if (priv->CurrentChannelBW !=HT_CHANNEL_WIDTH_20 )/* 40M */ tmpCCKindex = tmpCCK40Mindex;else
@@ -730,7 +687,6 @@ static void dm_TXPowerTrackingCallback_ThermalMeter(struct net_device *dev) }if (CCKSwingNeedUpdate) { -/*DbgPrint("Update CCK Swing, CCK_index = %d\n", pHalData->CCK_index);*/ dm_cck_txpower_adjust (dev, priv->bcck_in_ch14); }if (priv->OFDM_index != tmpOFDMindex) {
@@ -1301,7 +1257,6 @@ static void dm_CheckTXPowerTracking_ThermalMeter(struct net_device *dev) {struct r8192_priv *priv =ieee80211_priv (dev);static u8 TM_Trigger; -/*DbgPrint("dm_CheckTXPowerTracking()\n");*/ if (!priv->btxpower_tracking)return ;if (priv->txpower_count <=2 ) {
@@ -1321,7 +1276,6 @@ static void dm_CheckTXPowerTracking_ThermalMeter(struct net_device *dev) TM_Trigger =1 ;return ; } -/*DbgPrint("Schedule TxPowerTrackingWorkItem\n");*/ queue_delayed_work (priv->priv_wq, &priv->txpower_tracking_wq,0 ); TM_Trigger =0 ; }
@@ -1329,7 +1283,6 @@ static void dm_CheckTXPowerTracking_ThermalMeter(struct net_device *dev)static void dm_check_txpower_tracking (struct net_device *dev) {struct r8192_priv *priv =ieee80211_priv (dev); -/*static u32 tx_power_track_counter = 0;*/ #ifdef RTL8190P dm_CheckTXPowerTracking_TSSI (dev);
@@ -1414,7 +1367,6 @@ static void dm_CCKTxPowerAdjust_ThermalMeter(struct net_device *dev, bool bInCHRT_TRACE (COMP_POWER_TRACKING ,"CCK not chnl 14, reg 0x%x = 0x%x\n" , rCCK0_DebugPort, TempVal); }else { -/*priv->CCKTxPowerAdjustCntNotCh14++; cosa add for debug.*/ /* Write 0xa22 0xa23 */ TempVal = CCKSwingTable_Ch14[priv->CCK_index][0 ] + (CCKSwingTable_Ch14[priv->CCK_index][1 ]<<8 );
@@ -1497,10 +1449,7 @@ void dm_restore_dynamic_mechanism_state(struct net_device *dev) ratr_value = reg_ratr;if (priv->rf_type ==RF_1T2R ) {/* 1T2R, Spatial Stream 2 should be disabled */ ratr_value &= ~(RATE_ALL_OFDM_2SS ); -/*DbgPrint("HW_VAR_TATR_0 from 0x%x ==> 0x%x\n", ((pu4Byte)(val))[0], ratr_value);*/ } -/*DbgPrint("set HW_VAR_TATR_0 = 0x%x\n", ratr_value);*/ -/*cosa PlatformEFIOWrite4Byte(Adapter, RATR0, ((pu4Byte)(val))[0]);*/ write_nic_dword (dev,RATR0 , ratr_value);write_nic_byte (dev,UFWP ,1 ); }
@@ -1522,7 +1471,6 @@ static void dm_bb_initialgain_restore(struct net_device *dev)return ;/* Disable Initial Gain */ -/*PHY_SetBBReg(Adapter, UFWP, bMaskLWord, 0x800);*/ rtl8192_setBBreg (dev,UFWP , bMaskByte1,0x8 );/* Only clear byte 1 and rewrite. */ rtl8192_setBBreg (dev, rOFDM0_XAAGCCore1, bit_mask, (u32 )priv->initgain_backup.xaagccore1);rtl8192_setBBreg (dev, rOFDM0_XBAGCCore1, bit_mask, (u32 )priv->initgain_backup.xbagccore1);
@@ -1537,7 +1485,6 @@ static void dm_bb_initialgain_restore(struct net_device *dev)RT_TRACE (COMP_DIG ,"dm_BBInitialGainRestore 0xc68 is %x\n" , priv->initgain_backup.xdagccore1);RT_TRACE (COMP_DIG ,"dm_BBInitialGainRestore 0xa0a is %x\n" , priv->initgain_backup.cca);/* Enable Initial Gain */ -/*PHY_SetBBReg(Adapter, UFWP, bMaskLWord, 0x100);*/ rtl8192_setBBreg (dev,UFWP , bMaskByte1,0x1 );/* Only clear byte 1 and rewrite. */ }/* dm_BBInitialGainRestore */
@@ -1550,7 +1497,6 @@ static void dm_bb_initialgain_backup(struct net_device *dev)if (dm_digtable.dig_algorithm ==DIG_ALGO_BY_RSSI )return ; -/*PHY_SetBBReg(Adapter, UFWP, bMaskLWord, 0x800);*/ rtl8192_setBBreg (dev,UFWP , bMaskByte1,0x8 );/* Only clear byte 1 and rewrite. */ priv->initgain_backup.xaagccore1 = (u8 )rtl8192_QueryBBReg (dev, rOFDM0_XAAGCCore1, bit_mask); priv->initgain_backup.xbagccore1 = (u8 )rtl8192_QueryBBReg (dev, rOFDM0_XBAGCCore1, bit_mask);
@@ -1643,7 +1589,6 @@ static void dm_ctrl_initgain_byrssi_by_driverrssi(if (!dm_digtable.dig_enable_flag)return ; -/*DbgPrint("Dig by Sw Rssi\n");*/ if (dm_digtable.dig_algorithm_switch)/* if switched algorithm, we have to disable FW Dig. */ fw_dig =0 ;
@@ -1660,11 +1605,7 @@ static void dm_ctrl_initgain_byrssi_by_driverrssi(else dm_digtable.cur_connect_state =DIG_DISCONNECT ; -/*DbgPrint("DM_DigTable.PreConnectState = %d, DM_DigTable.CurConnectState = %d\n", -DM_DigTable.PreConnectState, DM_DigTable.CurConnectState);*/ - dm_digtable.rssi_val = priv->undecorated_smoothed_pwdb; -/*DbgPrint("DM_DigTable.Rssi_val = %d\n", DM_DigTable.Rssi_val);*/ dm_initial_gain (dev);dm_pd_th (dev);dm_cs_ratio (dev);
@@ -1700,11 +1641,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm( (priv->undecorated_smoothed_pwdb < dm_digtable.rssi_high_thresh)) return; -/*DbgPrint("Dig by Fw False Alarm\n");*/ -/*if (DM_DigTable.Dig_State == DM_STA_DIG_OFF)*/ -/*DbgPrint("DIG Check\n\r RSSI=%d LOW=%d HIGH=%d STATE=%d", -pHalData->UndecoratedSmoothedPWDB, DM_DigTable.RssiLowThresh, -DM_DigTable.RssiHighThresh, DM_DigTable.Dig_State);*/ /* 1. When RSSI decrease, We have to judge if it is smaller than a threshold * and then execute the step below. */
@@ -1737,12 +1673,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(* 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte (dev, (rOFDM0_XATxAFE+3 ),0x00 ); -/*else if (priv->card_8192 == HARDWARE_TYPE_RTL8190P) -write_nic_byte(pAdapter, rOFDM0_RxDetector1, 0x40); -else if (pAdapter->HardwareType == HARDWARE_TYPE_RTL8192E) -else -PlatformEFIOWrite1Byte(pAdapter, rOFDM0_RxDetector1, 0x40); -*/ }else write_nic_byte (dev, rOFDM0_RxDetector1,0x42 );
@@ -1750,7 +1680,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(write_nic_byte (dev,0xa0a ,0x08 );/* 1.5 Higher EDCCA. */ -/*PlatformEFIOWrite4Byte(pAdapter, rOFDM0_ECCAThreshold, 0x325);*/ return ; }
@@ -1771,7 +1700,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm( reset_cnt = priv->reset_count; dm_digtable.dig_state =DM_STA_DIG_ON ; -/*DbgPrint("DIG ON\n\r");*/ /* 2.1 Set initial gain. * 2008/02/26 MH SD3-Jerry suggest to prevent dirty environment.
@@ -1794,13 +1722,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(* 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte (dev, (rOFDM0_XATxAFE+3 ),0x20 ); -/* -else if (priv->card_8192 == HARDWARE_TYPE_RTL8190P) -write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); -else if (pAdapter->HardwareType == HARDWARE_TYPE_RTL8192E) -else -PlatformEFIOWrite1Byte(pAdapter, rOFDM0_RxDetector1, 0x42); -*/ }else write_nic_byte (dev, rOFDM0_RxDetector1,0x44 );
@@ -1810,7 +1731,6 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(/* 2.4 Lower EDCCA. * 2008/01/11 MH 90/92 series are the same. */ -/*PlatformEFIOWrite4Byte(pAdapter, rOFDM0_ECCAThreshold, 0x346);*/ /* 2.5 DIG On. */ rtl8192_setBBreg (dev,UFWP , bMaskByte1,0x1 );/* Only clear byte 1 and rewrite. */
@@ -1856,11 +1776,6 @@ static void dm_ctrl_initgain_byrssi_highpwr(/* 3.1 Higher PD_TH for OFDM for high power state. */ if (priv->CurrentChannelBW !=HT_CHANNEL_WIDTH_20 ) {write_nic_byte (dev, (rOFDM0_XATxAFE+3 ),0x10 ); - -/*else if (priv->card_8192 == HARDWARE_TYPE_RTL8190P) -write_nic_byte(dev, rOFDM0_RxDetector1, 0x41); -*/ - }else write_nic_byte (dev, rOFDM0_RxDetector1,0x43 ); }else {
@@ -1874,10 +1789,6 @@ static void dm_ctrl_initgain_byrssi_highpwr(/* 3.2 Recover PD_TH for OFDM for normal power region. */ if (priv->CurrentChannelBW !=HT_CHANNEL_WIDTH_20 ) {write_nic_byte (dev, (rOFDM0_XATxAFE+3 ),0x20 ); -/*else if (priv->card_8192 == HARDWARE_TYPE_RTL8190P) -write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); -*/ - }else write_nic_byte (dev, rOFDM0_RxDetector1,0x44 ); }
@@ -1919,7 +1830,6 @@ static void dm_initial_gain( dm_digtable.cur_ig_value = priv->DefaultInitialGain[0 ]; dm_digtable.pre_ig_value =0 ; } -/*DbgPrint("DM_DigTable.CurIGValue = 0x%x, DM_DigTable.PreIGValue = 0x%x\n", DM_DigTable.CurIGValue, DM_DigTable.PreIGValue);*/ /* if silent reset happened, we should rewrite the values back */ if (priv->reset_count != reset_cnt) {
@@ -1935,7 +1845,6 @@ static void dm_initial_gain(if ((dm_digtable.pre_ig_value != dm_digtable.cur_ig_value) || !initialized || force_write) { initial_gain = (u8 )dm_digtable.cur_ig_value; -/*DbgPrint("Write initial gain = 0x%x\n", initial_gain);*/ /* Set initial gain. */ write_nic_byte (dev, rOFDM0_XAAGCCore1, initial_gain);write_nic_byte (dev, rOFDM0_XBAGCCore1, initial_gain);
@@ -1987,7 +1896,6 @@ static void dm_pd_th( {if ((dm_digtable.prepd_thstate != dm_digtable.curpd_thstate) || (initialized <=3 ) || force_write) { -/*DbgPrint("Write PD_TH state = %d\n", DM_DigTable.CurPD_THState);*/ if (dm_digtable.curpd_thstate ==DIG_PD_AT_LOW_POWER ) {/* Lower PD_TH for OFDM. */ if (priv->CurrentChannelBW !=HT_CHANNEL_WIDTH_20 ) {
@@ -1995,9 +1903,6 @@ static void dm_pd_th(* 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte (dev, (rOFDM0_XATxAFE+3 ),0x00 ); -/*else if (priv->card_8192 == HARDWARE_TYPE_RTL8190P) -write_nic_byte(dev, rOFDM0_RxDetector1, 0x40); -*/ }else write_nic_byte (dev, rOFDM0_RxDetector1,0x42 ); }else if (dm_digtable.curpd_thstate ==DIG_PD_AT_NORMAL_POWER ) {
@@ -2007,18 +1912,12 @@ static void dm_pd_th(* 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte (dev, (rOFDM0_XATxAFE+3 ),0x20 ); -/*else if (priv->card_8192 == HARDWARE_TYPE_RTL8190P) -write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); -*/ }else write_nic_byte (dev, rOFDM0_RxDetector1,0x44 ); }else if (dm_digtable.curpd_thstate ==DIG_PD_AT_HIGH_POWER ) {/* Higher PD_TH for OFDM for high power state. */ if (priv->CurrentChannelBW !=HT_CHANNEL_WIDTH_20 ) {write_nic_byte (dev, (rOFDM0_XATxAFE+3 ),0x10 ); -/*else if (priv->card_8192 == HARDWARE_TYPE_RTL8190P) -write_nic_byte(dev, rOFDM0_RxDetector1, 0x41); -*/ }else write_nic_byte (dev, rOFDM0_RxDetector1,0x43 ); }
@@ -2065,7 +1964,6 @@ static void dm_cs_ratio( {if ((dm_digtable.precs_ratio_state != dm_digtable.curcs_ratio_state) || !initialized || force_write) { -/*DbgPrint("Write CS_ratio state = %d\n", DM_DigTable.CurCS_ratioState);*/ if (dm_digtable.curcs_ratio_state ==DIG_CS_RATIO_LOWER ) {/* Lower CS ratio for CCK. */ write_nic_byte (dev,0xa0a ,0x08 );
@@ -2094,7 +1992,6 @@ static void dm_check_edca_turbo( {struct r8192_priv *priv =ieee80211_priv (dev);PRT_HIGH_THROUGHPUT pHTInfo = priv->ieee80211->pHTInfo; -/*PSTA_QOS pStaQos = pMgntInfo->pStaQos;*/ /* Keep past Tx/Rx packet count for RT-to-RT EDCA turbo. */ static unsigned long lastTxOkCnt;
@@ -2111,20 +2008,16 @@ static void dm_check_edca_turbo(if (priv->ieee80211->pHTInfo->IOTAction &HT_IOT_ACT_DISABLE_EDCA_TURBO ) goto dm_CheckEdcaTurbo_EXIT; -/*printk("========>%s():bis_any_nonbepkts is %d\n", __func__, priv->bis_any_nonbepkts);*/ -/* Check the status for current condition. */ if (!priv->ieee80211->bis_any_nonbepkts) { curTxOkCnt = priv->stats.txbytesunicast - lastTxOkCnt; curRxOkCnt = priv->stats.rxbytesunicast - lastRxOkCnt;/* For RT-AP, we needs to turn it on when Rx>Tx */ if (curRxOkCnt >4 *curTxOkCnt) { -/*printk("%s():curRxOkCnt > 4*curTxOkCnt\n");*/ if (!priv->bis_cur_rdlstate || !priv->bcurrent_turbo_EDCA) {write_nic_dword (dev,EDCAPARA_BE , edca_setting_DL[pHTInfo->IOTPeer]); priv->bis_cur_rdlstate = true; } }else { -/*printk("%s():curRxOkCnt < 4*curTxOkCnt\n");*/ if (priv->bis_cur_rdlstate || !priv->bcurrent_turbo_EDCA) {write_nic_dword (dev,EDCAPARA_BE , edca_setting_UL[pHTInfo->IOTPeer]); priv->bis_cur_rdlstate = false;
@@ -2224,7 +2117,6 @@ static void dm_ctstoself(struct net_device *dev) curRxOkCnt = priv->stats.rxbytesunicast - lastRxOkCnt;if (curRxOkCnt >4 *curTxOkCnt) {/* downlink, disable CTS to self */ pHTInfo->IOTAction &= ~HT_IOT_ACT_FORCED_CTS2SELF ; -/*DbgPrint("dm_CTSToSelf() ==> CTS to self disabled -- downlink\n");*/ }else {/* uplink */ pHTInfo->IOTAction |=HT_IOT_ACT_FORCED_CTS2SELF ; }
@@ -2279,7 +2171,6 @@ void dm_rf_pathcheck_workitemcallback(struct work_struct *work)struct delayed_work *dwork =to_delayed_work (work); struct r8192_priv *priv = container_of(dwork, struct r8192_priv, rfpath_check_wq);struct net_device *dev = priv->ieee80211->dev; -/*bool bactually_set = false;*/ u8 rfpath =0 , i;/* 2008/01/30 MH After discussing with SD3 Jerry, 0xc04/0xd04 register will
@@ -2343,7 +2234,6 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)if (priv->ieee80211->mode ==WIRELESS_MODE_B ) { DM_RxPathSelTable.cck_method =CCK_RX_VERSION_2 ;/* pure B mode, fixed cck version2 */ -/*DbgPrint("Pure B mode, use cck rx version2\n");*/ }/* decide max/sec/min rssi index */
@@ -2496,7 +2386,6 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)if ((DM_RxPathSelTable.disabled_rf >> i) &0x1 ) {/* disabled rf */ if (tmp_max_rssi >= DM_RxPathSelTable.rf_enable_rssi_th[i]) {/* enable the BB Rx path */ -/*DbgPrint("RF-%d is enabled.\n", 0x1<<i);*/ rtl8192_setBBreg (dev, rOFDM0_TRxPathEnable,0x1 <<i,0x1 );/* 0xc04[3:0] */ rtl8192_setBBreg (dev, rOFDM1_TRxPathEnable,0x1 <<i,0x1 );/* 0xd04[3:0] */ DM_RxPathSelTable.rf_enable_rssi_th[i] =100 ;
@@ -2716,7 +2605,6 @@ void dm_check_fsync(struct net_device *dev)#define RegC38_NonFsync_Other_AP 1#define RegC38_Fsync_AP_BCM 2struct r8192_priv *priv =ieee80211_priv (dev); -/*u32 framesyncC34;*/ static u8 reg_c38_State = RegC38_Default;static u32 reset_cnt;
@@ -2791,14 +2679,12 @@ void dm_check_fsync(struct net_device *dev)if (reg_c38_State) {write_nic_byte (dev, rOFDM0_RxDetector3, priv->framesync); reg_c38_State = RegC38_Default; -/*DbgPrint("Fsync is idle, rssi>=40, write 0xc38 = 0x%x\n", pHalData->framesync);*/ } } }else {if (reg_c38_State) {write_nic_byte (dev, rOFDM0_RxDetector3, priv->framesync); reg_c38_State = RegC38_Default; -/*DbgPrint("Fsync is idle, not connected, write 0xc38 = 0x%x\n", pHalData->framesync);*/ } } }
@@ -2808,13 +2694,11 @@ void dm_check_fsync(struct net_device *dev)write_nic_byte (dev, rOFDM0_RxDetector3, priv->framesync); reg_c38_State = RegC38_Default; reset_cnt = priv->reset_count; -/*DbgPrint("reg_c38_State = 0 for silent reset.\n");*/ } }else {if (reg_c38_State) {write_nic_byte (dev, rOFDM0_RxDetector3, priv->framesync); reg_c38_State = RegC38_Default; -/*DbgPrint("framesync no monitor, write 0xc38 = 0x%x\n", pHalData->framesync);*/ } } }
@@ -2856,7 +2740,6 @@ static void dm_dynamic_txpower(struct net_device *dev) priv->bDynamicTxLowPower = false;return ; } -/*printk("priv->ieee80211->current_network.unknown_cap_exist is %d , priv->ieee80211->current_network.broadcom_cap_exist is %d\n", priv->ieee80211->current_network.unknown_cap_exist, priv->ieee80211->current_network.broadcom_cap_exist);*/ if ((priv->ieee80211->current_network.atheros_cap_exist) && (priv->ieee80211->mode ==IEEE_G )) { txhipower_threshold =TX_POWER_ATHEROAP_THRESH_HIGH ; txlowpower_threshold =TX_POWER_ATHEROAP_THRESH_LOW ;
@@ -2865,7 +2748,6 @@ static void dm_dynamic_txpower(struct net_device *dev) txlowpower_threshold =TX_POWER_NEAR_FIELD_THRESH_LOW ; } -/*printk("=======>%s(): txhipower_threshold is %d, txlowpower_threshold is %d\n", __func__, txhipower_threshold, txlowpower_threshold);*/ RT_TRACE (COMP_TXAGC ,"priv->undecorated_smoothed_pwdb = %ld\n" , priv->undecorated_smoothed_pwdb);if (priv->ieee80211->state ==IEEE80211_LINKED ) {
@@ -2884,7 +2766,6 @@ static void dm_dynamic_txpower(struct net_device *dev) priv->bDynamicTxLowPower = false; } }else { -/*pHalData->bTXPowerCtrlforNearFarRange = !pHalData->bTXPowerCtrlforNearFarRange;*/ priv->bDynamicTxHighPower = false; priv->bDynamicTxLowPower = false; }
@@ -2911,14 +2792,10 @@ static void dm_check_txrateandretrycount(struct net_device *dev)struct r8192_priv *priv =ieee80211_priv (dev);struct ieee80211_device *ieee = priv->ieee80211;/* for 11n tx rate */ -/*priv->stats.CurrentShowTxate = read_nic_byte(dev, CURRENT_TX_RATE_REG);*/ read_nic_byte (dev,CURRENT_TX_RATE_REG , &ieee->softmac_stats.CurrentShowTxate); -/*printk("=============>tx_rate_reg:%x\n", ieee->softmac_stats.CurrentShowTxate);*/ /* for initial tx rate */ -/*priv->stats.last_packet_rate = read_nic_byte(dev, INITIAL_TX_RATE_REG);*/ read_nic_byte (dev,INITIAL_TX_RATE_REG , &ieee->softmac_stats.last_packet_rate);/* for tx retry count */ -/*priv->stats.txretrycount = read_nic_dword(dev, TX_RETRY_COUNT_REG);*/ read_nic_dword (dev,TX_RETRY_COUNT_REG , &ieee->softmac_stats.txretrycount); }
Signature · 1 line
2.34.1
PATCH v3 3/4 staging: rtl8192u: add '*' on subsequent lines in block comment
In reply to Khadija KamranLinux kernel coding style for block comments uses a column of '*' on the left side.
Fix block comment by adding '*' on subsequent lines as reported by checkatch.pl script.
--- drivers/staging/rtl8192u/r8192U_dm.c | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-)
drivers/staging/rtl8192u/r8192U_dm.c +9 -8
@@ -1,13 +1,14 @@// SPDX-License-Identifier: GPL-2.0 /*++ -Copyright-c Realtek Semiconductor Corp. All rights reserved. - -Module Name: -r8192U_dm.c - -Abstract: -HW dynamic mechanism. ---*/ +* Copyright-c Realtek Semiconductor Corp. All rights reserved. +* +* Module Name: +* r8192U_dm.c +* +* Abstract: +* HW dynamic mechanism. +*-- +*/ #include "r8192U.h" #include "r8192U_dm.h" #include "r8192U_hw.h"
Signature · 1 line
2.34.1
PATCH v3 4/4 staging: rtl8192u: add '*/' on separate line in block comments
In reply to Khadija KamranLinux kernel coding style uses '*/' on a separate line at the end of multi line comments.
Fix block comments by moving '*/' at the end of block comments on a separate line as reported by checkpatch.pl script.
--- drivers/staging/rtl8192u/r8192U_dm.c | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-)
drivers/staging/rtl8192u/r8192U_dm.c +14 -7
@@ -244,7 +244,8 @@ void init_rate_adaptive(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ static void dm_check_rate_adaptive (struct net_device *dev) {struct r8192_priv *priv =ieee80211_priv (dev);
@@ -1525,7 +1526,8 @@ static void dm_bb_initialgain_backup(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ static void dm_dig_init (struct net_device *dev) {struct r8192_priv *priv =ieee80211_priv (dev);
@@ -1565,7 +1567,8 @@ static void dm_dig_init(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ static void dm_ctrl_initgain_byrssi (struct net_device *dev) {if (!dm_digtable.dig_enable_flag)
@@ -1751,7 +1754,8 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm(* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ static void dm_ctrl_initgain_byrssi_highpwr (struct net_device *dev) {
@@ -2137,7 +2141,8 @@ static void dm_ctstoself(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ static void dm_check_pbc_gpio (struct net_device *dev) {struct r8192_priv *priv =ieee80211_priv (dev);
@@ -2166,7 +2171,8 @@ static void dm_check_pbc_gpio(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ void dm_rf_pathcheck_workitemcallback (struct work_struct *work) {struct delayed_work *dwork =to_delayed_work (work);
@@ -2407,7 +2413,8 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ static void dm_check_rx_path_selection (struct net_device *dev) {struct r8192_priv *priv =ieee80211_priv (dev);
Signature · 1 line
2.34.1
Re: [PATCH v3 4/4] staging: rtl8192u: add '*/' on separate line in block comments
Quoted 27 lines · Khadija Kamran
Linux kernel coding style uses '*/' on a separate line at the end of multi line comments.
Fix block comments by moving '*/' at the end of block comments on a separate line as reported by checkpatch.pl script.
Signed-off-by Khadija Kamran <[email protected]>--- drivers/staging/rtl8192u/r8192U_dm.c | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-)drivers/staging/rtl8192u/r8192U_dm.c +2
-1@@ -244,7 +244,8 @@ void init_rate_adaptive(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ <snipped>...
voiddm_rf_pathcheck_workitemcallback(struct work_struct *work){drivers/staging/rtl8192u/r8192U_dm.c +0
-0struct delayed_work *dwork =to_delayed_work (work);
drivers/staging/rtl8192u/r8192U_dm.c static void dm_rxpath_sel_byrssi(struct net_device *dev) · line 2417
Quoted 6 lines
drivers/staging/rtl8192u/r8192U_dm.c +2
-1@@ -2407,7 +2413,8 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/
While at above can you please turn these comments above into kernel-doc comments (see Documentation/doc-guide/kernel-doc.rst for how to write one)? This requires a placeholder doc where you can write e.g. overview of the driver and how it is used. The doc should be in Documentation/driver-api/staging/ (since this is staging driver).
Thanks.
Signature · 1 line
An old man doll... just what I always wanted! - Clara
Greg KH
maintainerRe: [PATCH v3 4/4] staging: rtl8192u: add '*/' on separate line in block comments
Quoted 32 lines · Bagas Sanjaya
Quoted 31 lines · Khadija Kamran
Linux kernel coding style uses '*/' on a separate line at the end of multi line comments.
Fix block comments by moving '*/' at the end of block comments on a separate line as reported by checkpatch.pl script.
Signed-off-by Khadija Kamran <[email protected]>--- drivers/staging/rtl8192u/r8192U_dm.c | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-)drivers/staging/rtl8192u/r8192U_dm.c +2
-1@@ -244,7 +244,8 @@ void init_rate_adaptive(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/ +*--------------------------------------------------------------------------- +*/ <snipped>...
voiddm_rf_pathcheck_workitemcallback(struct work_struct *work){drivers/staging/rtl8192u/r8192U_dm.c +0
-1struct delayed_work *dwork =to_delayed_work (work);@@ -2407,7 +2413,8 @@ static void dm_rxpath_sel_byrssi(struct net_device *dev)* Output: NONE * * Return: NONE -*---------------------------------------------------------------------------*/
Quoted 8 lines
drivers/staging/rtl8192u/r8192U_dm.c static void dm_rxpath_sel_byrssi(struct net_device *dev) · line 2417
Quoted 2 lines
drivers/staging/rtl8192u/r8192U_dm.c +2
-0+*--------------------------------------------------------------------------- +*/ While at above can you please turn these comments above into kernel-doc comments (see
Documentation/doc-guide/kernel-doc.rstfor how to write one)? This requires a placeholder doc where you can write e.g. overview of the driver and how it is used. The doc should be inDocumentation/driver-api/staging/(since this is staging driver).
No, these are static functions, or just normal internal-to-the-driver functions, they do not need kerneldoc or any Documentation/* entries, sorry.
greg k-h
Re: [PATCH v3 4/4] staging: rtl8192u: add '*/' on separate line in block comments
Quoted 10 lines · Greg KH
Quoted 5 lines
While at above can you please turn these comments above into kernel-doc comments (see
Documentation/doc-guide/kernel-doc.rstfor how to write one)? This requires a placeholder doc where you can write e.g. overview of the driver and how it is used. The doc should be inDocumentation/driver-api/staging/(since this is staging driver).No, these are static functions, or just normal internal-to-the-driver functions, they do not need kerneldoc or any
Documentation/*entries, sorry.
Ah! I don't see the context behind the comments, thanks anyway!
Signature · 1 line
An old man doll... just what I always wanted! - Clara