* [PATCH] manuals: reduce verbosity with "worry about" expression
@ 2021-05-05 13:34 Michael Opdenacker
2021-05-05 13:37 ` [docs] " Quentin Schulz
0 siblings, 1 reply; 4+ messages in thread
From: Michael Opdenacker @ 2021-05-05 13:34 UTC (permalink / raw)
To: docs; +Cc: Michael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
---
documentation/dev-manual/common-tasks.rst | 4 ++--
documentation/kernel-dev/common.rst | 4 ++--
documentation/ref-manual/classes.rst | 4 ++--
documentation/ref-manual/structure.rst | 2 +-
documentation/toaster-manual/reference.rst | 5 ++---
5 files changed, 9 insertions(+), 10 deletions(-)
diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
index 37c7a19bfa..713ed8d64e 100644
--- a/documentation/dev-manual/common-tasks.rst
+++ b/documentation/dev-manual/common-tasks.rst
@@ -1589,7 +1589,7 @@ your software is built:
- *Autotools:* If your source files have a ``configure.ac`` file, then
your software is built using Autotools. If this is the case, you just
- need to worry about modifying the configuration.
+ to modify the configuration.
When using Autotools, your recipe needs to inherit the
:ref:`autotools <ref-classes-autotools>` class
@@ -1603,7 +1603,7 @@ your software is built:
- *CMake:* If your source files have a ``CMakeLists.txt`` file, then
your software is built using CMake. If this is the case, you just
- need to worry about modifying the configuration.
+ need to modify the configuration.
When you use CMake, your recipe needs to inherit the
:ref:`cmake <ref-classes-cmake>` class and your
diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst
index 3f35d8412f..54ea1e2ef3 100644
--- a/documentation/kernel-dev/common.rst
+++ b/documentation/kernel-dev/common.rst
@@ -589,8 +589,8 @@ recipe is processed.
In general, however, the Yocto Project maintainers take care of
moving the ``SRC_URI``-specified configuration options to the
- kernel's ``meta`` branch. Not only is it easier for BSP developers to
- not have to worry about putting those configurations in the branch,
+ kernel's ``meta`` branch. Not only is it easier for BSP developers
+ not to have to put those configurations in the branch,
but having the maintainers do it allows them to apply 'global'
knowledge about the kinds of common configuration options multiple
BSPs in the tree are typically using. This allows for promotion of
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 9a1fc2c93f..a6347449f1 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -1260,8 +1260,8 @@ The following list shows the tests you can list with the ``WARN_QA`` and
.. note::
- If you are not using runtime package management on your target
- system, then you do not need to worry about this situation.
+ This is only relevant when you are using runtime package management
+ on your target system.
- ``xorg-driver-abi:`` Checks that all packages containing Xorg
drivers have ABI dependencies. The ``xserver-xorg`` recipe provides
diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst
index f8dc7d2821..d28af6affd 100644
--- a/documentation/ref-manual/structure.rst
+++ b/documentation/ref-manual/structure.rst
@@ -38,7 +38,7 @@ usually matches the current stable BitBake release from the BitBake
project. BitBake, a :term:`Metadata` interpreter, reads the
Yocto Project Metadata and runs the tasks defined by that data. Failures
are usually caused by errors in your Metadata and not from BitBake
-itself; consequently, most users do not need to worry about BitBake.
+itself.
When you run the ``bitbake`` command, the main BitBake executable (which
resides in the ``bitbake/bin/`` directory) starts. Sourcing the
diff --git a/documentation/toaster-manual/reference.rst b/documentation/toaster-manual/reference.rst
index 3d4efe92d6..5d52c449cd 100644
--- a/documentation/toaster-manual/reference.rst
+++ b/documentation/toaster-manual/reference.rst
@@ -32,9 +32,8 @@ through a
`REST <https://en.wikipedia.org/wiki/Representational_state_transfer>`__
API, store the information about the layers in the Toaster database, and
then show the information to users. Users are then able to view that
-information and build layers from Toaster itself without worrying about
-cloning or editing the BitBake layers configuration file
-``bblayers.conf``.
+information and build layers from Toaster itself without having to
+clone or edit the BitBake layers configuration file ``bblayers.conf``.
Tying a layer source into Toaster is convenient when you have many
custom layers that need to be built on a regular basis by a community of
--
2.25.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [docs] [PATCH] manuals: reduce verbosity with "worry about" expression
2021-05-05 13:34 [PATCH] manuals: reduce verbosity with "worry about" expression Michael Opdenacker
@ 2021-05-05 13:37 ` Quentin Schulz
2021-05-05 13:54 ` Michael Opdenacker
[not found] ` <167C3018EF3F78EB.28940@lists.yoctoproject.org>
0 siblings, 2 replies; 4+ messages in thread
From: Quentin Schulz @ 2021-05-05 13:37 UTC (permalink / raw)
To: Michael Opdenacker; +Cc: docs
Hi Michael,
On Wed, May 05, 2021 at 03:34:08PM +0200, Michael Opdenacker wrote:
> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
> ---
> documentation/dev-manual/common-tasks.rst | 4 ++--
> documentation/kernel-dev/common.rst | 4 ++--
> documentation/ref-manual/classes.rst | 4 ++--
> documentation/ref-manual/structure.rst | 2 +-
> documentation/toaster-manual/reference.rst | 5 ++---
> 5 files changed, 9 insertions(+), 10 deletions(-)
>
> diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
> index 37c7a19bfa..713ed8d64e 100644
> --- a/documentation/dev-manual/common-tasks.rst
> +++ b/documentation/dev-manual/common-tasks.rst
> @@ -1589,7 +1589,7 @@ your software is built:
>
> - *Autotools:* If your source files have a ``configure.ac`` file, then
> your software is built using Autotools. If this is the case, you just
> - need to worry about modifying the configuration.
> + to modify the configuration.
>
Missing "need"
Otherwise:
Reviewed-by: Quentin Schulz <foss@0leil.net>
Thanks!
Quentin
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [docs] [PATCH] manuals: reduce verbosity with "worry about" expression
2021-05-05 13:37 ` [docs] " Quentin Schulz
@ 2021-05-05 13:54 ` Michael Opdenacker
[not found] ` <167C3018EF3F78EB.28940@lists.yoctoproject.org>
1 sibling, 0 replies; 4+ messages in thread
From: Michael Opdenacker @ 2021-05-05 13:54 UTC (permalink / raw)
To: Quentin Schulz; +Cc: docs
Hi Quentin,
Thanks for the super quick review!
On 5/5/21 3:37 PM, Quentin Schulz wrote:
> Hi Michael,
>
> On Wed, May 05, 2021 at 03:34:08PM +0200, Michael Opdenacker wrote:
>> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
>> ---
>> documentation/dev-manual/common-tasks.rst | 4 ++--
>> documentation/kernel-dev/common.rst | 4 ++--
>> documentation/ref-manual/classes.rst | 4 ++--
>> documentation/ref-manual/structure.rst | 2 +-
>> documentation/toaster-manual/reference.rst | 5 ++---
>> 5 files changed, 9 insertions(+), 10 deletions(-)
>>
>> diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
>> index 37c7a19bfa..713ed8d64e 100644
>> --- a/documentation/dev-manual/common-tasks.rst
>> +++ b/documentation/dev-manual/common-tasks.rst
>> @@ -1589,7 +1589,7 @@ your software is built:
>>
>> - *Autotools:* If your source files have a ``configure.ac`` file, then
>> your software is built using Autotools. If this is the case, you just
>> - need to worry about modifying the configuration.
>> + to modify the configuration.
>>
> Missing "need"
Oops, thanks. I fixed it in my branch.
Thanks again,
Michael.
--
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [docs] [PATCH] manuals: reduce verbosity with "worry about" expression
[not found] ` <167C3018EF3F78EB.28940@lists.yoctoproject.org>
@ 2021-05-06 15:43 ` Michael Opdenacker
0 siblings, 0 replies; 4+ messages in thread
From: Michael Opdenacker @ 2021-05-06 15:43 UTC (permalink / raw)
To: Quentin Schulz; +Cc: docs
Hello,
On 5/5/21 3:54 PM, Michael Opdenacker wrote:
> Hi Quentin,
>
> Thanks for the super quick review!
>
> On 5/5/21 3:37 PM, Quentin Schulz wrote:
>> Hi Michael,
>>
>> On Wed, May 05, 2021 at 03:34:08PM +0200, Michael Opdenacker wrote:
>>> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
>>> ---
>>> documentation/dev-manual/common-tasks.rst | 4 ++--
>>> documentation/kernel-dev/common.rst | 4 ++--
>>> documentation/ref-manual/classes.rst | 4 ++--
>>> documentation/ref-manual/structure.rst | 2 +-
>>> documentation/toaster-manual/reference.rst | 5 ++---
>>> 5 files changed, 9 insertions(+), 10 deletions(-)
>>>
>>> diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
>>> index 37c7a19bfa..713ed8d64e 100644
>>> --- a/documentation/dev-manual/common-tasks.rst
>>> +++ b/documentation/dev-manual/common-tasks.rst
>>> @@ -1589,7 +1589,7 @@ your software is built:
>>>
>>> - *Autotools:* If your source files have a ``configure.ac`` file, then
>>> your software is built using Autotools. If this is the case, you just
>>> - need to worry about modifying the configuration.
>>> + to modify the configuration.
>>>
>> Missing "need"
> Oops, thanks. I fixed it in my branch.
Merged into "master-next". Thanks again.
Michael.
--
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2021-05-06 15:43 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-05-05 13:34 [PATCH] manuals: reduce verbosity with "worry about" expression Michael Opdenacker
2021-05-05 13:37 ` [docs] " Quentin Schulz
2021-05-05 13:54 ` Michael Opdenacker
[not found] ` <167C3018EF3F78EB.28940@lists.yoctoproject.org>
2021-05-06 15:43 ` Michael Opdenacker
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.