From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alex Kost Subject: [PATCH 4/4] doc: Describe how Emacs packages are found. Date: Wed, 6 Jan 2016 19:55:05 +0300 Message-ID: <1452099305-746-5-git-send-email-alezost@gmail.com> References: <1452099305-746-1-git-send-email-alezost@gmail.com> Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:42542) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aGrNX-0003PA-2S for guix-devel@gnu.org; Wed, 06 Jan 2016 11:56:07 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aGrNW-000143-2M for guix-devel@gnu.org; Wed, 06 Jan 2016 11:56:07 -0500 Received: from mail-lf0-x22b.google.com ([2a00:1450:4010:c07::22b]:33258) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aGrNV-00013x-RO for guix-devel@gnu.org; Wed, 06 Jan 2016 11:56:05 -0500 Received: by mail-lf0-x22b.google.com with SMTP id p203so318885625lfa.0 for ; Wed, 06 Jan 2016 08:56:05 -0800 (PST) Received: from localhost.localdomain ([217.107.192.146]) by smtp.gmail.com with ESMTPSA id h9sm17188380lbj.42.2016.01.06.08.56.04 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 06 Jan 2016 08:56:04 -0800 (PST) In-Reply-To: <1452099305-746-1-git-send-email-alezost@gmail.com> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: guix-devel@gnu.org * doc/guix.texi (Application Setup)[Emacs Packages]: New subsection. --- doc/guix.texi | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index c252f63..7c60780 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -1051,6 +1051,25 @@ for Chinese languages: guix package -i font-adobe-source-han-sans:cn @end example +@subsection Emacs Packages + +When you install Emacs packages with Guix, the elisp files may be placed +either in @file{$HOME/.guix-profile/share/emacs/site-lisp/} or in +sub-directories of +@file{$HOME/.guix-profile/share/emacs/site-lisp/guix.d/}. The latter +directory exists because potentially there may exist thousands of Emacs +packages and storing all their files in a single directory may be not +reliable (because of name conflicts). So we think using a separate +directory for each package is a good idea. It is very similar to how +Emacs package system organizes the file structure (@pxref{Package +Files,,, emacs, The GNU Emacs Manual}). + +By default, Emacs (installed with Guix) ``knows'' where these packages +are placed, so you don't need to perform any configuring. If, for some +reason, you want to avoid auto-loading Emacs packages, installed with +Guix, you can do it by running Emacs with @code{--no-site-file} option +(@pxref{Init File,,, emacs, The GNU Emacs Manual}). + @c TODO What else? @c ********************************************************************* -- 2.6.3