diff options
| -rw-r--r-- | admin/ChangeLog | 14 | ||||
| -rw-r--r-- | admin/nt/README.W32 | 133 |
2 files changed, 74 insertions, 73 deletions
diff --git a/admin/ChangeLog b/admin/ChangeLog index 25806e275e0..cbc244bd78c 100644 --- a/admin/ChangeLog +++ b/admin/ChangeLog | |||
| @@ -1,3 +1,17 @@ | |||
| 1 | 2009-02-23 Jason Rumney <jasonr@gnu.org> | ||
| 2 | |||
| 3 | * nt/README-ftp-server: Update for 23.0.91 | ||
| 4 | |||
| 5 | * nt/README.W32: Remove ever expanding versions of | ||
| 6 | Windows. Shorten FAQ URL. Remove mention of obsolete lock | ||
| 7 | directory. Windows distribution now bin and barebin only. Add | ||
| 8 | note about SVG support. Remove old tar and gzip problem | ||
| 9 | workarounds. Use new (22.x) -Q option. Report all bugs through | ||
| 10 | bug tracker. | ||
| 11 | |||
| 12 | * nt/README-UNDUMP.W32: Modify for barebin distribution, as | ||
| 13 | undumped distribution no longer exists. | ||
| 14 | |||
| 1 | 2009-02-05 Yu-ji Hosokawa <yu-ji@hoso.net> (tiny change) | 15 | 2009-02-05 Yu-ji Hosokawa <yu-ji@hoso.net> (tiny change) |
| 2 | 16 | ||
| 3 | * nt/README.W32: Fix typo. (Bug#2207) | 17 | * nt/README.W32: Fix typo. (Bug#2207) |
diff --git a/admin/nt/README.W32 b/admin/nt/README.W32 index 12aa04c8e1e..d21959ced19 100644 --- a/admin/nt/README.W32 +++ b/admin/nt/README.W32 | |||
| @@ -4,62 +4,61 @@ See the end of the file for license conditions. | |||
| 4 | 4 | ||
| 5 | Emacs for Windows | 5 | Emacs for Windows |
| 6 | 6 | ||
| 7 | This README file describes how to set up and run a precompiled version | 7 | This README file describes how to set up and run a precompiled |
| 8 | of GNU Emacs for Windows NT/2000/XP and Windows 95/98/Me. This | 8 | version of GNU Emacs for Windows. This distribution can be found on |
| 9 | distribution can be found on the ftp.gnu.org server and its mirrors: | 9 | the ftp.gnu.org server and its mirrors: |
| 10 | 10 | ||
| 11 | ftp://ftp.gnu.org/gnu/emacs/windows/ | 11 | ftp://ftp.gnu.org/gnu/emacs/windows/ |
| 12 | 12 | ||
| 13 | This server contains other distributions, including the full Emacs | 13 | This server contains other distributions, including the full Emacs |
| 14 | source distribution and the lisp source distribution, as well as older | 14 | source distribution and a barebin distribution which can be installed |
| 15 | releases of Emacs for Windows. | 15 | over it, as well as older releases of Emacs for Windows. |
| 16 | 16 | ||
| 17 | Answers to frequently asked questions, and further information about | 17 | Answers to frequently asked questions, and further information about |
| 18 | this port of GNU Emacs and related software packages can be found via | 18 | this port of GNU Emacs and related software packages can be found via |
| 19 | http: | 19 | http: |
| 20 | 20 | ||
| 21 | http://www.gnu.org/software/emacs/windows/ntemacs.html | 21 | http://www.gnu.org/software/emacs/windows/ |
| 22 | 22 | ||
| 23 | * Preliminaries | 23 | * Preliminaries |
| 24 | 24 | ||
| 25 | Along with this file should be six subdirectories (bin, etc, info, | 25 | Along with this file should be five subdirectories (bin, etc, info, |
| 26 | lisp, lock, site-lisp). Depending on which distribution you have | 26 | lisp, site-lisp). If you have downloaded the barebin distribution, |
| 27 | installed, the lisp subdirectory might contain both the lisp source | 27 | then it will contain only the bin directory and the built in |
| 28 | (*.el) and compiled lisp files (*.elc), or just the compiled lisp | 28 | documentation in etc/DOC-X, the rest of the subdirectories are in |
| 29 | files. If you don't have the lisp source files, you can obtain them | 29 | the src distribution, which the barebin distribution is designed to |
| 30 | by downloading the lisp source distribution or the full source | 30 | be used with. |
| 31 | distribution from the ftp site mentioned above. | ||
| 32 | 31 | ||
| 33 | * Setting up Emacs | 32 | * Setting up Emacs |
| 34 | 33 | ||
| 35 | To install Emacs, simply unpack all the files into a directory of your | 34 | To install Emacs, simply unpack all the files into a directory of |
| 36 | choice, but note that you might encounter minor problems if there is a | 35 | your choice, but note that you might encounter minor problems if |
| 37 | space anywhere in the directory name. To complete the installation | 36 | there is a space anywhere in the directory name. To complete the |
| 38 | process, you can optionally run the program addpm.exe in the bin | 37 | installation process, you can optionally run the program addpm.exe |
| 39 | subdirectory. This will add some entries to the registry that tell | 38 | in the bin subdirectory. This will put an icon for Emacs in the |
| 40 | Emacs where to find its support files, and put an icon for Emacs in | 39 | Start Menu under "Start -> Programs -> Gnu Emacs". |
| 41 | the Start Menu under "Start -> Programs -> Gnu Emacs -> Emacs". | ||
| 42 | 40 | ||
| 43 | Some users have reported that the Start Menu item is not created for | 41 | Some users have reported that the Start Menu item is not created for |
| 44 | them. If this happens, just create your own shortcut to runemacs.exe, | 42 | them. If this happens, just create your own shortcut to runemacs.exe, |
| 45 | eg. by dragging it on to the desktop or the Start button. | 43 | eg. by dragging it on to the desktop or the Start button. |
| 46 | 44 | ||
| 47 | Note that running addpm is now an optional step; Emacs is able to | 45 | Note that running addpm is now an optional step; Emacs is able to |
| 48 | locate all of its files without needing the information to be set in | 46 | locate all of its files without needing any information to be set in |
| 49 | the environment or the registry, although such settings will still be | 47 | the environment or the registry, although such settings will still |
| 50 | obeyed if present. This is convenient for running Emacs on a machine | 48 | be obeyed if present. This is convenient for running Emacs on a |
| 51 | which disallows registry changes, or on which software should not be | 49 | machine which disallows registry changes, or on which software |
| 52 | installed. For instance, you can now run Emacs directly from a CD | 50 | should not be installed. For instance, you can now run Emacs |
| 53 | without copying or installing anything on the machine itself. | 51 | directly from a CD or USB flash drive without copying or installing |
| 52 | anything on the machine itself. | ||
| 54 | 53 | ||
| 55 | * Starting Emacs | 54 | * Starting Emacs |
| 56 | 55 | ||
| 57 | To run Emacs, simply select Emacs from the Start Menu, or invoke | 56 | To run Emacs, simply select Emacs from the Start Menu, or invoke |
| 58 | runemacs.exe directly from Explorer or a command prompt. This will | 57 | runemacs.exe directly from Explorer or from a command prompt. This |
| 59 | start Emacs in its default GUI mode, ready to use. If you have never | 58 | will start Emacs in its default GUI mode, ready to use. If you have |
| 60 | used Emacs before, you should follow the tutorial at this point | 59 | never used Emacs before, you should follow the tutorial at this |
| 61 | (select Emacs Tutorial from the Help menu), since Emacs is quite | 60 | point (select Emacs Tutorial from the Help menu), since Emacs is |
| 62 | different from ordinary Windows applications in many respects. | 61 | quite different from ordinary Windows applications in many respects. |
| 63 | 62 | ||
| 64 | If you want to use Emacs in tty or character mode within a command | 63 | If you want to use Emacs in tty or character mode within a command |
| 65 | window, you can start it by typing "emacs -nw" at the command prompt. | 64 | window, you can start it by typing "emacs -nw" at the command prompt. |
| @@ -108,7 +107,7 @@ See the end of the file for license conditions. | |||
| 108 | `Movemail' node of the Emacs manual. | 107 | `Movemail' node of the Emacs manual. |
| 109 | 108 | ||
| 110 | + digest-doc.exe, sorted-doc.exe - Tools for rebuilding the | 109 | + digest-doc.exe, sorted-doc.exe - Tools for rebuilding the |
| 111 | built-in documentation. | 110 | built-in documentation. |
| 112 | 111 | ||
| 113 | * Image support | 112 | * Image support |
| 114 | 113 | ||
| @@ -138,18 +137,24 @@ See the end of the file for license conditions. | |||
| 138 | GIF: requires libungif or giflib 4.1 or later, which will be | 137 | GIF: requires libungif or giflib 4.1 or later, which will be |
| 139 | called giflib4.dll, libungif4.dll or libungif.dll. | 138 | called giflib4.dll, libungif4.dll or libungif.dll. |
| 140 | 139 | ||
| 140 | In addition, Emacs can be compiled to support SVG. This precompiled | ||
| 141 | distribution has not been compiled that way, since the SVG library | ||
| 142 | or one or more of its extensive dependencies appear to be | ||
| 143 | unreliable under Windows. See nt/INSTALL in the src distribution if | ||
| 144 | you wish to compile Emacs with SVG support. | ||
| 141 | 145 | ||
| 142 | * Uninstalling Emacs | 146 | * Uninstalling Emacs |
| 143 | 147 | ||
| 144 | If you should need to uninstall Emacs, simply delete all the files and | 148 | If you should need to uninstall Emacs, simply delete all the files |
| 145 | subdirectories from the directory where it was unpacked (Emacs does | 149 | and subdirectories from the directory where it was unpacked (Emacs |
| 146 | not install or update any files in system directories or anywhere | 150 | does not install or update any files in system directories or |
| 147 | else). If you ran the addpm.exe program to create the registry | 151 | anywhere else). If you ran the addpm.exe program to create the |
| 148 | entries and the Start menu icon, then you can remove the registry | 152 | registry entries and the Start menu icon, then you can remove the |
| 149 | entries using regedit. All of the settings are written under the | 153 | registry entries using regedit. All of the settings are written |
| 150 | Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you didn't have | 154 | under the Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you |
| 151 | administrator privileges, the same key in HKEY_CURRENT_USER. Just | 155 | didn't have administrator privileges when you installed, the same |
| 152 | delete the Software\GNU\Emacs key. | 156 | key in HKEY_CURRENT_USER. Just delete the whole Software\GNU\Emacs |
| 157 | key. | ||
| 153 | 158 | ||
| 154 | The Start menu entry can be removed by right-clicking on the Task bar | 159 | The Start menu entry can be removed by right-clicking on the Task bar |
| 155 | and selecting Properties, then using the Remove option on the Start | 160 | and selecting Properties, then using the Remove option on the Start |
| @@ -162,12 +167,10 @@ See the end of the file for license conditions. | |||
| 162 | Unpacking the distributions | 167 | Unpacking the distributions |
| 163 | 168 | ||
| 164 | If you encounter trouble trying to run Emacs, there are a number of | 169 | If you encounter trouble trying to run Emacs, there are a number of |
| 165 | possible causes. If you didn't use the versions of tar and gunzip (or | 170 | possible causes. Check the following for indications that the |
| 166 | djtarnt) on the above ftp site, it is possible that the distribution | 171 | distribution was not corrupted by the tools used to unpack it: |
| 167 | became corrupted while it was being unpacked. Check the following for | ||
| 168 | indications that the distribution was not corrupted: | ||
| 169 | 172 | ||
| 170 | * Be sure to disable the CR/LF translation or the executables will | 173 | * Be sure to disable CR/LF translation or the executables will |
| 171 | be unusable. Older versions of WinZipNT would enable this | 174 | be unusable. Older versions of WinZipNT would enable this |
| 172 | translation by default. If you are using WinZipNT, disable it. | 175 | translation by default. If you are using WinZipNT, disable it. |
| 173 | (I don't have WinZipNT myself, and I do not know the specific | 176 | (I don't have WinZipNT myself, and I do not know the specific |
| @@ -178,14 +181,6 @@ See the end of the file for license conditions. | |||
| 178 | truncated to abbrevli.elc, your distribution has been corrupted | 181 | truncated to abbrevli.elc, your distribution has been corrupted |
| 179 | while unpacking and Emacs will not start. | 182 | while unpacking and Emacs will not start. |
| 180 | 183 | ||
| 181 | * Users have said that some utilities (WinZip again?) don't create | ||
| 182 | the lock subdirectory. You can create the lock directory by hand | ||
| 183 | (it is normally empty). | ||
| 184 | |||
| 185 | * Users have also reported that the gnu-win32 tar corrupts the | ||
| 186 | executables. Use the version of tar or djtarnt on the ftp.gnu.org | ||
| 187 | site instead. | ||
| 188 | |||
| 189 | If you believe you have unpacked the distributions correctly and are | 184 | If you believe you have unpacked the distributions correctly and are |
| 190 | still encountering problems, see the section on Further Information | 185 | still encountering problems, see the section on Further Information |
| 191 | below. | 186 | below. |
| @@ -203,7 +198,7 @@ See the end of the file for license conditions. | |||
| 203 | your favorite web browser to following the document (if you haven't | 198 | your favorite web browser to following the document (if you haven't |
| 204 | already): | 199 | already): |
| 205 | 200 | ||
| 206 | http://www.gnu.org/software/emacs/windows/ntemacs.html | 201 | http://www.gnu.org/software/emacs/windows/ |
| 207 | 202 | ||
| 208 | This document serves as an FAQ and a source for further information | 203 | This document serves as an FAQ and a source for further information |
| 209 | about the Windows port and related software packages. | 204 | about the Windows port and related software packages. |
| @@ -240,24 +235,16 @@ See the end of the file for license conditions. | |||
| 240 | about it. First check the FAQ on the web page above to see if the bug | 235 | about it. First check the FAQ on the web page above to see if the bug |
| 241 | is already known and if there are any workarounds. Then check whether | 236 | is already known and if there are any workarounds. Then check whether |
| 242 | the bug has something to do with code in your .emacs file, e.g. by | 237 | the bug has something to do with code in your .emacs file, e.g. by |
| 243 | invoking Emacs with the "-q --no-site-file" options. | 238 | invoking Emacs with the "-Q" option. |
| 244 | 239 | ||
| 245 | If you decide that it is a bug in Emacs that might be specific to the | 240 | If you decide that it is a bug in Emacs, use the built in bug |
| 246 | Windows port, send a message to the "help-emacs-windows@gnu.org" | 241 | reporting facility to report it (from the menu; Help -> Send Bug Report). |
| 247 | mailing list describing the bug, the version of Emacs that you are | 242 | If you have not yet configured Emacs for mail, then when you press |
| 248 | using, and the operating system that you are running on (Windows NT, | 243 | C-c C-c to send the report, it will ask you to paste the text of the |
| 249 | 2000, 95, 98, etc. including service pack level if known). If the bug | 244 | report into your mail client. If the bug is related to |
| 250 | is related to subprocesses, also specify which shell you are using | 245 | subprocesses, also specify which shell you are using (e.g., include |
| 251 | (e.g., include the values of `shell-file-name' and | 246 | the values of `shell-file-name' and `shell-explicit-file-name' in |
| 252 | `shell-explicit-file-name' in your message). | 247 | your message). |
| 253 | |||
| 254 | If you think the bug is not specific to the Windows port of Emacs, | ||
| 255 | then it is better to mail the bug report to "bug-gnu-emacs@gnu.org" so | ||
| 256 | that it will be seen by the right people. If Emacs has been set up to | ||
| 257 | send mail, you can use the command M-x report-emacs-bug to create and | ||
| 258 | send the bug report, but in some cases there is a function to report | ||
| 259 | bugs in a specific package; e.g. M-x gnus-bug for Gnus, M-x | ||
| 260 | c-submit-bug-report for C/C++/Java mode, etc. | ||
| 261 | 248 | ||
| 262 | Enjoy! | 249 | Enjoy! |
| 263 | 250 | ||