diff options
| author |   Michał Górny <mgorny@gentoo.org> | 2017-08-06 13:45:35 +0200 |
|---|---|---|
| committer |   Göktürk Yüksek <gokturk@gentoo.org> | 2017-09-25 00:10:26 -0400 |
| commit | c487cdb2874911a5495f2f05dae89d4253fa260f (patch) | |
| tree | 2490c807053f892eb1676a48292e9defc001b68b | |
| parent | general-concepts/ebuild-revisions: by default -> when empty (more precise) (diff) | |
| download | devmanual-c487cdb2874911a5495f2f05dae89d4253fa260f.tar.gz devmanual-c487cdb2874911a5495f2f05dae89d4253fa260f.tar.bz2 devmanual-c487cdb2874911a5495f2f05dae89d4253fa260f.zip | |
general-concepts/ebuild-revisions: Clearly define the purpose of revisions
| -rw-r--r-- | general-concepts/ebuild-revisions/text.xml | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/general-concepts/ebuild-revisions/text.xml b/general-concepts/ebuild-revisions/text.xml index f2d7234..b0c0d97 100644 --- a/general-concepts/ebuild-revisions/text.xml +++ b/general-concepts/ebuild-revisions/text.xml @@ -13,6 +13,20 @@ An ebuild with no explicit revision number has the implicit <c>-r0</c> revision. </p> +<p>Ebuild revisions usually serve two purposes:</p> +<ol> + <li> + keeping an older copy of an ebuild around when doing a potentially + breaking change, and + </li> + + <li> + propagating the rebuild of a package when performing a meaningful + change that would otherwise go unnoticed by users who have installed + the current version already. + </li> +</ol> + <p> Ebuilds should have their <c>-rX</c> incremented whenever a change is made which will make a substantial difference to what gets installed by the package <d/> by |