2005-03-27 19:09:49

by Rolf Eike Beer

[permalink] [raw]
Subject: [PATCH] typo fix in Documentation/eisa.txt

Trivial typo fix.

Signed-off-by: Rolf Eike Beer <[email protected]>

--- linux-2.6.0-test9/Documentation/eisa.txt 2003-10-25 20:43:59.000000000 +0200
+++ linux-2.6.0-test9-eike/Documentation/eisa.txt 2003-11-12 09:29:47.000000000 +0100
@@ -171,7 +171,7 @@
virtual_root.force_probe :

Force the probing code to probe EISA slots even when it cannot find an
-EISA compliant mainboard (nothing appears on slot 0). Defaultd to 0
+EISA compliant mainboard (nothing appears on slot 0). Default to 0
(don't force), and set to 1 (force probing) when either
CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING are set.


2005-03-27 19:32:16

by Jean Delvare

[permalink] [raw]
Subject: Re: [PATCH] typo fix in Documentation/eisa.txt

Hi Eike,

> Trivial typo fix.
> (...)
> Force the probing code to probe EISA slots even when it cannot find an
> -EISA compliant mainboard (nothing appears on slot 0). Defaultd to 0
> +EISA compliant mainboard (nothing appears on slot 0). Default to 0
> (don't force), and set to 1 (force probing) when either
> CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING are set.

Wouldn't it rather be "Defaults"?

--
Jean Delvare

2005-03-27 19:43:12

by Rolf Eike Beer

[permalink] [raw]
Subject: Re: [PATCH] typo fix in Documentation/eisa.txt

Jean Delvare wrote:
> Hi Eike,
>
> > Trivial typo fix.
> > (...)
> > Force the probing code to probe EISA slots even when it cannot find an
> > -EISA compliant mainboard (nothing appears on slot 0). Defaultd to 0
> > +EISA compliant mainboard (nothing appears on slot 0). Default to 0
> > (don't force), and set to 1 (force probing) when either
> > CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING are set.
>
> Wouldn't it rather be "Defaults"?

Damn, yes. Every time I read it again I feel a little bit more comfortable
with s/are set/is set/. Am I right or is it already too late for useful
work?

Eike


Attachments:
(No filename) (608.00 B)
(No filename) (189.00 B)
Download all attachments

2005-03-27 19:51:26

by Randy.Dunlap

[permalink] [raw]
Subject: Re: [PATCH] typo fix in Documentation/eisa.txt

Rolf Eike Beer wrote:
> Jean Delvare wrote:
>
>>Hi Eike,
>>
>>
>>>Trivial typo fix.
>>>(...)
>>> Force the probing code to probe EISA slots even when it cannot find an
>>>-EISA compliant mainboard (nothing appears on slot 0). Defaultd to 0
>>>+EISA compliant mainboard (nothing appears on slot 0). Default to 0
>>> (don't force), and set to 1 (force probing) when either
>>> CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING are set.
>>
>>Wouldn't it rather be "Defaults"?
>
>
> Damn, yes. Every time I read it again I feel a little bit more comfortable
> with s/are set/is set/. Am I right or is it already too late for useful
> work?

Defaults

when either FOO or BAR is set.

and the comma after (don't force) shouldn't be there...

--
~Randy

2005-03-27 19:59:25

by Rolf Eike Beer

[permalink] [raw]
Subject: Re: [PATCH] typo fix in Documentation/eisa.txt

Typo fixes.

Thanks to Randy Dunlap and Jean Delvare.

Signed-off-by: Rolf Eike Beer <[email protected]>

--- linux-2.6.11/Documentation/eisa.txt 2005-03-02 08:38:12.000000000 +0100
+++ linux-2.6.12-rc1/Documentation/eisa.txt 2005-03-27 21:58:04.000000000 +0200
@@ -171,9 +171,9 @@
virtual_root.force_probe :

Force the probing code to probe EISA slots even when it cannot find an
-EISA compliant mainboard (nothing appears on slot 0). Defaultd to 0
-(don't force), and set to 1 (force probing) when either
-CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING are set.
+EISA compliant mainboard (nothing appears on slot 0). Defaults to 0
+(don't force) and set to 1 (force probing) when either
+CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING is set.

** Random notes :

2005-03-27 20:01:51

by Jean Delvare

[permalink] [raw]
Subject: Re: [PATCH] typo fix in Documentation/eisa.txt

> > > Force the probing code to probe EISA slots even when it cannot find an
> > > -EISA compliant mainboard (nothing appears on slot 0). Defaultd to 0
> > > +EISA compliant mainboard (nothing appears on slot 0). Default to 0
> > > (don't force), and set to 1 (force probing) when either
> > > CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING are set.
> >
> > Wouldn't it rather be "Defaults"?
>
> Damn, yes. Every time I read it again I feel a little bit more
> comfortable with s/are set/is set/. Am I right or is it already too
> late for useful work?

"is" is better, even if both are commonly used in this case. And no,
it's not to late.

--
Jean Delvare

2005-03-29 01:17:50

by L. A. Walsh

[permalink] [raw]
Subject: Re: [PATCH] typo fix in Documentation/eisa.txt



Rolf Eike Beer wrote:

>Typo fixes.
>
>Thanks to Randy Dunlap and Jean Delvare.
>
>Signed-off-by: Rolf Eike Beer <[email protected]>
>
>--- linux-2.6.11/Documentation/eisa.txt 2005-03-02 08:38:12.000000000 +0100
>+++ linux-2.6.12-rc1/Documentation/eisa.txt 2005-03-27 21:58:04.000000000 +0200
>@@ -171,9 +171,9 @@
> virtual_root.force_probe :
>
> Force the probing code to probe EISA slots even when it cannot find an
>-EISA compliant mainboard (nothing appears on slot 0). Defaultd to 0
>-(don't force), and set to 1 (force probing) when either
>-CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING are set.
>+EISA compliant mainboard (nothing appears on slot 0). Defaults to 0
>+(don't force) and set to 1 (force probing) when either
>+CONFIG_ALPHA_JENSEN or CONFIG_EISA_VLB_PRIMING is set.
>
---
01234567890123456789012345678901234567890123456789012345678901234567890123456789
My expertise is limited by a fuzzy memory, and I know it's bad form to
comment much on english usage or spelling as they are often tangential to
the issue at hand, but as long as we are on the topic, I think you had it
right the first time.

I believe the comment, properly used the "imperative":
declaring intended usage of the variable, i.e. - "Do this or do
that"; "Default to 0 or set to 1". To use a perl like example:

# set probe action:
probe=0; # default to 0 (don't force)
probe=1 if (X || Y); # and set to 1 (force), if either X or Y is set

If you use "Defaults", then I think that's an implied 3rd person
singular usage and for correct parallelism, the parallel clause (after
the "and") should use the same tense. Third person tense for "set"
would use "is" as a passive-voice auxiliary: "[it] is set to 1..."

Saying "default to 0" is like the perlism:
setup values of v:

v=0; # default to 0
v=1 if (X || Y); # and set to 1 if X or Y is set

I can't believe we are discussing grammer concerns in comments in
the linux-kenel. :-) (!).

-linda