annotate man/macos.texi @ 68036:ad2c54d4bf05

(Mac International): Undo last change.
author YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
date Thu, 05 Jan 2006 08:13:36 +0000
parents e58128155819
children 8b6075eda680 7beb78bc1f8e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
1 @c This is part of the Emacs manual.
64890
3723093a21fd Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 59798
diff changeset
2 @c Copyright (C) 2000, 2001, 2002, 2003, 2004,
3723093a21fd Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 59798
diff changeset
3 @c 2005 Free Software Foundation, Inc.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
4 @c See file emacs.texi for copying conditions.
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
5 @node Mac OS, MS-DOS, Antinews, Top
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
6 @appendix Emacs and Mac OS
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
7 @cindex Mac OS
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
8 @cindex Macintosh
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
9
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
10 This section briefly describes the peculiarities of using Emacs
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
11 under Mac OS with native window system support. For Mac OS X, Emacs
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
12 can be built either without window system support, with X11, or with
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
13 Carbon API. This section only applies to the Carbon build. For Mac
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
14 OS Classic, Emacs can be built with or without Carbon API, and this
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
15 section applies to either of them because they run on the native
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
16 window system.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
17
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
18 Emacs built on Mac OS X supports most of its major features except
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
19 display support of PostScript images. The following features of Emacs
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
20 are not supported on Mac OS Classic: unexec (@code{dump-emacs}),
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
21 asynchronous subprocesses (@code{start-process}), and networking
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
22 (@code{open-network-stream}). As a result, packages such as Gnus,
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
23 GUD, and Comint do not work. Synchronous subprocesses
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
24 (@code{call-process}) are supported on non-Carbon build, but
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
25 specially-crafted external programs are needed. Since external
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
26 programs to handle commands such as @code{print-buffer} and
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
27 @code{diff} are not available on Mac OS Classic, they are not
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
28 supported. Non-Carbon build on Mac OS Classic does not support some
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
29 features such as file dialogs, drag-and-drop, and Unicode menus.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
30
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
31 @menu
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
32 * Input: Mac Input. Keyboard and mouse input on Mac.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
33 * Intl: Mac International. International character sets on Mac.
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
34 * Env: Mac Environment Variables. Setting environment variables for Emacs.
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
35 * Directories: Mac Directories. Volumes and directories on Mac.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
36 * Font: Mac Font Specs. Specifying fonts on Mac.
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
37 * Functions: Mac Functions. Mac-specific Lisp functions.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
38 @end menu
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
39
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
40 @node Mac Input
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
41 @section Keyboard and Mouse Input on Mac
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
42 @cindex Meta (Mac OS)
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
43 @cindex keyboard coding (Mac OS)
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
44
67100
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
45 @vindex mac-control-modifier
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
46 @vindex mac-command-modifier
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
47 @vindex mac-option-modifier
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
48 On Mac, Emacs can use @key{control}, @key{command}, and @key{option}
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
49 keys as any of Emacs modifier keys except @key{SHIFT} (i.e.,
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
50 @key{ALT}, @key{CTRL}, @key{HYPER}, @key{META}, and @key{SUPER}). The
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
51 assignment is controlled by the variables @code{mac-control-modifier},
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
52 @code{mac-command-modifier}, and @code{mac-option-modifier}. The
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
53 value for each of these variables can be one of the following symbols:
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
54 @code{alt}, @code{control}, @code{hyper}, @code{meta}, @code{super},
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
55 and @code{nil} (no particular assignment). By default, the
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
56 @key{control} key works as @key{CTRL}, and the @key{command} key as
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
57 @key{META}.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
58
67100
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
59 For the @key{option} key, if @code{mac-option-modifier} is set to
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
60 @code{nil}, which is the default, the key works as the normal
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
61 @key{option} key, i.e., dead-key processing will work. This is useful
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
62 for entering non-@acronym{ASCII} Latin characters directly from the
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
63 Mac keyboard, for example.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
64
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
65 Emacs recognizes the setting in the Keyboard control panel (Mac OS
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
66 Classic) or the International system preference pane (Mac OS X) and
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
67 supports international and alternative keyboard layouts (e.g., Dvorak)
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
68 if its script is either Roman, Japanese, Traditional Chinese, Korean,
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
69 Cyrillic, Simplified Chinese, or Central European. Keyboard layouts
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
70 based on Unicode may not work properly. Selecting one of the layouts
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
71 from the keyboard layout pull-down menu will affect how the keys typed
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
72 on the keyboard are interpreted.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
73
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
74 @vindex mac-pass-command-to-system
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
75 @vindex mac-pass-control-to-system
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
76 Mac OS intercepts and handles certain key combinations (e.g.,
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
77 @key{command}-@key{SPC} for switching input languages). These will not
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
78 be passed to Emacs. One can disable this interception by setting
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
79 @code{mac-pass-command-to-system} or @code{mac-pass-control-to-system}
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
80 to @code{nil}.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
81
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
82 @vindex mac-emulate-three-button-mouse
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
83 Especially for one-button mice, the multiple button feature can be
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
84 emulated by setting @code{mac-emulate-three-button-mouse} to @code{t}
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
85 or @code{reverse}. If set to @code{t} (@code{reverse}, respectively),
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
86 pressing the mouse button with the @key{option} key is recognized as
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
87 the second (third) button, and that with the @key{command} key is
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
88 recognized as the third (second) button.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
89
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
90 @vindex mac-wheel-button-is-mouse-2
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
91 For multi-button mice, the wheel button and the secondary button are
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
92 recognized as the second and the third button, respectively. If
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
93 @code{mac-wheel-button-is-mouse-2} is set to @code{nil}, their roles
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
94 are exchanged.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
95
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
96 @node Mac International
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
97 @section International Character Set Support on Mac
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
98 @cindex Mac Roman coding system
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
99 @cindex clipboard support (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
100
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
101 Mac uses non-standard encodings for the upper 128 single-byte
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
102 characters. They also deviate from the ISO 2022 standard by using
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
103 character codes in the range 128-159. The coding systems
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
104 @code{mac-roman}, @code{mac-centraleurroman}, and @code{mac-cyrillic}
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
105 are used to represent these Mac encodings.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
106
36413
f5625ac53fba Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents: 36263
diff changeset
107 The fontset @code{fontset-mac} is created automatically when Emacs
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
108 is run on Mac, and used by default. It displays as many kinds of
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
109 characters as possible using 12-point Monaco as a base font. If you
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
110 see some character as a hollow box with this fontset, then it's almost
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
111 impossible to display it only by customizing font settings (@pxref{Mac
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
112 Font Specs}).
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
113
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
114 You can use input methods provided either by LEIM (@pxref{Input
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
115 Methods}) or Mac OS to enter international characters. To use the
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
116 former, see the International Character Set Support section of the
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
117 manual (@pxref{International}).
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
118
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
119 Emacs on Mac OS automatically changes the value of
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
120 @code{keyboard-coding-system} according to the current keyboard
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
121 layout. So users don't need to set it manually, and even if set, it
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
122 will be changed when the keyboard layout change is detected next time.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
123
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
124 The Mac clipboard and the Emacs kill ring (@pxref{Killing}) are
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
125 synchronized by default: you can yank a piece of text and paste it
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
126 into another Mac application, or cut or copy one in another Mac
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
127 application and yank it into a Emacs buffer. This feature can be
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
128 disabled by setting @code{x-select-enable-clipboard} to @code{nil}.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
129 One can still do copy and paste with another application from the Edit
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
130 menu.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
131
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
132 On Mac, the role of the coding system for selection that is set by
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
133 @code{set-selection-coding-system} (@pxref{Specify Coding}) is
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
134 two-fold. First, it is used as a preferred coding system for the
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
135 traditional text flavor that does not specify any particular encodings
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
136 and is mainly used by applications on Mac OS Classic. Second, it
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
137 specifies the intermediate encoding for the UTF-16 text flavor that is
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
138 mainly used by applications on Mac OS X.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
139
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
140 When pasting UTF-16 text data from the clipboard, it is first
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
141 converted to the encoding specified by the selection coding system
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
142 using the converter in the Mac OS system, and then decoded into the
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
143 Emacs internal encoding using the converter in Emacs. If the first
68036
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
144 conversion failed, then the UTF-16 data is directly converted to Emacs
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
145 internal encoding using the converter in Emacs. Copying UTF-16 text
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
146 to the clipboard goes through the inverse path. The reason for this
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
147 two-pass decoding is to avoid subtle differences in Unicode mappings
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
148 between the Mac OS system and Emacs such as various kinds of hyphens,
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
149 and to minimize users' customization. For example, users that mainly
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
150 use Latin characters would prefer Greek characters to be decoded into
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
151 the @code{mule-unicode-0100-24ff} charset, but Japanese users would
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
152 prefer them to be decoded into the @code{japanese-jisx0208} charset.
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
153 Since the coding system for selection is automatically set according
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
154 to the system locale setting, users usually don't have to set it
ad2c54d4bf05 (Mac International): Undo last change.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 67100
diff changeset
155 manually.
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
156
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
157 The default language environment (@pxref{Language Environments}) is
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
158 set according to the locale setting at the startup time. On Mac OS,
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
159 the locale setting is consulted in the following order:
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
160
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
161 @enumerate
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
162 @item
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
163 Environment variables @env{LC_ALL}, @env{LC_CTYPE} and @env{LANG} as
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
164 in other systems.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
165
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
166 @item
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
167 Preference @code{AppleLocale} that is set by default on Mac OS X 10.3
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
168 and later.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
169
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
170 @item
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
171 Preference @code{AppleLanguages} that is set by default on Mac OS X
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
172 10.1 and later.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
173
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
174 @item
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
175 Variable @code{mac-system-locale} that is derived from the system
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
176 language and region codes. This variable is available on all
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
177 supported Mac OS versions including Mac OS Classic.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
178 @end enumerate
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
179
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
180 The default values of almost all variables about coding systems are
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
181 also set according to the language environment. So usually you don't
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
182 have to customize these variables manually.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
183
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
184 @node Mac Environment Variables
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
185 @section Environment Variables and Command Line Arguments.
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
186 @cindex environment variables (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
187
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
188 On Mac OS X, when Emacs is run in a terminal, it inherits the values
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
189 of environment variables from the shell from which it is invoked.
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
190 However, when it is run from the Finder as a GUI application, it only
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
191 inherits environment variable values defined in the file
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
192 @file{~/.MacOSX/environment.plist} that affects all the applications
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
193 invoked from the Finder or the @command{open} command.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
194
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
195 Command line arguments are specified like
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
196
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
197 @example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
198 /Applications/Emacs.app/Contents/MacOS/Emacs -geometry 80x25 &
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
199 @end example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
200
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
201 @noindent
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
202 if Emacs is installed at @file{/Applications/Emacs.app}. If Emacs is
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
203 invoked like this, then it also inherits the values of environment
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
204 variables from the shell from which it is invoked.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
205
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
206 On Mac OS Classic, environment variables and command line arguments
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
207 for Emacs can be set by modifying the @samp{STR#} resources 128 and
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
208 129, respectively. A common environment variable that one may want to
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
209 set is @samp{HOME}.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
210
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
211 The way to set an environment variable is by adding a string of the
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
212 form
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
213
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
214 @example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
215 ENV_VAR=VALUE
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
216 @end example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
217
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
218 @noindent
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
219 to resource @samp{STR#} number 128 using @code{ResEdit}. To set up the
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
220 program to use unibyte characters exclusively, for example, add the
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
221 string
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
222
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
223 @example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
224 EMACS_UNIBYTE=1
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
225 @end example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
226
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
227 @cindex Mac Preferences
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
228 Although Emacs on Mac does not support X resources (@pxref{X
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
229 Resources}) directly, one can use the Preferences system in place of X
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
230 resources. For example, adding the line
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
231
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
232 @example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
233 Emacs.cursorType: bar
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
234 @end example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
235
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
236 @noindent
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
237 to @file{~/.Xresources} in X11 corresponds to the execution of
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
238
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
239 @example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
240 defaults write org.gnu.Emacs Emacs.cursorType bar
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
241 @end example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
242
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
243 @noindent
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
244 on Mac OS X. One can use boolean or numeric values as well as string
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
245 values as follows:
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
246
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
247 @example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
248 defaults write org.gnu.Emacs Emacs.toolBar -bool false
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
249 defaults write org.gnu.Emacs Emacs.lineSpacing -int 3
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
250 @end example
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
251
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
252 @noindent
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
253 Try @kbd{M-x man RET defaults RET} for the usage of the
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
254 @command{defaults} command. Alternatively, if you have Developer
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
255 Tools installed on Mac OS X, you can use Property List Editor to edit
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
256 the file @file{~/Library/Preferences/org.gnu.Emacs.plist}.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
257
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
258
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
259 @node Mac Directories
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
260 @section Volumes and Directories on Mac
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
261 @cindex file names (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
262
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
263 This node applies to Mac OS Classic only.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
264
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
265 The directory structure in Mac OS Classic is seen by Emacs as
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
266
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
267 @example
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
268 /@var{volumename}/@var{filename}
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
269 @end example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
270
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
271 So when Emacs requests a file name, doing file name completion on
38865
62e02f5ae533 Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents: 38021
diff changeset
272 @file{/} will display all volumes on the system. You can use @file{..}
62e02f5ae533 Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents: 38021
diff changeset
273 to go up a directory level.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
274
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
275 On Mac OS Classic, to access files and folders on the desktop, look
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
276 in the folder @file{Desktop Folder} in your boot volume (this folder
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
277 is usually invisible in the Mac @code{Finder}).
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
278
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
279 On Mac OS Classic, Emacs creates the Mac folder
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
280 @file{:Preferences:Emacs:} in the @file{System Folder} and uses it as
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
281 the temporary directory. Emacs maps the directory name @file{/tmp/}
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
282 to that. Therefore it is best to avoid naming a volume @file{tmp}.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
283 If everything works correctly, the program should leave no files in it
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
284 when it exits. You should be able to set the environment variable
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
285 @code{TMPDIR} to use another directory but this folder will still be
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
286 created.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
287
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
288
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
289 @node Mac Font Specs
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
290 @section Specifying Fonts on Mac
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
291 @cindex font names (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
292
36503
d7815b5b49d7 Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents: 36499
diff changeset
293 It is rare that you need to specify a font name in Emacs; usually
67100
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
294 you specify face attributes instead. For example, you can use 14pt
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
295 Courier by customizing the default face attributes for all frames:
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
296
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
297 @lisp
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
298 (set-face-attribute 'default nil :family "courier" :height 140)
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
299 @end lisp
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
300
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
301 @noindent
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
302 Alternatively, an interactive one is also available
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
303 (@pxref{Face Customization}).
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
304
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
305 But when you do need to specify a font name in Emacs on Mac, use a
e58128155819 (Mac Input): Remove description of mac-command-key-is-meta. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65633
diff changeset
306 standard X font name:
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
307
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
308 @smallexample
36413
f5625ac53fba Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents: 36263
diff changeset
309 -@var{maker}-@var{family}-@var{weight}-@var{slant}-@var{widthtype}-@var{style}@dots{}
f5625ac53fba Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents: 36263
diff changeset
310 @dots{}-@var{pixels}-@var{height}-@var{horiz}-@var{vert}-@var{spacing}-@var{width}-@var{charset}
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
311 @end smallexample
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
312
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
313 @noindent
36503
d7815b5b49d7 Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents: 36499
diff changeset
314 @xref{Font X}. Wildcards are supported as they are on X.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
315
36413
f5625ac53fba Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents: 36263
diff changeset
316 Native Apple fonts in Mac Roman encoding has maker name @code{apple}
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
317 and charset @code{mac-roman}. For example 12-point Monaco can be
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
318 specified by the name @samp{-apple-monaco-*-12-*-mac-roman}. When
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
319 using a particular size of scalable fonts, it must be specified in a
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
320 format containing 14 @samp{-}s like
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
321 @samp{-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman}.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
322
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
323 You can specify a @code{mac-roman} font for @acronym{ASCII}
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
324 characters like
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
325
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
326 @lisp
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
327 (add-to-list
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
328 'default-frame-alist
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
329 '(font . "-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman"))
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
330 @end lisp
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
331
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
332 @noindent
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
333 but that does not extend to ISO-8859-1: specifying a @code{mac-roman}
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
334 font for Latin-1 characters introduces wrong glyphs.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
335
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
336 Native Apple Traditional Chinese, Simplified Chinese, Japanese,
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
337 Korean, Central European, Cyrillic, Symbol, and Dingbats fonts have
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
338 charsets @samp{big5-0}, @samp{gb2312.1980-0},
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
339 @samp{jisx0208.1983-sjis} and @samp{jisx0201.1976-0},
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
340 @samp{ksc5601.1989-0}, @samp{mac-centraleurroman},
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
341 @samp{mac-cyrillic}, @samp{mac-symbol}, and @samp{mac-dingbats},
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
342 respectively.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
343
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
344 Since Emacs as of the current version uses QuickDraw Text routines
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
345 for drawing texts, only characters in the charsets listed above can be
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
346 displayed with the OS-bundled fonts, even if other applications that
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
347 use @acronym{ATSUI} or Cocoa can display variety of characters with
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
348 them.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
349
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
350 The use of @code{create-fontset-from-fontset-spec} (@pxref{Defining
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
351 Fontsets}) for defining fontsets often results in wrong ones
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
352 especially when using only OS-bundled fonts. The recommended way is
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
353 to create a fontset using @code{create-fontset-from-mac-roman-font}:
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
354
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
355 @lisp
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
356 (create-fontset-from-mac-roman-font
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
357 "-apple-courier-medium-r-normal--13-*-*-*-*-*-mac-roman"
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
358 nil "foo")
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
359 @end lisp
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
360
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
361 @noindent
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
362 and then optionally specifying Chinese, Japanese, or Korean font
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
363 families using @code{set-fontset-font}:
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
364
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
365 @lisp
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
366 (set-fontset-font "fontset-foo"
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
367 'chinese-gb2312 '("song" . "gb2312.1980-0"))
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
368 @end lisp
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
369
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
370 Single-byte fonts converted from GNU fonts in BDF format, which are not
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
371 in the Mac Roman encoding, have foundry, family, and character sets
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
372 encoded in the names of their font suitcases. E.g., the font suitcase
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
373 @samp{ETL-Fixed-ISO8859-1} contains fonts which can be referred to by
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
374 the name @samp{-ETL-fixed-*-iso8859-1}.
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
375
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
376 @vindex mac-allow-anti-aliasing
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
377 Emacs uses the QuickDraw text rendering by default. On Mac OS X
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
378 10.2 and later, it can be changed so that it uses the Quartz 2D text
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
379 rendering (aka CG text rendering) by setting
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
380 @code{mac-allow-anti-aliasing} to @code{t}. However, it is reported
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
381 to sometimes leave some garbages.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
382
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
383 @node Mac Functions
36165
7ae44c5a0404 One more small cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 36163
diff changeset
384 @section Mac-Specific Lisp Functions
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
385 @cindex Lisp functions specific to Mac OS
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
386
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
387 @findex do-applescript
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
388 The function @code{do-applescript} takes a string argument,
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
389 executes it as an AppleScript command, and returns the result as a
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
390 string.
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
391
38892
8ae568af6251 2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 38865
diff changeset
392 @findex mac-file-name-to-posix
8ae568af6251 2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 38865
diff changeset
393 @findex posix-file-name-to-mac
8ae568af6251 2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 38865
diff changeset
394 The function @code{mac-file-name-to-posix} takes a Mac file name and
38944
7a42abfb0c82 Minor clarification.
Richard M. Stallman <rms@gnu.org>
parents: 38892
diff changeset
395 returns the GNU or Unix equivalent. The function
38892
8ae568af6251 2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 38865
diff changeset
396 @code{posix-file-name-to-mac} performs the opposite conversion. They
8ae568af6251 2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 38865
diff changeset
397 are useful for constructing AppleScript commands to be passed to
8ae568af6251 2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 38865
diff changeset
398 @code{do-applescript}.
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
399
65633
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
400 @findex mac-set-file-creator
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
401 @findex mac-get-file-creator
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
402 @findex mac-set-file-type
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
403 @findex mac-get-file-type
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
404 The functions @code{mac-set-file-creator},
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
405 @code{mac-get-file-creator}, @code{mac-set-file-type}, and
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
406 @code{mac-get-file-type} can be used to set and get creator and file
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
407 codes.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
408
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
409 @findex mac-get-preference
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
410 The function @code{mac-get-preference} returns the preferences value
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
411 converted to a Lisp object for a specified key and application.
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
412
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
413 @ignore
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
414 arch-tag: a822c2ab-4273-4997-927e-c153bb71dcf6
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
415 @end ignore