From 1a380640e4f5dae8da65b1465b03bba9b9618618 Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Mon, 8 Mar 2010 22:01:28 +0000 Subject: Clean up/sync docs for emerge --sync, and add a note about PORTAGE_SYNC_STALE. svn path=/main/trunk/; revision=15776 --- pym/_emerge/help.py | 37 +++++++++++++++++++++++++------------ 1 file changed, 25 insertions(+), 12 deletions(-) (limited to 'pym/_emerge/help.py') diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py index 1dfb63a47..ac36d0ccc 100644 --- a/pym/_emerge/help.py +++ b/pym/_emerge/help.py @@ -198,18 +198,31 @@ def help(myopts, havecolor=1): print(" emerge -S 'perl.*module'") print() print(" "+green("--sync")) - print(" Tells emerge to update the Portage tree as specified in") - print(" The SYNC variable found in /etc/make.conf. By default, SYNC instructs") - print(" emerge to perform an rsync-style update with rsync.gentoo.org.") - print() - print(" 'emerge-webrsync' exists as a helper app to emerge --sync, providing a") - print(" method to receive the entire portage tree as a tarball that can be") - print(" extracted and used. First time syncs would benefit greatly from this.") - print() - print(" "+turquoise("WARNING:")) - print(" If using our rsync server, emerge will clean out all files that do not") - print(" exist on it, including ones that you may have created. The exceptions") - print(" to this are the distfiles, local and packages directories.") + desc = "This updates the portage tree that is located in the " + \ + "directory that the PORTDIR variable refers to (default " + \ + "location is /usr/portage). The SYNC variable specifies " + \ + "the remote URI from which files will be synchronized. " + \ + "The PORTAGE_SYNC_STALE variable configures " + \ + "warnings that are shown when emerge --sync has not " + \ + "been executed recently." + for line in wrap(desc, desc_width): + print(desc_indent + line) + print() + print(desc_indent + turquoise("WARNING:")) + desc = "The emerge --sync action will modify and/or delete " + \ + "files located inside the directory that the PORTDIR " + \ + "variable refers to (default location is /usr/portage). " + \ + "For more information, see the PORTDIR documentation in " + \ + "the make.conf(5) man page." + for line in wrap(desc, desc_width): + print(desc_indent + line) + print() + print(desc_indent + green("NOTE:")) + desc = "The emerge-webrsync program will download the entire " + \ + "portage tree as a tarball, which is much faster than emerge " + \ + "--sync for first time syncs." + for line in wrap(desc, desc_width): + print(desc_indent + line) print() print(" "+green("--unmerge")+" ("+green("-C")+" short option)") print(" "+turquoise("WARNING: This action can remove important packages!")) -- cgit v1.2.3-1-g7c22