diff options
| author | Andrew Innes | 2001-08-29 13:58:01 +0000 |
|---|---|---|
| committer | Andrew Innes | 2001-08-29 13:58:01 +0000 |
| commit | 31098a38c7e84b5b6c2097e535ff0d2134b372e8 (patch) | |
| tree | adacafd9353057b77854df34d13e813be007c7c8 /admin | |
| parent | 5ae10f4ab76de8bd522c4d4d5acd7aa18342277c (diff) | |
| download | emacs-31098a38c7e84b5b6c2097e535ff0d2134b372e8.tar.gz emacs-31098a38c7e84b5b6c2097e535ff0d2134b372e8.zip | |
add scripts for creating precompiled Windows distributions
Diffstat (limited to 'admin')
| -rw-r--r-- | admin/nt/README-UNDUMP.W32 | 43 | ||||
| -rw-r--r-- | admin/nt/README-ftp-server | 241 | ||||
| -rw-r--r-- | admin/nt/README.W32 | 192 | ||||
| -rwxr-xr-x | admin/nt/dump.bat | 21 | ||||
| -rwxr-xr-x | admin/nt/makedist.bat | 122 |
5 files changed, 619 insertions, 0 deletions
diff --git a/admin/nt/README-UNDUMP.W32 b/admin/nt/README-UNDUMP.W32 new file mode 100644 index 00000000000..bd8f968fb06 --- /dev/null +++ b/admin/nt/README-UNDUMP.W32 | |||
| @@ -0,0 +1,43 @@ | |||
| 1 | Emacs for Windows NT and Windows 95/98/2000 | ||
| 2 | |||
| 3 | Version 21.0.104 pretest | ||
| 4 | |||
| 5 | July 16, 2001 | ||
| 6 | |||
| 7 | This README file describes how to dump a bare precompiled version of GNU | ||
| 8 | Emacs for Windows NT and Windows 95/98/2000. This distribution | ||
| 9 | supplements the standard dumped precompiled distribution of Emacs, which | ||
| 10 | you can download from: | ||
| 11 | |||
| 12 | ftp://ftp.gnu.org/gnu/windows/emacs/ | ||
| 13 | |||
| 14 | If you do not have the "bin" distribution, then you will need to | ||
| 15 | download it before you can use this undumped version. Also note that | ||
| 16 | you should only need to dump Emacs yourself if you want to dump Emacs | ||
| 17 | with more elisp files than are included normally, or to rebuild Emacs | ||
| 18 | after patching one of the elisp files that is preloaded. | ||
| 19 | |||
| 20 | The dumping process consists of running a bare Emacs, loading up a | ||
| 21 | number of general elisp files, and then creating a new Emacs executable | ||
| 22 | preinitialized and ready to run. In the precompiled distributions, | ||
| 23 | Emacs has already been dumped with the standard configuration. | ||
| 24 | |||
| 25 | To dump Emacs, unpack this distribution into the directory created by | ||
| 26 | unpacking the corresponding standard precompiled distribution. To | ||
| 27 | verify that you unpacked in the proper place, check to make sure that | ||
| 28 | you now have a temacs.exe file in the bin directory. | ||
| 29 | |||
| 30 | Once you have unpacked this distribution, cd into the bin directory and | ||
| 31 | run dump.bat. This will produce a new bin\emacs.exe executable for you | ||
| 32 | to use (the original one is renamed to emacs.exe.orig; this is not | ||
| 33 | overwritten if you run dump more than once). | ||
| 34 | |||
| 35 | For more information about running Emacs, read the README.W32 file that | ||
| 36 | came with the standard dumped precompiled distribution. If you have | ||
| 37 | problems with Emacs, including problems with dumping, send email to | ||
| 38 | "ntemacs-users@cs.washington.edu". | ||
| 39 | |||
| 40 | Enjoy. | ||
| 41 | |||
| 42 | Andrew Innes | ||
| 43 | (andrewi@gnu.org) | ||
diff --git a/admin/nt/README-ftp-server b/admin/nt/README-ftp-server new file mode 100644 index 00000000000..29f8e36d340 --- /dev/null +++ b/admin/nt/README-ftp-server | |||
| @@ -0,0 +1,241 @@ | |||
| 1 | Precompiled Distributions of | ||
| 2 | Emacs for Windows NT and Windows 95/98/2000 | ||
| 3 | |||
| 4 | Version 20.7 | ||
| 5 | |||
| 6 | June 13, 2000 | ||
| 7 | |||
| 8 | This directory contains source and precompiled distributions for GNU | ||
| 9 | Emacs on Windows NT and Windows 95/98/2000. This port is a part of | ||
| 10 | the standard GNU Emacs distribution from the Free Software Foundation; | ||
| 11 | the precompiled distributions are provided here for convenience since, | ||
| 12 | unlike Unix, the majority of Windows users do not have access to a | ||
| 13 | compiler (and, besides, do you really want to compile Emacs when you | ||
| 14 | don't have to?). | ||
| 15 | |||
| 16 | If you have access to the World Wide Web, I would recommend pointing | ||
| 17 | your favorite web browser to the following document (if you haven't | ||
| 18 | already): | ||
| 19 | |||
| 20 | http://www.gnu.org/software/emacs/windows/ntemacs.html | ||
| 21 | |||
| 22 | The above web document is a far more complete version of this README | ||
| 23 | file. If you don't have access to the Web, however, then read on. | ||
| 24 | |||
| 25 | |||
| 26 | * IMPORTANT LEGAL REMINDER | ||
| 27 | |||
| 28 | If you want to redistribute any of the precompiled distributions of | ||
| 29 | Emacs, be careful to check the implications of the GPL. For instance, | ||
| 30 | if you put the emacs-20.7-bin-i386.tar.gz file from this directory on | ||
| 31 | an Internet site, you must arrange to distribute the source files of | ||
| 32 | the SAME version (i.e. emacs-20.7-src.tar.gz). | ||
| 33 | |||
| 34 | Making a link to our copy of the source is NOT sufficient, since we | ||
| 35 | might upgrade to a new version while you are still distributing the | ||
| 36 | old binaries. | ||
| 37 | |||
| 38 | |||
| 39 | * Distributions in .tar.gz format | ||
| 40 | |||
| 41 | Emacs is distributed primarily as a set of large gzipped tar files | ||
| 42 | (*.tar.gz). Because Emacs is quite large and therefore difficult to | ||
| 43 | download over unreliable connections, it is provided in several | ||
| 44 | combinations, ranging from the complete source plus executables, to | ||
| 45 | just the minimal amount needed to run without any source, plus a | ||
| 46 | couple of optional packages. Here are the combinations (i386 in the | ||
| 47 | name indicates a tarball contains executables compiled for | ||
| 48 | Intel-compatible x86 systems): | ||
| 49 | |||
| 50 | + Primary precompiled distribution, including lisp source: | ||
| 51 | |||
| 52 | emacs-20.7-fullbin-i386.tar.gz | ||
| 53 | |||
| 54 | + Minimal precompiled distribution, which excludes lisp source: | ||
| 55 | |||
| 56 | emacs-20.7-bin-i386.tar.gz | ||
| 57 | |||
| 58 | You can download emacs-20.7-lisp.tar.gz to get the lisp source, if | ||
| 59 | you later decide you want it - it is useful for understanding how | ||
| 60 | packages work, and how they can best be setup or customized. | ||
| 61 | |||
| 62 | |||
| 63 | NB. If you just want to run Emacs, get one of the distributions above. | ||
| 64 | |||
| 65 | |||
| 66 | + Bare executables, only useful if you want to get the complete source | ||
| 67 | release below, but can't compile Emacs yourself: | ||
| 68 | |||
| 69 | emacs-20.7-barebin-i386.tar.gz (requires emacs-20.7-src.tar.gz) | ||
| 70 | |||
| 71 | + Undumped executable, only needed for rebuilding Emacs after changing | ||
| 72 | certain core lisp files: | ||
| 73 | |||
| 74 | emacs-20.7-undumped-i386.tar.gz | ||
| 75 | |||
| 76 | + Optional package providing the Library of Emacs Input Methods for | ||
| 77 | typing non-ascii characters, notably Chinese, Japanese and Korean, | ||
| 78 | but also including European and other character sets: | ||
| 79 | |||
| 80 | emacs-20.7-leim.tar.gz | ||
| 81 | |||
| 82 | + The complete official source for Emacs: | ||
| 83 | |||
| 84 | emacs-20.7-src.tar.gz | ||
| 85 | |||
| 86 | + The complete official source for LEIM: | ||
| 87 | |||
| 88 | leim-20.7-src.tar.gz | ||
| 89 | |||
| 90 | |||
| 91 | * Distributions in multi-file .zip format | ||
| 92 | |||
| 93 | A second distribution in the form of multiple small .zip files is also | ||
| 94 | provided, for the benefit of people who have unreliable internet | ||
| 95 | connections, or who need to copy the distribution onto floppy disks: | ||
| 96 | |||
| 97 | em207-b*.zip | ||
| 98 | |||
| 99 | This is equivalent to getting emacs-20.7-bin-i386.tar.gz above. | ||
| 100 | The lisp source is available as em207-l*.zip. | ||
| 101 | |||
| 102 | |||
| 103 | * Distributions for non-x86 platforms | ||
| 104 | |||
| 105 | I try to make this port available for all platforms supported by | ||
| 106 | Windows (it should build on all supported Windows NT/9x platforms). | ||
| 107 | However, I do not always have access to non-x86 platforms, and so I | ||
| 108 | cannot guarantee to provide precompiled distributions for the other | ||
| 109 | platforms myself. If you find there are no binaries for your | ||
| 110 | platform, and you have access to a Microsoft compiler, then you can | ||
| 111 | download the source and compile Emacs yourself (and, if you do, please | ||
| 112 | consider contributing your executables; send me mail and we can make | ||
| 113 | arrangements for making them available on this ftp server.) | ||
| 114 | |||
| 115 | |||
| 116 | * Unpacking distributions | ||
| 117 | |||
| 118 | Programs for handling the distribution file formats can be found in | ||
| 119 | the utilities directory: | ||
| 120 | |||
| 121 | ftp://ftp.gnu.org/gnu/windows/emacs/utilities | ||
| 122 | |||
| 123 | For gzipped tar files, you will need either gunzip.exe and tar.exe | ||
| 124 | together, or djtarnt.exe. djtarnt.exe can also unpack .zip files. I | ||
| 125 | strongly urge you to use these utilities since they were the ones used | ||
| 126 | to create the distributions; the most common problem people have in | ||
| 127 | trying to get Emacs to run is due to some other utility program | ||
| 128 | corrupting the distribution while unpacking. | ||
| 129 | |||
| 130 | Open a command prompt (MSDOS) window. Decide on a directory in which | ||
| 131 | to place Emacs. Move the distribution to that directory, and then | ||
| 132 | unpack it as follows. | ||
| 133 | |||
| 134 | If you have the gzipped tar version, use gunzip to uncompress the tar | ||
| 135 | file on the fly, and pipe the output through tar with the "xvf" flags | ||
| 136 | to extract the files from the tar file: | ||
| 137 | |||
| 138 | % gunzip -c some.tar.gz | tar xvf - | ||
| 139 | |||
| 140 | You may see messages from tar about not being able to change the | ||
| 141 | modification time on directories, and from gunzip complaining about a | ||
| 142 | broken pipe. These messages are harmless and you can ignore them. On | ||
| 143 | Windows NT, unpacking tarballs this way leaves them in compressed | ||
| 144 | form, taking up less space on disk. Unfortunately, on Windows 95 and | ||
| 145 | 98, a large temporary file is created, so it is better to use the | ||
| 146 | djtarnt.exe program, which performs the equivalent operation in one | ||
| 147 | step: | ||
| 148 | |||
| 149 | % djtarnt -x some.tar.gz | ||
| 150 | |||
| 151 | You may be prompted to rename or overwrite directories when using | ||
| 152 | djtarnt: simply type return to continue (this is harmless). | ||
| 153 | |||
| 154 | If you have the multi-file .zip distribution, use djtarnt to unpack | ||
| 155 | all of the .zip files: | ||
| 156 | |||
| 157 | % djtarnt -x *.zip | ||
| 158 | |||
| 159 | Once you have unpacked a precompiled distribution of Emacs, it should | ||
| 160 | have the following subdirectories: | ||
| 161 | |||
| 162 | bin etc info lisp lock site-lisp | ||
| 163 | |||
| 164 | If your utility failed to create the lock directory, then you can | ||
| 165 | simply create it by hand (it is initially empty). | ||
| 166 | |||
| 167 | |||
| 168 | * Unpacking with other tools | ||
| 169 | |||
| 170 | If you do use other utility programs to unpack the distribution, check | ||
| 171 | the following to be sure the distribution was not corrupted: | ||
| 172 | |||
| 173 | + Be sure to disable the CR/LF translation or the executables will be | ||
| 174 | unusable. Older versions of WinZipNT would enable this translation | ||
| 175 | by default. If you are using WinZipNT, disable it. (I don't have | ||
| 176 | WinZipNT myself, and I do not know the specific commands necessary | ||
| 177 | to disable it.) | ||
| 178 | |||
| 179 | + Check that filenames were not truncated to 8.3. For example, there | ||
| 180 | should be a file lisp/abbrevlist.el; if this has been truncated to | ||
| 181 | abbrevli.el, your distribution has been corrupted while unpacking | ||
| 182 | and Emacs will not start. | ||
| 183 | |||
| 184 | + I've been told that some utilities (WinZip again?) don't create the | ||
| 185 | lock subdirectory. The lock subdirectory needs to be created. | ||
| 186 | |||
| 187 | + I've also had reports that the "gnu-win32" port of tar corrupts the | ||
| 188 | executables. Use the version of tar or djtarnt in the utilities | ||
| 189 | directory instead. | ||
| 190 | |||
| 191 | If you believe you have unpacked the distributions correctly and are | ||
| 192 | still encountering problems, see the section on Further Information | ||
| 193 | below. | ||
| 194 | |||
| 195 | |||
| 196 | * Compiling from source | ||
| 197 | |||
| 198 | If you would like to compile Emacs from source, download the source | ||
| 199 | distribution, unpack it in the same manner as a precompiled | ||
| 200 | distribution, and look in the file nt/INSTALL for detailed directions. | ||
| 201 | Note, though, that you must have a Microsoft compiler to compile the | ||
| 202 | source. (Support for compiling with gcc 2.95 or later will be | ||
| 203 | available in a future release.) | ||
| 204 | |||
| 205 | |||
| 206 | * Further information | ||
| 207 | |||
| 208 | There is a web page that serves as a FAQ at: | ||
| 209 | |||
| 210 | http://www.gnu.org/software/emacs/windows/ntemacs.html | ||
| 211 | |||
| 212 | There is also a mailing list for discussing issues related to this | ||
| 213 | port of Emacs. For information about the list, send a message to | ||
| 214 | ntemacs-users-request@cs.washington.edu with the word "info" in the | ||
| 215 | *body* of the message. To subscribe to the list, send a message to | ||
| 216 | the same address with the word "subscribe" in the body of the message; | ||
| 217 | similarly, to unsubscribe from the list, send a message with the word | ||
| 218 | "unsubscribe" in the message body. | ||
| 219 | |||
| 220 | Another valuable source of information and help which should not be | ||
| 221 | overlooked is the various Usenet news groups dedicated to Emacs. | ||
| 222 | These are particuarly good for help with general issues which aren't | ||
| 223 | specific to the Windows port of Emacs. The main news groups to use | ||
| 224 | for seeking help are: | ||
| 225 | |||
| 226 | gnu.emacs.help | ||
| 227 | comp.emacs | ||
| 228 | |||
| 229 | There are also fairly regular postings and announcements of new or | ||
| 230 | updated Emacs packages on this group: | ||
| 231 | |||
| 232 | gnu.emacs.sources | ||
| 233 | |||
| 234 | You are also always welcome to send me mail directly. If you don't | ||
| 235 | hear from me immediately, however, don't worry; it sometimes takes me | ||
| 236 | a few days (or longer) to get to all of my mail regarding Emacs. | ||
| 237 | |||
| 238 | Enjoy! | ||
| 239 | |||
| 240 | Andrew Innes | ||
| 241 | (andrewi@gnu.org) | ||
diff --git a/admin/nt/README.W32 b/admin/nt/README.W32 new file mode 100644 index 00000000000..40667344b6a --- /dev/null +++ b/admin/nt/README.W32 | |||
| @@ -0,0 +1,192 @@ | |||
| 1 | Emacs for Windows NT and Windows 95/98/2000 | ||
| 2 | |||
| 3 | Version 21.0.104 pretest | ||
| 4 | |||
| 5 | July 16, 2001 | ||
| 6 | |||
| 7 | This README file describes how to set up and run a precompiled version | ||
| 8 | of GNU Emacs for Windows NT and Windows 95/98/2000. This distribution | ||
| 9 | can be found on the ftp.gnu.org server and its mirrors: | ||
| 10 | |||
| 11 | ftp://ftp.gnu.org/gnu/windows/emacs/ | ||
| 12 | |||
| 13 | This server contains other distributions, including the full Emacs | ||
| 14 | source distribution and the lisp source distribution, as well as older | ||
| 15 | releases of Emacs for Windows. | ||
| 16 | |||
| 17 | Answers to frequently asked questions, and further information about | ||
| 18 | this port of GNU Emacs and related software packages can be found via | ||
| 19 | http or ftp: | ||
| 20 | |||
| 21 | http://www.gnu.org/software/emacs/windows/ntemacs.html | ||
| 22 | ftp://ftp.gnu.org/gnu/windows/emacs/docs/ntemacs.html | ||
| 23 | |||
| 24 | * Preliminaries | ||
| 25 | |||
| 26 | Along with this file should be six subdirectories (bin, etc, info, | ||
| 27 | lisp, lock, site-lisp). Depending on which distribution you have | ||
| 28 | installed, the lisp subdirectory might contain both the lisp source | ||
| 29 | (*.el) and compiled lisp files (*.elc), or just the compiled lisp | ||
| 30 | files. If you don't have the lisp source files, you can obtain them | ||
| 31 | by downloading the lisp source distribution or the full source | ||
| 32 | distribution from the ftp site mentioned above. | ||
| 33 | |||
| 34 | * Setting up Emacs | ||
| 35 | |||
| 36 | To install Emacs, simply unpack all the files into a directory of your | ||
| 37 | choice, but note that you might encounter minor problems if there is a | ||
| 38 | space anywhere in the directory name. To complete the installation | ||
| 39 | process, you can optionally run the program addpm.exe in the bin | ||
| 40 | subdirectory. This will add some entries to the registry that tell | ||
| 41 | Emacs where to find its support files, and put an icon for Emacs in | ||
| 42 | the Start Menu under "Start -> Programs -> Gnu Emacs -> Emacs". | ||
| 43 | |||
| 44 | Some users have reported that the Start Menu item is not created for | ||
| 45 | them. If this happens, just create your own shortcut to runemacs.exe, | ||
| 46 | eg. by dragging it on to the desktop or the Start button. | ||
| 47 | |||
| 48 | Note that running addpm is now an optional step; Emacs is able to | ||
| 49 | locate all of its files without needing the information to be set in | ||
| 50 | the environment or the registry, although such settings will still be | ||
| 51 | obeyed if present. This is convenient for running Emacs on a machine | ||
| 52 | which disallows registry changes, or on which software should not be | ||
| 53 | installed. For instance, you can now run Emacs directly from a CD | ||
| 54 | without copying or installing anything on the machine itself. | ||
| 55 | |||
| 56 | * Starting Emacs | ||
| 57 | |||
| 58 | To run Emacs, simply select Emacs from the Start Menu, or invoke | ||
| 59 | runemacs.exe directly from Explorer or a command prompt. This will | ||
| 60 | start Emacs in its default GUI mode, ready to use. If you have never | ||
| 61 | used Emacs before, you should follow the tutorial at this point | ||
| 62 | (select Emacs Tutorial from the Help menu), since Emacs is quite | ||
| 63 | different from ordinary Windows applications in many respects. | ||
| 64 | |||
| 65 | If you want to use Emacs in tty or character mode within a command | ||
| 66 | window, you can start it by typing "emacs -nw" at the command prompt. | ||
| 67 | (Obviously, you need to ensure that the Emacs bin subdirectory is in | ||
| 68 | your PATH first, or specify the path to emacs.exe.) The -nw | ||
| 69 | (non-windowed) mode of operation is most useful if you have a telnet | ||
| 70 | server on your machine, allowing you to run Emacs remotely. | ||
| 71 | |||
| 72 | * Uninstalling Emacs | ||
| 73 | |||
| 74 | If you should need to uninstall Emacs, simply delete all the files and | ||
| 75 | subdirectories from the directory where it was unpacked (Emacs does | ||
| 76 | not install or update any files in system directories or anywhere | ||
| 77 | else). If you ran the addpm.exe program to create the registry | ||
| 78 | entries and the Start menu icon, then you can remove the registry | ||
| 79 | entries using regedit. All of the settings are written under the | ||
| 80 | Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you didn't have | ||
| 81 | administrator privileges, the same key in HKEY_CURRENT_USER. Just | ||
| 82 | delete the Software\GNU\Emacs key. | ||
| 83 | |||
| 84 | The Start menu entry can be removed by right-clicking on the Task bar | ||
| 85 | and selecting Properties, then using the Remove option on the Start | ||
| 86 | Menu Programs page. (If you installed under an account with | ||
| 87 | administrator privileges, then you need to click the Advanced button | ||
| 88 | and look for the Gnu Emacs menu item under All Users.) | ||
| 89 | |||
| 90 | * Troubleshooting | ||
| 91 | |||
| 92 | Unpacking the distributions | ||
| 93 | |||
| 94 | If you encounter trouble trying to run Emacs, there are a number of | ||
| 95 | possible causes. If you didn't use the versions of tar and gunzip (or | ||
| 96 | djtarnt) on the above ftp site, it is possible that the distribution | ||
| 97 | became corrupted while it was being unpacked. Check the following for | ||
| 98 | indications that the distribution was not corrupted: | ||
| 99 | |||
| 100 | * Be sure to disable the CR/LF translation or the executables will | ||
| 101 | be unusable. Older versions of WinZipNT would enable this | ||
| 102 | translation by default. If you are using WinZipNT, disable it. | ||
| 103 | (I don't have WinZipNT myself, and I do not know the specific | ||
| 104 | commands necessary to disable it.) | ||
| 105 | |||
| 106 | * Check that filenames were not truncated to 8.3. For example, | ||
| 107 | there should be a file lisp\abbrevlist.elc; if this has been | ||
| 108 | truncated to abbrevli.elc, your distribution has been corrupted | ||
| 109 | while unpacking and Emacs will not start. | ||
| 110 | |||
| 111 | * Users have said that some utilities (WinZip again?) don't create | ||
| 112 | the lock subdirectory. You can create the lock directory by hand | ||
| 113 | (it is normally empty). | ||
| 114 | |||
| 115 | * Users have also reported that the gnu-win32 tar corrupts the | ||
| 116 | executables. Use the version of tar or djtarnt on the ftp.gnu.org | ||
| 117 | site instead. | ||
| 118 | |||
| 119 | If you believe you have unpacked the distributions correctly and are | ||
| 120 | still encountering problems, see the section on Further Information | ||
| 121 | below. | ||
| 122 | |||
| 123 | Virus scanners | ||
| 124 | |||
| 125 | Some virus scanners interfere with Emacs' use of subprocesses. If you | ||
| 126 | are unable to use subprocesses and you use Dr. Solomon's WinGuard or | ||
| 127 | McAfee's Vshield, turn off "Scan all files" (WinGuard) or "boot sector | ||
| 128 | scanning" (McAfee exclusion properties). | ||
| 129 | |||
| 130 | * Further information | ||
| 131 | |||
| 132 | If you have access to the World Wide Web, I would recommend pointing | ||
| 133 | your favorite web browser to following the document (if you haven't | ||
| 134 | already): | ||
| 135 | |||
| 136 | http://www.gnu.org/software/emacs/windows/ntemacs.html | ||
| 137 | |||
| 138 | This document serves as an FAQ and a source for further information | ||
| 139 | about the Windows port and related software packages. | ||
| 140 | |||
| 141 | In addition to the FAQ, there is a mailing list for discussing issues | ||
| 142 | related to the Windows port of Emacs. The name of the list is | ||
| 143 | "ntemacs-users@cs.washington.edu". For information about the list, | ||
| 144 | send a message to "ntemacs-users-request@cs.washington.edu" with the | ||
| 145 | word "info" in the body of the message. To subscribe to the list, | ||
| 146 | send a message to the same address with the word "subscribe" in the | ||
| 147 | body of the message; similarly, to unsubscribe from the list, send a | ||
| 148 | message with the word "unsubscribe" in the message body. | ||
| 149 | |||
| 150 | Another valuable source of information and help which should not be | ||
| 151 | overlooked is the various Usenet news groups dedicated to Emacs. | ||
| 152 | These are particuarly good for help with general issues which aren't | ||
| 153 | specific to the Windows port of Emacs. The main news groups to use | ||
| 154 | for seeking help are: | ||
| 155 | |||
| 156 | gnu.emacs.help | ||
| 157 | comp.emacs | ||
| 158 | |||
| 159 | There are also fairly regular postings and announcements of new or | ||
| 160 | updated Emacs packages on this group: | ||
| 161 | |||
| 162 | gnu.emacs.sources | ||
| 163 | |||
| 164 | * Reporting bugs | ||
| 165 | |||
| 166 | If you encounter a bug in this port of Emacs, we would like to hear | ||
| 167 | about it. First check the FAQ on the web page above to see if the bug | ||
| 168 | is already known and if there are any workarounds. Then check whether | ||
| 169 | the bug has something to do with code in your .emacs file, e.g. by | ||
| 170 | invoking Emacs with the "-q --no-site-file" options. | ||
| 171 | |||
| 172 | If you decide that it is a bug in Emacs that might be specific to the | ||
| 173 | Windows port, send a message to the ntemacs-users@cs.washington.edu | ||
| 174 | mailing list describing the bug, the version of Emacs that you are | ||
| 175 | using, and the operating system that you are running on (Windows NT, | ||
| 176 | 2000, 95 or 98 including service pack level if known). If the bug is | ||
| 177 | related to subprocesses, also specify which shell you are using (e.g., | ||
| 178 | include the values of `shell-file-name' and `shell-explicit-file-name' | ||
| 179 | in your message). | ||
| 180 | |||
| 181 | If you think the bug is not specific to the Windows port of Emacs, | ||
| 182 | then it is better to mail the bug report to bug-gnu-emacs@gnu.org so | ||
| 183 | that it will be seen by the right people. If Emacs has been set up to | ||
| 184 | send mail, you can use the command M-x report-emacs-bug to create and | ||
| 185 | send the bug report, but in some cases there is a function to report | ||
| 186 | bugs in a specific package; e.g. M-x gnus-bug for Gnus, M-x | ||
| 187 | c-submit-bug-report for C/C++/Java mode, etc. | ||
| 188 | |||
| 189 | Enjoy. | ||
| 190 | |||
| 191 | Andrew Innes | ||
| 192 | (andrewi@gnu.org) | ||
diff --git a/admin/nt/dump.bat b/admin/nt/dump.bat new file mode 100755 index 00000000000..34f24d3a910 --- /dev/null +++ b/admin/nt/dump.bat | |||
| @@ -0,0 +1,21 @@ | |||
| 1 | @echo off | ||
| 2 | rem Run temacs.exe to recreate the dumped emacs.exe. | ||
| 3 | rem This is only likely to be useful on systems where the prebuilt | ||
| 4 | rem emacs.exe crashes on startup. | ||
| 5 | |||
| 6 | rem First save original emacs.exe if present | ||
| 7 | if exist emacs.exe.orig goto dump | ||
| 8 | echo Saving original emacs.exe as emacs.exe.orig | ||
| 9 | ren emacs.exe emacs.exe.orig | ||
| 10 | |||
| 11 | :dump | ||
| 12 | rem Overwrites emacs.exe if still present | ||
| 13 | mkdir ..\lib-src | ||
| 14 | copy fns* ..\lib-src | ||
| 15 | mkdir obj | ||
| 16 | mkdir obj\i386 | ||
| 17 | mkdir obj\etc | ||
| 18 | copy ..\etc\DOC* obj\etc | ||
| 19 | copy temacs.exe obj\i386 | ||
| 20 | obj\i386\temacs -batch -l loadup dump | ||
| 21 | copy obj\i386\emacs.exe . | ||
diff --git a/admin/nt/makedist.bat b/admin/nt/makedist.bat new file mode 100755 index 00000000000..710e3fb0eb1 --- /dev/null +++ b/admin/nt/makedist.bat | |||
| @@ -0,0 +1,122 @@ | |||
| 1 | @echo off | ||
| 2 | |||
| 3 | set TAR=wtar | ||
| 4 | |||
| 5 | rem Make a copy of current Emacs source | ||
| 6 | if (%3) == () goto usage | ||
| 7 | if not (%4) == () goto %4 | ||
| 8 | if not (%4) == (src) goto :lisp | ||
| 9 | |||
| 10 | :src | ||
| 11 | |||
| 12 | echo Create full source distribution, excluding leim | ||
| 13 | %TAR% --exclude leim --exclude _marker --exclude DOC --exclude DOC-X --exclude TAGS --exclude bin --exclude obj --exclude obj-spd --exclude oo --exclude oo-spd --exclude *~ --exclude *.rej -cvf - emacs-%1 | gzip -9 > %2-src.tar.gz | ||
| 14 | if not (%4) == () goto end | ||
| 15 | |||
| 16 | :lisp | ||
| 17 | echo Create limited elisp source distribution | ||
| 18 | %TAR% --exclude *.rej --exclude *.elc --exclude *~ -cvf - emacs-%1/lisp | gzip -9 > %2-lisp.tar.gz | ||
| 19 | if not (%4) == () goto end | ||
| 20 | |||
| 21 | :bin | ||
| 22 | |||
| 23 | set eld=emacs-%1/lisp | ||
| 24 | |||
| 25 | rem Keep this list in sync with the DONTCOMPILE list in lisp/Makefile.in | ||
| 26 | |||
| 27 | set elfiles=%eld%/cus-load.el %eld%/cus-start.el %eld%/emacs-lisp/cl-specs.el %eld%/eshell/esh-maint.el %eld%/eshell/esh-groups.el %eld%/finder-inf.el %eld%/forms-d2.el %eld%/forms-pass.el %eld%/generic-x.el %eld%/international/latin-1.el %eld%/international/latin-2.el %eld%/international/latin-3.el %eld%/international/latin-4.el %eld%/international/latin-5.el %eld%/international/latin-8.el %eld%/international/latin-9.el %eld%/international/mule-conf.el %eld%/loaddefs.el %eld%/loadup.el %eld%/mail/blessmail.el %eld%/patcomp.el %eld%/paths.el %eld%/play/bruce.el %eld%/subdirs.el %eld%/term/internal.el %eld%/term/AT386.el %eld%/term/apollo.el %eld%/term/bobcat.el %eld%/term/iris-ansi.el %eld%/term/keyswap.el %eld%/term/linux.el %eld%/term/lk201.el %eld%/term/news.el %eld%/term/vt102.el %eld%/term/vt125.el %eld%/term/vt200.el %eld%/term/vt201.el %eld%/term/vt220.el %eld%/term/vt240.el %eld%/term/vt300.el %eld%/term/vt320.el %eld%/term/vt400.el %eld%/term/vt420.el %eld%/term/wyse50.el %eld%/term/xterm.el %eld%/version.el | ||
| 28 | |||
| 29 | rem set term_elfiles=%eld%/term/AT386.el %eld%/term/apollo.el %eld%/term/bg-mouse.el %eld%/term/bobcat.el %eld%/term/internal.el %eld%/term/iris-ansi.el %eld%/term/keyswap.el %eld%/term/linux.el %eld%/term/lk201.el %eld%/term/news.el %eld%/term/pc-win.el %eld%/term/sun-mouse.el %eld%/term/sun.el %eld%/term/sup-mouse.el %eld%/term/tvi970.el %eld%/term/vt100.el %eld%/term/vt102.el %eld%/term/vt125.el %eld%/term/vt200.el %eld%/term/vt201.el %eld%/term/vt220.el %eld%/term/vt240.el %eld%/term/vt300.el %eld%/term/vt320.el %eld%/term/vt400.el %eld%/term/vt420.el %eld%/term/w32-win.el %eld%/term/wyse50.el %eld%/term/x-win.el %eld%/term/xterm.el | ||
| 30 | |||
| 31 | rem set elcfiles=%eld%/*.elc %eld%/emacs-lisp/*.elc %eld%/emulation/*.elc %eld%/gnus/*.elc %eld%/international/*.elc %eld%/language/*.elc %eld%/mail/*.elc %eld%/play/*.elc %eld%/progmodes/*.elc %eld%/term/*.elc %eld%/textmodes/*.elc | ||
| 32 | |||
| 33 | set fns_el= | ||
| 34 | for %%f in (emacs-%1/bin/fns*) do set fns_el=%fns_el% emacs-%1/bin/%%f | ||
| 35 | |||
| 36 | echo Create bin distribution | ||
| 37 | copy %3\README.W32 emacs-%1\README.W32 | ||
| 38 | |||
| 39 | rem %TAR% --exclude temacs.exe --exclude emacs.mdp --exclude *.pdb | ||
| 40 | rem --exclude *.opt --exclude *.el --exclude *~ -cvf - emacs-%1/BUGS | ||
| 41 | rem emacs-%1/GETTING.GNU.SOFTWARE emacs-%1/README emacs-%1/README.W32 | ||
| 42 | rem emacs-%1/bin %fns_el% emacs-%1/etc emacs-%1/info emacs-%1/lisp %elfiles% | ||
| 43 | rem %term_elfiles% emacs-%1/lock emacs-%1/site-lisp -cvf - | gzip -9 > %2-bin-i386.tar.gz | ||
| 44 | |||
| 45 | del #files# | ||
| 46 | for %%f in (emacs-%1/BUGS emacs-%1/GETTING.GNU.SOFTWARE emacs-%1/README emacs-%1/README.W32) do echo %%f>>#files# | ||
| 47 | for %%f in (emacs-%1/bin/fns*) do echo emacs-%1/bin/%%f>>#files# | ||
| 48 | for %%f in (emacs-%1/bin emacs-%1/etc emacs-%1/info emacs-%1/lisp %elfiles%) do echo %%f>>#files# | ||
| 49 | for %%f in (%eld%/term/*.el) do echo %eld%/term/%%f>>#files# | ||
| 50 | for %%f in (emacs-%1/lock emacs-%1/site-lisp) do echo %%f>>#files# | ||
| 51 | %TAR% --exclude temacs.exe --exclude emacs.mdp --exclude *.pdb --exclude *.opt --exclude *.el --exclude *~ -T #files# -cvf - | gzip -9 > %2-bin-i386.tar.gz | ||
| 52 | del emacs-%1\README.W32 | ||
| 53 | del #files# | ||
| 54 | if not (%4) == () goto end | ||
| 55 | |||
| 56 | :fullbin | ||
| 57 | |||
| 58 | echo Create full bin distribution | ||
| 59 | copy %3\README.W32 emacs-%1\README.W32 | ||
| 60 | |||
| 61 | %TAR% --exclude temacs.exe --exclude emacs.mdp --exclude *.pdb --exclude *.opt --exclude *~ -cvf - emacs-%1/BUGS emacs-%1/GETTING.GNU.SOFTWARE emacs-%1/README emacs-%1/README.W32 emacs-%1/bin emacs-%1/etc emacs-%1/info emacs-%1/lisp emacs-%1/lock emacs-%1/site-lisp | gzip -9 > %2-fullbin-i386.tar.gz | ||
| 62 | del emacs-%1\README.W32 | ||
| 63 | if not (%4) == () goto end | ||
| 64 | |||
| 65 | :leim | ||
| 66 | |||
| 67 | echo Create archive with precompiled leim files | ||
| 68 | %TAR% -cvf - emacs-%1/leim/leim-list.el emacs-%1/leim/quail emacs-%1/leim/ja-dic | gzip -9 > %2-leim.tar.gz | ||
| 69 | if not (%4) == () goto end | ||
| 70 | |||
| 71 | :undumped | ||
| 72 | |||
| 73 | echo Create archive with extra files needed for redumping emacs | ||
| 74 | copy %3\README-UNDUMP.W32 emacs-%1\README-UNDUMP.W32 | ||
| 75 | copy %3\dump.bat emacs-%1\bin | ||
| 76 | if exist emacs-%1\src\obj-spd\i386\temacs.exe copy emacs-%1\src\obj-spd\i386\temacs.exe emacs-%1\bin | ||
| 77 | if exist emacs-%1\src\oo-spd\i386\temacs.exe copy emacs-%1\src\oo-spd\i386\temacs.exe emacs-%1\bin | ||
| 78 | %TAR% -cvf - emacs-%1/README-UNDUMP.W32 emacs-%1/bin/dump.bat emacs-%1/bin/temacs.exe | gzip -9 > %2-undumped-i386.tar.gz | ||
| 79 | del emacs-%1\bin\temacs.exe | ||
| 80 | del emacs-%1\bin\dump.bat | ||
| 81 | del emacs-%1\README-UNDUMP.W32 | ||
| 82 | if not (%4) == () goto end | ||
| 83 | |||
| 84 | :barebin | ||
| 85 | |||
| 86 | echo Create archive with just the basic binaries and generated files | ||
| 87 | echo (the user needs to unpack the full source distribution for | ||
| 88 | echo everything else) | ||
| 89 | copy %3\README.W32 emacs-%1\README.W32 | ||
| 90 | %TAR% -cvf - emacs-%1/README.W32 emacs-%1/bin emacs-%1/etc/DOC emacs-%1/etc/DOC-X | gzip -9 > %2-barebin-i386.tar.gz | ||
| 91 | del emacs-%1\README.W32 | ||
| 92 | if not (%4) == () goto end | ||
| 93 | |||
| 94 | goto end | ||
| 95 | |||
| 96 | rem Only do this if explicitly requested | ||
| 97 | :zipfiles | ||
| 98 | |||
| 99 | echo Create zip files for bin and lisp archives | ||
| 100 | mkdir distrib | ||
| 101 | cd distrib | ||
| 102 | gunzip -c ..\%2-bin-i386.tar.gz | %TAR% xf - | ||
| 103 | zip -rp9 em%5_bin %2 | ||
| 104 | rm -rf %2 | ||
| 105 | zipsplit -n 1400000 -b .. em%5_bin.zip | ||
| 106 | del em%5_bin.zip | ||
| 107 | gunzip -c ..\%2-lisp.tar.gz | %TAR% xf - | ||
| 108 | zip -rp9 em%5_lis %2 | ||
| 109 | rm -rf %2 | ||
| 110 | zipsplit -n 1400000 -b .. em%5_lis.zip | ||
| 111 | del em%5_lis.zip | ||
| 112 | cd .. | ||
| 113 | |||
| 114 | goto end | ||
| 115 | |||
| 116 | :usage | ||
| 117 | echo Generate source and binary distributions of emacs. | ||
| 118 | echo Usage: %0 emacs-version dist-basename distfiles [lisp,bin,undumped,barebin] | ||
| 119 | echo (e.g., %0 19.34 emacs-19.34.5 d:\andrewi\distfiles) | ||
| 120 | echo Or: %0 emacs-version dist-basename distfiles "zipfiles" short-version | ||
| 121 | echo (e.g., %0 20.6 emacs-20.6 d:\andrewi\distfiles zipfiles 206) | ||
| 122 | :end | ||