[gentoo-commits] proj/emacs-tools:backups/emacs-common-gentoo@1030 commit in: /

["Sebastian Pipping" <sping@gentoo.org>]

commit:     5f4befa210e82badab42b82bac78cdbc9d8ccc22
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Mar 29 06:16:17 2007 +0000
Commit:     Sebastian Pipping <sping <AT> gentoo <DOT> org>
CommitDate: Thu Mar 29 06:16:17 2007 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/emacs-tools.git;a=commit;h=5f4befa2

Added emacs.eselect.5 man page.

svn path=/emacs-extra/eselect-emacs/; revision=188

---
 ChangeLog       |    1 +
 emacs.eselect   |    1 +
 emacs.eselect.5 |   64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 66 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 32aaec3..967c045 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -56,3 +56,4 @@ Version 0.5 (24 Mar 2007)
 Version 0.6 (28 Mar 2007)
 	28 Mar 2007
 	Undo previous change.
+	Added man page.

diff --git a/emacs.eselect b/emacs.eselect
index 3f6d7af..991fbbb 100644
--- a/emacs.eselect
+++ b/emacs.eselect
@@ -99,6 +99,7 @@ set_symlinks() {
 	[[ -f "${ROOT}/usr/bin/${target}" ]] \
 		|| die -q "Target \"${1}\" doesn't appear to be valid!"
 
+	echo "Switching to ${target}..."
 	remove_symlinks
 	# the main /usr/bin/emacs symlink is only set for Emacs binaries
 	# (but not for other providers of auxiliary programs, e.g., XEmacs)

diff --git a/emacs.eselect.5 b/emacs.eselect.5
new file mode 100644
index 0000000..1539b59
--- /dev/null
+++ b/emacs.eselect.5
@@ -0,0 +1,64 @@
+.TH "ESELECT" "5" "March 2007" "Gentoo Linux" "eselect"
+.SH "NAME"
+emacs.eselect \- The emacs management module for Gentoo's eselect
+.SH "SYNOPSIS"
+\fBeselect emacs\fR [\fBhelp\fR|\fBusage\fR]
+.br 
+\fBeselect emacs list\fR
+.br
+\fBeselect emacs set\fR \fItarget\fR
+.br
+\fBeselect emacs show\fR
+.br
+\fBeselect emacs update\fR [\fI--if-unset\fR]
+.SH "DESCRIPTION"
+\fBeselect\fR is Gentoo's configuration and management tool. It features
+modules that care for the individual administrative tasks.
+.SH "ACTION: LIST"
+\fBeselect emacs list\fR
+.br
+List all installed version of emacs.
+
+# eselect emacs list
+.br
+Available Emacs symlink targets:
+.br
+  [1]   emacs-18
+  [2]   emacs-21 *
+  [3]   emacs-22
+.SH "ACTION: SET"
+\fBeselect emacs set\fR \fItarget\fR
+.br
+Activates the selected version of emacs. \fItarget\fR can be either an
+identification number given by \fBeselect emacs list\fR or the name of
+one installed version.
+
+# eselect emacs set 3
+.br
+Switching to emacs-22...
+.SH "ACTION: SHOW"
+\fBeselect emacs show\fR [\fItarget\fR]
+.br
+Prints the currently activated emacs version.
+
+# eselect emacs show
+.br
+Current target of symlink:
+.br
+emacs-22
+.SH "ACTION: UPDATE"
+\fBeselect emacs update\fR [\fI--if-unset\fR]
+.br
+Update the Emacs symlink to the last available version. If option
+[\fI--if-unset\fR] is given, an existing implementation is not
+overridden.
+
+# eselect emacs update
+.br
+Switching to emacs-22...
+.SH "AUTHOR"
+Christian Faulhammer <opfer@gentoo.org>
+.br
+Ulrich Mueller <ulm@kph.uni-mainz.de>
+.SH "REVISION"
+$Id: $