diff options
Diffstat (limited to 'etc')
| -rw-r--r-- | etc/COOKIES | 157 | ||||
| -rw-r--r-- | etc/MACHINES | 810 | ||||
| -rw-r--r-- | etc/celibacy.1 | 12 | ||||
| -rw-r--r-- | etc/condom.1 | 148 | ||||
| -rw-r--r-- | etc/emacs.1 | 495 | ||||
| -rw-r--r-- | etc/emacstool.1 | 134 | ||||
| -rw-r--r-- | etc/future-bug | 37 | ||||
| -rw-r--r-- | etc/gnus-tut.txt | 294 |
8 files changed, 1930 insertions, 157 deletions
diff --git a/etc/COOKIES b/etc/COOKIES new file mode 100644 index 0000000000..41f8afee24 --- /dev/null +++ b/etc/COOKIES @@ -0,0 +1,157 @@ +[Someone sent this in from California, and we decided to extend +our campaign against information hoarding to recipes as well +as software. (Recipes are the closest thing, not involving computers, +to software.) + +The story appears to be a myth, according to the Chicago Tribune, +which says that Mrs Fields Cookies hoards the information completely. +Therefore, this recipe can be thought of as a compatible replacement. +We have reports that the cookies it makes are pretty good.] + +Someone at PG&E called the Mrs. Fields Cookie office +and requested the recipe for her cookies. They asked +her for her charge card number, and she gave it to them +thinking the cost would be $15 to $25. It turned out +to be $200! + +Therefore, this person is giving the recipe to anyone +and everyone she knows (and doesn't know) so that +someone can get use of her $200. Anyway, just keep +passing it on. + +Cream together: 2 cups butter + 2 cups sugar + 2 cups brown sugar + +Add: 4 eggs + 2 tsp. vanilla + +Mis together in +separate bowl: 4 cups flour + 5 cups oatmeal (put small + amounts of oatmeal in blender until it turns to + powder. Measure out 5 cups of oatmeal and only + "powderize" that, NOT 5 cups "powderized" oatmeal) + + 1 tsp salt + 2 tsp baking powder + 2 tsp baking soda + +Mix: All of the above + +Add: 24 oz. bag of chocolate chips and + 1 finely grated 8 oz Hershey bar (plain) + +Add: 3 cups chopped nuts (any kind) + +Bake on greased cookie sheet (make golf ball sized balls) and +bake about two inches apart. Bake at 350 degrees for 8 - 10 +minutes. DO NOT OVERBAKE. Makes 112. + +From: [email protected] (John R. Bane) +Subject: Re: free cookie foundation? + +Hi! I "stole" your very expensive cookie recipe off the net. If you +want to send me your SnailMail address, I'll be glad to send you a +dollar (I would like to suggest this to the net, but I think there is +some netiquette rule against asking for money - or is that only money +for oneself?) to help defray the cost (it's not much, but if EVERYone +who took the recipe sent you a dollar, it would help). + +Here also is another cookie recipe which I'm very fond of. + +Makes 6-8 dozen +Bake at 375 degrees for ~10 min. + +Cream together: + +1 cup shortening (I use Weight Watcher's Reduced Calorie Margarine!) +1/4 cup peanut butter (I recommend the non-sugared kind) +1/2 cup sugar +1/2 cup brown sugar +2 eggs +1 teaspoon vanilla + +Add: + +1/2 cup flour +1 teaspoon soda +1/2 teaspoon salt +2 cups rolled oats (I use the 5-min variety) +1-2 cups chocolate chips (I use 2 cups semi-sweet - ummmm!) +1 cup nuts (I use pecan pieces - don't get them crushed, or the extra + oil will make greasy cookies) +1 cup shredded or flaked coconut + +(The nuts were listed as optional and I added the coconut myself, but +I really love them there! You could also add things like m&m's, or +raisins (I don't care for raisins in cookies, but you might). I've +always wanted to try banana chips.) + +Mix well. Drop by teaspoonfuls on greased cookie sheet (I use pam). +Bake at 375 degrees for approx. 10 min. + +My aunt found this recipe in an Amish book called something like +"Eating Well When The Whole World Is Starving," and although I thought +a cookie recipe was a bit odd for a book like that, they are about the +healthiest a cookie is ever likely to get. + +They are also very easy to make (no blending, sifting, rolling, etc.) +and extremely delicious. I get rave reviews and recipe requests whenever +I make them. + + - rene + +Chocolate Chip Cookies - Glamorous, crunchy, rich with chocolate bits & nuts. + +Also known as "Toll House" Cookies ... from Kenneth and Ruth Wakefield's +charming New England Toll House on the outskirts of Whitman, Massachusetts. +These cookies were first introduced to American homemakers in 1939 through +our series of radio talks on "Famous Foods From Famous Eating Places." + +Mix Thoroughly : + 2/3 cup soft shortening ( part butter ) + 1/2 cup granulated sugar + 1/2 cup brown sugar ( packed ) + 1 egg + 1 tsp vanilla + +Sift together and stir in : + 1-1/2 cups sifted flour (*) + 1/2 tsp soda + 1/2 tsp salt + +Stir in : + 1/2 cup cut-up nuts + 6 oz package of semi-sweet chocolate pieces ( about 1-1/4 cups ) + + +(*) for a softer, more rounded cookie, use 1-3/4 cups sifted flour. + + +Drop rounded teaspoonfuls about 2" apart on ungreased baking sheet. Bake until +delicately browned ... cookies should still be soft. Cool slightly before you +remove them from the baking sheet. + +Temperature: 375 F. ( modern oven ) +Time: bake 8 - 10 minutes +Amount: 4 - 5 dozen 2" cookies + + +===== + +Personal comments : + +I find it tastes better with a mixture of shortening and butter, as they say. + +You don't need << all >> of that sugar, and it can be whatever color you want. + +The nuts are optional. Feel free to play with the recipe. I put oatmeal in it, +reducing flour accordingly, and sometimes cinnamon. + +I also find it useful to grease the cookie sheets. + +I think I'm going to go bake some now ... + +-- richard + diff --git a/etc/MACHINES b/etc/MACHINES index eb86f4c1aa..7e08ec8ae5 100644 --- a/etc/MACHINES +++ b/etc/MACHINES @@ -25,6 +25,36 @@ to operating system names (i.e. sunos4.1) or architecture names (i.e. hppa1.1). If you leave out the version number, the `configure' script will configure Emacs for the latest version it knows about. +Acorn RISCiX (arm-acorn-riscix1.2) + + Emacs 19.29 has changes that ought to support RISCiX 1.2. + + Due to a bug in the RISCiX C compiler (3.4.5), emacs must + be built with gcc (versions 2.5.8 onwards). + + In addition, you will need GNU sed and GNU make, as the RISCiX release + versions of these utilities cannot cope with building emacs-19! + + GNU sed should be configured with: + + env 'DEFS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \ + -Doptarg=gnu_optarg' ./configure + + GNU make (3.72+) should be configured with: + + env 'CFLAGS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \ + -Doptarg=gnu_optarg' ./configure + + Emacs may be configured to use the X toolkit, by adding --with-x-toolkit + to the configure command. If you do this, you will need to edit the line + in src/Makefile which defines LIBW (about line 59) to read: + + LIBW= -lXaw_n + + This ensures that the non-shared widget library is used. + + It is unlikely that this version of emacs will work with RISCiX 1.1. + Alliant (fx80-alliant-bsd): 18.52 worked on system version 4. Previous Emacs versions were @@ -36,7 +66,21 @@ Alliant (fx80-alliant-bsd): Alliant FX/2800 (i860-alliant-bsd) - Known to work with 18.58 and OS version 2.2, compiler version 1.3. + Known to work with 19.26 and OS version 2.2, compiler version 1.3. + +Alpha (DEC) running OSF/1 (alpha-dec-osf1, alpha-dec-linux-gnu) + + For OSF/1 (aka Digital Unix) version 4.0, update 386, + it is reported that you need to run configure this way: + + configure --x-includes=/usr/include --x-libraries=/usr/shlib + + For 4.0 revision 564, and 4.0A and 4.0B, Emacs 20 seems to work + with no special configuration options. + + Note that the X11 libraries on GNU/Linux systems + for the Alpha are said to have bugs that prevent Emacs from working with X + (as of November 1995). Altos 3068 (m68k-altos-sysv) @@ -55,55 +99,48 @@ Amdahl UTS (580-amdahl-sysv) even worth trying to use it. Success was obtained with the uts native C compiler on uts version 5.2.5. -Apollo running Domain (m68k-apollo-bsd) +Apollo running X Windows (m68k-apollo-bsd) - 18.52 works, to some extent. - Code for dumping Emacs has been written, but we cannot distribute it yet. - There are reports of bugs in cc -O on this system. + Apollo version now supports dumping. It has been tested on SR10.3 and + SR10.4. It certainly requires at least SR10.0, and maybe SR10.2. Be sure + to build in the BSD environment. - In `lib-src/Makefile', don't expect emacsclient and emacsserver to - compile. You might want to remove them from your makefile. + By default, everything is compiled with the switch "-W0,-opt,2". Don't try + to change this to full optimization (-O). The full optimizer (in Domain CC + 6.7, 6.8 and 6.9) generates some bad code in several modules which causes + the emacs window, under X, to be refreshed with each keystroke. - Supposedly something in dired.c runs into a compiler bug. - Paraphrasing the statement should avoid the problem. I have not yet - received word as to the exact statement this is. + The configuration stuff should work for the most part. However, some Domain + installations may have to edit src/Makefile manually after it is created. + There are too many versions of both cc and X to automate this easily. - The Apollo has a bizarre operating system which does not permit - Emacs to be dumped with preloaded pure Lisp code. Therefore, each - time you start Emacs on this system, the standard Lisp code is loaded - into it. Expect it to take a long time. You can prevent loading of - the standard Lisp code by specifying the -nl switch. It must - come at the beginning of the command line; only the -t and -batch - switches may come before it. + In `lib-src/Makefile', emacsclient and emacsserver compile and work fine + under CC 6.9. They now probably work under other versions of the compiler, + as well. - There is one remaining problem on the Apollo. You must replace - the CPP line in src/Makefile with "CPP = /usr/lib/cpp". - The C preprocessor lives there rather than in /lib/cpp because the - Aegis OS uses the /lib directory as the repository for shared libraries. + The Apollo Domain CC compiler will issue quite a few warning messages, + mostly complaining about incompatible pointers. In general, these are + harmless and can be ignored. If you discover otherwise, please submit a bug + report identifying the problem in detail. + When you try to dump emacs, you may get the message ".rwdi section needs + relocation." This means you are linking with some code that has compressed + data sections. In some cases this comes from linking with X libraries. Try + using shared X libraries instead. With some versions of Domain/OS this is + as simple as removing the "-lX11" from the LIBX line in src/Makefile. + + When running the configure script, use the configuration name + "m68k-apollo-bsd". You will also need to use the "-with-gcc=no" and + "-with-x" options. Depending upon your site configuration, you may have to + use other configure options, as well. Examine the INSTALL file for other + configure options. - Here is a design for a method of dumping and reloading the relevant - necessary impure areas of Emacs. - - On dumping, you need to dump only the array `pure' plus the - locations that contain values of forwarded Lisp variables or that are - protected for garbage collection. The former can be found by a - garbage- collection-like technique, and the latter are in the - staticprolist vector (see alloc.c for both things). - - Reloading would work in an Emacs that has just been started; except - when a switch is specified to inhibit this, it would read the dump - file and set all the appropriate locations. The data loaded must be - relocated, but that's not hard. Those locations that are of type - Lisp_Object can be found by a technique like garbage-collection, and - those of them that point to storage can be relocated. The other data - read from the file will not need to be relocated. + Check out the file 'lisp/x-apollo.el'. To use it, add - The switch to inhibit loading the data base would be used when it - is time to dump a new data base. + (load "x-apollo") - This would take a few seconds, which is much faster than loading - the Lisp code of Emacs from scratch. + to your .emacs file. It provides useful default Apollo function key + bindings. AT&T 3b2, 3b5, 3b15, 3b20 (we32k-att-sysv) @@ -123,6 +160,11 @@ AT&T 3b2, 3b5, 3b15, 3b20 (we32k-att-sysv) The MAXMEM may also prevent Emacs from running. The file 3B-MAXMEM in this directory explains how to increase MAXMEM. + On some of these machines, you may need to define IN_SCCS_ID + in config.h to make Emacs work. Supposedly you can tell whether + this is necessary by checking something in /usr/include/sys/time.h; + we do not know precisely what. + AT&T 7300 or 3b1 (m68k-att-sysv) 18.52 worked. If you have strange troubles with dumping @@ -134,7 +176,22 @@ AT&T 7300 or 3b1 (m68k-att-sysv) support them, so you can remove the #define SHORTNAMES in that version. -Bull sps7 (m68k-bull-sysv) +Bull DPX/2 models 2nn or 3nn (m68k-bull-sysv3) + + Minor fixes merged into 19.19, which should work with CC or GCC. + + You should compile with all the POSIX stuff: undef _SYSV and define + _POSIX_SOURCE, _XOPEN_SOURCE and _BULL_SOURCE. + + On bos2.00.45 there is a bug that makes the F_SETOWN fcntl + call enters in an infinite loop. F_SETOWN_BUG has been defined to avoid + calling it. + +Bull DPX/20 (rs6000-bull-bosx) + + Version 19 works. + +Bull sps7 (m68k-bull-sysv2) Changes partially merged in version 19, but some fixes are probably required. @@ -161,7 +218,7 @@ Clipper (clipper-???) Convex (c1-convex-bsd, c2-convex-bsd, c32-convex-bsd, c34-convex-bsd, c38-convex-bsd) - 18.53 supposedly to work. + Support updated and residual bugs fixed in 19.26. Cubix QBx/386 (i386-cubix-sysv) @@ -173,9 +230,31 @@ Cydra 5 (cydra-cydrome-sysv) 18.51 worked in one version of their operating system but stopped working in a newer version. This has not been fixed. +Data General Aviion (m88k-dg-dgux) + + 19.23 works; however, the GCC provided with DGUX 5.4R3.00 fails to + compile src/emacs.c. GCC 2.5.8 does work. + The 19.26 pretest was reported to work; no word on which compiler. + System versions other than DGUX 5.4R3.00 have not been tested. + + DGUX 5.4R3.10 works with 19.29 and 19.30. + + DGUX R4.11 contains changes to the stdio internals and it doesn't work + with versions before 20.2 without patches. 20.2 works in interactive + mode but usually fails in batch mode. The problem is that using + stderr in the dumped emacs usually leads to a segmentation fault. + Only m88k has been tested. + DECstation (mips-dec-ultrix or mips-dec-osf) - Version 19 works under Ultrix. + This machine is the older Mips-based DECstation. + Emacs should now work on the Alpha CPU. + + 19.25 works on Ultrix 4.2. The 19.26 pretest was reported to work + on Ultrix 4.2a and on 4.4. + + One user reported 19.25 did not work at all with --with-x-toolkit + using X11R5 patch level 10, but worked ok with X11R5 pl26. See under Ultrix for problems using X windows on Ultrix. Note that this is a MIPS machine. @@ -189,13 +268,26 @@ DECstation (mips-dec-ultrix or mips-dec-osf) Motorola Delta 147 (m68k-motorola-sysv) + The EMacs 19.26 pretest was reported to work. + Motorola Delta boxes running System V/68 release 3. - (tested on sys1147 with SVR3V5). Changes merged in 19.1. + Tested on 147 board with SVR3V7, no X and gcc. + Tested on 167 board with SVR3V7, no X, cc, gnucc and gcc. + Reports say it works with X too. + + The installation script chooses the compiler itself. gnucc is + preferred. -Motorola Delta 187 (m88k-motorola-sysv or m88k-motorola-m88kbcs) +Motorola Delta 187 (m88k-motorola-sysv, + m88k-motorola-sysvr4, or + m88k-motorola-m88kbcs) - Machine support added in version 19. - HAVE_X_MENU does not work due to lack of insque. + The 19.26 pretest was reported to run on SVR3. However, if you + use --with-x-toolkit on svr3, you will have problems compiling some + files because time.h and sys/time.h get included twice. + One fix is to edit those files to protect against multiple inclusion. + + As of version 19.13, Emacs was reported to run under SYSVr3 and SYSVr4. Dual running System V (m68k-dual-sysv) @@ -225,6 +317,10 @@ Encore machine (ns16k-encore-bsd) A kernel bug in some system versions causes input characters to be lost occasionally. +Fujitsu DS/90 (sparc-fujitsu-sysv4) + + Changes merged in 20.3. + GEC 63 (local-gec63-usg5.2) Changes are partially merged in version 18, but certainly require @@ -251,22 +347,52 @@ Gould NP1 (np1-gould-bsd) Version 19 supposedly works. +Harris Night Hawk (m68k-harris-cxux or m88k-harris-cxux) + + This port was added in 19.23. The configuration actually tested was + a Night Hawk 4800 running CX/UX 7.0. + + If you have GCC ported and want to build with it, you probably need to + change things (like compiler switches) defined in the s/cxux.h file. + + If you have X11R6 installed in /usr/lib, configure will fail to find + it and may find X11R5 instead. To work around this problem, use + --x-libraries=/usr/lib when you run configure. + + With CX/UX 7.0 and later releases, you need to build after setting the + SDE_TARGET environment variable to COFF (a port using ELF and shared + libraries has not yet been done). + +Harris Power PC (powerpc-harris-powerunix) + + Patches have been merged in 19.31. + Honeywell XPS100 (xps100-honeywell-sysv) Config file added in version 19. -HP 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux7.) +Hewlett-Packard 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux + or m68k-hp-netbsd) - Version 19 works under BSD. - - These machines are 68000-series CPUs running HP-UX + These machines are 68000-series CPUs running HP/UX (a derivative of sysV with some BSD features) or BSD 4.3 ported by Utah. The operating system suffix determines which system Emacs is built for. - Series 200 HPUX runs Emacs only if it has the "HP-UX upgrade". + Series 200 HPUX runs Emacs only if it has the "HP/UX upgrade". + + Version 19 works under BSD. The 19.26 pretest was reported + to work on HPUX 9. 19.31 works on HPUX 10.01, but there are + some problems on 10.10 which have not been resolved. Emacs 19.34 + works on HPUX 10.20 provided you compile with GCC; with the HP C + compiler, subprocess commands do not work. + + On HPUX 9, Emacs sometimes crashes with SIGBUS or SIGSEGV after you + delete a frame. We think this is due to a bug in the X libraries + provided by HP. With the alternative X libraries in + /usr/contrib/mitX11R5/lib, the problem does not happen. - If you are running HP-UX release 8.0 or later, you need the optional - "C/ANSI C" software in order to build Emacs (older releases of HP-UX + If you are running HP/UX release 8.0 or later, you need the optional + "C/ANSI C" software in order to build Emacs (older releases of HP/UX do not require any special software). If the file "/etc/filesets/C" exists on your machine, you have this software, otherwise you do not. @@ -281,14 +407,14 @@ HP 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux7.) processor and a 5.+ kernel has the new compiler. Define C_SWITCH_MACHINE to be +X to make a version of Emacs that - runs on both 68010 and 68020 based hp-ux's. + runs on both 68010 and 68020 based HP/UX's. Define HPUX_68010 if you are using the new assembler, for a system that has a 68010 without a 68881. This is to say, a s200 (upgraded) or s310. Define the symbol HPUX_NET if you have the optional network features - that include the `netunam' system call. This is refered to as + that include the `netunam' system call. This is referred to as Network Services (NS/9000) in HP literature. HP 9000 series 500: not supported. @@ -297,14 +423,71 @@ HP 9000 series 500: not supported. which relocates data in memory during execution of a program, and support for it would be difficult to implement. -HP 9000 series 800 (Spectrum) (hppa1.0-hp-hpux) +HP 9000 series 700 or 800 (Spectrum) (hppa1.0-hp-hpux or hppa1.1-hp-hpux + or ...hpux9shr, or ...-nextstep) + + Use hppa1.1 for the 700 series and hppa1.0 for the 800 + series machines. (Emacs may not actually care which one you use.) - These files support HP's Precision Architecture machines - running HP-UX. It has been moderately tested on the Series - 840. + Support for NextSTEP was added in 19.31. - If you are running HP-UX release 8.0 or later, you need the optional - "C/ANSI C" software in order to build Emacs (older releases of HP-UX + Emacs 20 may work on HPUX 10. You need patch PHSS_6202 to install + the Xaw and Xmu libraries. On HPUX 10.20 you may need to compile with GCC; + when Emacs was compiled with HP's C compiler, HP92453-01 A.10.32.03, + the subprocess features failed to work. + + 19.26 is believed to work on HPUX 9 provided you compile with GCC. + As of version 19.16, Emacs was reported to build (using GCC) and run + on HP 9000/700 series machines running HP/UX versions 8.07 and 9.01. + The HP compiler is known to fail on some versions if you use +O3, + but it may work with lower optimization levels. + + Use hppa1.1-hp-hpux9shr to use shared libraries on HPUX version 9. + You may need to create the X libraries libXaw.a and libXmu.a from + the MIT X distribute, and you may need to edit src/Makefile's + definition of LIBXT to look like this: + + LIBXT= $(LIBW) -lXmu -lXt $(LIBXTR6) -lXext + + Some people report trouble using the GNU memory allocator under + HP/UX version 9. The problems often manifest as lots of ^@'s in the + buffer. + + We are told that these problems go away if you obtain the latest + patches for the HP/UX C compiler. James J Dempsey + <[email protected]> says that this set of versions works for him: + /bin/cc: + HP92453-01 A.09.28 HP C Compiler + /lib/ccom: + HP92453-01 A.09.28 HP C Compiler + HP-UX SLLIC/OPTIMIZER HP-UX.09.00.23 02/18/93 + Ucode Code Generator - HP-UX.09.00.23.5 (patch) 2/18/93 + + For 700 series machines, the HP-UX patch needed is known as + PHSS_2653. (Perhaps for 800 series machines as well; we don't + know.) If you are on the Internet, you should be able to obtain + this patch by using telnet to access the machine + support.mayfield.hp.com and logging in as "hpslreg" and following + the instructions there. Or you may be able to use this + web site: + + HP Patch Server: http://support.mayfield.hp.com/patches/html/patches.html + HP Support Line: http://support.mayfield.hp.com + + Please do not ask FSF for further support on this. If you have any + trouble obtaining the patch, contact HP Software Support. + + If your buffer fills up with nulls (^@) at some point, it could well + be that problem. That problem does not happen when people use GCC + to compile Emacs. On the other hand, the HP compiler version 9.34 + was reported to work for the 19.26 pretest. 9.65 was also reported to work. + + If you turn on the DSUSP character (delayed suspend), + Emacs 19.26 does not know how to turn it off on HPUX. + You need to turn it off manually. + + If you are running HP/UX release 8.0 or later, you need the optional + "C/ANSI C" software in order to build Emacs (older releases of HP/UX do not require any special software). If the file "/etc/filesets/C" exists on your machine, you have this software, otherwise you do not. @@ -321,6 +504,19 @@ High Level Hardware Orion 1/05 (clipper-highlevel-bsd) C compiler has a bug; it loops compiling eval.c. Compile it by hand without optimization. +HITACHI SR2001/SR2201 series (hppa1.1-hitachi-hiuxmpp) + + These machines are based on PA architecture running HI-UX/MPP + (based on OSF1. `MPP' stands for `Massively Parallel Processor'). + + Emacs 19.34 is believed to work; its pretest was tested + both on SR2001 (output of `uname -rv' is `00-01-BB 0') and + SR2201 (`02-00 0'). + + The machine description file is `src/m/sr2k.h' is based on + `src/m/hp800.h'. The system description file is `src/s/hiuxmpp.h' + based on `src/s/osf1.h'. Note that this system doesn't use COFF. + IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2) Changes merged in version 19. You may need to copy @@ -329,18 +525,38 @@ IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2) i386-ibm-aix1.1 may not work with certain new X window managers, and may be suboptimal. -IBM RS/6000 (rs6000-ibm-aix) +IBM RS/6000 (rs6000-ibm-aix*) + + Emacs 19.26 is believed to work; its pretest was tested. - Changes merged in version 19. Currently the configuration - does not actually depend on the version of AIX. + At last report, Emacs didn't run well on terminals. Informed + persons say that the tty VMIN and VTIME settings have been + corrupted; if you have a fix, please send it to us. Compiling with -O using the IBM compiler has been known - to make Emacs work incorrectly. + to make Emacs work incorrectly. It's reported that on + AIX 3.2.5 with an IBM compiler earlier than 1.03.00.14, + cc -O fails for some files. You need to install any + PTF containing APAR #IX42810 to bring the compiler to + the 1.03.00.14 level to allow optimized compiles. + + There are reports that IBM compiler versions earlier than 1.03.00.02 + fail even without -O. However, another report said that compiler + version 1.02.01.00 did work, on AIX 3.2.4, with Emacs 19.31. + + As of 19.11, if you strip the Emacs executable, it ceases to work. + + If you are using AIX 3.2.3, you may get a core dump when loading + ange-ftp. You may be able to fix the problem by defining LIBS_TERMCAP + as -ltermcap -lcurses. Please tell us if this fails to work. + + If anyone can fix the above problems, or confirm that they don't happen + with certain versions of various programs, we would appreciate it. IBM RT/PC (romp-ibm-bsd or romp-ibm-aix) - 18.52 worked on both operating systems. Use romp-ibm-bsd for the 4.2-like system and romp-ibm-aix for AIX. + 19.22 is reported to work under bsd. We don't know about AIX. On BSD, if you have trouble, try compiling with a different compiler. @@ -366,21 +582,78 @@ Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3) in a system header file, which confuses Emacs (which thinks that UMAX indicates the Umax operating system). -Intel 386 (i386-unknown-isc, i386-unknown-esix, i386-unknown-xenix, - i386-intsys-sysv, i386-unknown-sysv5.2.2, i386-unknown-sysv5.3, - and i386-unknown-bsd4.2) - - 18.58 should support a wide variety of operating systems. - Make sure to use i386-unknown-isc2.2 for Interactive 386/ix version - 2.2 or later. - Use i386-unknown-esix for Esix. +Intel 386 (i386-*-isc, i386-*-esix, i386-*-bsdi2, + i386-*-xenix, i386-*-freebsd, i386-*-linux-gnu, + i386-*-sol2.4, i386-*-sysv3, i386-intsys-sysv, + i386-*-sysv4, i386-*-sysv4.2, + i386-*-sysv5.3, i386-*-bsd4.2, + i386-*-sco3.2v4, i386-*-bsd386, i386-*-386bsd, + i386-*-msdos, i386-*-windowsnt. + i386... can be replaced with i486... or i586...) + + In the above configurations, * means that the manufacturer's name + you specify does not matter, and you can use any name you like + (but it should not contain any dashes or stars). + + When using the ISC configurations, be sure to specify the isc + version number - for example, if you're running ISC 3.0, use + i386-unknown-isc3.0 as your configuration name. + Use i386-*-esix for Esix; Emacs runs as of version 19.6. + Use i386-*-linux-gnu for GNU/Linux systems; Emacs runs as of version 19.26. Use i386-intsys-sysv for Integrated Solutions 386 machines. It may also be correct for Microport systems. - It isn't clear what to do on an SCO system. The system's C - preprocessor doesn't seem to handle the src subdirectory's Make - trickery, so you will probably need to install the GNU C preprocessor. - - If you are using Xenix, see notes above under Xenix. + Use i386-*-sco3.2v4 for SCO 3.2v4; Emacs runs as of version 19.26. + + On GNU/Linux systems, Emacs 19.23 was said to work properly with libc + version 4.5.21, but not with 4.5.19. If your system uses QMAGIC + for the executable format, you must edit config.h to define LINUX_QMAGIC. + + On GNU/Linux, configure may fail to put these definitions in config.h: + + #define HAVE_GETTIMEOFDAY + #define HAVE_MKDIR + #define HAVE_RMDIR + #define HAVE_XSCREENNUMBEROFSCREEN + + To work around the problem, add those definitions by hand. + It is possible that this problem happens only with X11R6 + or that newer system versions have fixed it. + + The 19.26 pretest was reported to work on SVR4.3 and on Freebsd. + + 19.29 is reported to crash when using Motif on Solaris 2.5. + The reasons are not yet known. + + Use i386-*-bsdiN for BSDI BSD/OS version N; Emacs runs as of version 19.23. + In some system versions, `make' is broken; use GNU make instead. + Shell bugs in version 1.0 of BSD/OS cause configure + to do the wrong thing with --with-x-toolkit; the workaround is to edit + configure to run another shell such as bash. + + For System V release 3, use i386-*-sysv3. + For System V release 4, use i386-*-sysv4. + For System V release 4.2, use i386-*-sysv4.2. + + If you are using Xenix, see notes at end under Xenix. + If you are using Esix, see notes at end under Esix. + If you are using SCO Unix, see notes at end under SCO. + + On 386bsd, NetBSD and FreeBSD, at one time, it was necessary to use + GNU make, not the system's make. Assuming it's installed as gmake, + do `gmake install MAKE=gmake'. However, more recently it is + reported that using the system Make on NetBSD 1.3.1 works ok. + + If you are using System V release 4.2, you may find that `cc -E' + puts spurious spaces in `src/xmakefile'. If that happens, + specify CPP=/lib/cpp as an option when you run make. + There is no problem if you compile with GCC. + + Note that use of Linux with GCC 2.4 and the DLL 4.4 libraries + requires the experimental "net 2" network patches (no relation to + Berkeley Net 2). There is a report that (some version of) Linux + requires including `/usr/src/linux/include/linux' in buffer.c + but no coherent explanation of why that might be so. If it is so, + in current versions of Linux, something else should probably be changed. Some sysV.3 systems seem to have bugs in `opendir'; for them, alter `config.h' to define NONSYSTEM_DIR_LIBRARY @@ -392,6 +665,15 @@ Intel 386 (i386-unknown-isc, i386-unknown-esix, i386-unknown-xenix, On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES to config.h. + On SCO, there are problems in regexp matching when Emacs is compiled + with the system compiler. The compiler version is "Microsoft C + version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93; + Quick C Compiler Version 1.00.46 (Beta). The solution is to compile + with GCC. + + On ISC systems (2.02 and more recent), don't try to use the versions + of X that come with the system; use XFree86 instead. + There is no consistency in the handling of certain system header files on V.3. @@ -418,30 +700,24 @@ Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6) and m68k-sgi-iris3.6 for system version 3.6. Note that the 3030 is the same as the Iris 2500 Turbo. -Iris 4D (mips-sgi-irix3.3 or mips-sgi-irix4.0) - - 18.58 is known to work on Silicon Graphics 4D series machines - with IRIX 3.3 or IRIX 4.0. Version 19 should support the - ANSI C compiler version 3.10. - - Most irix3.3 systems do not have an ANSI C compiler, but a few do. - If you are using the ANSI C compiler, you may need to add - #define C_SWITCH_MACHINE -cckr - to config.h. +Iris 4D (mips-sgi-irix[456].*) - There is a bug in IRIX that can sometimes leave ptys owned by - root with a permission of 622. This causes malfunctions in use - of subprocesses of Emacs. This may be fixed in IRIX 4.0.5. + The 19.26 pretest was reported to work on IRIX 4.0.5 and 5.2. + 19.23 was reported to work on IRIX 5.2, but you may need to install + the "compiler_dev.hdr.internal" subsystem in order to compile unexelfsgi.c. + 19.22 was known to work on all Silicon Graphics machines running + IRIX 4.0.5 or IRIX 5.1. -Macintosh + Compiling with -O using IRIX compilers prior to 3.10.1 may not work. + Don't use -O or use GCC instead. - We are boycotting Apple because of Apple's efforts to take away - our freedom to write compatible imitations of existing software. - If you value your freedom to write such programs, we urge you - not to buy from Apple, not to develop software for Apple, and - certainly not to accept a job with Apple. + Most IRIX 3.3 systems do not have an ANSI C compiler, but a few do. + Compile Emacs 18 with the -cckr switch on these machines. - See the file APPLE in this directory for more information. + There is a bug in IRIX 3.3 that can sometimes leave ptys owned by root + with a permission of 622. This causes malfunctions in use of + subprocesses of Emacs. Irix versions 4.0 and later with GNU Emacs + versions 18.59 and later fix this bug. Masscomp (m68k-masscomp-rtu) @@ -454,7 +730,7 @@ Masscomp (m68k-masscomp-rtu) unsigned char k; unsigned char *p;... x = p[k]; has been reported for "C version 1.2 under RTU 3.1". We do not wish to take the time to install the numerous workarounds required to - compensate for this bug; go complain to Masscomp. + compensate for this bug. For RTU version 3.1, define FIRST_PTY_LETTER to be 'p' in `src/s/rtu.h' (or #undef and redefine it in config.h) so that ptys will be used. @@ -469,7 +745,14 @@ Megatest (m68k-megatest-bsd) Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd) - Changes merged in 18.39. Some fixes in 18.56. + The C compiler on Riscos 4.51 dumps core trying to optimize + parts of Emacs. Try without optimization or try GCC. + + Meanwhile, the linker on that system returns success even if + there are undefined symbols; as a result, configure gets the + wrong answers to various questions. No work-around is known + except to edit src/config.h by hand to indicate which functions + don't exist. Use mips-mips-riscos4.0 for RISCOS version 4. Use mips-mips-bsd with the BSD world. @@ -495,6 +778,10 @@ Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd) great disadvantage: you will not be able to run Emacs under a debugger. I think crashing on division by zero is a lesser problem. + [email protected] reported needing to use --x-libraries=/bsd43/usr/lib + on a riscos4bsd site. But it is not clear whether this is needed in + general or only because of quirks on a particular site. + National Semiconductor 32000 (ns32k-ns-genix) This is for a complete machine from National Semiconductor, @@ -513,6 +800,30 @@ NCR Tower 32 (m68k-ncr-sysv2 or m68k-ncr-sysv3) There is a report that compilation with -O did not work with 18.54 under System V release 2. +NCR Intel system (i386-ncr-sysv4.2) + + This system works in 19.31, but if you don't link it with GNU ld, + you may need to set LD_RUN_PATH at link time to specify where + to find the X libraries. + +NEC EWS4800 (mips-nec-sysv4) + + This system works in 20.4, but you should use the compiler + /usr/abiccs/bin/cc (MIPS ABI MODE). + +NeXT (m68k-next-nextstep) + + Emacs 19 has not been tested extensively yet, but it seems to work + in a NeXTStep 3.0 terminal window, and under the X server called + co-Xist. You may need to specify -traditional when src/Makefile + builds xmakefile. + + NeXT users might want to implement direct operation with NeXTStep, + but from the point of view of the GNU project, that is a + distraction. + + Thanks to Thorsten Ohl for working on the NeXT port of Emacs 19. + Nixdorf Targon 31 (m68k-nixdorf-sysv) Machine description file for version 17 is included in 18 @@ -524,6 +835,15 @@ Nu (TI or LMI) (m68k-nu-sysv) Version 18 is believed to work. +Paragon OSF/1 (i860-intel-osf1) + + Changes merged in 19.29. + + There is a bug in OSF/1 make which claims there is a syntax error + in the src/xmakefile. You can successfully build emacs with: + + pmake MAKE=pmake + Plexus (m68k-plexus-sysv) Worked as of 17.56. @@ -538,6 +858,10 @@ Prime EXL (i386-prime-sysv) Pyramid (pyramid-pyramid-bsd) + The 19.26 pretest was observed to work on OSx 5.0, but it is necessary + to edit gmalloc.c. You must add #include <sys/types.h> at the top, + and delete the #define for size_t. + You need to build Emacs in the Berkeley universe with the `ucb' command, as in `ucb make' or `ucb build-install'. @@ -565,9 +889,47 @@ Sequent Balance (ns32k-sequent-bsd4.2 or ns32k-sequent-bsd4.3) Delete some lines at the end of `src/m/sequent.h' for earlier system versions. -Sequent Symmetry (i386-sequent-bsd) +Sequent Symmetry (i386-sequent-bsd, i386-sequent-ptx, i386-sequent-ptx4) + + 19.33 has changes to support ptx 4 (a modified SVR4). + + Emacs 19 should work on Dynix (BSD). However, if you compile with + the Sequent compiler, you may find Emacs does not restore the + terminal settings on exit. If this happens, compile with GCC. + + Emacs 19.27 contains patches that should support + DYNIX/ptx 1.4 and 2.1 with the native cc compiler. + + GCC can't compile src/process.c due to a non-standard Sequent asm + keyword extension supported by cc and used for the network byte/word + swapping functions in the PTX /usr/include/netinet/in.h file. GCC + 2.5.8 includes the file <sys/byteorder.h> which can be included into + netinet/in.h to perform these byte/word swapping functions in the + same manner. Patches have been submitted to the FSF against GCC + 2.6.0 to fix this problem and allow Emacs to be built with GCC. - Emacs 19 should work. + If your machine does not have TCP/IP installed, you will have to edit the + src/s/ptx.h file and comment out #define TCPIP_INSTALLED. + +Siemens Nixdorf RM600 and RM400 (mips-siemens-sysv4) + + Changes merged in 19.29. This configuration should also work for + Pyramid MIS Server running DC-OSX 1.x. The version configured with + `--with-x' works without any modifications, but `--with-x-toolkit' + works only if the Athena library and the Toolkit library are linked + statically. For this, edit `src/Makefile' after the `configure' run + and modify the lines with `-lXaw' and `-lXt' as follows: + + LIBW= /usr/lib/libXaw.a + LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext + + In addition, `--with-x-toolkit=motif' works only + if the Motif library and the Toolkit library are linked statically. + To do this, edit `src/Makefile' after the `configure' run + and modify the lines with `-lXm' and `-lXt' as follows: + + LIBW= /usr/lib/libXm.a /usr/ccs/lib/libgen.a + LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3) @@ -575,7 +937,7 @@ SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3) SONY News 3000 series (RISC NEWS) (mips-sony-bsd) - Worked, as of 18.56. Note that this is a MIPS architecture machine. + The 19.26 pretest is reported to work. Some versions of the operating system give SIGTRAP for division by zero instead of the usual signals. This causes division by zero @@ -584,6 +946,10 @@ SONY News 3000 series (RISC NEWS) (mips-sony-bsd) Emacs from working under any debugger. But you can change init_data in data.c if you wish. +Stardent i860 (i860-stardent-sysv4.0) + + 19.26 pretest reported to work. + Stardent 1500 or 3000 See Titan. @@ -595,26 +961,99 @@ Stride (m68k-stride-sysv) It may be possible to run on their V.1 system but changes in the s- file would be needed. -Sun 1, 2 and 3 (m68k-sun-sunos, sparc-sun-sunos, i386-sun-sunos) +Sun 3, Sun 4 (sparc), Sun 386 (m68k-sun-sunos, sparc-sun-sunos, i386-sun-sunos, + sparc-sun-sunos4.1.3noshr, sparc-sun-solaris2.*, + i386-sun-solaris2.*) + + Emacs 20.3 fails to build on Solaris 2.5 if you use GCC 2.7.2.3. + Installing GCC 2.8 fixes the problem. + + 19.32 works on Solaris 2.4 and 2.5. On Solaris 2.5 + you may need one of these patches to prevent Emacs from crashing + when it starts up: + 103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes) + 102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes) + 103242-04: [README] SunOS 5.5: linker patch (595363 bytes) + + There are reports that using SunSoft cc with -xO4 -xdepend produces + bad code for some part of Emacs. + + Emacs works ok Sunos 4.1.x + provided you completely replace your C shared library + using one of the SunOS 4.1.x jumbo replacement patches from Sun. + Here are the patch numbers for Sunos 4.1.3: + 100890-10 SunOS 4.1.3: domestic libc jumbo patch + 100891-10 SunOS 4.1.3: international libc jumbo patch + + Some people report that Emacs crashes immediately on startup when + used with a non-X terminal, but we think this is due to compiling + with GCC and failing to use GCC's "fixed" system header files. + + Some Sun versions of X windows use the clipboard, not the selections, + for transferring text between clients. The Cut, Paste and Copy items + in the menu bar Edit menu work with the clipboard. It's important to include the SunOS version number in the configuration name. For example, for SunOS release 4.0 on a Sun 3, use `m68k-sun-sunos4.0'; for SunOS release 4.1 on a Sparc, use - `sparc-sun-sunos4.1'. + `sparc-sun-sunos4.1'. For SunOS release 4.1.3 on a Sparc, use + `sparc-sun-sunos4.1.3'. Note that shared libraries are now + used by default on SunOS 4.1. + + A user reported irreproducible segmentation faults when using 19.29 + on Solaris 2.3 and 2.4 after compiling it with the Sun compiler. + The problem went away when GCC 2.7.0 was used instead. We do not know + whether anything in Emacs is partly to blame for this. + + X11R6 is set up to make shared libraries only, on Sunos 4. + Therefore, in order to link Emacs, you need to create static X libraries. + To do this, rebuild X11 after setting + #define ForceNormalLib YES + #define SeparateSharedCompile YES + in site.def (after #ifdef AfterVendorCF). Use `m68k' for the 68000-based Sun boxes, `sparc' for Sparcstations, - and `i386' for Sun Roadrunners. - - There are three machine files for the different versions of SunOS - that run on the Motorola 68000 processors. All are derived from - Berkeley 4.2. Emacs 17 has run on all of them. - - See the file etc/SUNBUG for how to solve problems caused by - bugs in the "export" version of SunOS 4. - - If you have trouble using open-network-stream, get the - distribution of `bind' (the BSD name-server), build libresolv.a, - and link Emacs with -lresolv. This problem is due to obsolete + and `i386' for Sun Roadrunners. i386 calls for Sunos4.0. + + If you compile with Sun's ANSI compiler acc, you need additional options + when linking temacs, such as + /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1 + (those should be added just before the libraries) and you need to + add -lansi just before -lc. The precise file names depend on the + compiler version, so we cannot easily arrange to supply them. + + On SunOS 4.1.1, do not use /usr/5bin/cc. You can use gcc or/usr/bin/cc. + Make sure the environment variable LD_LIBRARY_PATH is not defined. + + Some people report crashes on SunOS 4.1.3 if SYSTEM_MALLOC is defined. + Others have reported that Emacs works if SYSTEM_MALLOC is defined, and not + if it is undefined. So far we do not know why results vary in this way. + The sources are set up so that SYSTEM_MALLOC is defined; if that crashes, + or if you want the benefit of the relocating memory allocator, you can + try enabling the #undef SYSTEM_MALLOC in src/s/sunos4-1-3.h. + + On Solaris 2, you need to install patch 100947-02 to fix a system bug. + Presumably this patch comes from Sun. You must alter the definition of + LD_SWITCH_SYSTEM if your X11 libraries are not in /usr/openwin/lib. + You must make sure that /usr/ucblib is not in your LD_LIBRARY_PATH. + + On Solaris 2.2, with a multiprocessor SparcCenter 1000, Emacs 19.17 is + reported to hang sometimes if it exits while it has one or more + subprocesses (e.g. the `wakeup' subprocess used by `display-time'). + Emacs and its subprocesses become zombies, and in their zombie state + slow down their host and disable rlogin and telnet. This is most + likely due to a bug in Solaris 2.2's multiprocessor support, + rather than an Emacs bug. + + On Solaris, do not use /usr/ucb/cc. Use /opt/SUNWspro/bin/cc. Make + sure that /usr/ccs/bin and /opt/SUNWspro/bin are in your PATH before + /usr/ucb. (Most free software packages have the same requirement on + Solaris.) + + If you have trouble using open-network-stream, get the distribution + of `bind' (the BSD name-server), build libresolv.a, and link Emacs + with -lresolv, by copying the #definition of LIBS_SYSTEM in + src/s/sunos4-1.h to src/config.h. This problem is due to obsolete software in the nonshared standard library. If you want to use SunWindows, define HAVE_SUN_WINDOWS @@ -624,7 +1063,9 @@ Sun 1, 2 and 3 (m68k-sun-sunos, sparc-sun-sunos, i386-sun-sunos) We recommend that you instead use the X window system, which has technical advantages, is an industry standard, and is also - free software. + free software. The FSF does not support the SunWindows code; + we installed it only on the understanding we would not let it + divert our efforts from what we think is important. If you are compiling for X windows, and the X window library was compiled to use the 68881, then you must edit config.h according @@ -639,34 +1080,17 @@ Sun 1, 2 and 3 (m68k-sun-sunos, sparc-sun-sunos, i386-sun-sunos) To build a single Emacs that will run on Sun 2 and Sun 3 HARDWARE, just build it on the Sun 2. - Changes for the Sparc architecture were merged in 18.50. Some - people say optimizing compilation does not work; some say that -O2 - (whatever that is) works perhaps with a small change. - - Changes for the Roadrunner architecture were merged in 18.51. - - There is a bug in the Export version of SunOS 4.0 shipped outsde the - US; it has something to do with Pentagon export restrictions on the - DES chips in Suns. The symptom is that "cc -Bstatic ..." WILL NOT - WORK ON SUNOS 4.0 EXPORT without a little help from "ar". The - static C-library is /lib/libc.a, and this is where the problem - occurs. There are a bunch of .o files in there relating to DES - stuff (des_crypt.o, des_soft.o, _crypt.o, etc). All of them will - cause cc -Bstatic to die with these errors: - - > _edata: ld: user attempt to redefine loader-defined symbol - > _end: user attempt to redefine loader-defined symbol - > _etext: /lib/libc.a(des_crypt.o): multiply defined + On Sunos 4.1.3, the word is that Emacs can loop infinitely + on startup with X due perhaps to a bug in Sunos. Installing all of + these Sun patches fixes the problem. We don't know which of them + are really relevant. - In order to make cc -Bstatic useful, you must remove all the - brain-damaged .o files from /lib/libc.a. To do this use - - ar d /lib/libc.a des_crypt.o des_soft.o _crypt.o .... - - (Make a backup of /lib/libc.a first, you may decide you need the "real" - thing someday). Note that there are a bunch of these files, these may - not be all of them. You will find them quick enough by trying to - compile ANY C program, even one which does NOTHING. + 100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03 + 101080-01 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10 + 101134-01 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02 + 101070-01 101145-01 100173-10 100305-15 100383-06 100513-04 100570-05 + 100689-01 101071-03 101200-02 100178-09 100338-05 100421-03 100536-02 + 100584-05 100784-01 101072-01 101207-01 Tadpole 68K (m68k-tadpole-sysv) @@ -695,13 +1119,18 @@ Tandem Integrity S2 (mips-tandem-sysv) You must edit `lib-src/Makefile' to define LOADLIBES = -mld. +Tektronix XD88 (m88k-tektronix-sysv3*) + + The 19.26 pretest was reported to work. + Minor changes merged in 19.19. + Tektronix 16000 box (6130?) (ns16k-tektronix-bsd) Emacs 17.61 worked. Tektronix 4300 (m68k-tektronix-bsd) - Emacs 18.51 worked. + Emacs 19.26 pretest reported to work. Titan P2 or P3 (titan-titan-sysv) @@ -724,8 +1153,10 @@ Vaxen running Berkeley Unix (vax-dec-bsd4.1, vax-dec-bsd4.2, vax-dec-bsd4.3), 18.36 worked on System V rel 0 (vax-dec-sysv0). - 18.36 was believed to work on VMS. Addition of features is necessary - to make this Emacs version more usable. + Richard Levitte <[email protected]> distributes a set of patches to + Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably + won't work very well, or even compile. Levitte is working on a + port, so these problems should be fixed in the near future. Whitechapel MG1 (ns16k-whitechapel-?) @@ -738,7 +1169,7 @@ Wicat (m68k-wicat-sysv) See comments in `src/m/wicat.h' for things you should change depending on the system and compiler version you have. -Here is a summary of the systems supported: +Here are notes about some of the systems supported: Berkeley 4.1 (bsd4.1) @@ -752,10 +1183,66 @@ Berkeley 4.3 (bsd4.3) Works, on Vaxes at least. +Esix + + The following was written for Emacs 18.59 and has been + slightly adapted for Emacs 19. It may need more change to be correct. + + Use s/usg5-4.h for Esix System V 4.0.[34] systems if you also have + XFree86. If you insist on using the Esix X Window libraries, good + luck. s/esix5r4.h provides a starting point, but doesn't seem to + work consistently. The basic problems involve the need to load + -lX11 *last* in the link command, and even then some things break. + You get best results by installing XFree86 and forgetting about the + Esix stuff unless you want to run IXI xdt3, which really only needs + the Esix X11 shared libraries. + + To compile with XFree86, make sure that your LD_LIBRARY_PATH + contains /usr/X386/lib. Be careful if you also have the Esix X + Window libraries that /usr/X386/lib appears *first* in the + LD_LIBRARY_PATH. Then define C_SWITCH_X_SYSTEM -I/usr/X386/include. + +Linux (actually GNU/Linux) + + Most of the complete systems which use the Linux kernel are close + enough to the GNU system to be considered variant GNU systems. We + call them "Linux-based GNU systems," or GNU/Linux for short. + + It is not coincidence that many of the other components used with + Linux--including GNU Emacs--were developed specifically for the GNU + project. The GNU project was launched in 1984 to develop a free + complete Unix-like operating system. To reach this goal, we had to + develop whatever system components were not available as freely + redistributable software from some other source. + + The GNU project wants users of GNU/Linux systems to be aware of how + these systems relate to the GNU project, because that will help + spread the GNU idea that software should be free--and thus encourage + people to write more free software. See the file LINUX-GNU in this + directory for more explanation. + Microport See under "Intel 386". +MSDOS + + For installation on MSDOS, see the file INSTALL (search for `MSDOG', + near the end of the file). See the "MS-DOS" chapter of the manual + for information about using Emacs on MSDOS. + +SCO Unix + If you have TCP but not X, you need to edit src/s/sco4.h + to define HAVE_SOCKETS. + + If you are using MMDF instead of sendmail, you need to remove + /usr/lib/sendmail or modify lisp/paths.el before compiling. + lisp/paths.el (which is loaded during the build) will attempt to use + sendmail if it exists. + + If you are using SMAIL, you need to define the macro + SMAIL in config.h. + System V rel 0 (usg5.0) Works, on Vaxes and 3bxxx's. @@ -774,7 +1261,7 @@ System V rel 2 (usg5.2) If you find that the character Meta-DEL makes Emacs crash, find where function init_sys_modes in sysdep.c sets sg.c_cc[VQUIT] and make it store 7 there. I have as yet no evidence of whether - this problem, known in HP-UX, exists in other system V versions. + this problem, known in HP/UX, exists in other system V versions. System V rel 2.2 (usg5.2.2) @@ -817,6 +1304,9 @@ System V rel 4.0.3 and 4.0.4 (usg5.4) ptys are an extension, and POSIX says that extensions *when used* may change the action of standard facilities in any fashion. + If you get compilation errors about wrong number of + arguments to getpgrp, define GETPGRP_NO_ARG. + The standard C preprocessor may generate xmakefile incorrectly. However, /lib/cpp will work, so use `make CPP=/lib/cpp'. Standard cpp seems to work OK under Dell 2.2. @@ -867,14 +1357,20 @@ Uniplus 5.2 (unipl5.2) VMS (vmsM.N) - The config file s/vms5-5.h may be right for some earlier versions; - please let us know what happens when you try it in VMS versions 5.0 - thru 5.4. + Richard Levitte <[email protected]> distributes a set of patches to + Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably + won't work very well, or even compile. Levitte is working on a + port, so these problems should be fixed in the near future. Note that Emacs for VMS is usually distributed in a special VMS distribution. See the file ../vms/VMSINSTALL for info on moving Unix distributions to VMS, and other VMS-related topics. +Windows NT + + For installation on Windows NT, see the file etc/INSTALL and search for + `Windows NT'. + Xenix (xenix) Should work in 18.50, but you will need to edit the files @@ -889,6 +1385,6 @@ Xenix (xenix) to make the Emacs meta key work. Local variables: -mode: text +mode: indented-text fill-prefix: " " End: diff --git a/etc/celibacy.1 b/etc/celibacy.1 new file mode 100644 index 0000000000..5a3fdd594f --- /dev/null +++ b/etc/celibacy.1 @@ -0,0 +1,12 @@ +CELIBACY(1) UNIX Programmer's Manual CELIBACY(1) + + + +NAME + celibacy - don't have sex + +SYNOPSIS + celibacy + +DESCRIPTION + Does nothing worth mentioning. diff --git a/etc/condom.1 b/etc/condom.1 new file mode 100644 index 0000000000..88f4c6c044 --- /dev/null +++ b/etc/condom.1 @@ -0,0 +1,148 @@ +CONDOM(1) EUNUCH Programmer's Manual CONDOM(1) + + + +NAME + condom - Protection against viruses and prevention of child + processes + +SYNOPSIS + condom [options] [processid] + +DESCRIPTION + _condom_ provides protection against System Transmitted +Viruses (STVs) that may invade your system. Although the spread of +such viruses across a network can only be abated by aware and cautious +users, _condom_ is the only highly-effective means of preventing +viruses from entering your system (see celibacy(1)). Any data passed +to _condom_ by the protected process will be blocked, as specified by +the value of the -s option (see OPTIONS below). _condom_ is known to +defend against the following viruses and other malicious +afflictions... + + o AIDS + o Herpes Simplex (genital varieties) + o Syphilis + o Crabs + o Genital warts + o Gonorrhea + o Chlamydia + o Michelangelo + o Jerusalem + + When used alone or in conjunction with pill(1), sponge(1), +foam(1), and/or setiud(3), _condom_ also prevents the conception of a +child process. If invoked from within a synchronous process, _condom_ +has, by default, an 80% chance of preventing the external processes +from becoming parent processes (see the -s option below). When other +process contraceptives are used, the chance of preventing a child +process from being forked becomes much greater. See pill(1), +sponge(1), foam(1), and setiud(3) for more information. + If no options are given, the current user's login process (as +determined by the environment variable USER) is protected with a +Trojan rough-cut latex condom without a reservoir tip. The optional +'processid' argument is an integer specifying the process to protect. + NOTE: _condom_ may only be used with a hard disk. _condom_ +will terminate abnormally with exit code -1 if used with a floppy +disk (see DIAGNOSTICS below). + +OPTIONS + The following options may be given to _condom_... + + -b BRAND BRANDs are as follows... + + trojan (default) + ramses + sheik + goldcoin + fourex + + -m MATERIAL The valid MATERIALs are... + + latex (default) + saranwrap + membrane -- WARNING! The membrane option is _not_ + endorsed by the System Administrator General as an + effective barrier against certain viruses. It is + supported only for the sake of tradition. + + -f FLAVOR The following FLAVORs are currently supported... + + plain (default) + apple + banana + cherry + cinnamon + licorice + orange + peppermint + raspberry + spearmint + strawberry + + -r Toggle reservoir tip (default is no reservoir tip) + + -s STRENGTH STRENGTH is an integer between 20 and 100 specifying + the resilience of _condom_ against data passed to + _condom_ by the protected process. Using a larger + value of STRENGTH increases _condom_'s protective + abilities, but also reduces interprocess communication. + A smaller value of STRENGTH increases interprocess + communication, but also increases the likelihood of a + security breach. An extremely vigorous process or + one passing an enormous amount of data to _condom_ + will increase the chance of _condom_'s failure. The + default STRENGTH is 80%. + + -t TEXTURE Valid TEXTUREs are... + + rough (default) + ribbed + bumps + lubricated (provides smoother interaction between + processes) + + WARNING: The use of an external application to _condom_ in +order to reduce friction between processes has been proven in +benchmark tests to decrease _condom_'s strength factor! If execution +speed is important to your process, use the '-t lubricated' option. + +DIAGNOSTICS + _condom_ terminates with one of the following exit codes... + + -1 An attempt was made to use _condom_ on a floppy disk. + + 0 _condom_ exited successfully (no data was passed to + the synchronous process). + + 1 _condom_ failed and data was allowed through. The + danger of transmission of an STV or the forking of a child + process is inversely proportional to the number of other + protections employed and is directly proportional to + the ages of the processes involved. + +BUGS + _condom_ is NOT 100% effective at preventing a child process +from being forked or at deterring the invasion of a virus (although +the System Administrator General has deemed that _condom_ is the most +effective means of preventing the spread of system transmitted +viruses). See celibacy(1) for information on a 100% effective program +for preventing these problems. + Remember... the use of sex(1) and other related routines +should only occur between mature, consenting processes. If you must +use sex(1), please employ _condom_ to protect your process and your +synchronous process. If we are all responsible, we can stop the +spread of STVs. + +AUTHORS and HISTORY + The original version of _condom_ was released in Roman times +and was only marginally effective. With the advent of modern +technology, _condom_ now supports many more options and is much more +effective. + The current release of _condom_ was written by Ken Maupin at +the University of Washington ([email protected]) and was last +updated on 10/7/92. + +SEE ALSO + celibacy(1), sex(1), pill(1), sponge(1), foam(1), and +setiud(3) diff --git a/etc/emacs.1 b/etc/emacs.1 new file mode 100644 index 0000000000..f8aceedba1 --- /dev/null +++ b/etc/emacs.1 @@ -0,0 +1,495 @@ +.TH EMACS 1 "1995 December 7" +.UC 4 +.SH NAME +emacs \- GNU project Emacs +.SH SYNOPSIS +.B emacs +[ +.I command-line switches +] [ +.I files ... +] +.br +.SH DESCRIPTION +.I GNU Emacs +is a version of +.I Emacs, +written by the author of the original (PDP-10) +.I Emacs, +Richard Stallman. +.br +The primary documentation of GNU Emacs is in the GNU Emacs Manual, +which you can read on line using Info, a subsystem of Emacs. Please +look there for complete and up-to-date documentation. This man page +is updated only when someone volunteers to do so; the Emacs +maintainers' priority goal is to minimize the amount of time this man +page takes away from other more useful projects. +.br +The user functionality of GNU Emacs encompasses +everything other +.I Emacs +editors do, and it is easily extensible since its +editing commands are written in Lisp. +.PP +.I Emacs +has an extensive interactive help facility, +but the facility assumes that you know how to manipulate +.I Emacs +windows and buffers. +CTRL-h (backspace +or CTRL-h) enters the Help facility. Help Tutorial (CTRL-h t) +requests an interactive tutorial which can teach beginners the fundamentals +of +.I Emacs +in a few minutes. +Help Apropos (CTRL-h a) helps you +find a command given its functionality, Help Character (CTRL-h c) +describes a given character's effect, and Help Function (CTRL-h f) +describes a given Lisp function specified by name. +.PP +.I Emacs's +Undo can undo several steps of modification to your buffers, so it is +easy to recover from editing mistakes. +.PP +.I GNU Emacs's +many special packages handle mail reading (RMail) and sending (Mail), +outline editing (Outline), compiling (Compile), running subshells +within +.I Emacs +windows (Shell), running a Lisp read-eval-print loop +(Lisp-Interaction-Mode), and automated psychotherapy (Doctor). +.PP +There is an extensive reference manual, but +users of other Emacses +should have little trouble adapting even +without a copy. Users new to +.I Emacs +will be able +to use basic features fairly rapidly by studying the tutorial and +using the self-documentation features. +.PP +.SM Emacs Options +.PP +The following options are of general interest: +.TP 8 +.I file +Edit +.I file. +.TP +.BI \+ number +Go to the line specified by +.I number +(do not insert a space between the "+" sign and +the number). +.TP +.B \-q +Do not load an init file. +.TP +.BI \-u " user" +Load +.I user's +init file. +.TP +.BI \-t " file" +Use specified +.I file +as the terminal instead of using stdin/stdout. +This must be the first argument specified in the command line. +.PP +The following options are lisp-oriented +(these options are processed in the order encountered): +.TP 8 +.BI \-f " function" +Execute the lisp function +.I function. +.TP +.BI \-l " file" +Load the lisp code in the file +.I file. +.PP +The following options are useful when running +.I Emacs +as a batch editor: +.TP 8 +.BI \-batch +Edit in batch mode. The editor will send messages to stderr. This +option must be the first in the argument list. You must use -l and -f +options to specify files to execute and functions to call. +.TP +.B \-kill +Exit +.I Emacs +while in batch mode. +.\" START DELETING HERE IF YOU'RE NOT USING X +.PP +.SM Using Emacs with X +.PP +.I Emacs +has been tailored to work well with the X window system. +If you run +.I Emacs +from under X windows, it will create its own X window to +display in. You will probably want to start the editor +as a background process +so that you can continue using your original window. +.PP +.I Emacs +can be started with the following X switches: +.TP 8 +.BI \-name " name" +Specifies the name which should be assigned to the initial +.I Emacs +window. This controls looking up X resources as well as the window title. +.TP 8 +.BI \-title " name" +Specifies the title for the initial X window. +.TP 8 +.B \-r +Display the +.I Emacs +window in reverse video. +.TP +.B \-i +Use the "kitchen sink" bitmap icon when iconifying the +.I Emacs +window. +.TP +.BI \-font " font, " \-fn " font" +Set the +.I Emacs +window's font to that specified by +.I font. +You will find the various +.I X +fonts in the +.I /usr/lib/X11/fonts +directory. +Note that +.I Emacs +will only accept fixed width fonts. +Under the X11 Release 4 font-naming conventions, any font with the +value "m" or "c" in the eleventh field of the font name is a fixed +width font. Furthermore, fonts whose name are of the form +.IR width x height +are generally fixed width, as is the font +.IR fixed . +See +.IR xlsfonts (1) +for more information. + +When you specify a font, be sure to put a space between the +switch and the font name. +.TP +.BI \-b " pixels" +Set the +.I Emacs +window's border width to the number of pixels specified by +.I pixels. +Defaults to one pixel on each side of the window. +.TP +.BI \-ib " pixels" +Set the window's internal border width to the number of pixels specified +by +.I pixels. +Defaults to one pixel of padding on each side of the window. +.PP +.TP 8 +.BI \-geometry " geometry" +Set the +.I Emacs +window's width, height, and position as specified. The geometry +specification is in the standard X format; see +.IR X (1) +for more information. +The width and height are specified in characters; the default is 80 by +24. +.PP +.TP 8 +.BI \-fg " color" +On color displays, sets the color of the text. + +See the file +.I /usr/lib/X11/rgb.txt +for a list of valid +color names. +.TP +.BI \-bg " color" +On color displays, +sets the color of the window's background. +.TP +.BI \-bd " color" +On color displays, +sets the color of the window's border. +.TP +.BI \-cr " color" +On color displays, +sets the color of the window's text cursor. +.TP +.BI \-ms " color" +On color displays, +sets the color of the window's mouse cursor. +.TP +.BI \-d " displayname, " \-display " displayname" +Create the +.I Emacs +window on the display specified by +.IR displayname . +Must be the first option specified in the command line. +.TP +.B \-nw +Tells +.I Emacs +not to use its special interface to X. If you use this +switch when invoking +.I Emacs +from an +.IR xterm (1) +window, display is done in that window. +This must be the first option specified in the command line. +.PP +You can set +.I X +default values for your +.I Emacs +windows in your +.I \.Xresources +file (see +.IR xrdb (1)). +Use the following format: +.IP +emacs.keyword:value +.PP +where +.I value +specifies the default value of +.I keyword. +.I Emacs +lets you set default values for the following keywords: +.TP 8 +.B font (\fPclass\fB Font) +Sets the window's text font. +.TP +.B reverseVideo (\fPclass\fB ReverseVideo) +If +.I reverseVideo's +value is set to +.I on, +the window will be displayed in reverse video. +.TP +.B bitmapIcon (\fPclass\fB BitmapIcon) +If +.I bitmapIcon's +value is set to +.I on, +the window will iconify into the "kitchen sink." +.TP +.B borderWidth (\fPclass\fB BorderWidth) +Sets the window's border width in pixels. +.TP +.B internalBorder (\fPclass\fB BorderWidth) +Sets the window's internal border width in pixels. +.TP +.B foreground (\fPclass\fB Foreground) +For color displays, +sets the window's text color. +.TP +.B background (\fPclass\fB Background) +For color displays, +sets the window's background color. +.TP +.B borderColor (\fPclass\fB BorderColor) +For color displays, +sets the color of the window's border. +.TP +.B cursorColor (\fPclass\fB Foreground) +For color displays, +sets the color of the window's text cursor. +.TP +.B pointerColor (\fPclass\fB Foreground) +For color displays, +sets the color of the window's mouse cursor. +.TP +.B geometry (\fPclass\fB Geometry) +Sets the geometry of the +.I Emacs +window (as described above). +.TP +.B title (\fPclass\fB Title) +Sets the title of the +.I Emacs +window. +.TP +.B iconName (\fPclass\fB Title) +Sets the icon name for the +.I Emacs +window icon. +.PP +If you try to set color values while using a black and white display, +the window's characteristics will default as follows: +the foreground color will be set to black, +the background color will be set to white, +the border color will be set to grey, +and the text and mouse cursors will be set to black. +.PP +.SM Using the Mouse +.PP +The following lists the mouse button bindings for the +.I Emacs +window under X11. + +.in +\w'CTRL-SHIFT-middle'u+4n +.ta \w'CTRL-SHIFT-middle'u+4n +.ti -\w'CTRL-SHIFT-middle'u+4n +MOUSE BUTTON FUNCTION +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +left Set point. +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +middle Paste text. +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +right Cut text into X cut buffer. +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +SHIFT-middle Cut text into X cut buffer. +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +SHIFT-right Paste text. +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +CTRL-middle Cut text into X cut buffer and kill it. +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +CTRL-right Select this window, then split it into +two windows. Same as typing CTRL-x 2. +.\" START DELETING HERE IF YOU'RE NOT USING X MENUS +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +CTRL-SHIFT-left X buffer menu--hold the buttons and keys +down, wait for menu to appear, select +buffer, and release. Move mouse out of +menu and release to cancel. +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +CTRL-SHIFT-middle X help menu--pop up index card menu for +Emacs help. +.\" STOP DELETING HERE IF YOU'RE NOT USING X MENUS +.br +.ti -\w'CTRL-SHIFT-middle'u+4n +CTRL-SHIFT-right Select window with mouse, and delete all +other windows. Same as typing CTRL-x 1. +.\" STOP DELETING HERE IF YOU'RE NOT USING X +.PP +.SH MANUALS +You can order printed copies of the GNU Emacs Manual from the Free +Software Foundation, which develops GNU software. See the file ORDERS +for ordering information. +.br +Your local Emacs maintainer might also have copies available. As +with all software and publications from FSF, everyone is permitted to +make and distribute copies of the Emacs manual. The TeX source to the +manual is also included in the Emacs source distribution. +.PP +.SH FILES +/usr/local/info - files for the Info documentation browser +(a subsystem of Emacs) to refer to. Currently not much of Unix +is documented here, but the complete text of the Emacs reference +manual is included in a convenient tree structured form. + +/usr/local/share/emacs/$VERSION/src - C source files and object files + +/usr/local/share/emacs/$VERSION/lisp - Lisp source files and compiled files +that define most editing commands. Some are preloaded; +others are autoloaded from this directory when used. + +/usr/local/share/emacs/$VERSION/etc - various programs that are used with +GNU Emacs, and some files of information. + +/usr/local/share/emacs/$VERSION/etc/DOC.* - contains the documentation +strings for the Lisp primitives and preloaded Lisp functions +of GNU Emacs. They are stored here to reduce the size of +Emacs proper. + +/usr/local/share/emacs/$VERSION/etc/OTHER.EMACSES discusses GNU Emacs +vs. other versions of Emacs. +.br +/usr/local/share/emacs/$VERSION/etc/SERVICE lists people offering +various services to assist users of GNU Emacs, including education, +troubleshooting, porting and customization. +.br +These files also have information useful to anyone wishing to write +programs in the Emacs Lisp extension language, which has not yet been fully +documented. + +/usr/local/com/emacs/lock - holds lock files that are made for all +files being modified in Emacs, to prevent simultaneous modification +of one file by two users. + +.\" START DELETING HERE IF YOU'RE NOT USING X +/usr/lib/X11/rgb.txt - list of valid X color names. +.\" STOP DELETING HERE IF YOU'RE NOT USING X +.PP +.SH BUGS +There is a mailing list, [email protected] on the internet +(ucbvax!prep.ai.mit.edu!bug-gnu-emacs on UUCPnet), for reporting Emacs +bugs and fixes. But before reporting something as a bug, please try +to be sure that it really is a bug, not a misunderstanding or a +deliberate feature. We ask you to read the section ``Reporting Emacs +Bugs'' near the end of the reference manual (or Info system) for hints +on how and when to report bugs. Also, include the version number of +the Emacs you are running in \fIevery\fR bug report that you send in. + +Do not expect a personal answer to a bug report. The purpose of reporting +bugs is to get them fixed for everyone in the next release, if possible. +For personal assistance, look in the SERVICE file (see above) for +a list of people who offer it. + +Please do not send anything but bug reports to this mailing list. +Send requests to be added to mailing lists to the special list [email protected] (or the corresponding UUCP +address). For more information about Emacs mailing lists, see the +file /usr/local/emacs/etc/MAILINGLISTS. Bugs tend actually to be +fixed if they can be isolated, so it is in your interest to report +them in such a way that they can be easily reproduced. +.PP +Bugs that I know about are: shell will not work with programs +running in Raw mode on some Unix versions. +.SH UNRESTRICTIONS +.PP +.I Emacs +is free; anyone may redistribute copies of +.I Emacs +to +anyone under the terms stated in the +.I Emacs +General Public License, +a copy of which accompanies each copy of +.I Emacs +and which also +appears in the reference manual. +.PP +Copies of +.I Emacs +may sometimes be received packaged with distributions of Unix systems, +but it is never included in the scope of any license covering those +systems. Such inclusion violates the terms on which distribution +is permitted. In fact, the primary purpose of the General Public +License is to prohibit anyone from attaching any other restrictions +to redistribution of +.I Emacs. +.PP +Richard Stallman encourages you to improve and extend +.I Emacs, +and urges that +you contribute your extensions to the GNU library. Eventually GNU +(Gnu's Not Unix) will be a complete replacement for Berkeley +Unix. +Everyone will be free to use, copy, study and change the GNU system. +.SH SEE ALSO +X(1), xlsfonts(1), xterm(1), xrdb(1) +.SH AUTHORS +.PP +.I Emacs +was written by Richard Stallman and the Free Software Foundation. +Joachim Martillo and Robert Krawitz added the X features. diff --git a/etc/emacstool.1 b/etc/emacstool.1 new file mode 100644 index 0000000000..999588a81a --- /dev/null +++ b/etc/emacstool.1 @@ -0,0 +1,134 @@ +.TH EMACSTOOL 1 +.SH NAME +.I emacstool +\- run emacs under Sun windows with function-key and mouse support. +.SH SYNOPSIS +.I emacstool +[{window_args} {-rc run_command_path} args ... ] +.SH TYPICAL USAGE +In ~/.suntools or ~/.rootmenu include a line like this: +.br +"Emacstool" emacstool -WI emacs.icon -f emacstool-init +.SH DESCRIPTION +.B Emacstool +creates a SunView frame and a tty subwindow within which mouse events +and function keys are translated to ASCII sequences which Emacs can +parse. The translated input events are sent to the process running in +the tty subwindow, which is typically GNU Emacs. Emacstool thereby +allows GNU Emacs users to make full use of the mouse and function keys. +GNU Emacs can be loaded with functions to interpret the mouse and +function-key events to make a truly fine screen oriented editor for +the Sun Workstation. +.PP +(Note that GNU Emacs has a special interface to the X window system as +well. The X window system has many technical advantages, it is an +industry standard, and it is also free software. The Free Software +Foundation urges you to try X windows, and distributes a free copy of +X on Emacs distribution tapes.) +.PP +Function keys are translated to a sequence of the form +`^X*[a-o][lrt]'. The last character is `l', `r', or `t' corresponding +to whether the key is among the Left, Right, or Top function keys. +The third character indicates which button of the group +was pressed. Thus, the function key in the lower right corner will +transmit the sequence `^X*or'. In addition, the [lrt] is affected by +the Control, Meta, and Shift keys. Unshifted Control keys will be +non-alphabetic: C-l is [,], C-r is [2], C-t is [4]. +.PP +Mouse buttons are encoded as `^X^@([124] x y)\\n'. ^X^@ is the +standard GNU Emacs mouse event prefix, it is followed by a list +indicating the button pressed and the character row and column of the +point in the window where the mouse cursor is, and followed by a +newline character. In GNU Emacs, the ^X^@ dispatches to a +mouse event handler which then reads the following list. +.SH OPTIONS +.B Emacstool +supports all the standard window arguments, including font and icon +specifiers. +.PP +By default, Emacstool runs the program +.I emacs +in the created subwindow. +The value of the environment variable +.I EMACSTOOL +can be used to override this if your version of +.B Emacs +is not accessible on your search path by the name +.I Emacs. +In addition, the run command can be set by the +.I pathname +following the last occurrence of the +.I \-rc +flag. +This is convenient for using Emacstool to run on remote machines. +.PP +All other command line arguments not used by the window system are passed +as arguments to the program that runs in the Emacstool window. +.PP +For example: +.PP +local% (emacstool -rc rlogin remote -8 &)& +.PP +will create an Emacstool window logged in to a machine named +.I remote. +If Emacs is run from this window, +Emacstool will encode mouse and function keys, and send them to rlogin. +If Emacs is run from this shell on the remote machine, it will see +the mouse and function keys properly. +However, since the remote host does not have access to the screen, +the cursor cannot be changed, menus will not appear, and the selection +buffer (STUFF) is limited. +.SH Using With GNU Emacs: +The GNU Emacs files +lisp/term/sun.el, +lisp/sun-mouse.el, +lisp/sun-fns.el, +and +src/sunfns.c +provide emacs support for the Emacstool and function keys. +Emacstool will automatically set the TERM environment variable to be "sun" +and unset the environment variable TERMCAP. That is, these variables will +not be inherited from the shell that starts Emacstool. +Since the terminal type is +.I SUN +(that is, the environment variable TERM is set to +.I SUN), +Emacs will automatically load the file lisp/term/sun. +This, in turn, will ensure that sun-mouse.el is autoloaded when any mouse +events are detected. It is suggested that +.I sun-mouse +and +.I sun-fns +be loaded in your site-init.el file, so that they will always be loaded +when running on a Sun workstation. +.PP +In addition, Emacstool sets the environment variable IN_EMACSTOOL = "t". +Lisp code in your ~/.emacs can use (getenv "IN_EMACSTOOL") +to determine whether to do Emacstool specific initialization. +Sun.el uses this to automatically call emacstool-init (getenv "IN_EMACSTOOL") +is defined. +.PP +The file src/sunfns.c defines several useful functions for emacs on +the Sun. Among these are procedures to pop-up SunView +.I menus, +put and get from the SunView +.I STUFF +buffer, and a procedure for changing the cursor +.I icon. +If you want to define or edit cursor icons, +there is a rudimentary mouse driven icon editor in the file +lisp/sun-cursors.el. Try invoking (sc:edit-cursor) +.SH BUGS +It takes a few milliseconds to create a menu before it pops up. +.SH ENVIRONMENT VARIABLES +EMACSTOOL +IN_EMACSTOOL +TERM +TERMCAP +.SH FILES +.DT +emacs +.SH "SEE ALSO" +emacs(1) + .../etc/SUN-SUPPORT + .../lisp/term/sun.el diff --git a/etc/future-bug b/etc/future-bug new file mode 100644 index 0000000000..9b608c749c --- /dev/null +++ b/etc/future-bug @@ -0,0 +1,37 @@ +Date: Tue, 23 Feb 2199 21:03:50 -0600 +From: Karl Fogel <[email protected]> +To: [email protected] +Subject: M-x search-backward-in-time broken... +X-Windows: you'll envy the dead. + +In GNU Emacs 51.70.4 (i9986-unknown-linux-gnu, X toolkit) of Sat Feb 20 2199 on floss +configured using `configure --with-x-toolkit=yes' + + The `search-backward-in-time' function appears to be broken in +Emacs 51.70. + + Unfortunately, I can never seem to start the debugger early +enough to catch the error as it happens. However I have traced the +problem through source by eye, and it looks like `time-forward' can't +handle negative arguments anymore. This is consistent with other +symptoms: for example, `undo' (which since 51.25 has worked by passing +a negative arg to `time-forward') is also broken. However, `do' still +works -- it seems that `time-forward' continues to handle positive +arguments just fine. + + No one here-and-now can figure out how to fix the problem, +because the code for `time-forward' is so hairy. We're using M-x +report-future-emacs-bug to request that you folks include more +comments when you write it (sometime in 2198 as I recall). + + Thanks! + +-Karl Fogel <[email protected]> + + +P.S. You'll be pleased to know that since (time-forward N) still works + for N >= 0, we've used it to pre-emptively update configure.in. + Emacs now configures and builds on every platform that will ever + be made. It wasn't easy, but at least that's one problem out of + the way for good. If you'd like the patch, just ask. + diff --git a/etc/gnus-tut.txt b/etc/gnus-tut.txt new file mode 100644 index 0000000000..94e9500f71 --- /dev/null +++ b/etc/gnus-tut.txt @@ -0,0 +1,294 @@ +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: So you want to use the new Gnus +Message-ID: <[email protected]> + +Actually, since you are reading this, chances are you are already +using the new Gnus. Congratulations. + +This entire newsgroup you are reading is, in fact, no real newsgroup +at all, in the traditional sense. It is an example of one of the +"foreign" select methods that Gnus may use. + +The text you are now reading is stored in the "etc" directory with the +rest of the Emacs sources. You are using the "nndoc" backend for +accessing it. Scary, isn't it? + +This isn't the real documentation. `M-x info', `m gnus <RET>' to read +that. This "newsgroup" is intended as a kinder, gentler way of getting +people started. + +Gnus is a rewrite of GNUS 4.1, written by Masanobu Umeda. The rewrite +was done by moi, yours truly, your humble servant, Lars Magne +Ingebrigtsen. If you have a WWW browser, you can investigate to your +heart's delight at <URL:http://www.ifi.uio.no/~larsi/larsi.html>. + +;; Copyright (C) 1995 Free Software Foundation, Inc. + +;; Author: Lars Magne Ingebrigtsen <[email protected]> +;; Keywords: news + +;; This file is part of GNU Emacs. + +;; GNU Emacs is free software; you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation; either version 2, or (at your option) +;; any later version. + +;; GNU Emacs is distributed in the hope that it will be useful, +;; but WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;; GNU General Public License for more details. + +;; You should have received a copy of the GNU General Public License +;; along with GNU Emacs; see the file COPYING. If not, write to the +;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, +;; Boston, MA 02111-1307, USA. + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: Starting up +Message-ID: <[email protected]> + +If you are having problems with Gnus not finding your server, you have +to set `gnus-select-method'. A "method" is a way of specifying *how* +the news is to be found, and from *where*. + +Say you want to read news from you local, friendly nntp server +"news.my.local.server". + +(setq gnus-select-method '(nntp "news.my.local.server")) + +Quite easy, huh? + +From the news spool: + +(setq gnus-select-method '(nnspool "")) + +From your mh-e spool: + +(setq gnus-select-method '(nnmh "")) + +There's a whole bunch of other methods for reading mail and news, see +the "Foreign groups" article for that. + + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: Where are all the groups, then? +Message-ID: <[email protected]> + +If this is the first time you have used a newsreader, you won't have a +.newsrc file. This means that Gnus will think that all the newsgroups +on the server are "new", and kill them all. + +If you have a .newsrc file, the new groups will be processed with the +function in the `gnus-subscribe-newsgroup-method' variable, which is +`gnus-subscribe-zombies' by default. + +This means that all the groups have been made into "zombies" - not +quite dead, but not exactly alive, either. + +Jump back to the *Group* buffer, and type `A z' to list all the zombie +groups. Look though the list, and subscribe to the groups you want to +read by pressing `u' on the one you think look interesting. + +If all the groups have been killed, type `A k' to list all the killed +groups. Subscribe to them the same way. + +When you are satisfied, press `S z' to kill all the zombie groups. + +Now you should have a nice list of all groups you are interested in. + +(If you later want to subscribe to more groups, press `A k' to +list all the kill groups, and repeat. You can also type `U' and be +prompted for groups to subscribe to.) + + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: I want to read my mail! +Message-ID: <[email protected]> + +Yes, Virginia, you can read mail with Gnus. + +First you have to decide which mail backend you want to use. You have +nnml, which is a one-file-one-mail backend, which is quite nice, but +apt to make your systems administrator go crazy and come after you +with a shotgun. + +nnmbox uses a Unix mail box to store mail. Nice, but slow. + +nnmh uses mh-e folders, which is also a one-file-one-mail thingie, but +slower than nnml. (It doesn't support NOV files.) + +So if you want to go with nnmbox, you can simply say: + +(setq gnus-secondary-select-methods '((nnmbox ""))) + +(The same for the other methods, kind of.) + +You should also set `nnmail-split-methods' to something sensible: + +(setq nnmail-split-methods + '(("mail.junk" "From:.*Lars") + ("mail.misc ""))) + +This will put all mail from me in you junk mail group, and the rest in +"mail.misc". + +These groups will be subscribe the same way as the normal groups, so +you will probably find them among the zombie groups after you set +these variables and re-start Gnus. + + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: Foreign newsgroups +Message-ID: <[email protected]> + +These are groups that do not come from `gnus-select-method'. + +Say you want to read "alt.furniture.couches" from "news.funet.fi". You +can then either type `B news.funet.fi <RET>' to browse that server and +subscribe to that group, or you can type +`G m alt.furniture.couches<RET>nntp<RET>news.funet.fi<RET>', if you +like to type a lot. + +If you want to read a directory as a newsgroup, you can create an +nndir group, much the same way. There's a shorthand for that, +though. If, for instance, you want to read the (ding) list archives, +you could type `G d /ftp <RET>'. + +There's lots more to know about foreign groups, but you have to read +the info pages to find out more. + + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: Low level changes in GNUS, or, Wrong type argument: stringp, nil +Message-ID: <[email protected]> + +Gnus really isn't GNUS, even though it looks like it. If you scrape +the surface, you'll find that most things have changed. + +This means that old code that relies on GNUS internals will fail. + +In particular, `gnus-newsrc-hashtb', `gnus-newsrc-assoc', +`gnus-killed-list', the `nntp-header-' macros and the display formats +have all changed. If you have some code lying around that depend on +these, or change these, you'll have to re-write your code. + +Old hilit19 code does not work at all. In fact, you should probably +remove all hilit code from all the Gnus hooks +(`gnus-group-prepare-hook', `gnus-summary-prepare-hook' and +`gnus-summary-article-hook'). (Well, at the very least the first +two.) Gnus provides various integrated functions for highlighting, +which are both faster and more accurated. + +There is absolutely no chance, whatsoever, of getting Gnus to work +with Emacs 18. It won't even work on Emacsen older than Emacs +19.30/XEmacs 19.13. Upgrade your Emacs or die. + + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: How do I re-scan my mail groups? +Message-ID: <[email protected]> + +Reading the active file from the nntp server is a drag. + +Just press `M-g' on the mail groups, and they will be re-scanned. + +You can also re-scan all the mail groups by putting them on level 1 +(`S l 1'), and saying `1 g' to re-scan all level 1 groups. + + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: How do I set up virtual newsgroups? +Message-ID: <[email protected]> + +Virtual newsgroups are collections of other newsgroups. Why people +want this is beyond me, but here goes: + +Create the group by saying + +`M-a my.virtual.newsgroup<RET>nnvirtual<RET>^rec\.aquaria\.*<RET>' + +This will create the group "nnvirtual:my.virtual.newsgroup", which +will collect all articles from all the groups in the "rec.aquaria" +hierarchy. + +If you want to edit the regular expression, just type `M-e' on the +group line. + +Note that all the groups that are part of the virtual group have to be +alive. This means that the cannot, absolutely not, be zombie or +killed. They can be unsubscribed; that's no problem. + +You can combine groups from different servers in the same virtual +newsgroup, something that may actually be useful. Say you have the +group "comp.headers" on the server "news.server.no" and the same group +on "news.server.edu". If people have posted articles with Distribution +headers that stop propagation of their articles, combining these two +newsgroups into one virtual newsgroup should give you a better view of +what's going on. + +One caveat, though: The virtual group article numbers from the first +source group (group A) will always be lower than the article numbers +from the second (group B). This means that Gnus will believe that +articles from group A are older than articles from group B. Threading +will lessen these problems, but it might be a good idea to sort the +threads over the date of the articles to get a correct feel for the +flow of the groups: + +(setq gnus-thread-sort-functions '(gnus-thread-sort-by-date)) + +If you only want this in virtual groups, you could say something along +the lines of: + +(setq gnus-select-group-hook + (lambda () + (if (eq 'nnvirtual (car (gnus-find-method-for-group + gnus-newsgroup-name))) + (progn + (make-local-variable 'gnus-thread-sort-functions) + (setq gnus-thread-sort-functions '(gnus-thread-sort-by-date)))))) + + +From lars Thu Feb 23 23:20:38 1995 +From: [email protected] (ding) +Date: Fri Feb 24 13:40:45 1995 +Subject: Bugs & stuff +Message-ID: <[email protected]> + +If you want to report a bug, please type `M-x gnus-bug'. This will +give me a precise overview of your Gnus and Emacs version numbers, +along with a look at all Gnus variables you have changed. + +Du not expect a reply back, but your bug should be fixed in the next +version. If the bug persists, please re-submit your bug report. + +When a bug occurs, I need a recipe for how to trigger the bug. You +have to tell me exactly what you do to uncover the bug, and you should +(setq debug-on-error t) and send me the backtrace along with the bug +report. + +If I am not able to reproduce the bug, I won't be able to fix it. + +I would, of course, prefer that you locate the bug, fix it, and mail +me the patches, but one can't have everything. + +If you have any questions on usage, the "[email protected]" mailing list +is where to post the questions. + + |