User Guide for Emacs Daemon init script
=======================================

GNU Emacs 23 supports running as a daemon in the background, to which
a user can connect through the emacsclient program.  This can be done
either in the current terminal (emacsclient -t), or by opening a new X
window (emacsclient -c), giving maximum flexibility in connection with
the multi-tty extension also available in Emacs 23.

Every user who wants to connect to an Emacs server must have an own
instance of the daemonized GNU Emacs.  The init script automatically
determines the user by its name, so you create a symbolic link (do
not copy the script, or you will miss eventual updates!) in your
/etc/init.d directory:

	ln -s emacs /etc/init.d/emacs.<username>

This may be added to the boot sequence (and will run under the user's
privileges)

	rc-update add emacs.<username>

To get all benefits of the daemon setup, you should set the EDITOR
environment variable to "emacsclient", so that programs calling an
external editor will use the existing Emacs process.  Also file
associations in your desktop system should call emacsclient.  When
closing a session or frame, no contents is lost; you may simply
reconnect to the Emacs server.

Further customizations can be done through the /etc/conf.d/emacs file,
which is extensively commented.  You may also create individual
/etc/conf.d/emacs.<username> files for "multiplexed" user
configuration.

Please contact the Gentoo GNU Emacs team directly through Bugzilla
https://bugs.gentoo.org/ (preferred) or by e-mail gnu-emacs@gentoo.org
if you have problems, feature requests or bug reports.


Authors
=======

Ulrich Müller <ulm@gentoo.org>
Christian Faulhammer <fauli@gentoo.org> (documentation)
