[PATCH 1/1] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[PATCH 1/1] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Amaury Denoyelle]

This patch fixes coding style errors reported by checkpatch.pl for
cb_pcidas64.c, about too long source code lines.

Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
---
 drivers/staging/comedi/drivers/cb_pcidas64.c | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
index a94c33c..8c2d1d9 100644
--- a/drivers/staging/comedi/drivers/cb_pcidas64.c
+++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
@@ -243,7 +243,8 @@ enum adc_control0_contents {
 	ADC_SOFT_GATE_BITS = 0x1,	/*  software gate */
 	ADC_EXT_GATE_BITS = 0x2,	/*  external digital gate */
 	ADC_ANALOG_GATE_BITS = 0x3,	/*  analog level gate */
-	ADC_GATE_LEVEL_BIT = 0x4,	/*  level-sensitive gate (for digital) */
+	/*  level-sensitive gate (for digital) */
+	ADC_GATE_LEVEL_BIT = 0x4,
 	ADC_GATE_POLARITY_BIT = 0x8,	/*  gate active low */
 	ADC_START_TRIG_SOFT_BITS = 0x10,
 	ADC_START_TRIG_EXT_BITS = 0x20,
@@ -1381,7 +1382,8 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
 	return devpriv->ai_fifo_segment_length;
 }
 
-/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
+/* adjusts the size of hardware fifo
+ * (which determines block size for dma xfers) */
 static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
 {
 	const struct pcidas64_board *thisboard = dev->board_ptr;
@@ -1588,7 +1590,8 @@ static inline void warn_external_queue(struct comedi_device *dev)
 		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
 }
 
-/* Their i2c requires a huge delay on setting clock or data high for some reason */
+/* Their i2c requires a huge delay on setting clock or data high for some
+ * reason */
 static const int i2c_high_udelay = 1000;
 static const int i2c_low_udelay = 10;
 
@@ -1987,8 +1990,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
 
 /* utility function that rounds desired timing to an achievable time, and
  * sets cmd members appropriately.
- * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
- */
+ * adc paces conversions from master clock by dividing by (x + 3) where x is
+ * 24 bit number */
 static void check_adc_timing(struct comedi_device *dev, struct comedi_cmd *cmd)
 {
 	const struct pcidas64_board *thisboard = dev->board_ptr;
-- 
2.4.1

Re: [PATCH 1/1] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Sudip Mukherjee]

On Sun, May 17, 2015 at 04:47:23PM +0200, Amaury Denoyelle wrote:
> This patch fixes coding style errors reported by checkpatch.pl for
> cb_pcidas64.c, about too long source code lines.
> 
> Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
> ---
<snip>
>  }
>  
> -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
> +/* adjusts the size of hardware fifo
> + * (which determines block size for dma xfers) */

This is not the style for multi-line comments. Please check CodingStyle
in Documentation.

