From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Cl=C3=A9ment?= Lassieur Subject: Re: Emacs-Guix 0.3.1 Date: Mon, 22 May 2017 10:51:19 +0200 Message-ID: <87inkt46m0.fsf@lassieur.org> References: <87a86rp1r9.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:43141) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dCj3n-0005iO-Su for help-guix@gnu.org; Mon, 22 May 2017 04:51:30 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dCj3j-0005vs-Br for help-guix@gnu.org; Mon, 22 May 2017 04:51:27 -0400 Received: from mail.lassieur.org ([83.152.10.219]:57530) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dCj3j-0005sp-4L for help-guix@gnu.org; Mon, 22 May 2017 04:51:23 -0400 In-reply-to: List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org Sender: "Help-Guix" To: Fox Cc: help-guix@gnu.org Fox writes: > Alex Kost wrote: > >> if you don't like to read "info", Emacs-Guix manual is available >> online now: > > https://alezost.github.io/guix.el/manual/latest/html_node/index.html > > > html sure is better workable than the "info" format. I prefer the 'info' format because: - it makes it very easy to grep special characters (try to grep the pair syntax (a . b) in Google..., with info, just do: 's', then ' \. '), - keyboard bindings (i, m...) are incredibly useful when you are looking for info on a general topic or keyword, e.g. G-exps in Guix, 'format' in Guile. - it's offline. > But then, some GNU documentation suffers from lack of ability to explain > things to folks who do NOT know it all already. > > case in point: > https://www.gnu.org/software/emacs/manual/html_mono/eshell.html#Invocation > > if you expected to be told how to invoke an eshell, forget it. > That whole manual is only useful if you ALREADY know that you need to > press ALT-x eshell RETURN and the menus (where in a real editor such a > function would be available) will let you down, so don't even bother to > search eamcs menus for "eshell". So instead of reading the GNU manual on > eshell you better do what you always do: google it and often times succeed. Actually, the info you are looking for is in the Emacs manual (https://www.gnu.org/software/emacs/manual/html_node/emacs/Shell.html). BTW if you don't know 'info', there is an 'info' manual that is very helpful for people who do NOT know it all already: (https://www.gnu.org/software/texinfo/manual/info-stnd/info-stnd.html) :-)