From: David Wardle <d.wardle.b@gmail.com>
To: emacs-devel@gnu.org
Cc: Eli Zaretskii <eliz@gnu.org>
Subject: Suggested amendment to www.gnu.org/software/emacs/download.html#windows
Date: Wed, 29 Nov 2017 10:24:27 +1300 [thread overview]
Message-ID: <CABkDqShF+_xzmMaBxvnCW5k-xsu1ry1sTpTZDinKL8dJscDaqA@mail.gmail.com> (raw)
Hi developers.
I have a suggested amendment to:
https://www.gnu.org/software/emacs/download.html#windows
I've put the suggested amendment and the reason I suggest it below (in
separate sections).
Sincerely,
David Wardle
Auckland
NEW ZEALAND
--------------------------------------------------------------------------------------------------------
The amendment:
Append to the first paragraph (which currently ends
`...double-clicking on that shortcut's icon.'):
`Note that to use some tools, <a
href="http://www.gnu.org/software/emacs/DMSwinAH.html"> additional
downloads are required</a>.'
...where the link is to a new webpage with content (this is just the
bare bones):
<body>
<h1>GNU Emacs</h1>
<h2>Download & installation --- MicroSoft Windows system ---
additional help</h2>
<p>Running <code>bin\runemacs.exe</code> should give:
<img class="teaser" src="images/teaser.png" alt=""/>
(or something similar).</p>
<p>Clicking on Tools gives the options:
<!-- A picture the same as the previous one, but with the Tools menu
dropped down -->
</p>
<p>Some of the options e.g. Compare (Ediff) will not work unless
additional packages are downloaded and correctly installed.</p>
<h3>An example solution</h3>
<p>Taking the case of Compare (Ediff), one solution (among several
possibilities) is to download the Setup program for <a
href="http://gnuwin32.sourceforge.net/packages/diffutils.htm">DiffUtils
for Windows</a> (which is created by the <a
href="http://gnuwin32.sourceforge.net/">GnuWin project</a>). Running
the Setup program will create a directory on your computer e.g.
`C:\Program Files\GnuWin32' containing directories `bin' (which
contains programs `comp.exe', `diff.exe', etc.), `contrib' (which
contains a directory `diffutils'), etc.</p>
<p>In order for Compare (Ediff) to work, Emacs needs to be told about
the existence of `comp.exe', `diff.exe', etc. This is done by <a
href="https://www.computerhope.com/issues/ch000549.htm">adding the
directory</a> `C:\Program Files\GnuWin32\bin' to your computer's PATH
(note that changing the PATH is serious and must be done with care ---
be sure to record the PATH <em>before</em> you change anything in case
you need to return the PATH to its original state).
</body>
--------------------------------------------------------------------------------------------------------
The reason I suggest it:
I'm not a computer expert. But I do have some knowledge. I have been
using a Mac but recently needed to organize some files on a Windows
machine. I went to Wikipedia:
https://en.wikipedia.org/wiki/Comparison_of_file_comparison_tools
Based on the Wikipedia page, Ediff seemed the most appealing option
(it could compare binary files, was available across the three major
operating systems, etc.). So I followed the Wikipedia links to the
Emacs Wikipedia page and then to:
https://www.gnu.org/software/emacs/download.html#windows
I downloaded emacs-25.3-i686.zip from:
http://mirror.lagoon.nc/pub/gnu/emacs/windows/
When I ran bin\runemacs.exe, Emacs started fine and Tool -> Compare
(Ediff) worked fine comparing directories. But, when I tried to use
Ediff for comparing files, I just got the error `No such file or
directory, diff'. This had me completely mystified. I spent hours
trying to understand the error and did get there in the end with some
much appreciated help:
http://lists.gnu.org/archive/html/help-emacs-windows/2017-11/msg00000.html
But it would have been much better if the download instructions were
supplemented with some additional information for less-expert users
(like me). Such information would have saved me hours of frustration
and the need to pester others. Hence the reason I make my suggestion.
next reply other threads:[~2017-11-28 21:24 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-11-28 21:24 David Wardle [this message]
2017-11-29 3:30 ` Suggested amendment to www.gnu.org/software/emacs/download.html#windows Eli Zaretskii
2017-12-09 5:09 ` David Wardle
2017-12-09 14:50 ` Óscar Fuentes
2017-12-09 14:59 ` Noam Postavsky
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CABkDqShF+_xzmMaBxvnCW5k-xsu1ry1sTpTZDinKL8dJscDaqA@mail.gmail.com \
--to=d.wardle.b@gmail.com \
--cc=eliz@gnu.org \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.