>  static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
>  {
<snip>	
>  
> @@ -1987,8 +1990,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
>  
>  /* utility function that rounds desired timing to an achievable time, and
>   * sets cmd members appropriately.
> - * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
> - */
> + * adc paces conversions from master clock by dividing by (x + 3) where x is
> + * 24 bit number */
same here

and when you are sending just one patch, you do not need to mention
[Patch 1/1] in the subject. just mention [Patch]

regards
sudip

[PATCH v2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Amaury Denoyelle]

[-- Attachment #1: Type: text/plain, Size: 1813 bytes --]

Sudip Mukherjee <sudipm.mukherjee@gmail.com> wrote:

> On Sun, May 17, 2015 at 04:47:23PM +0200, Amaury Denoyelle wrote:
> > This patch fixes coding style errors reported by checkpatch.pl for
> > cb_pcidas64.c, about too long source code lines.
> > 
> > Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
> > ---
> <snip>
> >  }
> >  
> > -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
> > +/* adjusts the size of hardware fifo
> > + * (which determines block size for dma xfers) */
> 
> This is not the style for multi-line comments. Please check CodingStyle
> in Documentation.
> 
> >  static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
> >  {
> <snip>	
> >  
> > @@ -1987,8 +1990,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
> >  
> >  /* utility function that rounds desired timing to an achievable time, and
> >   * sets cmd members appropriately.
> > - * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
> > - */
> > + * adc paces conversions from master clock by dividing by (x + 3) where x is
> > + * 24 bit number */
> same here
> 
> and when you are sending just one patch, you do not need to mention
> [Patch 1/1] in the subject. just mention [Patch]
> 
> regards
> sudip

Thanks for your review. I was aware of the coding style for multi-line comments, but I chose to follow the same convention already used in the source file.

I submit a new version where I respect the coding style in the comments I fixed. I editted only multi-line comments that were too long, in order to not have a messy patch. If you think it's better to be done, maybe I could submit a two-part patch.

regards,

-- 
Amaury Denoyelle

[-- Attachment #2: 0001-Staging-comedi-fix-line-longer-than-80-chars-in-cb_p.patch --]
[-- Type: text/x-diff, Size: 2888 bytes --]

From f91eadba14278565683f4ea950e94f69c2822c1d Mon Sep 17 00:00:00 2001
From: Amaury Denoyelle <amaury.denoyelle@gmail.com>
Date: Sun, 17 May 2015 15:53:50 +0200
Subject: [PATCH v2] Staging: comedi: fix line longer than 80 chars in
 cb_pcidas64.c

This patch fixes coding style errors reported by checkpatch.pl for
cb_pcidas64.c, about too long source code lines.
Adjust edited multi-line comments according to kernel coding style

Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
---
 drivers/staging/comedi/drivers/cb_pcidas64.c | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
index a94c33c..dc2d884 100644
--- a/drivers/staging/comedi/drivers/cb_pcidas64.c
+++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
@@ -243,7 +243,8 @@ enum adc_control0_contents {
 	ADC_SOFT_GATE_BITS = 0x1,	/*  software gate */
 	ADC_EXT_GATE_BITS = 0x2,	/*  external digital gate */
 	ADC_ANALOG_GATE_BITS = 0x3,	/*  analog level gate */
-	ADC_GATE_LEVEL_BIT = 0x4,	/*  level-sensitive gate (for digital) */
+	/*  level-sensitive gate (for digital) */
+	ADC_GATE_LEVEL_BIT = 0x4,
 	ADC_GATE_POLARITY_BIT = 0x8,	/*  gate active low */
 	ADC_START_TRIG_SOFT_BITS = 0x10,
 	ADC_START_TRIG_EXT_BITS = 0x20,
@@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
 	return devpriv->ai_fifo_segment_length;
 }
 
-/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
+/*
+ * adjusts the size of hardware fifo (which determines block size for dma xfers)
+ */
 static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
 {
 	const struct pcidas64_board *thisboard = dev->board_ptr;
@@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
 		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
 }
 
-/* Their i2c requires a huge delay on setting clock or data high for some reason */
+/*
+ * their i2c requires a huge delay on setting clock or data high for some reason
+ */
 static const int i2c_high_udelay = 1000;
 static const int i2c_low_udelay = 10;
 
@@ -1985,9 +1990,11 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
 	return divisor;
 }
 
-/* utility function that rounds desired timing to an achievable time, and
+/*
+ * utility function that rounds desired timing to an achievable time, and
  * sets cmd members appropriately.
- * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
+ * adc paces conversions from master clock by dividing by (x + 3) where x is
+ * 24 bit number
  */
 static void check_adc_timing(struct comedi_device *dev, struct comedi_cmd *cmd)
 {
-- 
2.4.1

Re: [PATCH v2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Amaury Denoyelle]

> Sudip Mukherjee <sudipm.mukherjee@gmail.com> wrote:
> 
> > On Sun, May 17, 2015 at 04:47:23PM +0200, Amaury Denoyelle wrote:
> > > This patch fixes coding style errors reported by checkpatch.pl for
> > > cb_pcidas64.c, about too long source code lines.
> > > 
> > > Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
> > > ---
> > <snip>
> > >  }
> > >  
> > > -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
> > > +/* adjusts the size of hardware fifo
> > > + * (which determines block size for dma xfers) */
> > 
> > This is not the style for multi-line comments. Please check CodingStyle
> > in Documentation.
> > 
> > >  static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
> > >  {
> > <snip>	
> > >  
> > > @@ -1987,8 +1990,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
> > >  
> > >  /* utility function that rounds desired timing to an achievable time, and
> > >   * sets cmd members appropriately.
> > > - * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
> > > - */
> > > + * adc paces conversions from master clock by dividing by (x + 3) where x is
> > > + * 24 bit number */
> > same here
> > 
> > and when you are sending just one patch, you do not need to mention
> > [Patch 1/1] in the subject. just mention [Patch]
> > 
> > regards
> > sudip
> 

Looks like I did not properly joined patch with previous mail, so I resend it.
Really sorry for the noise...

So, like I was stated in previous mail;

Thanks for your review. I was aware of the coding style for multi-line comments, but I chose to follow the same convention already used in the source file.

I submit a new version where I respect the coding style in the comments I fixed. I editted only multi-line comments that were too long, in order to not have a messy patch. If you think it's better to be done, maybe I could submit a two-part patch.

Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
---
 drivers/staging/comedi/drivers/cb_pcidas64.c | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
index a94c33c..dc2d884 100644
--- a/drivers/staging/comedi/drivers/cb_pcidas64.c
+++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
@@ -243,7 +243,8 @@ enum adc_control0_contents {
 	ADC_SOFT_GATE_BITS = 0x1,	/*  software gate */
 	ADC_EXT_GATE_BITS = 0x2,	/*  external digital gate */
 	ADC_ANALOG_GATE_BITS = 0x3,	/*  analog level gate */
-	ADC_GATE_LEVEL_BIT = 0x4,	/*  level-sensitive gate (for digital) */
+	/*  level-sensitive gate (for digital) */
+	ADC_GATE_LEVEL_BIT = 0x4,
 	ADC_GATE_POLARITY_BIT = 0x8,	/*  gate active low */
 	ADC_START_TRIG_SOFT_BITS = 0x10,
 	ADC_START_TRIG_EXT_BITS = 0x20,
@@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
 	return devpriv->ai_fifo_segment_length;
 }
 
-/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
+/*
+ * adjusts the size of hardware fifo (which determines block size for dma xfers)
+ */
 static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
 {
 	const struct pcidas64_board *thisboard = dev->board_ptr;
@@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
 		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
 }
 
-/* Their i2c requires a huge delay on setting clock or data high for some reason */
+/*
+ * their i2c requires a huge delay on setting clock or data high for some reason
+ */
 static const int i2c_high_udelay = 1000;
 static const int i2c_low_udelay = 10;
 
@@ -1985,9 +1990,11 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
 	return divisor;
 }
 
-/* utility function that rounds desired timing to an achievable time, and
+/*
+ * utility function that rounds desired timing to an achievable time, and
  * sets cmd members appropriately.
- * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
+ * adc paces conversions from master clock by dividing by (x + 3) where x is
+ * 24 bit number
  */
 static void check_adc_timing(struct comedi_device *dev, struct comedi_cmd *cmd)
 {
-- 
2.4.1

Re: [PATCH v2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Sudip Mukherjee]

On Mon, May 18, 2015 at 08:51:29PM +0200, Amaury Denoyelle wrote:
> > Sudip Mukherjee <sudipm.mukherjee@gmail.com> wrote:
> > 
> > > On Sun, May 17, 2015 at 04:47:23PM +0200, Amaury Denoyelle wrote:
> Thanks for your review. I was aware of the coding style for multi-line comments, but I chose to follow the same convention already used in the source file.
> 
> I submit a new version where I respect the coding style in the comments I fixed. I editted only multi-line comments that were too long, in order to not have a messy patch. If you think it's better to be done, maybe I could submit a two-part patch.

please send that way.
And while replying please linewrap your reply to 72 char.

regards
sudip

[PATCH v3 0/2] staging: comedi: fix coding style in cb_pcidas64.c

[Amaury Denoyelle]

These two patches fixes various coding style error in cb_pcidas64.c file.

1/2:
- address line longer than 80 characters
2/2:
- format multi-line comments according to the kernel coding style

Amaury Denoyelle (2):
  Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c
  Staging: comedi: fix style for multi-line comments in cb_pcidas64.c

 drivers/staging/comedi/drivers/cb_pcidas64.c | 154 ++++++++++++++++++---------
 1 file changed, 103 insertions(+), 51 deletions(-)

-- 
2.4.1

[PATCH v3 1/2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Amaury Denoyelle]

This patch fixes coding style errors reported by checkpatch.pl for
cb_pcidas64.c, about too long source code lines.

Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
---
 drivers/staging/comedi/drivers/cb_pcidas64.c | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
index a94c33c..f1bba2b 100644
--- a/drivers/staging/comedi/drivers/cb_pcidas64.c
+++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
@@ -243,7 +243,8 @@ enum adc_control0_contents {
 	ADC_SOFT_GATE_BITS = 0x1,	/*  software gate */
 	ADC_EXT_GATE_BITS = 0x2,	/*  external digital gate */
 	ADC_ANALOG_GATE_BITS = 0x3,	/*  analog level gate */
-	ADC_GATE_LEVEL_BIT = 0x4,	/*  level-sensitive gate (for digital) */
+	/*  level-sensitive gate (for digital) */
+	ADC_GATE_LEVEL_BIT = 0x4,
 	ADC_GATE_POLARITY_BIT = 0x8,	/*  gate active low */
 	ADC_START_TRIG_SOFT_BITS = 0x10,
 	ADC_START_TRIG_EXT_BITS = 0x20,
@@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
 	return devpriv->ai_fifo_segment_length;
 }
 
-/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
+/*
+ * adjusts the size of hardware fifo (which determines block size for dma xfers)
+ */
 static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
 {
 	const struct pcidas64_board *thisboard = dev->board_ptr;
@@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
 		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
 }
 
-/* Their i2c requires a huge delay on setting clock or data high for some reason */
+/*
+ * their i2c requires a huge delay on setting clock or data high for some reason
+ */
 static const int i2c_high_udelay = 1000;
 static const int i2c_low_udelay = 10;
 
@@ -1987,7 +1992,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
 
 /* utility function that rounds desired timing to an achievable time, and
  * sets cmd members appropriately.
- * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
+ * adc paces conversions from master clock by dividing by (x + 3) where x is
+ * 24 bit number
  */
 static void check_adc_timing(struct comedi_device *dev, struct comedi_cmd *cmd)
 {
-- 
2.4.1

Re: [PATCH v3 1/2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Sudip Mukherjee]

On Tue, May 19, 2015 at 07:57:49PM +0200, Amaury Denoyelle wrote:
> This patch fixes coding style errors reported by checkpatch.pl for
> cb_pcidas64.c, about too long source code lines.
> 
> Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
> ---
>  drivers/staging/comedi/drivers/cb_pcidas64.c | 14 ++++++++++----
>  1 file changed, 10 insertions(+), 4 deletions(-)
> 
> diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
> index a94c33c..f1bba2b 100644
> --- a/drivers/staging/comedi/drivers/cb_pcidas64.c
> +++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
<snip>
> @@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
>  	return devpriv->ai_fifo_segment_length;
>  }
>  
> -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
> +/*
> + * adjusts the size of hardware fifo (which determines block size for dma xfers)
> + */
I did not understand this one. You are not breaking the comment into
two lines, then why multiline style?

>  	const struct pcidas64_board *thisboard = dev->board_ptr;
> @@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
>  		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
>  }
>  
> -/* Their i2c requires a huge delay on setting clock or data high for some reason */
> +/*
> + * their i2c requires a huge delay on setting clock or data high for some reason
> + */
same here.

regards
sudip

Re: [PATCH v3 1/2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Amaury Denoyelle]

Sudip Mukherjee <sudipm.mukherjee@gmail.com> wrote:

> On Tue, May 19, 2015 at 07:57:49PM +0200, Amaury Denoyelle wrote:
> <snip>
> > @@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
> >  	return devpriv->ai_fifo_segment_length;
> >  }
> >  
> > -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
> > +/*
> > + * adjusts the size of hardware fifo (which determines block size for dma xfers)
> > + */
> I did not understand this one. You are not breaking the comment into
> two lines, then why multiline style?
> 
> >  	const struct pcidas64_board *thisboard = dev->board_ptr;
> > @@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
> >  		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
> >  }
> >  
> > -/* Their i2c requires a huge delay on setting clock or data high for some reason */
> > +/*
> > + * their i2c requires a huge delay on setting clock or data high for some reason
> > + */
> same here.
> 

