Sync from eselect-emacs-1.8 version.

svn path=/trunk/; revision=396

2 files changed, 95 insertions, 68 deletions

diff --git a/man/ctags.eselect.5 b/man/ctags.eselect.5
index ff2cf40..423a42d 100644
--- a/man/ctags.eselect.5
+++ b/man/ctags.eselect.5
@@ -1,29 +1,37 @@
-.\" Copyright 1999-2008 Gentoo Foundation
+.\" Copyright 2007-2008 Gentoo Foundation
 .\" Distributed under the terms of the GNU General Public License v2
 .\" $Id$
 .\"
-.TH "ESELECT" "5" "May 2008" "Gentoo Linux" "eselect"
-.SH "NAME"
+.TH ESELECT 5 "December 2008" "Gentoo Linux" eselect
+.SH NAME
 ctags.eselect, etags.eselect \- The ctags and etags management module
 for Gentoo's eselect
-.SH "SYNOPSIS"
-\fBeselect ctags\fR [\fBhelp\fR|\fBusage\fR]
+.SH SYNOPSIS
+.B eselect ctags
+.RB [ help | usage ]
 .br
-\fBeselect ctags list\fR
+.B eselect ctags list
 .br
-\fBeselect ctags set\fR \fItarget\fR
+.B eselect ctags set
+.I target
 .br
-\fBeselect ctags show\fR
+.B eselect ctags show
 .br
-\fBeselect ctags update\fR
-.SH "DESCRIPTION"
-\fBeselect\fR is Gentoo's configuration and management tool. It features
-modules that care for the individual administrative tasks.
+.B eselect ctags update
+.SH DESCRIPTION
+.B eselect
+is Gentoo's configuration and management tool.  It features modules
+that care for the individual administrative tasks.
 
-The \fBctags\fR and \fBetags\fR eselect modules share a common syntax,
-therefore this man page collectively refers to them as \fBctags\fR.
-.SH "ACTION: LIST"
-\fBeselect ctags list\fR
+The
+.B ctags
+and
+.B etags
+eselect modules share a common syntax, therefore this man page
+collectively refers to them as
+.BR ctags .
+.SH ACTION: LIST
+.B eselect ctags list
 .br
 List all installed ctags versions.
 
@@ -33,31 +41,34 @@ Available ctags symlink targets:
 .br
   [1]   ctags-emacs-22 *
   [2]   exuberant-ctags
-.SH "ACTION: SET"
-\fBeselect ctags set\fR \fItarget\fR
+.SH ACTION: SET
+.B eselect ctags set
+.I target
 .br
-Activates the selected ctags version. \fItarget\fR can be either an
-identification number given by \fBeselect ctags list\fR or the name of
-one installed version.
+Activate the selected ctags version.
+.I target
+can be either an identification number given by
+.B eselect ctags list
+or the name of one installed version.
 
 # eselect ctags set 2
 .br
 Switching ctags to exuberant-ctags ...
-.SH "ACTION: SHOW"
-\fBeselect ctags show\fR
+.SH ACTION: SHOW
+.B eselect ctags show
 .br
-Prints the currently activated ctags version.
+Print the currently activated ctags version.
 
 # eselect ctags show
 .br
 Current target of symlink:
 .br
   exuberant-ctags
-.SH "ACTION: UPDATE"
-\fBeselect ctags update\fR
+.SH ACTION: UPDATE
+.B eselect ctags update
 .br
-Update the ctags symlink. For an update only the version is changed,
-but not the provider (i.e. Emacs vs Exuberant). At the moment only
+Update the ctags symlink.  For an update only the version is changed,
+but not the provider (i.e. Emacs vs Exuberant).  At the moment only
 (X)Emacs offers several concurrent versions.
 
 # eselect ctags update
@@ -65,17 +76,22 @@ but not the provider (i.e. Emacs vs Exuberant). At the moment only
 Switching ctags to exuberant-ctags ...
 .br
 Switching etags to etags-emacs-22 ...
