From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: Merging guix.el Date: Tue, 02 Sep 2014 00:28:40 +0200 Message-ID: <87k35nug9z.fsf@gnu.org> References: <874mx3z9h2.fsf@gnu.org> <87fvgim60p.fsf@gmail.com> <87mwaobxbo.fsf@gnu.org> <87tx4wlbis.fsf@gmail.com> <87wq9s4bqy.fsf@gnu.org> <87iolbkvbc.fsf@gmail.com> <87lhq466xx.fsf@gnu.org> <8761h7lpal.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:40712) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XOa5h-0008IS-SQ for guix-devel@gnu.org; Mon, 01 Sep 2014 18:28:55 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XOa5b-0005Mn-Co for guix-devel@gnu.org; Mon, 01 Sep 2014 18:28:49 -0400 Received: from hera.aquilenet.fr ([2a01:474::1]:54544) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XOa5a-0005Md-TT for guix-devel@gnu.org; Mon, 01 Sep 2014 18:28:43 -0400 In-Reply-To: <8761h7lpal.fsf@gmail.com> (Alex Kost's message of "Mon, 01 Sep 2014 12:26:26 +0400") 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: Alex Kost Cc: Guix-devel Alex Kost skribis: > I've just pushed a manual for =E2=80=9Cguix.el=E2=80=9D (into =E2=80=9Cem= acs-ui=E2=80=9D branch). I > tried my best, but I'm not a native English speaker and I have never > worked with Texinfo before, so there may be... issues :-) Looks good to me! Here are some minor comments (I=E2=80=99m not a native speaker either): +GNU Guix is distributed with a user interface for GNU Emacs (which is +also known as ``guix.el''). It can be used for: To make the goal clearer, what about something like: GNU Guix comes with a visual user interface for GNU@tie{}Emacs, known as ``guix.el''. It can be used for routine package management tasks, pretty much like the @command{guix package} command (@pxref{Invoking guix package}). Specifically, guix.el makes it easy to: @itemize @item browse and display ... @item search ... ... Also there are a few places that mention =E2=80=9CGuix packages=E2=80=9D, w= here it should be just =E2=80=9Cpackages=E2=80=9D, I think. +@menu +* Initial Setup:: +* Usage:: +* Configuration:: +@end menu Please add something to the right-hand side. Node names are global, so they need to be less generic, to avoid possible name clashes with the rest of the manual. For instance: guix.el Setup guix.el Usage guix.el Configuration The section names can remain unchanged, though. +@item +@uref{http://nongnu.org/geiser/, Geiser}, version 0.3 or later: it is +used for interacting with guile process. =E2=80=9Cwith the Guile process=E2=80=9D +In rare occasions (for example if you compile your Emacs manually and =E2=80=9COn rare occasions=E2=80=9D +@node Usage +@subsection Usage + +After successful setting up ``guix.el'', you should be able to use =E2=80=9COnce ``guix.el'' has been successfully configured, ...=E2=80=9D +@item C-c C-z +Go to the Guix REPL. Add: (@pxref{The REPL,,, geiser, Geiser User Manual}) +@menu +* Commands:: +* List buffer:: +* Info buffer:: +@end menu Same remark as the other menu and node names. +@node Configuration +@subsection Configuration + +There are many variables you can modify to change the appearance or +behavior of Emacs UI. Some of these variables are described in this s/UI/user interface/ +@menu +* Guile and Build Options:: +* Keymaps:: +* Appearance:: +@end menu RHS and node names. --- a/doc/guix.texi +++ b/doc/guix.texi @@ -584,6 +584,7 @@ management tools it provides. * Invoking guix gc:: Running the garbage collector. * Invoking guix pull:: Fetching the latest Guix and distribution. * Invoking guix archive:: Exporting and importing store files. +* Emacs Interface:: Package management from Emacs. @end menu What about moving it higher, just after =E2=80=9CInvoking guix package=E2= =80=9D? Thank you! Ludo=E2=80=99.