The single-line version of these comments are over 80 characters (just
because of the "*/" characters), so I had to split them over several
lines.

What is the proper formatting to use for this case ?

regards,

-- 
Amaury Denoyelle

Re: [PATCH v3 1/2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Sudip Mukherjee]

On Wed, May 20, 2015 at 09:24:18AM +0200, Amaury Denoyelle wrote:
> Sudip Mukherjee <sudipm.mukherjee@gmail.com> wrote:
> 
> > On Tue, May 19, 2015 at 07:57:49PM +0200, Amaury Denoyelle wrote:
> > <snip>
> > > @@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
> > >  	return devpriv->ai_fifo_segment_length;
> > >  }
> > >  
> > > -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
> > > +/*
> > > + * adjusts the size of hardware fifo (which determines block size for dma xfers)
> > > + */
> > I did not understand this one. You are not breaking the comment into
> > two lines, then why multiline style?
> > 
> > >  	const struct pcidas64_board *thisboard = dev->board_ptr;
> > > @@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
> > >  		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
> > >  }
> > >  
> > > -/* Their i2c requires a huge delay on setting clock or data high for some reason */
> > > +/*
> > > + * their i2c requires a huge delay on setting clock or data high for some reason
> > > + */
> > same here.
> > 
> 
> The single-line version of these comments are over 80 characters (just
> because of the "*/" characters), so I had to split them over several
> lines.
yes, i noticed. its almost 84 char. but after applying your patch also
it comes to 81.

what about:

/*
 * Their i2c requires a huge delay on setting clock or data high
 * for some reason
 */ 

regards
sudip

Re: [PATCH v3 1/2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Ian Abbott]

On 20/05/15 09:22, Sudip Mukherjee wrote:
> On Wed, May 20, 2015 at 09:24:18AM +0200, Amaury Denoyelle wrote:
>> Sudip Mukherjee <sudipm.mukherjee@gmail.com> wrote:
>>
>>> On Tue, May 19, 2015 at 07:57:49PM +0200, Amaury Denoyelle wrote:
>>> <snip>
>>>> @@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
>>>>   	return devpriv->ai_fifo_segment_length;
>>>>   }
>>>>
>>>> -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
>>>> +/*
>>>> + * adjusts the size of hardware fifo (which determines block size for dma xfers)
>>>> + */
>>> I did not understand this one. You are not breaking the comment into
>>> two lines, then why multiline style?
>>>
>>>>   	const struct pcidas64_board *thisboard = dev->board_ptr;
>>>> @@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
>>>>   		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
>>>>   }
>>>>
>>>> -/* Their i2c requires a huge delay on setting clock or data high for some reason */
>>>> +/*
>>>> + * their i2c requires a huge delay on setting clock or data high for some reason
>>>> + */
>>> same here.
>>>
>>
>> The single-line version of these comments are over 80 characters (just
>> because of the "*/" characters), so I had to split them over several
>> lines.
> yes, i noticed. its almost 84 char. but after applying your patch also
> it comes to 81.

Really?  I only see 80 characters.

