summaryrefslogtreecommitdiff
path: root/etc
diff options
context:
space:
mode:
authorDave Love <fx@gnu.org>1999-10-03 12:17:04 +0000
committerDave Love <fx@gnu.org>1999-10-03 12:17:04 +0000
commita7bfd66f45c12ca1b8c158b44c57dc56de13654c (patch)
tree9d75950dd678bdf8da58eb550c28ac1637eaac4f /etc
parent5bcd0f1eda7f99a916841d906be538fab381b7d3 (diff)
downloademacs-a7bfd66f45c12ca1b8c158b44c57dc56de13654c.tar.gz
#CENSORSHIP
Diffstat (limited to 'etc')
-rw-r--r--etc/COOKIES157
-rw-r--r--etc/MACHINES810
-rw-r--r--etc/celibacy.112
-rw-r--r--etc/condom.1148
-rw-r--r--etc/emacs.1495
-rw-r--r--etc/emacstool.1134
-rw-r--r--etc/future-bug37
-rw-r--r--etc/gnus-tut.txt294
8 files changed, 1930 insertions, 157 deletions
diff --git a/etc/COOKIES b/etc/COOKIES
new file mode 100644
index 00000000000..41f8afee249
--- /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: ucdavis!lll-lcc!hplabs!parcvax!bane@ucbvax.berkeley.edu (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 eb86f4c1aa0..7e08ec8ae58 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
+ <jjd@spserv.bbn.com> 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.
+ dsg@mitre.org 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 <levitte@e.kth.se> 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 <levitte@e.kth.se> 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 00000000000..5a3fdd594f3
--- /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 00000000000..88f4c6c044a
--- /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 (maupin@cs.washington.edu) 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 00000000000..f8aceedba1c
--- /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, bug-gnu-emacs@prep.ai.mit.edu 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
+info-gnu-emacs-request@prep.ai.mit.edu (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 00000000000..999588a81ae
--- /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 00000000000..9b608c749cc
--- /dev/null
+++ b/etc/future-bug
@@ -0,0 +1,37 @@
+Date: Tue, 23 Feb 2199 21:03:50 -0600
+From: Karl Fogel <kfogel@floss.cyclic.com>
+To: bug-gnu-emacs@prep.ai.mit.edu
+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 <kfogel@red-bean.com>
+
+
+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 00000000000..94e9500f712
--- /dev/null
+++ b/etc/gnus-tut.txt
@@ -0,0 +1,294 @@
+From lars Thu Feb 23 23:20:38 1995
+From: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: So you want to use the new Gnus
+Message-ID: <lars-doc1@eyesore.no>
+
+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 <larsi@ifi.uio.no>
+;; 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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: Starting up
+Message-ID: <lars-doc2@eyesore.no>
+
+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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: Where are all the groups, then?
+Message-ID: <lars-doc3@eyesore.no>
+
+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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: I want to read my mail!
+Message-ID: <lars-doc4@eyesore.no>
+
+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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: Foreign newsgroups
+Message-ID: <lars-doc5@eyesore.no>
+
+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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: Low level changes in GNUS, or, Wrong type argument: stringp, nil
+Message-ID: <lars-doc6@eyesore.no>
+
+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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: How do I re-scan my mail groups?
+Message-ID: <lars-doc8@eyesore.no>
+
+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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: How do I set up virtual newsgroups?
+Message-ID: <lars-doc9@eyesore.no>
+
+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: larsi@ifi.uio.no (ding)
+Date: Fri Feb 24 13:40:45 1995
+Subject: Bugs & stuff
+Message-ID: <lars-doc7@eyesore.no>
+
+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 "ding@ifi.uio.no" mailing list
+is where to post the questions.
+
+