[PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

[PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

[Michael Opdenacker]

"metadata" is used both as singular and as plural.
The first change fixes a case in which the verbs have a singular conjugation
but articles that indicate a plural case.

The second change is for consistency with the first one inside
the same paragraph.

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
---
 doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
index eb140665..64e7305d 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
+++ b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
@@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.
 Conceptually, BitBake is similar to GNU Make in some regards but has
 significant differences:
 
--  BitBake executes tasks according to provided metadata that builds up
+-  BitBake executes tasks according to provided metadata that build up
    the tasks. Metadata is stored in recipe (``.bb``) and related recipe
    "append" (``.bbappend``) files, configuration (``.conf``) and
    underlying include (``.inc``) files, and in class (``.bbclass``)
-   files. The metadata provides BitBake with instructions on what tasks
+   files. The metadata provide BitBake with instructions on what tasks
    to run and the dependencies between those tasks.
 
 -  BitBake includes a fetcher library for obtaining source code from
-- 
2.25.1

Re: [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

[Quentin Schulz]

Hi Michael,

On Thu, Jul 29, 2021 at 03:01:33PM +0200, Michael Opdenacker wrote:
> "metadata" is used both as singular and as plural.
> The first change fixes a case in which the verbs have a singular conjugation
> but articles that indicate a plural case.
> 
> The second change is for consistency with the first one inside
> the same paragraph.
> 
> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
> ---
>  doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
> index eb140665..64e7305d 100644
> --- a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
> +++ b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
> @@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.
>  Conceptually, BitBake is similar to GNU Make in some regards but has
>  significant differences:
>  
> --  BitBake executes tasks according to provided metadata that builds up
> +-  BitBake executes tasks according to provided metadata that build up
>     the tasks. Metadata is stored in recipe (``.bb``) and related recipe

Then "Metadata are" here seems appropriate to me. What do you think?

Cheers,
Quentin

Re: [docs] [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

[Michael Opdenacker]

Hi Quentin,

On 7/29/21 3:05 PM, Quentin Schulz wrote:
> Hi Michael,
>
> On Thu, Jul 29, 2021 at 03:01:33PM +0200, Michael Opdenacker wrote:
>> "metadata" is used both as singular and as plural.
>> The first change fixes a case in which the verbs have a singular conjugation
>> but articles that indicate a plural case.
>>
>> The second change is for consistency with the first one inside
>> the same paragraph.
>>
>> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
>> ---
>>  doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--
>>  1 file changed, 2 insertions(+), 2 deletions(-)
>>
>> diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
>> index eb140665..64e7305d 100644
>> --- a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
>> +++ b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
>> @@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.
>>  Conceptually, BitBake is similar to GNU Make in some regards but has
>>  significant differences:
>>  
>> --  BitBake executes tasks according to provided metadata that builds up
>> +-  BitBake executes tasks according to provided metadata that build up
>>     the tasks. Metadata is stored in recipe (``.bb``) and related recipe
> Then "Metadata are" here seems appropriate to me. What do you think?

Good catch, many thanks! I paid attention to the following case, but
missed that one.
Cheers,
Michael.
-- 

Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

[Richard Purdie]

On Thu, 2021-07-29 at 15:05 +0200, Quentin Schulz wrote:
> Hi Michael,
> 
> On Thu, Jul 29, 2021 at 03:01:33PM +0200, Michael Opdenacker wrote:
> > "metadata" is used both as singular and as plural.
> > The first change fixes a case in which the verbs have a singular conjugation
> > but articles that indicate a plural case.
> > 
> > The second change is for consistency with the first one inside
> > the same paragraph.
> > 
> > Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
> > ---
> >  doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--
> >  1 file changed, 2 insertions(+), 2 deletions(-)
> > 
> > diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
> > index eb140665..64e7305d 100644
> > --- a/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
> > +++ b/doc/bitbake-user-manual/bitbake-user-manual-intro.rst
> > @@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.
> >  Conceptually, BitBake is similar to GNU Make in some regards but has
> >  significant differences:
> >  
> > 
> > 
> > 
> > --  BitBake executes tasks according to provided metadata that builds up
> > +-  BitBake executes tasks according to provided metadata that build up
> >     the tasks. Metadata is stored in recipe (``.bb``) and related recipe
> 
> Then "Metadata are" here seems appropriate to me. What do you think?

I'd have said "Metadata is stored in recipes"...

Cheers,

Richard 

Re: [docs] [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

[Michael Opdenacker]

On 7/29/21 11:31 PM, Richard Purdie wrote:
> I'd have said "Metadata is stored in recipes"...

Let's trust you on this, Richard.
All this back and forth just for eventually adding a single "the"!

At least, I'm starting to understand the usage of "metadata" and "data"
in today's English.
Thanks for your time and patience!
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com