annotate doc/misc/ns-emacs.texi @ 98288:0e01cc1dc57b mh-e-doc-8_1

*** empty log message ***
author Bill Wohler <wohler@newt.com>
date Sun, 21 Sep 2008 17:34:10 +0000
parents 97b52beb60b7
children eec60dbfa1b8
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
3 @setfilename ../../info/ns-emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
4 @settitle Emacs.app
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
5
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
6 @dircategory Emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
7 @direntry
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
8 * NS-Emacs: (ns-emacs). Emacs.app for GNUstep and MacOS X.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
9 @end direntry
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
10
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
11 @iftex
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
12 @finalout
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
13 @end iftex
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
14
97383
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
15 @copying
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
16 This document describes Emacs.app for GNUstep and MacOS X.
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
17
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
18 Copyright @copyright{} 1994, 1997, 2005, 2006, 2007, 2008 Free Software
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
19 Foundation, Inc.
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
20
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
21 Copyright @copyright{} 2001 Christophe de Dinechin.
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
22 Copyright @copyright{} 1997 Christian Limpach.
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
23
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
24 @quotation
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
25 Permission is granted to copy, distribute and/or modify this document
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
26 under the terms of the GNU Free Documentation License, Version 1.2 or
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
27 any later version published by the Free Software Foundation; with no
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
28 Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
29 and with the Back-Cover Texts as in (a) below. A copy of the license
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
30 is included in the section entitled ``GNU Free Documentation License''.
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
31
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
32 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
33 modify this GNU manual. Buying copies from the FSF supports it in
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
34 developing GNU and promoting software freedom.''
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
35 @end quotation
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
36 @end copying
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
37
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
38
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
39 @titlepage
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
40 @sp 10
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
41 @center @titlefont{Emacs.app}
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
42
97563
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
43 @center (Version 9.0-rc3, November, 2007)
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
44
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
45 @sp 2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
46 @center Carl Edman
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
47 @sp 2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
48 @center Christian Limpach
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
49 @sp 2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
50 @center Scott Bender
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
51 @sp 2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
52 @center Christophe de Dinechin
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
53 @sp 2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
54 @center Adrian Robert
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
55 @sp 2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
56
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
57 @end titlepage
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
58
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
59 @ignore
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
60 @menu
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
61 * Introduction::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
62 * Events::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
63 * Preferences Panel::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
64 * Preferences::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
65 * Tips and Tricks::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
66 * Thanks::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
67 @end menu
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
68 @end ignore
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
69
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
70 @node Top, Introduction, (dir), (dir)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
71 @top Emacs.app
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
72
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
73 Emacs.app for GNUstep and MacOS X (http://emacs-app.sf.net) is a version of
97383
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
74 GNU Emacs which adds support for the GNUstep and MacOS X systems via the
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
75 OpenStep APIs (referred to as "Cocoa" under OS X). For support for
fc2bd95cda23 Use @copying. Change copyright of authors with assignment to FSF.
Glenn Morris <rgm@gnu.org>
parents: 97043
diff changeset
76 NeXTstep, OpenStep, and Rhapsody systems, try the older "Emacs-on-Aqua",
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
77 available at http://emacs-on-aqua.sf.net.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
78
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
79 This port leaves most of the core functions of Emacs unchanged and is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
80 fully-compatible with all Emacs Lisp packages, however it has a number of
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
81 step-ish features which do not have any equivalent in Emacs's X11 interface.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
82 The design aim was to make it look as similar as possible to an X application
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
83 to Emacs Lisp programs and to make it look like a normal GNUstep or MacOS X
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
84 application to users.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
85
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
86 (From here on out we refer to this port as "Emacs.app", and the systems
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
87 supported by this port as "NeXTstep", "NS", or "OpenStep", because saying
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
88 GNUstep / MacOS X is too clumsy. Both systems were derived from the NeXTstep
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
89 libraries developed by NeXT, Inc. for its NeXT computer and operating system,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
90 whose APIs were later published as the OpenStep specification. All classes
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
91 and functions in these APIs start with the letters 'NS' for this historical
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
92 reason.)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
93
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
94 Comments and bug reports relating to the window system interface are welcome.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
95 To report a bug please use the @samp{Help/Report Emacs.app bug...} menu item.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
96 This sends messages to the maintainer. (Note, please include your email
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
97 address if you don't usually send email from this machine.)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
98
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
99 Problems and bugs which do not relate to the NS support (i.e. which can be
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
100 reproduced even in a dumb terminal or under the Carbon port or X11) should be
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
101 reported through the normal Emacs channels.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
102
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
103 Also, please inspect the ``Known Issues'' contained in the README file you may
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
104 have received with this distribution or listed at the web site
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
105 http://emacs-app.sf.net .
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
106
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
107 There is also a developer mailing list for Emacs.app,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
108 <emacs-app-dev-@@lists.sourceforge.net>. Sign up through the project page at
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
109 http://emacs-app.sf.net. A user mailing list will be added in time and if
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
110 warranted.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
111
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
112
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
113 @menu
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
114 * Introduction:: What you need to know to use and program.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
115 * Events:: How NS window system events are handled.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
116 * Preferences Panel:: Using the Preferences Panel to customize Emacs.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
117 * Customization:: Customization for Emacs.app.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
118 * Tips and Tricks:: Collected hints from Emacs users
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
119 * Thanks:: The people who helped create Emacs.app
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
120 @end menu
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
121
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
122 @node Introduction, Events, Top, Top
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
123 @section Introduction
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
124
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
125 Despite the size and complexity of GNU Emacs, NeXTstep and the NeXTstep
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
126 support code, this manual can be kept mercifully short by saying that
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
127 everything written in the Emacs and the Emacs Lisp manuals about GNU Emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
128 applies equally to this Emacs except as noted here.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
129
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
130 @itemize @bullet
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
131 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
132 The ``right-click'' button (usually the right-hand button on a two-button
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
133 mouse) is mapped to Mouse-3, instead of Mouse-2 as earlier versions of
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
134 Emacs.app. This is for compatibility with X versions of emacs. To get some
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
135 of the old behavior back, you can put in your .emacs:
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
136
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
137 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
138 (global-set-key [mouse-3] 'mouse-yank-at-click)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
139 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
140
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
141 The other functionality of mouse-3 in a buffer of extending a selection is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
142 available via shift-click as in other NS applications. To pop up a context
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
143 menu,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
144
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
145 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
146 The Alt or Opt key is bound to the traditional emacs "meta" by default, while
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
147 the NS "command" key is bound to 'super', for which a set of keybindings are
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
148 set to mimic other NeXTstep applications. (See @ref{Events}.) You can change
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
149 either of these bindings using the preferences panel (see @ref{Preferences
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
150 Panel}).
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
151
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
152 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
153 The standard NeXTstep font and color panels are accessible through the Windows
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
154 menu, or through the standard Cmd-t and Cmd-C. These are easier to use than
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
155 Emacs's own methods for setting these items. To use the color panel, drag
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
156 from it to an emacs frame. The foreground (or background, if shift is held
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
157 down) of the face at that point will be changed. To finalize settings for
97563
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
158 either color or font, choose 'Save Options' from under the Options menu. To
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
159 discard these settings, create a new frame and close the altered one.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
160
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
161 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
162 Opening files / directories and 'Save Buffer As' operated from the menus use
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
163 the standard NS file panels. Likewise if you use Cmd-o or Cmd-S. However,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
164 if you use the regular Emacs key combinations Ctrl-x,Ctrl-f and Ctrl-x,w for
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
165 these functions, the normal Emacs mode of typing filenames into the minibuffer
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
166 is used.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
167
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
168 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
169 On GNUstep, in an X-windows environment you need to use Cmd-c instead of one
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
170 of the Ctrl-w or Meta-w commands to transfer text to the X primary selection.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
171 (Ordinarily the "clipboard" selection is used, for compatibility with more
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
172 modern Gnome and KDE programs.) Likewise, Cmd-y (instead of Ctrl-y) will
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
173 yank/paste in the X primary selection instead of the kill-ring / clipboard.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
174
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
175 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
176 The @code{window-system} variable can now have the value @code{ns} in addition
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
177 to, e.g., @code{x} or @code{nil}. You can use this in your .emacs file:
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
178
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
179 If you just want to distinguish between cases in which there is a
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
180 window system and in which there isn't, this construct is useful.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
181 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
182 (if window-system
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
183 ... ;;; evaluate if any window system is running
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
184 ...) ;;; evaluate only when running on a dumb terminal
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
185 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
186
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
187 For more detailed control, use this.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
188 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
189 (cond
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
190 ((eq window-system 'ns) ;;; NS specific instructions
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
191 ...)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
192 ((eq window-system 'x) ;;; X specific instructions
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
193 ...)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
194 (t ;;; Instructions for dumb terminal or other window systems
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
195 ...))
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
196 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
197
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
198 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
199 Likewise, you can detect whether you are running in emacs-23 or an earlier
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
200 version with:
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
201
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
202 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
203 (if (eq emacs-major-version '23) <emacs-23 code> <emacs-22- code>)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
204 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
205
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
206 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
207 Most NS specific functions begin with 'ns-'. Do "C-h f ns-[TAB]" to list
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
208 these. Many of these replace equivalent 'x-' functions, while others perform
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
209 uniquely NS things, such as Service invocation.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
210
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
211 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
212 There are also NS variables beginning with 'ns-', however in most cases users
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
213 need not pay attention to them since the customizability they provide is also
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
214 available through the defaults system and preferences panel (see
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
215 @ref{Preferences Panel} and @ref{Customization}).
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
216
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
217 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
218 When Emacs is called by a name which ends in @file{-nw} it will always
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
219 start in terminal mode. For example, a user who needs a terminal only
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
220 emacs would create a symbolic link from @file{emacs} to @file{emacs-nw}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
221 When he launches @file{emacs-nw} from the command line, the window
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
222 system will never be involved. (Note, as of rc2, terminal mode is still not
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
223 working under OS X.)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
224 @end itemize
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
225
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
226 @node Events, Preferences Panel, Introduction, Top
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
227 @section Events
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
228
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
229 Under Emacs.app the NeXTstep command key works as the @dfn{super} modifier
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
230 key. In principle users can bind their command keys to whatever function they
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
231 want, but to make the transition for NS users easier the default NS startup
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
232 files bind the most commonly used NS command keys to work just like they do in
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
233 most other NS applications. Some are shown in the menus. Choose "List
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
234 Keybindings" from the Help menu and scroll down to the keys labeled starting
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
235 with 's-' to see all of them.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
236
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
237 NS applications receive a number of special events which have no X equivalent.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
238 These are sent as specially defined ``keys'' (which don't correspond to any
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
239 keyboard stroke combination). Under Emacs these ``key'' events can be bound
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
240 to functions just like ordinary keystrokes. Here is a list of these events.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
241
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
242 @table @code
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
243 @item ns-open-file
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
244 This event occurs when another NeXTstep application requests that Emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
245 open a file. A typical reason for this would be a user double-clicking
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
246 a file in the Finder. When this event is registered the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
247 name of the file to open is found in the variable @code{ns-input-file}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
248
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
249 The behaviour of the default binding is controlled by the variable
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
250 @code{ns-pop-up-frames}. It's default value @code{'fresh} causes Emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
251 to open the new file in the selected frame if the selected buffer is a
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
252 scratch buffer. Otherwise Emacs opens a new frame and displays the file
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
253 in that.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
254
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
255 To always get a new frame one would change @code{ns-pop-up-frames} to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
256 @code{t}. To get the opposite behaviour (i.e. always putting the file into
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
257 the selected frame), change @code{ns-pop-up-frames} to @code{nil}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
258
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
259 @item ns-open-temp-file
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
260 This event occurs when another application requests that Emacs open a
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
261 temporary file. The file name is again in @code{ns-input-file}. By
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
262 default this is handled by just generating a @code{ns-open-file} event
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
263 (which then causes the @code{ns-open-file} function to be called
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
264 whatever that may be).
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
265
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
266 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
267 (define-key global-map [ns-open-temp-file] [ns-open-file])
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
268 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
269
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
270 @item ns-open-file-line
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
271 Some applications (like e.g. ProjectBuilder or gdb) request not only a
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
272 particular file, but also a particular line or sequence of lines in the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
273 file. The file name is in @code{ns-input-file}, and
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
274 @code{ns-input-line} is either the line or a cons cell the car of which
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
275 contains the beginning line and the cdr of which the ending line.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
276
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
277 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
278 (define-key global-map [ns-open-file-line] 'ns-open-file-select-line)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
279 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
280
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
281 @item ns-drag-file
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
282 When a user drags files from another application into an Emacs frame
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
283 this event is triggered. Here @code{ns-input-file} is a list of all
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
284 dragged files. The default binding inserts all the dragged files into
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
285 the current buffer.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
286
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
287 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
288 (define-key global-map [ns-drag-file] 'ns-insert-files)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
289 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
290
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
291 @item ns-drag-color
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
292 When a user drags a color from the color well (or some other source)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
293 Emacs sees this event and @code{ns-input-color} contains the name of the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
294 dragged color. The default bindings alter the foreground color of the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
295 area the color was dragged onto (or background color if the color was
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
296 shift dragged).
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
297
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
298 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
299 (define-key global-map [ns-drag-color]
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
300 'ns-set-foreground-at-mouse)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
301 (define-key global-map [S-ns-drag-color]
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
302 'ns-set-background-at-mouse)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
303 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
304
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
305 @item ns-change-font
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
306 Emacs.app allows the user to open a standard NS font panel (by default that
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
307 function is bound to @kbd{Cmd-t}). When the user selects a font in that
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
308 panel this event occurs. @code{ns-input-font} will contain the name of
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
309 the selected font and @code{ns-input-fontsize} is its size. The
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
310 default binding causes Emacs to adjust the font of the selected frame.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
311
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
312 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
313 (define-key global-map [ns-change-font] 'ns-respond-to-changefont)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
314 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
315
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
316 @item ns-power-off
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
317 Finally when the user logs out and Emacs is still running it receives
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
318 this event so that it has a chance to save its files before it dies.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
319
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
320 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
321 (define-key global-map [ns-power-off]
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
322 '(lambda () (interactive) (save-buffers-kill-emacs t)))
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
323 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
324
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
325 @end table
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
326
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
327 Emacs.app also allows users to make use of NeXTstep services programatically,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
328 in addition to via the Services menu. On the most basic level programmers can
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
329 use the @code{ns-perform-service} to pass arbitrary strings to arbitrary
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
330 services and receive the results back. However convenience functions are
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
331 automatically provided for all services so there should be no need to use
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
332 this. These function names begin with 'ns-service-', and they will either
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
333 operate on marked text (replacing it with the result) or take a string
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
334 argument and return the result as a string. Type "M-x ns-service-[TAB][TAB]"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
335 to see those currently defined. Note that Emacs may require a restart to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
336 access newly available services.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
337
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
338
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
339 @node Preferences Panel, Customization, Events, Top
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
340 @section Preferences Panel
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
341
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
342 The Preferences Panel can be used to set or change some of the settings for
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
343 Emacs such as the text appearance, cursor settings, and key bindings.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
344
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
345 To save any settings changed through the Preferences Panel, hit OK;
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
346 this has the same effect as if you had explicitly chosen Help > Save
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
347 Preferences.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
348
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
349 To restore Emacs to use its default settings click Reset to Defaults from
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
350 the Preferences Panel.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
351
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
352 Additional GNUstep/OS X preferences may be set from the command line using
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
353 the @command{defaults} command. (See @ref{Customization}.)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
354
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
355
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
356 @section Text Rendering Preferences
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
357
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
358 Font and color settings can be set using the standard NeXTstep font
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
359 and color panels.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
360
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
361 @itemize @bullet
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
362 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
363 To set the default font used by Emacs click the Default Font... button
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
364 to launch the Font Panel. Click on a frame before selecting the font
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
365 family, typeface, and size of the default font from the Font Panel.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
366
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
367 Note that the default font will not be changed if a frame hasn't been
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
368 selected first.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
369
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
370 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
371 To set the default foreground or background color click the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
372 Colors... button to launch the Color Panel. Choose the color you want
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
373 using any of the color models (color wheel, sliders, palette, image,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
374 or crayons) available from the Colors toolbar. To apply the color
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
375 drag a swatch from the color bar at the top of the panel to text on
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
376 an Emacs frame. Holding down shift will change the background color
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
377 instead of the foreground.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
378
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
379 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
380 To use antialiased text check the Smooth Fonts option. Lighter font
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
381 smoothing can be achieved by checking the Use Quickdraw (lighter)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
382 smoothing option.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
383
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
384 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
385 To change the line height that text is displayed at drag the Expand
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
386 Line Spacing slider. When the slider is set to 0.0 Emacs will use the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
387 same line height as other Mac OS X applications. To increase the line
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
388 height (and decrease the number of lines that can be displayed on the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
389 screen) drag the slider towards 1.0. To decrease the line height
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
390 (increases the number of lines that can be displayed) drag the slider
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
391 towards -1.0.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
392
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
393 After the line spacing setting has been changed Emacs must be restarted
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
394 to take account of the change.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
395
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
396 @end itemize
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
397
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
398 @section Display Preferences
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
399
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
400 The Display Preferences can be used to change the appearance of the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
401 default cursor used by Emacs.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
402
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
403 @itemize @bullet
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
404 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
405 The Cursor Type radio buttons can be used to select the style used for the cursor:
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
406
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
407 @itemize
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
408 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
409 Box - the cursor is displayed as a box
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
410 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
411 Underscore - the cursor is displayed as a horizontal bar
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
412 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
413 Bar - the cursor is displayed as a vertical bar
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
414 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
415 Hollow - the cursor is displayed as a box with an outline but no fill
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
416 @end itemize
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
417
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
418 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
419 Use the Cursor Blink Rate slider to set the frequency at which the cursor blinks.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
420
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
421 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
422 Check the Use System Highlight Color option to use the system default
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
423 color for highlighted text.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
424
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
425 @end itemize
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
426
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
427 @section Modifier Interpretation Preferences
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
428
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
429 The Modifier Preferences can be used to change the behaviour of the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
430 Alt/Opt and Command keys. By default the Alt or Opt key is bound to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
431 the Emacs 'Meta' key, and the Command key is bound to 'super' which
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
432 allows the Command key to function in a way similar to other
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
433 NeXTstep/OS X applications.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
434
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
435 @itemize @bullet
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
436 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
437 To re-bind the Alt or Opt key select a keybinding from the Alt/Opt Key
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
438 combo box.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
439 @item
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
440 To re-bind the Command key select a keybinding from the Command Key
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
441 combo box.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
442 @end itemize
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
443
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
444
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
445 @node Customization, Tips and Tricks, Preferences Panel, Top
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
446 @section Customization
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
447
97563
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
448 Under X, resources are used to customize the behavior of Emacs to the
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
449 needs of the user. These resources are queried programmatically with
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
450 the @code{x-get-resource} function. Under NS defaults fulfill a
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
451 similar function. They can be read using the @code{ns-get-resource}
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
452 function. Calls to @code{x-get-resource} are automatically mapped to
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
453 @code{ns-get-resource}. From the command line, the command
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
454 `@code{defaults read org.gnu.Emacs}' will show these resources as of
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
455 last Emacs quit, and individual resources can be read/written by
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
456 commands like `@code{defaults read Emacs Foo}' and `@code{defaults
97b52beb60b7 ns-emacs.texi: Update version. (Introduction): Correct menu location for options save. (Customization): Note that defaults are stored under org.gnu.Emacs.
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 97383
diff changeset
457 write Emacs Foo barvalue}'.
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
458
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
459 Calling the function @code{ns-save-preferences} in lisp, or selecting ``Save
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
460 Options'' from the 'Options' menu will automatically write out the defaults
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
461 corresponding to the selected window.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
462
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
463 In addition, it is also possible to set many of the following customizations
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
464 by setting the @code{default-frame-alist} in the @file{~/.emacs} file.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
465
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
466 Many of the preferences relating specifically to the NS windowing system (font
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
467 rendering, cursor type, etc.) can be set using a @ref{Preferences Panel}
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
468 accessed in the standard fashion from the menubar or Cmd-,. It is important
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
469 to note that when you hit 'OK' on this panel, @emph{all} NS settings are saved
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
470 (including font and colors) just as if you had called
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
471 @code{ns-save-preferences}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
472
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
473 Note that if you use the 'Default Font' button on the Preferences panel, you
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
474 must click on a frame before selecting a font, otherwise nothing will happen.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
475 If you pop up the color panel, you must drag colors to a frame for them to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
476 have an effect. (Remember to hold down 'shift' to change background instead
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
477 of foreground.)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
478
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
479 This is a listing of some of the more useful defaults (and their default
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
480 values). Several of these defaults accept the names of colors as values. For
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
481 a list of all available colors pull up the color panel and look at the color
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
482 list called ``Emacs''. Emacs also accepts color specifications of the form
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
483 @samp{ARGBaarrggbb} where @var{aa}, @var{rr}, @var{gg}, and @var{bb} are two
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
484 hexadecimal digits describing the alpha, red, green, and blue content of the
96839
acf9127fbc06 corrected color spec docs in ns-emacs.texi
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 96808
diff changeset
485 color respectively. @samp{HSBhhssbb}, @samp{CMYKccmmyykk} and
acf9127fbc06 corrected color spec docs in ns-emacs.texi
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 96808
diff changeset
486 @samp{GRAYgg} are the equivalents in @samp{HSB}, @samp{CMYK} and gray
acf9127fbc06 corrected color spec docs in ns-emacs.texi
Adrian Robert <Adrian.B.Robert@gmail.com>
parents: 96808
diff changeset
487 scales. (For HSB, @samp{AHSBaahhssbb} is also accepted.)
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
488
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
489 @table @samp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
490 @item InternalBorderWidth
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
491 Width in pixels of the internal border of the NS frame. This acts to separate
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
492 the text area of the window from the fringes, scrollbars, and/or edges.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
493
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
494 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
495 defaults write Emacs InternalBorderWidth 2
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
496 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
497
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
498 @item VerticalScrollBars
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
499 @samp{YES} or @samp{NO} to enable or disable scroll bars, @samp{left} or
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
500 @samp{right} to explicitly set the side.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
501
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
502 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
503 defaults write Emacs VerticalScrollBars YES
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
504 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
505
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
506 @item Font
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
507 Name of the default font to be used for new frames (which can be overriden by
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
508 various faces). If this font is not set, Emacs.app will use the system
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
509 wide fixed pitch font. For most users the system fixed pitch font will be
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
510 @samp{Monaco} which doesn't have any bold or italic versions. (Italic will be
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
511 synthesized.)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
512
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
513 @item FontSize
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
514 Size of the font to be used for new frames. If not set Emacs for NS will use
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
515 the default size of the system wide fixed pitch font.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
516
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
517 @item Foreground
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
518 The default foreground (text) color for new frames.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
519
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
520 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
521 defaults write Emacs Foreground "Black"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
522 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
523
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
524 @item Background
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
525 The default background color for new frames.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
526
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
527 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
528 defaults write Emacs Background "White"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
529 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
530
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
531 @item Height
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
532 Height in rows of the default window.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
533
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
534 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
535 defaults write Emacs Height 48
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
536 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
537
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
538 @item Width
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
539 Width in columns of the default window.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
540
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
541 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
542 defaults write Emacs Width 80
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
543 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
544
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
545 @item CursorType
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
546 Name of the default cursor type for Emacs. Allowed values are
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
547 @samp{box}, @samp{hollow}, @samp{underscore}, @samp{bar}, @samp{line} and @samp{no}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
548
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
549 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
550 defaults write Emacs CursorType box
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
551 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
552
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
553 @item CursorBlinkRate
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
554 Users who want their cursor to blink can set the rate (in seconds) with
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
555 this defaults write. Setting it to @samp{NO} disables cursor blinking.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
556
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
557 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
558 defaults write Emacs CursorBlinkRate NO
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
559 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
560
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
561 @item CursorColor
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
562 Name of the default cursor color for Emacs. Of a particular use for this
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
563 setting is the @samp{Highlight} "color". When it is the cursor color,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
564 Emacs will draw the cursor using the standard NS highlighting operator.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
565
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
566 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
567 defaults write Emacs CursorColor Highlight
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
568 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
569
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
570 @item Top
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
571 Distance in pixels from the top of the screen of the upper left corner
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
572 of the default window.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
573
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
574 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
575 defaults write Emacs Top 100
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
576 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
577
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
578 @item Left
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
579 Distance in pixels from the left edge of the screen to the upper left
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
580 corner of the default window.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
581
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
582 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
583 defaults write Emacs Left 100
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
584 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
585
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
586 @item HideOnAutoLaunch
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
587 @samp{YES} or @samp{NO} to determine whether Emacs will hide itself when
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
588 autolaunched from the dock.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
589
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
590 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
591 defaults write Emacs HideOnAutoLaunch NO
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
592 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
593
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
594 @item ExpandSpace
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
595 This lets you expand or shrink the line height used for displaying text. When
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
596 this is set to 0.0, display should look like other NS apps. If you set it
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
597 higher than 0, Emacs will spread the text lines apart, less than 0, compress
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
598 them together. (With settings below zero parts of characters may be chopped
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
599 off in certain fonts.) When using the @ref{Preferences Panel}, this is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
600 controlled by a slider. You must OK the panel and then restart Emacs.app for
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
601 this default to take effect.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
602
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
603 When setting this using @code{"defaults write"}, you can either set a floating
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
604 point value, or @samp{YES}, which is equivalent 0.5, or @samp{NO}, which is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
605 equivalent to 0.0.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
606
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
607 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
608 defaults write Emacs ExpandSpace -0.125
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
609 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
610
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
611 @item GSFontAntiAlias
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
612 This turns antialiasing on and off on. Note that, on OS X, even if
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
613 antialiasing is on, Emacs will not antialias text of a size below the system
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
614 preference setting.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
615
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
616 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
617 defaults write Emacs GSFontAntiAlias NO
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
618 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
619
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
620 @item UseQuickdrawSmoothing
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
621 On OS X 10.3 and higher, this will render fonts using Quickdraw antialiasing,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
622 which is less heavy than the Quartz antialiasing used by default. Whether
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
623 this is on or off, the system font size threshold for antialiasing (see above)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
624 is respected.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
625
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
626 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
627 defaults write Emacs UseQuickdrawSmoothing YES
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
628 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
629
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
630 @item AlternateModifier
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
631 This allows you to set the effect of the Alt or Opt key. The default is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
632 @samp{meta}, meaning to use as the Emacs 'meta' key. You can also set this to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
633 @samp{command}, @samp{hyper}, @samp{alt}, or @samp{none}. The last is useful
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
634 for Continental users who normally use this key to enter accented and other
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
635 special characters.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
636
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
637 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
638 defaults write Emacs AlternateModifier "none"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
639 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
640
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
641 @item CommandModifier
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
642 This allows you to set the effect of the Command key. The default is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
643 @samp{super}, which is used in a set of keybindings such as @code{s-o} for
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
644 ``open file'' and @code{s-z} for ``undo'' that are similar to other NeXTstep
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
645 applications. On the other hand, some people who use the Alt/Opt key for
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
646 accent entry like to set this to @samp{meta} so they still have easy access to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
647 Emacs functionality bound to meta keys. You can also set this, like Alt/Opt,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
648 to @samp{hyper} or @samp{alt}, though there are no bindings to combinations
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
649 using these keys by default. The @samp{none} option is not available for the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
650 Command key.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
651
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
652 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
653 defaults write Emacs CommandModifier "meta"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
654 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
655
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
656 @item fooFrame
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
657 Position and size to use for the frame named @var{foo} when it is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
658 created. The position and size have to be specified as a space
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
659 separated list: @samp{top}, @samp{left}, @samp{height} and
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
660 @samp{width}. @samp{top} and @samp{left} are expressed in pixels,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
661 @samp{height} is given in rows and @samp{width} is given in columns.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
662 Named frames can be created by e.g. @code{(make-frame '((name
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
663 . "FOO")))}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
664
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
665 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
666 defaults write Emacs TestFrame "100 200 30 70"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
667 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
668
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
669 Another default previouly used by many Emacs users is this.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
670
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
671 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
672 defaults write Workspace DefaultOpenApp Emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
673 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
674
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
675 It caused the NeXTstep Workspace to open files without a registered extension
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
676 in Emacs instead of as usual Edit. For this default to work, Emacs needed to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
677 be in the application search path of the Workspace (which usually includes
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
678 @file{~/Applications} and @file{~/Applications}). If anyone knows the current
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
679 way to do this under OS X please contact the authors.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
680
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
681 @end table
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
682
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
683 @node Tips and Tricks, Thanks, Customization, Top
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
684 @section Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
685
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
686 Emacs is an extremely customizable editor. You can make it conform to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
687 virtually any conceivable user idiosyncrasy (and some which are not) by adding
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
688 a few well-chosen lines of emacs lisp to your @file{~/.emacs}. Unfortunately
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
689 even many experienced C developers are unfamiliar with Emacs Lisp. For that
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
690 reason many Emacs.app defaults have been chosen to make it behave as similar
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
691 to TextEdit as possible. But there are some customizations which a majority
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
692 of users probably would hate as much as a minority would love them. This
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
693 section contains a cookbook of such customizations. New contributions by
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
694 Emacs users are very welcome.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
695
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
696 @menu
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
697 * Grabbing environment variables::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
698 * Miscellaneous useful variables::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
699 * Color adjustments::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
700 * Evaling in the minibuffer::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
701 * Highlighting matching parentheses::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
702 * Dealing with X specific packages::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
703 * Rebinding the numeric keypad::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
704 * Improving C mode::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
705 * Custom menu items::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
706 * Single line scrolling::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
707 * Open files by dragging to an Emacs window::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
708 @ignore
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
709 * Extended font customization::
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
710 @end ignore
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
711 @end menu
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
712
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
713 @node Grabbing environment variables, Miscellaneous useful variables, Tips and Tricks, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
714 @subsection Grabbing environment variables
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
715
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
716 Many programs which may run under Emacs like latex or man depend on the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
717 settings of environment variables. If Emacs is launched from the shell, it
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
718 will automatically inherit these environment variables and its subprocesses
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
719 will inherit them from it. But if Emacs.app is launched from the Finder it
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
720 is not a descendant of any shell, so its environment variables haven't been
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
721 set which often causes the subprocesses it launches to behave differently than
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
722 they would when launched from the shell.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
723
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
724 To solve this problem for Emacs.app, there are two solutions. First is to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
725 run, from the command line:
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
726
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
727 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
728 .../Emacs.app/Contents/MacOS/bin/mac-fix-env
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
729 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
730
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
731 This will pick up your environment settings and save them into a special file
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
732 @file{~/.MacOSX/environment.plist}, which the desktop environment will use to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
733 set the environment for all launched applications. The drawback of this
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
734 method is it needs to be run again whenever something changes.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
735
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
736 The other approach is to use the @code{ns-grabenv} command inside Emacs. This
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
737 function will run a subshell and copy its environment variables into Emacs.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
738
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
739 Adding this line to your @file{~/.emacs} will grab the csh environment
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
740 whenever emacs runs under a window system.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
741
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
742 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
743 (if window-system (ns-grabenv))
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
744 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
745
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
746 If you have a different shell you will have to give @code{ns-grabenv} some
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
747 arguments. For zsh you would do this.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
748
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
749 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
750 (if window-system (ns-grabenv "/usr/bin/zsh"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
751 "source /etc/zshenv"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
752 "source ~/.zshenv"))
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
753 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
754
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
755 The reason that @code{ns-grabenv} is not done by default is that it adds up
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
756 to a second or two to the Emacs startup time.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
757
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
758 @node Miscellaneous useful variables, Color adjustments, Grabbing environment variables, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
759 @subsection Miscellaneous useful variables
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
760
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
761 This section describes a few variables you might want to set in your
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
762 @file{~/.emacs} each of which doesn't warrant its own section.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
763
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
764 There is a conflict between the way the region behaved in emacs in the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
765 pre-GUI days and the way GUI users expect the selection to work. By
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
766 default that conflict is resolved by having the former adopt the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
767 behaviour of the latter which most people prefer. However if you are a
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
768 die-hard emacs user you may prefer things the other way around and add
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
769 this line to your @file{~/.emacs}. Experiment with both settings.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
770
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
771 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
772 (setq transient-mark-mode nil)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
773 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
774
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
775 When you try to move beyond the end of a file Emacs used to add newlines as
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
776 needed, however from Emacs-21 on, this was no longer done. If you prefer the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
777 old behavior, this line in your @file{~/.emacs} will restore it.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
778
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
779 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
780 (setq next-line-add-newlines t)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
781 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
782
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
783 By default when you kill a line with text on it, only the text is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
784 removed while the line itself remains. You have to kill twice to really
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
785 get rid of the whole line. When this variable is set and you kill a
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
786 line while at the beginning of the line it will go at once.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
787
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
788 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
789 (setq kill-whole-line t)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
790 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
791
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
792 Annoyed by the Emacs startup message ? Add this and you start with a
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
793 tabula rasa.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
794
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
795 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
796 (setq inhibit-startup-message t)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
797 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
798
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
799 @node Color adjustments, Evaling in the minibuffer, Miscellaneous useful variables, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
800 @subsection Color adjustments
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
801
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
802 A non-elisp hint: The easiest way to adjust your emacs color scheme is to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
803 bring up a color panel (with @key{Cmd-C}) and drag the color you want over the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
804 emacs face you want to change. Normal dragging will alter the foreground
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
805 color. Shift dragging will alter the background color. To make the changes
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
806 permanent select the "Save Options" item in the "Options" menu, or run
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
807 @code{ns-save-preferences}. Useful in this context is the listing of all
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
808 faces obtained by @key{M-x} @code{list-faces-display}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
809
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
810 @node Evaling in the minibuffer, Highlighting matching parentheses, Color adjustments, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
811 @subsection Evaling in the minibuffer
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
812
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
813 Often you (at least if you are an elisp hacker) want to quickly evaluate
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
814 an elisp expression. To accomodate this desire Emacs provides the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
815 @code{eval-expression} command bound to @key{M-:}. By default it is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
816 disabled to protect novice users from themselves. These commands
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
817 re-enable it and turn on an extremely powerful completion facility.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
818
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
819 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
820 (put 'eval-expression 'disabled nil)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
821
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
822 (define-key read-expression-map "\t" 'lisp-complete-symbol)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
823 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
824
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
825 @node Highlighting matching parentheses, Dealing with X specific packages, Evaling in the minibuffer, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
826 @subsection Highlighting matching parentheses
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
827
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
828 I doubt that there is anybody who doesn't use this already, but just in
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
829 case:
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
830
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
831 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
832 (show-paren-mode 't)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
833 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
834
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
835 In Emacs.app this is currently enhanced by use of the @code{mic-paren} package
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
836 from http://www.docs.uu.se/~mic/emacs.html.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
837
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
838 @node Dealing with X specific packages, Rebinding the numeric keypad, Highlighting matching parentheses, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
839 @subsection Dealing with X specific packages
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
840
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
841 Some emacs lisp packages explicitly call X specific functions instead of
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
842 calling generic functions which call the NS or X versions as appropriate.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
843 Typically such packages will result in error messages like @samp{Symbol's
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
844 function definition is void: x-foo-bar}. The proper way of dealing with this
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
845 is to have the author fix the code to call the generic functions. Generally
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
846 all that requires is removing the @samp{x-} prefix from all function calls.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
847
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
848 However, sometimes that is not possible, or it may be a package internal to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
849 emacs itself. In this case please report a bug to the Emacs.app maintainers
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
850 (not the main GNU emacs maintainers).
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
851
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
852 A related problem is font names. For historical reasons, Emacs assumes all
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
853 font names are given ``X style'', as in ``-adobe-courier-....-iso8859-1''.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
854 Emacs.app tries to work around this as well as possible, and the best thing to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
855 do is never rely on functions to set font names yourself but to always use the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
856 font panel.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
857
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
858 @node Rebinding the numeric keypad, Improving C mode, Dealing with X specific packages, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
859 @subsection Rebinding the numeric keypad
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
860
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
861 By default in Emacs the numeric keypad keys are bound to the same
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
862 characters they are in all other NS applications. But it is easy to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
863 change these bindings to commands many will find more useful. As an
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
864 example here is the code which rebinds the numeric keypad for me.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
865
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
866 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
867 (global-set-key [kp-0] 'other-window)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
868 (global-set-key [kp-1] 'end-of-buffer)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
869 (global-set-key [kp-2] [down])
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
870 (global-set-key [kp-3] 'scroll-up)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
871 (global-set-key [kp-4] [left])
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
872 (global-set-key [kp-5] 'set-mark-command)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
873 (global-set-key [kp-6] [right])
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
874 (global-set-key [kp-7] 'beginning-of-buffer)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
875 (global-set-key [kp-8] [up])
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
876 (global-set-key [kp-9] 'scroll-down)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
877 (global-set-key [kp-decimal] 'yank)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
878 (global-set-key [kp-enter] 'set-mark-command)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
879 (global-set-key [kp-add] 'copy-region-as-kill)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
880 (global-set-key [kp-subtract] 'kill-region)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
881 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
882
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
883 On machines with function keys they can be bound as well. This for example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
884 would bind @key{F12} to run gnus.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
885
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
886 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
887 (global-set-key [f12] 'gnus)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
888 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
889
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
890 @node Improving C mode, Custom menu items, Rebinding the numeric keypad, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
891 @subsection Improving C mode
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
892
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
893 That underscores are considered to break words in C mode has been driving me
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
894 insane for a long time. This line fixes the problem.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
895
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
896 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
897 (modify-syntax-entry ?_ "w" c-mode-syntax-table)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
898 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
899
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
900 @node Custom menu items, Single line scrolling, Improving C mode, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
901 @subsection Custom menu items
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
902
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
903 The tools menu is intended for customization. Adding items to it is
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
904 relatively painless as this example illustrates.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
905
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
906 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
907 (define-key global-map [menu-bar tools www] '("WWW" . w3-use-hotlist))
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
908 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
909
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
910 @node Single line scrolling, Open files by dragging to an Emacs window, Custom menu items, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
911 @subsection Single line scrolling
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
912
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
913 The meta-arrow keys will perform single-line scrolling in Emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
914 just like they did in the old NeXT/OpenStep Stuart.app.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
915
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
916 @node Open files by dragging to an Emacs window, , Single line scrolling, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
917 @subsection Open files by dragging to an Emacs window
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
918
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
919 The default behaviour when a user drags files from another application
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
920 into an Emacs frame is to insert the contents of all the dragged files
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
921 into the current buffer. To remap the @code{ns-drag-file} event to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
922 open the dragged files in the current frame use the following line:
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
923
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
924 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
925 (define-key global-map [ns-drag-file] 'ns-find-file)
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
926 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
927
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
928 @ignore
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
929 @node Extended font customization, , Single line scrolling, Tips and Tricks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
930 @subsection Extended font customization
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
931
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
932 By default Emacs tries to guess the right font when you ask for a bold,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
933 italic or bold-italic face. Unfortunately this fails sometimes, for
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
934 example Emacs won't guess that it should use @samp{Courier-Bold} as the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
935 font for the bold face of @samp{Ohlfs}. As an example here is the code
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
936 which sets up @samp{Courier-Bold}, @samp{Courier-Oblique} and
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
937 @samp{Courier-BoldOblique} as the fonts to be used with @samp{Ohlfs}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
938
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
939 @lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
940 (setq ns-convert-font-trait-alist
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
941 '(("Ohlfs" "Courier-Bold" "Courier-Oblique"
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
942 "Courier-BoldOblique")))
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
943 @end lisp
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
944
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
945 You will still have to set the @samp{DefaultFont}, @samp{BoldFont},
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
946 @samp{ItalicFont} and @samp{Bold-ItalicFont} defaults as Emacs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
947 initializes the default faces before it reads your @file{~/.emacs}.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
948 Also Emacs initializes @code{ns-convert-font-trait-alist} from these
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
949 defaults so that normally it's sufficient to set these defaults to get
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
950 correct faces.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
951
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
952 @example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
953 defaults write Emacs DefaultFont Ohlfs
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
954 defaults write Emacs BoldFont Courier-Bold
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
955 defaults write Emacs ItalicFont Courier-Oblique
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
956 defaults write Emacs Bold-ItalicFont Courier-BoldOblique
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
957 @end example
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
958 @end ignore
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
959
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
960
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
961 @node Thanks, , Tips and Tricks, Top
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
962 @section Thanks
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
963 A signficant number of people have been involved in the creation of Emacs.app.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
964 Carl Edman <cedman@@lynx.ps.uci.edu> created and maintained Emacs up to
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
965 version 4.1 and it's reasonable to say that without his work, Emacs.app
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
966 wouldn't exist. Michael Brouwer <michael@@thi.nl> wrote the original version
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
967 (up to and including version 3.x) and was a constant contributor to Emacs.app
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
968 version 4 and above. Christian Limpach <chris@@nice.ch> took over maintenance
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
969 and updating at version 4.2, and made substantial contributions in a number of
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
970 areas. Scott Bender <sbender@@harmony-ds.com> ported the code to OpenStep and
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
971 Rhapsody for version 6.0. Christophe de Dinechin <ddd@@cup.hp.com> ported the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
972 code to MacOS X for version 7.0 and moved the code base to SourceForge. Leigh
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
973 Smith <leigh@@leighsmith.com> maintained the SourceForge project for a period.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
974 Adrian Robert <arobert@@cogsci.ucsd.edu> ported the code to GNUstep
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
975 (http://gnustep.org), updated it for post-emacs-20, and maintains it for the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
976 present.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
977
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
978 Also a number of others have contributed code. Steve Nygard
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
979 <nygard@@telusplanet.net> got emacs to dump under OpenStep. The font panel
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
980 code was Andrew Athan's <athan@@object.com> work. Joe Reiss
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
981 <jreiss@@magnus.acs.ohio-state.edu> both created the beautiful icons you see
97043
9592c50233ab Remove support for Mac Carbon.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 96839
diff changeset
982 and wrote the popup menu and dialog box code as well as much else.
96808
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
983
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
984 Finally, suggestions from Darcy Brockbank, Timothy Bissell, Scott Byer, David
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
985 Griffiths, Scott Hess, Eberhard Mandler, John C. Randolph, and Bradley Taylor
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
986 all helped things along at one point or another. Axel Seibert
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
987 <seiberta@@informatik.tu-muenchen.de> and Paul J. Sanchez
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
988 <paul@@whimsy.umsl.edu> offered their time and machines to make a binary
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
989 release possible.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
990
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
991 The GNUstep port was made possible through the assistance of Adam Fedor, Fred
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
992 Kiefer, M. Uli Klusterer, Alexander Malmberg, and Jonas Matton. Gürkan Sengün
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
993 made it accessible to a wider community.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
994
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
995 Riccardo Mottola helped with compatibility with MacOS versions 10.1 and 10.2,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
996 and GNUstep on platforms other than Linux.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
997
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
998 Peter Dyballa kept things honest with multilingual support. Rahul Abrol, Adam
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
999 Ratcliffe, David M. Cooke, and Carsten Bormann provided various small patches.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1000
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1001 Then there were a number of people who kept up the constant supply of bug
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1002 reports, suggested features and praise (which is the main fuel which the
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1003 development of a project like this runs) and so helped ensure that this
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1004 program is as bug free (hah !) and feature rich as you see it today. First
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1005 among them were Hardy Mayer <hardy@@golem.ps.uci.edu>, Gisli Ottarsson
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1006 <gisli@@timoshenko.eecs.umich.edu>, Anthony Heading <ajrh@@signal.dra.hmg.gb>,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1007 David Bau <bau@@cs.cornell.edu>, Jamie Zawinski <jwz@@lucid.com>, Martin
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1008 Moncrieffe <moncrief@@mayo.edu>, Simson L. Garfinkel
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1009 <simsong@@next.cambridge.ma.us>, Richard Stallman <rms@@gnu.ai.mit.edu>,
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1010 Stephen Anderson <anderson@@sapir.cog.jhu.edu>, Ivo Welch
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1011 <ivo@@next.agsm.ucla.edu>, Magnus Nordborg <magnus@@fisher.Stanford.EDU>, Tom
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1012 Epperly <epperly@@valeron.che.wisc.edu>, Andreas Koenig
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1013 <k@@franz.ww.tu-berlin.de>, Yves Arrouye <Yves.Arrouye@@imag.fr>, Anil
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1014 Somayaji <soma@@hotspur.mit.edu>, Gregor Hoffleit
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1015 <flight@@mathi.uni-heidelberg.DE> and doubtlessly many more.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1016
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1017 Finally, let us also thank those few hundred other people on the mailing list
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1018 from whom we didn't hear much, but the presence of which assured us that maybe
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1019 this project was actually worth doing.
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1020 @bye
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1021
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1022 @ignore
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1023 arch-tag: 286bdf18-ccfb-48b2-b730-994771de6bdd
9ed40c70bfa8 * ns-emacs.texi: Moved from ../emacs. Add @direntry.
Andreas Schwab <schwab@suse.de>
parents:
diff changeset
1024 @end ignore