view nextstep/INSTALL @ 100913:c2069bd311e6

(basic-save-buffer): Protect buffer-modified flag around first swap. (pmail-show-message): Protect buffer-modified flag around swap. (pmail-change-major-mode-hook): Likewise. (pmail-use-collection-buffer, pmail-swap-buffers-maybe): Likewise. (pmail-error-bad-format): Always phrase the error as about an invalid message. (pmail-convert-file-maybe): Don't use pmail-error-bad-format. (pmail-mode-map): Move pmail-widen to C-c C-w. (pmail-mode-1): Don't alter mode-line-modified. (pmail-perm-variables): Turn off undo in view buffer. (pmail-variables): Turn off undo. (pmail-show-message): Delete useless calls to `widen'. Avoid passing thru temp buffer if we don't need base64 or quoted printable decoding for whole message. (pmail-keywords): Variable deleted. (pmail-last-label, pmail-last-multi-labels): Moved to pmailkwd.el. (pmail-perm-variables): Don't mess with pmail-last-label. Don't mess with pmail-keywords. (pmail-copy-headers): Doc fix. (pmail-set-header): New function. (pmail-get-keywords): Doc fix. (pmail-get-labels): New function. (pmail-display-labels): Use pmail-get-labels. (pmail-set-attribute): Mark pmail-buffer modified if we change an attribute. (pmail-apply-in-message): New function. (pmail-message-labels-p): Function moved to pmailsum.el. (pmail-message-recipients-p, pmail-message-regexp-p): Likewise. (pmail-current-subject, pmail-current-subject-regexp): Fns deleted. (pmail-simplified-subject, pmail-simplified-subject-regexp): New fns. (pmail-next-same-subject): Fetch each msg's subject and compare. (pmail-speedbar-move-message): Use pmail-output. (pmail-construct-io-menu): Use pmail-output. (pmail-default-pmail-file): Variable deleted. (pmail-auto-file): Use pmail-output. (pmail-mode-map): Remove pmail-output-to-babyl-file. Add pmail-output-as-seen. (pmail-mode): Update output commands in doc string.

Copyright (C) 2008 Free Software Foundation, Inc.
See the end of the file for license conditions.


Compilation
-----------

In the top-level directory, use:

  ./configure --with-ns
  make -j2

Make the -j higher on multi-core systems, usually one higher than number of
cores is best.

This will compile all the files, but emacs will not be able to be run except
in -nw (terminal) mode.

In order to run Emacs.app, you must run:

  make install

This will assemble the app in nextstep/Emacs.app.

If you pass the --disable-ns-self-contained option to configure, the lisp
files will be installed under whatever 'prefix' is set to (defaults to
/usr/local).  The bundle will be smaller, but depend on these resources (may
require 'sudo' for "make install").

On OS X you can also open Cocoa/Emacs.xcodeproj and build it again there.  You
may need to set some directories.  (Note, ZeroLink currently does not work
with Emacs owing to the use of private_extern in the code as well as some
other, unidentifiable problem.)  Before doing this you must run "make install"
once as outlined above, to set up the lisp resources.

On GNUstep, you CAN'T use ProjectCenter, since PC cannot work with files
outside of its project directory.


Installation
------------

Move nextstep/Emacs.app to any desired install location.


Distributions and Universal Binaries
------------------------------------

Building as outlined above will create ordinary binaries running on your
architecture only.  To create universal binaries, set CFLAGS to include
"-arch ppc -arch i386".


Improve Ctrl-G Handling
-----------------------

To enable a version of the code that handles ctrl-g more responsively in
certain cases -- but may introduce other glitches -- pass
"--enable-cocoa-experimental-ctrl-g" to configure.




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 3 of the License, 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.  If not, see <http://www.gnu.org/licenses/>.