diff options
| author |   Sam James <sam@gentoo.org> | 2021-03-22 05:37:37 +0000 |
|---|---|---|
| committer |   Ulrich Müller <ulm@gentoo.org> | 2021-03-30 08:53:23 +0200 |
| commit | 97c28330bb6906f046337c4000e69ef52c52296f (patch) | |
| tree | a70e98588194d97eaf31bd10df1bd13cb1d43ac6 | |
| parent | eclass-writing: mention that checking (official) overlays may be useful (diff) | |
| download | devmanual-97c28330.tar.gz devmanual-97c28330.tar.bz2 devmanual-97c28330.zip | |
eclass-writing: mention etiquette with respect to metadata invalidation
Signed-off-by: Sam James <sam@gentoo.org>
Signed-off-by: Ulrich Müller <ulm@gentoo.org>
| -rw-r--r-- | eclass-writing/text.xml | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/eclass-writing/text.xml b/eclass-writing/text.xml index adf3671..ccebfb6 100644 --- a/eclass-writing/text.xml +++ b/eclass-writing/text.xml @@ -90,6 +90,17 @@ Committing a broken eclass can kill huge numbers of packages. Since A simple way to verify syntax is <c>bash -n foo.eclass</c>. </p> +<note> +Given that updating an eclass will invalidate the cache of all consumer ebuilds, +it is good etiquette to ping other developers in e.g. <c>#gentoo-dev</c> +on IRC or informally determine if there are other similar changes (mainly +documentation) which should be pushed at the same time in order to avoid +unnecessary cache regeneration within a few hours or days of each other. + +The same applies to your own work <d/> please prepare all of your commits and +batch push them at once where possible. +</note> + </body> </section> |