all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Dani Moncayo <dmoncayo@gmail.com>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 18840@debbugs.gnu.org
Subject: bug#18840: 24.4; nt/README.W32: obsolete snippet
Date: Sun, 26 Oct 2014 17:49:39 +0100	[thread overview]
Message-ID: <CAH8Pv0h2xWArigsVsXADWBY0Yz7MPKJePMeuPkvsQuMH3yHWZw@mail.gmail.com> (raw)
In-Reply-To: <83lho24y28.fsf@gnu.org>

>> This snipped from the file nt/README.W32:
>> -------------------------
>> * Preliminaries
>>
>>   Along with this file should be four subdirectories (bin, libexec,
>>   share, and var).
>> -------------------------
>> is obsolete, since now this file is placed under
>> 'share/emacs/VERSION/' on the binary distribution.
>>
>> So, it should be either reworded or removed.
>
> Actually, I think that file should be manually copied to the top-level
> directory, after "make install" finishes.  Otherwise, the probability
> of it being discovered by users is probably close to zero.

That's a possibility, but I think we also should:

* Reword that section to make it independent of the location of the
  README.W32 file (the current wording is not valid for the copy in
  'share/emacs/VERSION').

* Tell the user _not_ to copy the top-level README.W32 when setting up
  his/her Emacs setup (individual packages should not pollute the top
  level directory).

For example, something along these lines:

=== modified file 'nt/README.W32'
--- nt/README.W32       2014-10-09 00:47:30 +0000
+++ nt/README.W32       2014-10-26 16:33:39 +0000
@@ -21,12 +21,19 @@

 * Preliminaries

-  Along with this file should be four subdirectories (bin, libexec,
-  share, and var).
+  The binary distribution has these top-level directories:
+
+  + bin: <explain briefly its contents>
+
+  + libexec: <explain briefly its contents>
+
+  + share: <explain briefly its contents>
+
+  + var: <explain briefly its contents>

 * Setting up Emacs

-  To install Emacs, simply unpack all the files into a directory of
+  To install Emacs, simply unpack the top-level directories into a directory of
   your choice.  To complete the installation process, you can
   optionally run the program addpm.exe in the bin subdirectory.  This
   will put an icon for Emacs in the Start Menu under

-- 
Dani Moncayo





  reply	other threads:[~2014-10-26 16:49 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-10-26  9:47 bug#18840: 24.4; nt/README.W32: obsolete snippet Dani Moncayo
2014-10-26 16:04 ` Eli Zaretskii
2014-10-26 16:49   ` Dani Moncayo [this message]
2014-10-26 17:17     ` Eli Zaretskii
2014-10-26 17:55       ` Dani Moncayo
2014-10-26 18:05         ` Dani Moncayo
2014-10-26 18:24           ` Eli Zaretskii
2014-10-26 18:40             ` Dani Moncayo

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=CAH8Pv0h2xWArigsVsXADWBY0Yz7MPKJePMeuPkvsQuMH3yHWZw@mail.gmail.com \
    --to=dmoncayo@gmail.com \
    --cc=18840@debbugs.gnu.org \
    --cc=eliz@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.