Re: Emacs-Guix 0.3.1

[myglc2 <myglc2@gmail.com>]

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 ...

   ‘M-x eshell’ invokes a shell implemented entirely in Emacs.  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.html

If, as it suggests, you run emacs type 'M-x report-emacs-bug' and attach
your original email, it might even be ;-)