-.SH "BUGS"
-Under FreeBSD, \fBeselect ctags\fR does not work since \fBctags\fR is
-a real binary, owned by package freebsd-ubin. (\fBeselect etags\fR
+.SH BUGS
+Under FreeBSD,
+.B eselect ctags
+does not work since
+.B ctags
+is a real binary, owned by package freebsd-ubin.
+.RB ( "eselect etags"
 does work though.)
 
-\fBeselect etags\fR does not display any valid targets if there is no
-Emacs variant installed. This is a feature.
-.SH "AUTHOR"
+.B eselect etags
+does not display any valid targets if there is no Emacs variant
+installed.  This is a feature.
+.SH AUTHOR
 Ulrich Mueller <ulm@gentoo.org>
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR eselect (1),
 .BR emacs.eselect (5)
-.SH "REVISION"
+.SH REVISION
 $Id$
diff --git a/man/emacs.eselect.5 b/man/emacs.eselect.5
index 694108e..b4e40a5 100644
--- a/man/emacs.eselect.5
+++ b/man/emacs.eselect.5
@@ -1,25 +1,29 @@
-.\" Copyright 1999-2008 Gentoo Foundation
+.\" Copyright 2007-2008 Gentoo Foundation
 .\" Distributed under the terms of the GNU General Public License v2
 .\" $Id$
 .\"
-.TH "ESELECT" "5" "May 2008" "Gentoo Linux" "eselect"
-.SH "NAME"
+.TH ESELECT 5 "December 2008" "Gentoo Linux" eselect
+.SH NAME
 emacs.eselect \- The Emacs management module for Gentoo's eselect
-.SH "SYNOPSIS"
-\fBeselect emacs\fR [\fBhelp\fR|\fBusage\fR]
+.SH SYNOPSIS
+.B eselect emacs
+.RB [ help | usage ]
 .br
-\fBeselect emacs list\fR
+.B eselect emacs list
 .br
-\fBeselect emacs set\fR \fItarget\fR
+.B eselect emacs set
+.I target
 .br
-\fBeselect emacs show\fR
+.B eselect emacs show
 .br
-\fBeselect emacs update\fR [\fIifunset\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
+.B eselect emacs update
+.RI [ ifunset ]
+.SH DESCRIPTION
+.B eselect
+is Gentoo's configuration and management tool.  It features modules
+that care for the individual administrative tasks.
+.SH ACTION: LIST
+.B eselect emacs list
 .br
 List all installed Emacs versions and even informs you if XEmacs has
 been found on your system.
@@ -31,12 +35,18 @@ Available GNU Emacs symlink targets:
   [1]   emacs-18
   [2]   emacs-21 *
   [3]   emacs-22
-.SH "ACTION: SET"
-\fBeselect emacs set\fR \fItarget\fR
-.br
-Activates the selected Emacs version. \fItarget\fR can be either an
-identification number given by \fBeselect emacs list\fR or the name of
-one installed version.
+.SH ACTION: SET
+.B eselect emacs set
+.I target
+.br
+Activate the selected Emacs version.
+.I target
+can be either an identification number given by
+.B eselect emacs list
+or the name of one installed version.  To avoid runtime issues with
+incompatible byte-code from the previously selected Emacs version, run 
+.B emacs-updater -a rebuild
+to remerge all needed packages.
 
 # eselect emacs set 3
 .br
@@ -45,22 +55,23 @@ Switching emacs to emacs-22 ...
 Switching ctags to ctags-emacs-22 ...
 .br
 Switching etags to etags-emacs-22 ...
-.SH "ACTION: SHOW"
-\fBeselect emacs show\fR
+.SH ACTION: SHOW
+.B eselect emacs show
 .br
-Prints the currently activated Emacs version.
+Print the currently activated Emacs version.
 
 # eselect emacs show
 .br
 Current target of GNU Emacs symlink:
 .br
   emacs-22
-.SH "ACTION: UPDATE"
-\fBeselect emacs update\fR [\fIifunset\fR]
+.SH ACTION: UPDATE
+.B eselect emacs update
+.RI [ ifunset ]
 .br
-Update the emacs symlink to the last available version. If option
-[\fIifunset\fR] is given, an existing implementation is not
-overridden.
+Update the emacs symlink to the last available version.  If option
+.I ifunset
+is given, an existing implementation is not overridden.
 
 # eselect emacs update
 .br
@@ -69,12 +80,12 @@ Switching emacs to emacs-22 ...
 Switching ctags to ctags-emacs-22 ...
 .br
 Switching etags to etags-emacs-22 ...
-.SH "AUTHORS"
-Christian Faulhammer <opfer@gentoo.org>
+.SH AUTHORS
+Christian Faulhammer <fauli@gentoo.org>
 .br
 Ulrich Mueller <ulm@gentoo.org>
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR eselect (1),
 .BR ctags.eselect (5)
-.SH "REVISION"
+.SH REVISION
 $Id$