From mboxrd@z Thu Jan 1 00:00:00 1970 From: myglc2 Subject: Re: Emacs-Guix 0.3.1 Date: Mon, 22 May 2017 22:48:56 -0400 Message-ID: <86efvgb84n.fsf@gmail.com> References: <87a86rp1r9.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]:51290) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dCzsb-00005m-W2 for help-guix@gnu.org; Mon, 22 May 2017 22:49:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dCzsY-0007Z7-U3 for help-guix@gnu.org; Mon, 22 May 2017 22:49:02 -0400 Received: from mail-qt0-x232.google.com ([2607:f8b0:400d:c0d::232]:34125) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dCzsY-0007Z0-Q0 for help-guix@gnu.org; Mon, 22 May 2017 22:48:58 -0400 Received: by mail-qt0-x232.google.com with SMTP id c13so117185224qtc.1 for ; Mon, 22 May 2017 19:48:58 -0700 (PDT) In-Reply-To: (Fox's message of "Mon, 22 May 2017 08:21:09 +0200") 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 On 05/22/2017 at 08:21 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. > > 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, 'google it' failed you here: The top 'google eshell' didn't answer you question. If you had run emacs, typed 'M-x info m emacs C-s eshell C-s' you would have read ... =E2=80=98M-x eshell=E2=80=99 invokes a shell implemented entirely in Ema= cs. It is documented in its own manual. *Note Eshell: (eshell)Top. google/HTML is worse than emacs/INFO for a number of reasons. One of them: Google typically shows you the DOC for a different software version than you are trying to use. So you end up wasting many hours reading all about how the software you are running does NOT work and wondering what on earth is wrong. If you will invest an hour learning how to use emacs/INFO you will save many such hours ;-) Agreed, the top 'google eshell' hit could be improved. If you 'google eshell bugs' it takes you to ... https://www.gnu.org/software/emacs/manual/html_node/eshell/Bugs-and-ideas.h= tml If, as it suggests, you run emacs type 'M-x report-emacs-bug' and attach your original email, it might even be ;-)