view nextstep/INSTALL @ 106768:21fd634f447a

Make line<->pixel_y conversion macros aware of native menu/tool bars. They are placed above the internal border. This supersedes special treatment of native tool bars in the display code. This fixes wrong display position of native menu bars and bogus mouse highlighting of native tool bars, both of which can be found when internal border width is large. Also it fixes wrong flashed part on visible bell with native menu bars. * frame.h (FRAME_TOP_MARGIN_HEIGHT): New macro. (FRAME_LINE_TO_PIXEL_Y, FRAME_PIXEL_Y_TO_LINE): Take account of pseudo windows above internal border. * window.h (WINDOW_MENU_BAR_P, WINDOW_TOOL_BAR_P): New macros. (WINDOW_TOP_EDGE_Y, WINDOW_BOTTOM_EDGE_Y): Take account of pseudo windows above internal border. * xdisp.c (get_glyph_string_clip_rects, init_glyph_string): Don't treat tool bar windows specially. * xfns.c (x_set_tool_bar_lines): Take account of menu bar height. * xterm.c (x_after_update_window_line): Don't treat tool bar windows specially. (XTflash): Take account of menu bar height. * w32term.c (x_after_update_window_line): Don't treat tool bar windows specially.

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


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

In the top-level directory, use:

  ./configure --with-ns

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").


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

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


Xcode
-----

On OS X Emacs can be built under Xcode.  You need to run "configure"
as described above first.  There are two targets: 'temacs' and 'Emacs.app'.

'temacs' will build the undumped emacs executable, and copy it and the
*.o files to the src directory.  These steps are necessary so the next target
works.

'Emacs.app' uses "Run Script" build phases to assemble the Emacs.app bundle.
It uses the 'ns-app' target in src/Makefile together with the 'install' target
in the top level Makefile.

The source files under the temacs target must list "pre-crt0" first
and "lastfile" last, so that dumping works.

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


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".


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/>.