From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: [PATCH 4/6] doc: emacs: Add "Locations" section. Date: Tue, 05 Apr 2016 22:46:46 +0200 Message-ID: <87wpobwzpl.fsf@gnu.org> References: <1459799266-7426-1-git-send-email-alezost@gmail.com> <1459799266-7426-5-git-send-email-alezost@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]:44548) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1anXsE-0004U5-SL for guix-devel@gnu.org; Tue, 05 Apr 2016 16:46:55 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1anXs9-0003DM-PJ for guix-devel@gnu.org; Tue, 05 Apr 2016 16:46:54 -0400 In-Reply-To: <1459799266-7426-5-git-send-email-alezost@gmail.com> (Alex Kost's message of "Mon, 4 Apr 2016 22:47:44 +0300") 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@gnu.org Alex Kost skribis: > * doc/emacs.texi (Emacs Commands): Move description of 'guix-edit' > command to... > (Emacs Locations): ... here. Document 'guix-find-location'. New > section. > * doc/guix.texi (Top): Add it. [...] > +@node Emacs Locations > +@section Locations =E2=80=9CSource Locations=E2=80=9D or =E2=80=9CPackage Source Locations=E2= =80=9D or =E2=80=9CSource of Package Definitions=E2=80=9D? > +As you know, package definitions are placed in Guile files, also known > +as @dfn{package locations}. The following commands should help you not > +getting lost in these locations: s/getting/get/ > +@table @kbd > + > +@item M-x guix-find-location > +Find package location file (press @key{TAB} to choose a location from a > +completion list). Maybe =E2=80=9COpen the given package definition source file=E2=80=9C? (I= =E2=80=99ve always found the use of the word =E2=80=98find=E2=80=99 in Emacs to be somewhat co= nfusing, but maybe it=E2=80=99s just me.) > +If you are contributing to Guix, you may find it useful for @kbd{M-x > +guix-find-location} and @kbd{M-x guix-edit} to open locations from your > +git directory. This can be done by setting @code{guix-directory} s/git directory/Git checkout/ Thanks, Ludo=E2=80=99.