[gentoo-commits] proj/gentoo-news:master commit in: 2015/2015-02-04-portage-sync-changes/

[Brian Dolbec]

commit:     bd8e67fe227681c439fafad046ad0cd17280c320
Author:     Brian Dolbec <dolsen <AT> gentoo <DOT> org>
AuthorDate: Wed Feb  4 18:28:25 2015 +0000
Commit:     Brian Dolbec <dolsen <AT> gentoo <DOT> org>
CommitDate: Wed Feb  4 18:28:25 2015 +0000
URL:        http://sources.gentoo.org/gitweb/?p=proj/gentoo-news.git;a=commit;h=bd8e67fe

Add news item for portage sync changes

---
 .../2015-02-04-portage-sync-changes.en.txt         | 77 ++++++++++++++++++++++
 .../2015-02-04-portage-sync-changes.en.txt.asc     | 19 ++++++
 2 files changed, 96 insertions(+)

diff --git a/2015/2015-02-04-portage-sync-changes/2015-02-04-portage-sync-changes.en.txt b/2015/2015-02-04-portage-sync-changes/2015-02-04-portage-sync-changes.en.txt
new file mode 100644
index 0000000..544cf4d
--- /dev/null
+++ b/2015/2015-02-04-portage-sync-changes/2015-02-04-portage-sync-changes.en.txt
@@ -0,0 +1,77 @@
+Title: New portage plug-in sync system
+Author: Brian Dolbec <dolsen@g.o>
+Content-Type: text/plain
+Posted: 2015-02-02
+Revision: 1
+News-Item-Format: 1.0
+Display-If-Installed: sys-apps/portage
+
+There is a new plug-in sync system in >=sys-apps/portage-2.2.16.
+This system will allow third party modules to be easily installed.  Look
+for a new layman plug-in sync module in layman's next release.  Next is
+a brief look at the changes.  See the url [1] listed below for detailed
+descriptions and usage.
+
+Changes:  /etc/portage/repos.conf/*
+    New setting for all repository types (needed):
+        auto-sync = yes/no, true/false  # default if absent: yes/true
+
+    New for git sync-type: (applies to clone only)
+        sync-depth = n  where n = {0,1,2,3,...} (optional, default = 1)
+            0 -- full history
+            1 -- shallow clone, only current state (default)
+            2,3,... number of history changes to download
+
+    New sync-type modules:
+        sync-type = svn  # sync a subversion repository
+        sync-type = websync # Perform an emerge-webrsync operation
+        sync-type = laymanator  # (if installed) runs a layman -s action
+
+    New native portage postsync hooks
+        /etc/portage/postsync.d/*
+            Runs hooks once, only after all repos have been synced.
+        /etc/portage/repo.postsync.d/*
+            Runs each script with three arguments:
+                repo name, sync-uri, location
+            Each script is run at the completion of every repo synced.
+
+Migration:
+    Edit /etc/portage/repos.conf/*.conf files, add the auto-sync option
+    to each repository definition.  Edit sync-type option to one of the
+    supported types {rsync, git, cvs, svn, websync, laymanator}.
+        [some-repo]
+        ...
+        sync-type = rsync
+        auto-sync = yes
+
+    For an existing /etc/portage/repos.conf/layman.conf file:
+        1) change/add the sync-type
+            sync-type = laymanator
+        2) Ensure you have the correct layman version installed with
+           it's laymanator module also installed.
+    Alternate method:
+        Please see the wiki page url [1] for detailed instructions.
+
+Primary control of all sync operations has been moved from emerge to
+emaint.  "emerge --sync" now just calls the emaint sync module with the
+--auto option.  The --auto option performs a sync on only those
+repositories with the auto-sync setting not set to 'no' or 'false'. If
+it is absent, then it will default to yes and "emerge --sync" will sync
+the repository.
+
+NOTE: As a result of the default auto-sync = True/Yes setting, commands
+    like "eix-sync", "esync -l", "emerge --sync && layman -S" will cause
+    many repositories to be synced multiple times in a row.  Please edit
+    your configs or scripts to adjust for the new operation.
+
+WARNING:
+    Due to the abaove default. For any repos that you EXPLICITLY do not
+    want to be synced. You MUST set "auto-sync = no"
+
+The 'emaint sync' module operates similar to layman.  It can sync
+single or multiple repos.  See "emaint --help" or for more details and
+examples see the wiki page listed below [1].
+
+Additional help and project API documentation can be found at:
+
+[1] https://wiki.gentoo.org/wiki/Project:Portage/Sync

diff --git a/2015/2015-02-04-portage-sync-changes/2015-02-04-portage-sync-changes.en.txt.asc b/2015/2015-02-04-portage-sync-changes/2015-02-04-portage-sync-changes.en.txt.asc
new file mode 100644
index 0000000..add6bbe
--- /dev/null
+++ b/2015/2015-02-04-portage-sync-changes/2015-02-04-portage-sync-changes.en.txt.asc
@@ -0,0 +1,19 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v2.0
+
+iQJ8BAABCgBmBQJU0mL3XxSAAAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25zLm9w
+ZW5wZ3AuZmlmdGhob3JzZW1hbi5uZXQ2OUZEQTI0MjY5QzhCNUE3RTlFMjMxRTkw
+MTg2ODIyMzFCOTI2RTRGAAoJEAGGgiMbkm5PFXEP/j/ZfwsUWMjxXqsJzCNWLC3K
+kOLlRFEnLkk/vPiPQDD+jTKjV6Az8K7w2Bb9duXXnBvW2iQ121vThW2qufJk1RZr
+YmaBoTzRQ/iG8ekfLG5TtoZeIAJGgrpLd3xgGatIBYpV/nGX877RjoSsgoMwg9h0
+HGIfVeLd/oBF2Zy7l56fGbIHdkOmtzf6ufc6lJPgJHB4KELZIt3rItQ1BHNRdI5n
+KQV1IUcjSi80F2j43uReWCy5LIqXc6eA57iw1zTL56jOhPE4JB0rQXvVYjg0PNb/
+vNjdsXY1NoMUh9Hrc2jOCH5U54PFK4PfdvvY6ujc3Q0D6brxUbi3WdAEV9q3w8JB
+hpXP3PpZD4Py7ZW72pXMEMbs0IwOd2/X9Sdh22wabRIpBU9dm5vm36rlTWVw6nS+
+Ztrn5lya4fXbEFHA/9Y9bopKW58uVHZMnsxMQOAFkyYl/zMPqznpWWWX9pPntuWL
+XaicQbhPCMezQ1aPXkOuBPkpHC+TGaf9raRQHLDhb/oB+28gMkRCFoOcGpGzA7l+
+jFU+SiGG0lrasHvw/nLHM01Z1lfH5BbJc8affm1bYDCM2fIJjHY2Uq0/kdRD/wAE
+nb0ANdPhmOeLXyElfwBdUpjzy3Xf7gKTyZN/rbvDBo+uN2TfqpYHc1mrZ6mnUD7s
+D0L0fwwC1nXJD/1WkR0B
+=tbkV
+-----END PGP SIGNATURE-----