-- 
-=( Ian Abbott @ MEV Ltd.    E-mail: <abbotti@mev.co.uk> )=-
-=(                          Web: http://www.mev.co.uk/  )=-

Re: [PATCH v3 1/2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Sudip Mukherjee]

On Wed, May 20, 2015 at 10:00:45AM +0100, Ian Abbott wrote:
> On 20/05/15 09:22, Sudip Mukherjee wrote:
> >On Wed, May 20, 2015 at 09:24:18AM +0200, Amaury Denoyelle wrote:
> >>Sudip Mukherjee <sudipm.mukherjee@gmail.com> wrote:
> >>
> >>>On Tue, May 19, 2015 at 07:57:49PM +0200, Amaury Denoyelle wrote:
> >>><snip>
> >yes, i noticed. its almost 84 char. but after applying your patch also
> >it comes to 81.
> 
> Really?  I only see 80 characters.
yeah, i am also seeing 80 now. sorry for the noise.

regards
sudip
> 
> -- 
> -=( Ian Abbott @ MEV Ltd.    E-mail: <abbotti@mev.co.uk> )=-
> -=(                          Web: http://www.mev.co.uk/  )=-

Re: [PATCH v3 1/2] Staging: comedi: fix line longer than 80 chars in cb_pcidas64.c

[Ian Abbott]

On 19/05/15 18:57, Amaury Denoyelle wrote:
> This patch fixes coding style errors reported by checkpatch.pl for
> cb_pcidas64.c, about too long source code lines.
>
> Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
> ---
>   drivers/staging/comedi/drivers/cb_pcidas64.c | 14 ++++++++++----
>   1 file changed, 10 insertions(+), 4 deletions(-)
>
> diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
> index a94c33c..f1bba2b 100644
> --- a/drivers/staging/comedi/drivers/cb_pcidas64.c
> +++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
> @@ -243,7 +243,8 @@ enum adc_control0_contents {
>   	ADC_SOFT_GATE_BITS = 0x1,	/*  software gate */
>   	ADC_EXT_GATE_BITS = 0x2,	/*  external digital gate */
>   	ADC_ANALOG_GATE_BITS = 0x3,	/*  analog level gate */
> -	ADC_GATE_LEVEL_BIT = 0x4,	/*  level-sensitive gate (for digital) */
> +	/*  level-sensitive gate (for digital) */
> +	ADC_GATE_LEVEL_BIT = 0x4,
>   	ADC_GATE_POLARITY_BIT = 0x8,	/*  gate active low */
>   	ADC_START_TRIG_SOFT_BITS = 0x10,
>   	ADC_START_TRIG_EXT_BITS = 0x20,
> @@ -1381,7 +1382,9 @@ static int set_ai_fifo_segment_length(struct comedi_device *dev,
>   	return devpriv->ai_fifo_segment_length;
>   }
>
> -/* adjusts the size of hardware fifo (which determines block size for dma xfers) */
> +/*
> + * adjusts the size of hardware fifo (which determines block size for dma xfers)
> + */
>   static int set_ai_fifo_size(struct comedi_device *dev, unsigned int num_samples)
>   {
>   	const struct pcidas64_board *thisboard = dev->board_ptr;
> @@ -1588,7 +1591,9 @@ static inline void warn_external_queue(struct comedi_device *dev)
>   		"Use internal AI channel queue (channels must be consecutive and use same range/aref)\n");
>   }
>
> -/* Their i2c requires a huge delay on setting clock or data high for some reason */
> +/*
> + * their i2c requires a huge delay on setting clock or data high for some reason
> + */
>   static const int i2c_high_udelay = 1000;
>   static const int i2c_low_udelay = 10;
>
> @@ -1987,7 +1992,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
>
>   /* utility function that rounds desired timing to an achievable time, and
>    * sets cmd members appropriately.
> - * adc paces conversions from master clock by dividing by (x + 3) where x is 24 bit number
> + * adc paces conversions from master clock by dividing by (x + 3) where x is
> + * 24 bit number
>    */
>   static void check_adc_timing(struct comedi_device *dev, struct comedi_cmd *cmd)
>   {
>

Looks good.

Reviewed-by: Ian Abbott <abbotti@mev.co.uk>

-- 
-=( Ian Abbott @ MEV Ltd.    E-mail: <abbotti@mev.co.uk> )=-
-=(                          Web: http://www.mev.co.uk/  )=-

[PATCH v3 2/2] Staging: comedi: fix style for multi-line comments in cb_pcidas64.c

[Amaury Denoyelle]

This patch reformat multi-line comments which are not properly written
according to the kernel coding style in cb_pcidas64.c

Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
---
 drivers/staging/comedi/drivers/cb_pcidas64.c | 140 ++++++++++++++++++---------
 1 file changed, 93 insertions(+), 47 deletions(-)

diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
index f1bba2b..3d646c1 100644
--- a/drivers/staging/comedi/drivers/cb_pcidas64.c
+++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
@@ -155,8 +155,10 @@ static inline unsigned int dac_msb_4020_reg(unsigned int channel)
 }
 
 enum read_only_registers {
-	/*  hardware status register,
-	 *  reading this apparently clears pending interrupts as well */
+	/*
+	 * hardware status register,
+	 * reading this apparently clears pending interrupts as well
+	 */
 	HW_STATUS_REG = 0x0,
 	PIPE1_READ_REG = 0x4,
 	ADC_READ_PNTR_REG = 0x8,
@@ -301,7 +303,8 @@ enum calibration_contents {
 	CAL_GAIN_BIT = 0x800,
 };
 
-/* calibration sources for 6025 are:
+/*
+ * calibration sources for 6025 are:
  *  0 : ground
  *  1 : 10V
  *  2 : 5V
@@ -661,8 +664,10 @@ static const struct hw_fifo_info ai_fifo_60xx = {
 	.fifo_size_reg_mask = 0x7f,
 };
 
-/* maximum number of dma transfers we will chain together into a ring
- * (and the maximum number of dma buffers we maintain) */
+/*
+ * maximum number of dma transfers we will chain together into a ring
+ * (and the maximum number of dma buffers we maintain)
+ */
 #define MAX_AI_DMA_RING_COUNT (0x80000 / DMA_BUFFER_SIZE)
 #define MIN_AI_DMA_RING_COUNT (0x10000 / DMA_BUFFER_SIZE)
 #define AO_DMA_RING_COUNT (0x10000 / DMA_BUFFER_SIZE)
@@ -1261,8 +1266,10 @@ static void enable_ai_interrupts(struct comedi_device *dev,
 
 	bits = EN_ADC_OVERRUN_BIT | EN_ADC_DONE_INTR_BIT |
 	       EN_ADC_ACTIVE_INTR_BIT | EN_ADC_STOP_INTR_BIT;
-	/*  Use pio transfer and interrupt on end of conversion
-	 *  if CMDF_WAKE_EOS flag is set. */
+	/*
+	 * Use pio transfer and interrupt on end of conversion
+	 * if CMDF_WAKE_EOS flag is set.
+	 */
 	if (cmd->flags & CMDF_WAKE_EOS) {
 		/*  4020 doesn't support pio transfers except for fifo dregs */
 		if (thisboard->layout != LAYOUT_4020)
@@ -1425,8 +1432,10 @@ static void init_stc_registers(struct comedi_device *dev)
 
 	spin_lock_irqsave(&dev->spinlock, flags);
 
-	/*  bit should be set for 6025,
-	 *  although docs say boards with <= 16 chans should be cleared XXX */
+	/*
+	 * bit should be set for 6025,
+	 * although docs say boards with <= 16 chans should be cleared XXX
+	 */
 	if (1)
 		devpriv->adc_control1_bits |= ADC_QUEUE_CONFIG_BIT;
 	writew(devpriv->adc_control1_bits,
@@ -1689,8 +1698,10 @@ static void i2c_write(struct comedi_device *dev, unsigned int address,
 	uint8_t bitstream;
 	static const int read_bit = 0x1;
 
-	/* XXX need mutex to prevent simultaneous attempts to access
-	 * eeprom and i2c bus */
+	/*
+	 * XXX need mutex to prevent simultaneous attempts to access
+	 * eeprom and i2c bus
+	 */
 
 	/*  make sure we dont send anything to eeprom */
 	devpriv->plx_control_bits &= ~CTL_EE_CS;
@@ -1782,14 +1793,18 @@ static int ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
 				cal_en_bit = CAL_EN_60XX_BIT;
 			else
 				cal_en_bit = CAL_EN_64XX_BIT;
-			/*  select internal reference source to connect
-			 *  to channel 0 */
+			/*
+			 * select internal reference source to connect
+			 * to channel 0
+			 */
 			writew(cal_en_bit |
 			       adc_src_bits(devpriv->calibration_source),
 			       devpriv->main_iobase + CALIBRATION_REG);
 		} else {
-			/*  make sure internal calibration source
-			 *  is turned off */
+			/*
+			 * make sure internal calibration source
+			 * is turned off
+			 */
 			writew(0, devpriv->main_iobase + CALIBRATION_REG);
 		}
 		/*  load internal queue */
@@ -1821,8 +1836,10 @@ static int ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
 			devpriv->i2c_cal_range_bits |= attenuate_bit(channel);
 		else
 			devpriv->i2c_cal_range_bits &= ~attenuate_bit(channel);
-		/*  update calibration/range i2c register only if necessary,
-		 *  as it is very slow */
+		/*
+		 * update calibration/range i2c register only if necessary,
+		 * as it is very slow
+		 */
 		if (old_cal_range_bits != devpriv->i2c_cal_range_bits) {
 			uint8_t i2c_data = devpriv->i2c_cal_range_bits;
 
@@ -1830,10 +1847,12 @@ static int ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
 				  sizeof(i2c_data));
 		}
 
-		/* 4020 manual asks that sample interval register to be set
+		/*
+		 * 4020 manual asks that sample interval register to be set
 		 * before writing to convert register.
 		 * Using somewhat arbitrary setting of 4 master clock ticks
-		 * = 0.1 usec */
+		 * = 0.1 usec
+		 */
 		writew(0, devpriv->main_iobase + ADC_SAMPLE_INTERVAL_UPPER_REG);
 		writew(2, devpriv->main_iobase + ADC_SAMPLE_INTERVAL_LOWER_REG);
 	}
@@ -1968,9 +1987,11 @@ static int ai_config_insn(struct comedi_device *dev, struct comedi_subdevice *s,
 	return -EINVAL;
 }
 
-/* Gets nearest achievable timing given master clock speed, does not
+/*
+ * Gets nearest achievable timing given master clock speed, does not
  * take into account possible minimum/maximum divisor values.  Used
- * by other timing checking functions. */
+ * by other timing checking functions.
+ */
 static unsigned int get_divisor(unsigned int ns, unsigned int flags)
 {
 	unsigned int divisor;
@@ -1990,7 +2011,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
 	return divisor;
 }
 
-/* utility function that rounds desired timing to an achievable time, and
+/*
+ * utility function that rounds desired timing to an achievable time, and
  * sets cmd members appropriately.
  * adc paces conversions from master clock by dividing by (x + 3) where x is
  * 24 bit number
@@ -2474,8 +2496,10 @@ static int setup_channel_queue(struct comedi_device *dev,
 				       devpriv->main_iobase +
 				       ADC_QUEUE_FIFO_REG);
 			}
-			/* doing a queue clear is not specified in board docs,
-			 * but required for reliable operation */
+			/*
+			 * doing a queue clear is not specified in board docs,
+			 * but required for reliable operation
+			 */
 			writew(0, devpriv->main_iobase + ADC_QUEUE_CLEAR_REG);
 			/*  prime queue holding register */
 			writew(0, devpriv->main_iobase + ADC_QUEUE_LOAD_REG);
@@ -2498,8 +2522,10 @@ static int setup_channel_queue(struct comedi_device *dev,
 				devpriv->i2c_cal_range_bits &=
 					~attenuate_bit(channel);
 		}
-		/*  update calibration/range i2c register only if necessary,
-		 *  as it is very slow */
+		/*
+		 * update calibration/range i2c register only if necessary,
+		 * as it is very slow
+		 */
 		if (old_cal_range_bits != devpriv->i2c_cal_range_bits) {
 			uint8_t i2c_data = devpriv->i2c_cal_range_bits;
 
@@ -2516,11 +2542,13 @@ static inline void load_first_dma_descriptor(struct comedi_device *dev,
 {
 	struct pcidas64_private *devpriv = dev->private;
 
-	/* The transfer size, pci address, and local address registers
+	/*
+	 * The transfer size, pci address, and local address registers
 	 * are supposedly unused during chained dma,
 	 * but I have found that left over values from last operation
 	 * occasionally cause problems with transfer of first dma
-	 * block.  Initializing them to zero seems to fix the problem. */
+	 * block.  Initializing them to zero seems to fix the problem.
+	 */
 	if (dma_channel) {
 		writel(0,
 		       devpriv->plx9080_iobase + PLX_DMA1_TRANSFER_SIZE_REG);
@@ -2675,15 +2703,19 @@ static void pio_drain_ai_fifo_16(struct comedi_device *dev)
 			     0x7fff;
 		write_index = readw(devpriv->main_iobase + ADC_WRITE_PNTR_REG) &
 			      0x7fff;
-		/* Get most significant bits (grey code).
+		/*
+		 * Get most significant bits (grey code).
 		 * Different boards use different code so use a scheme
 		 * that doesn't depend on encoding.  This read must
 		 * occur after reading least significant 15 bits to avoid race
-		 * with fifo switching to next segment. */
+		 * with fifo switching to next segment.
+		 */
 		prepost_bits = readw(devpriv->main_iobase + PREPOST_REG);
 
-		/* if read and write pointers are not on the same fifo segment,
-		 * read to the end of the read segment */
+		/*
+		 * if read and write pointers are not on the same fifo segment,
+		 * read to the end of the read segment
+		 */
 		read_segment = adc_upper_read_ptr_code(prepost_bits);
 		write_segment = adc_upper_write_ptr_code(prepost_bits);
 
@@ -2712,7 +2744,8 @@ static void pio_drain_ai_fifo_16(struct comedi_device *dev)
 	} while (read_segment != write_segment);
 }
 
-/* Read from 32 bit wide ai fifo of 4020 - deal with insane grey coding of
+/*
+ * Read from 32 bit wide ai fifo of 4020 - deal with insane grey coding of
  * pointers.  The pci-4020 hardware only supports dma transfers (it only
  * supports the use of pio for draining the last remaining points from the
  * fifo when a data acquisition operation has completed).
@@ -2790,8 +2823,10 @@ static void drain_dma_buffers(struct comedi_device *dev, unsigned int channel)
 		devpriv->ai_dma_index = (devpriv->ai_dma_index + 1) %
 					ai_dma_ring_count(thisboard);
 	}
-	/* XXX check for dma ring buffer overrun
-	 * (use end-of-chain bit to mark last unused buffer) */
+	/*
+	 * XXX check for dma ring buffer overrun
+	 * (use end-of-chain bit to mark last unused buffer)
+	 */
 }
 
 static void handle_ai_interrupt(struct comedi_device *dev,
@@ -2939,8 +2974,10 @@ static unsigned int load_ao_dma_buffer(struct comedi_device *dev,
 	next_bits = le32_to_cpu(devpriv->ao_dma_desc[buffer_index].next);
 	next_bits |= PLX_END_OF_CHAIN_BIT;
 	devpriv->ao_dma_desc[buffer_index].next = cpu_to_le32(next_bits);
-	/* clear end of chain bit on previous buffer now that we have set it
-	 * for the last buffer */
+	/*
+	 * clear end of chain bit on previous buffer now that we have set it
+	 * for the last buffer
+	 */
 	next_bits = le32_to_cpu(devpriv->ao_dma_desc[prev_buffer_index].next);
 	next_bits &= ~PLX_END_OF_CHAIN_BIT;
 	devpriv->ao_dma_desc[prev_buffer_index].next = cpu_to_le32(next_bits);
@@ -3033,9 +3070,11 @@ static irqreturn_t handle_interrupt(int irq, void *d)
 	plx_status = readl(devpriv->plx9080_iobase + PLX_INTRCS_REG);
 	status = readw(devpriv->main_iobase + HW_STATUS_REG);
 
-	/* an interrupt before all the postconfig stuff gets done could
+	/*
+	 * an interrupt before all the postconfig stuff gets done could
 	 * cause a NULL dereference if we continue through the
-	 * interrupt handler */
+	 * interrupt handler
+	 */
 	if (!dev->attached)
 		return IRQ_HANDLED;
 
@@ -3195,8 +3234,10 @@ static int prep_ao_dma(struct comedi_device *dev, const struct comedi_cmd *cmd)
 	unsigned int nbytes;
 	int i;
 
-	/* clear queue pointer too, since external queue has
-	 * weird interactions with ao fifo */
+	/*
+	 * clear queue pointer too, since external queue has
+	 * weird interactions with ao fifo
+	 */
 	writew(0, devpriv->main_iobase + ADC_QUEUE_CLEAR_REG);
 	writew(0, devpriv->main_iobase + DAC_BUFFER_CLEAR_REG);
 
@@ -3465,7 +3506,8 @@ static int dio_60xx_wbits(struct comedi_device *dev,
 	return insn->n;
 }
 
-/* pci-6025 8800 caldac:
+/*
+ * pci-6025 8800 caldac:
  * address 0 == dac channel 0 offset
  * address 1 == dac channel 0 gain
  * address 2 == dac channel 1 offset
@@ -3475,7 +3517,8 @@ static int dio_60xx_wbits(struct comedi_device *dev,
  * address 6 == coarse adc gain
  * address 7 == fine adc gain
  */
-/* pci-6402/16 uses all 8 channels for dac:
+/*
+ * pci-6402/16 uses all 8 channels for dac:
  * address 0 == dac channel 0 fine gain
  * address 1 == dac channel 0 coarse gain
  * address 2 == dac channel 0 coarse offset
@@ -3484,7 +3527,7 @@ static int dio_60xx_wbits(struct comedi_device *dev,
  * address 5 == dac channel 1 coarse gain
  * address 6 == dac channel 0 fine offset
  * address 7 == dac channel 1 fine offset
-*/
+ */
 
 static int caldac_8800_write(struct comedi_device *dev, unsigned int address,
 			     uint8_t value)
@@ -3744,7 +3787,8 @@ static int eeprom_read_insn(struct comedi_device *dev,
 	return 1;
 }
 
-/* Allocate and initialize the subdevice structures.
+/*
+ * Allocate and initialize the subdevice structures.
  */
 static int setup_subdevices(struct comedi_device *dev)
 {
@@ -3779,8 +3823,10 @@ static int setup_subdevices(struct comedi_device *dev)
 	s->cancel = ai_cancel;
 	if (thisboard->layout == LAYOUT_4020) {
 		uint8_t data;
-		/*  set adc to read from inputs
-		 *  (not internal calibration sources) */
+		/*
+		 * set adc to read from inputs
+		 * (not internal calibration sources)
+		 */
 		devpriv->i2c_cal_range_bits = adc_src_4020_bits(4);
 		/*  set channels to +-5 volt input ranges */
 		for (i = 0; i < s->n_chan; i++)
-- 
2.4.1

Re: [PATCH v3 2/2] Staging: comedi: fix style for multi-line comments in cb_pcidas64.c

[Ian Abbott]

On 19/05/15 18:57, Amaury Denoyelle wrote:
> This patch reformat multi-line comments which are not properly written
> according to the kernel coding style in cb_pcidas64.c
>
> Signed-off-by: Amaury Denoyelle <amaury.denoyelle@gmail.com>
> ---
>   drivers/staging/comedi/drivers/cb_pcidas64.c | 140 ++++++++++++++++++---------
>   1 file changed, 93 insertions(+), 47 deletions(-)
>
> diff --git a/drivers/staging/comedi/drivers/cb_pcidas64.c b/drivers/staging/comedi/drivers/cb_pcidas64.c
> index f1bba2b..3d646c1 100644
> --- a/drivers/staging/comedi/drivers/cb_pcidas64.c
> +++ b/drivers/staging/comedi/drivers/cb_pcidas64.c
> @@ -155,8 +155,10 @@ static inline unsigned int dac_msb_4020_reg(unsigned int channel)
>   }
>
>   enum read_only_registers {
> -	/*  hardware status register,
> -	 *  reading this apparently clears pending interrupts as well */
> +	/*
> +	 * hardware status register,
> +	 * reading this apparently clears pending interrupts as well
> +	 */
>   	HW_STATUS_REG = 0x0,
>   	PIPE1_READ_REG = 0x4,
>   	ADC_READ_PNTR_REG = 0x8,
> @@ -301,7 +303,8 @@ enum calibration_contents {
>   	CAL_GAIN_BIT = 0x800,
>   };
>
> -/* calibration sources for 6025 are:
> +/*
> + * calibration sources for 6025 are:
>    *  0 : ground
>    *  1 : 10V
>    *  2 : 5V
> @@ -661,8 +664,10 @@ static const struct hw_fifo_info ai_fifo_60xx = {
>   	.fifo_size_reg_mask = 0x7f,
>   };
>
> -/* maximum number of dma transfers we will chain together into a ring
> - * (and the maximum number of dma buffers we maintain) */
> +/*
> + * maximum number of dma transfers we will chain together into a ring
> + * (and the maximum number of dma buffers we maintain)
> + */
>   #define MAX_AI_DMA_RING_COUNT (0x80000 / DMA_BUFFER_SIZE)
>   #define MIN_AI_DMA_RING_COUNT (0x10000 / DMA_BUFFER_SIZE)
>   #define AO_DMA_RING_COUNT (0x10000 / DMA_BUFFER_SIZE)
> @@ -1261,8 +1266,10 @@ static void enable_ai_interrupts(struct comedi_device *dev,
>
>   	bits = EN_ADC_OVERRUN_BIT | EN_ADC_DONE_INTR_BIT |
>   	       EN_ADC_ACTIVE_INTR_BIT | EN_ADC_STOP_INTR_BIT;
> -	/*  Use pio transfer and interrupt on end of conversion
> -	 *  if CMDF_WAKE_EOS flag is set. */
> +	/*
> +	 * Use pio transfer and interrupt on end of conversion
> +	 * if CMDF_WAKE_EOS flag is set.
> +	 */
>   	if (cmd->flags & CMDF_WAKE_EOS) {
>   		/*  4020 doesn't support pio transfers except for fifo dregs */
>   		if (thisboard->layout != LAYOUT_4020)
> @@ -1425,8 +1432,10 @@ static void init_stc_registers(struct comedi_device *dev)
>
>   	spin_lock_irqsave(&dev->spinlock, flags);
>
> -	/*  bit should be set for 6025,
> -	 *  although docs say boards with <= 16 chans should be cleared XXX */
> +	/*
> +	 * bit should be set for 6025,
> +	 * although docs say boards with <= 16 chans should be cleared XXX
> +	 */
>   	if (1)
>   		devpriv->adc_control1_bits |= ADC_QUEUE_CONFIG_BIT;
>   	writew(devpriv->adc_control1_bits,
> @@ -1689,8 +1698,10 @@ static void i2c_write(struct comedi_device *dev, unsigned int address,
>   	uint8_t bitstream;
>   	static const int read_bit = 0x1;
>
> -	/* XXX need mutex to prevent simultaneous attempts to access
> -	 * eeprom and i2c bus */
> +	/*
> +	 * XXX need mutex to prevent simultaneous attempts to access
> +	 * eeprom and i2c bus
> +	 */
>
>   	/*  make sure we dont send anything to eeprom */
>   	devpriv->plx_control_bits &= ~CTL_EE_CS;
> @@ -1782,14 +1793,18 @@ static int ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
>   				cal_en_bit = CAL_EN_60XX_BIT;
>   			else
>   				cal_en_bit = CAL_EN_64XX_BIT;
> -			/*  select internal reference source to connect
> -			 *  to channel 0 */
> +			/*
> +			 * select internal reference source to connect
> +			 * to channel 0
> +			 */
>   			writew(cal_en_bit |
>   			       adc_src_bits(devpriv->calibration_source),
>   			       devpriv->main_iobase + CALIBRATION_REG);
>   		} else {
> -			/*  make sure internal calibration source
> -			 *  is turned off */
> +			/*
> +			 * make sure internal calibration source
> +			 * is turned off
> +			 */
>   			writew(0, devpriv->main_iobase + CALIBRATION_REG);
>   		}
>   		/*  load internal queue */
> @@ -1821,8 +1836,10 @@ static int ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
>   			devpriv->i2c_cal_range_bits |= attenuate_bit(channel);
>   		else
>   			devpriv->i2c_cal_range_bits &= ~attenuate_bit(channel);
> -		/*  update calibration/range i2c register only if necessary,
> -		 *  as it is very slow */
> +		/*
> +		 * update calibration/range i2c register only if necessary,
> +		 * as it is very slow
> +		 */
>   		if (old_cal_range_bits != devpriv->i2c_cal_range_bits) {
>   			uint8_t i2c_data = devpriv->i2c_cal_range_bits;
>
> @@ -1830,10 +1847,12 @@ static int ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
>   				  sizeof(i2c_data));
>   		}
>
> -		/* 4020 manual asks that sample interval register to be set
> +		/*
> +		 * 4020 manual asks that sample interval register to be set
>   		 * before writing to convert register.
>   		 * Using somewhat arbitrary setting of 4 master clock ticks
> -		 * = 0.1 usec */
> +		 * = 0.1 usec
> +		 */
>   		writew(0, devpriv->main_iobase + ADC_SAMPLE_INTERVAL_UPPER_REG);
>   		writew(2, devpriv->main_iobase + ADC_SAMPLE_INTERVAL_LOWER_REG);
>   	}
> @@ -1968,9 +1987,11 @@ static int ai_config_insn(struct comedi_device *dev, struct comedi_subdevice *s,
>   	return -EINVAL;
>   }
>
> -/* Gets nearest achievable timing given master clock speed, does not
> +/*
> + * Gets nearest achievable timing given master clock speed, does not
>    * take into account possible minimum/maximum divisor values.  Used
> - * by other timing checking functions. */
> + * by other timing checking functions.
> + */
>   static unsigned int get_divisor(unsigned int ns, unsigned int flags)
>   {
>   	unsigned int divisor;
> @@ -1990,7 +2011,8 @@ static unsigned int get_divisor(unsigned int ns, unsigned int flags)
>   	return divisor;
>   }
>
> -/* utility function that rounds desired timing to an achievable time, and
> +/*
> + * utility function that rounds desired timing to an achievable time, and
>    * sets cmd members appropriately.
>    * adc paces conversions from master clock by dividing by (x + 3) where x is
>    * 24 bit number
> @@ -2474,8 +2496,10 @@ static int setup_channel_queue(struct comedi_device *dev,
>   				       devpriv->main_iobase +
>   				       ADC_QUEUE_FIFO_REG);
>   			}
> -			/* doing a queue clear is not specified in board docs,
> -			 * but required for reliable operation */
> +			/*
> +			 * doing a queue clear is not specified in board docs,
> +			 * but required for reliable operation
> +			 */
>   			writew(0, devpriv->main_iobase + ADC_QUEUE_CLEAR_REG);
>   			/*  prime queue holding register */
>   			writew(0, devpriv->main_iobase + ADC_QUEUE_LOAD_REG);
> @@ -2498,8 +2522,10 @@ static int setup_channel_queue(struct comedi_device *dev,
>   				devpriv->i2c_cal_range_bits &=
>   					~attenuate_bit(channel);
>   		}
> -		/*  update calibration/range i2c register only if necessary,
> -		 *  as it is very slow */
> +		/*
> +		 * update calibration/range i2c register only if necessary,
> +		 * as it is very slow
> +		 */
>   		if (old_cal_range_bits != devpriv->i2c_cal_range_bits) {
>   			uint8_t i2c_data = devpriv->i2c_cal_range_bits;
>
> @@ -2516,11 +2542,13 @@ static inline void load_first_dma_descriptor(struct comedi_device *dev,
>   {
>   	struct pcidas64_private *devpriv = dev->private;
>
> -	/* The transfer size, pci address, and local address registers
> +	/*
> +	 * The transfer size, pci address, and local address registers
>   	 * are supposedly unused during chained dma,
>   	 * but I have found that left over values from last operation
>   	 * occasionally cause problems with transfer of first dma
> -	 * block.  Initializing them to zero seems to fix the problem. */
> +	 * block.  Initializing them to zero seems to fix the problem.
> +	 */
>   	if (dma_channel) {
>   		writel(0,
>   		       devpriv->plx9080_iobase + PLX_DMA1_TRANSFER_SIZE_REG);
> @@ -2675,15 +2703,19 @@ static void pio_drain_ai_fifo_16(struct comedi_device *dev)
>   			     0x7fff;
>   		write_index = readw(devpriv->main_iobase + ADC_WRITE_PNTR_REG) &
>   			      0x7fff;
> -		/* Get most significant bits (grey code).
> +		/*
> +		 * Get most significant bits (grey code).
>   		 * Different boards use different code so use a scheme
>   		 * that doesn't depend on encoding.  This read must
>   		 * occur after reading least significant 15 bits to avoid race
> -		 * with fifo switching to next segment. */
> +		 * with fifo switching to next segment.
> +		 */
>   		prepost_bits = readw(devpriv->main_iobase + PREPOST_REG);
>
> -		/* if read and write pointers are not on the same fifo segment,
> -		 * read to the end of the read segment */
> +		/*
> +		 * if read and write pointers are not on the same fifo segment,
> +		 * read to the end of the read segment
> +		 */
>   		read_segment = adc_upper_read_ptr_code(prepost_bits);
>   		write_segment = adc_upper_write_ptr_code(prepost_bits);
>
> @@ -2712,7 +2744,8 @@ static void pio_drain_ai_fifo_16(struct comedi_device *dev)
>   	} while (read_segment != write_segment);
>   }
>
> -/* Read from 32 bit wide ai fifo of 4020 - deal with insane grey coding of
> +/*
> + * Read from 32 bit wide ai fifo of 4020 - deal with insane grey coding of
>    * pointers.  The pci-4020 hardware only supports dma transfers (it only
>    * supports the use of pio for draining the last remaining points from the
>    * fifo when a data acquisition operation has completed).
> @@ -2790,8 +2823,10 @@ static void drain_dma_buffers(struct comedi_device *dev, unsigned int channel)
>   		devpriv->ai_dma_index = (devpriv->ai_dma_index + 1) %
>   					ai_dma_ring_count(thisboard);
>   	}
> -	/* XXX check for dma ring buffer overrun
> -	 * (use end-of-chain bit to mark last unused buffer) */
> +	/*
> +	 * XXX check for dma ring buffer overrun
> +	 * (use end-of-chain bit to mark last unused buffer)
> +	 */
>   }
>
>   static void handle_ai_interrupt(struct comedi_device *dev,
> @@ -2939,8 +2974,10 @@ static unsigned int load_ao_dma_buffer(struct comedi_device *dev,
>   	next_bits = le32_to_cpu(devpriv->ao_dma_desc[buffer_index].next);
>   	next_bits |= PLX_END_OF_CHAIN_BIT;
>   	devpriv->ao_dma_desc[buffer_index].next = cpu_to_le32(next_bits);
> -	/* clear end of chain bit on previous buffer now that we have set it
> -	 * for the last buffer */
> +	/*
> +	 * clear end of chain bit on previous buffer now that we have set it
> +	 * for the last buffer
> +	 */
>   	next_bits = le32_to_cpu(devpriv->ao_dma_desc[prev_buffer_index].next);
>   	next_bits &= ~PLX_END_OF_CHAIN_BIT;
>   	devpriv->ao_dma_desc[prev_buffer_index].next = cpu_to_le32(next_bits);
> @@ -3033,9 +3070,11 @@ static irqreturn_t handle_interrupt(int irq, void *d)
>   	plx_status = readl(devpriv->plx9080_iobase + PLX_INTRCS_REG);
>   	status = readw(devpriv->main_iobase + HW_STATUS_REG);
>
> -	/* an interrupt before all the postconfig stuff gets done could
> +	/*
> +	 * an interrupt before all the postconfig stuff gets done could
>   	 * cause a NULL dereference if we continue through the
> -	 * interrupt handler */
> +	 * interrupt handler
> +	 */
>   	if (!dev->attached)
>   		return IRQ_HANDLED;
>
> @@ -3195,8 +3234,10 @@ static int prep_ao_dma(struct comedi_device *dev, const struct comedi_cmd *cmd)
>   	unsigned int nbytes;
>   	int i;
>
> -	/* clear queue pointer too, since external queue has
> -	 * weird interactions with ao fifo */
> +	/*
> +	 * clear queue pointer too, since external queue has
> +	 * weird interactions with ao fifo
> +	 */
>   	writew(0, devpriv->main_iobase + ADC_QUEUE_CLEAR_REG);
>   	writew(0, devpriv->main_iobase + DAC_BUFFER_CLEAR_REG);
>
> @@ -3465,7 +3506,8 @@ static int dio_60xx_wbits(struct comedi_device *dev,
>   	return insn->n;
>   }
>
> -/* pci-6025 8800 caldac:
> +/*
> + * pci-6025 8800 caldac:
>    * address 0 == dac channel 0 offset
>    * address 1 == dac channel 0 gain
>    * address 2 == dac channel 1 offset
> @@ -3475,7 +3517,8 @@ static int dio_60xx_wbits(struct comedi_device *dev,
>    * address 6 == coarse adc gain
>    * address 7 == fine adc gain
>    */
> -/* pci-6402/16 uses all 8 channels for dac:
> +/*
> + * pci-6402/16 uses all 8 channels for dac:
>    * address 0 == dac channel 0 fine gain
>    * address 1 == dac channel 0 coarse gain
>    * address 2 == dac channel 0 coarse offset
> @@ -3484,7 +3527,7 @@ static int dio_60xx_wbits(struct comedi_device *dev,
>    * address 5 == dac channel 1 coarse gain
>    * address 6 == dac channel 0 fine offset
>    * address 7 == dac channel 1 fine offset
> -*/
> + */
>
>   static int caldac_8800_write(struct comedi_device *dev, unsigned int address,
>   			     uint8_t value)
> @@ -3744,7 +3787,8 @@ static int eeprom_read_insn(struct comedi_device *dev,
>   	return 1;
>   }
>
> -/* Allocate and initialize the subdevice structures.
> +/*
> + * Allocate and initialize the subdevice structures.
>    */
>   static int setup_subdevices(struct comedi_device *dev)
>   {
> @@ -3779,8 +3823,10 @@ static int setup_subdevices(struct comedi_device *dev)
>   	s->cancel = ai_cancel;
>   	if (thisboard->layout == LAYOUT_4020) {
>   		uint8_t data;
> -		/*  set adc to read from inputs
> -		 *  (not internal calibration sources) */
> +		/*
> +		 * set adc to read from inputs
> +		 * (not internal calibration sources)
> +		 */
>   		devpriv->i2c_cal_range_bits = adc_src_4020_bits(4);
>   		/*  set channels to +-5 volt input ranges */
>   		for (i = 0; i < s->n_chan; i++)
>

Looks good.

Reviewed-by: Ian Abbott <abbotti@mev.co.uk>

-- 
-=( Ian Abbott @ MEV Ltd.    E-mail: <abbotti@mev.co.uk> )=-
-=(                          Web: http://www.mev.co.uk/  )=-