annotate man/macos.texi @ 71234:f565df3b3c04

*** empty log message ***
author Eli Zaretskii <eliz@gnu.org>
date Mon, 05 Jun 2006 19:47:51 +0000
parents 95f50a235a27
children c2028c244c54 146cd8369025
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,
68639
dc2d5a6655a3 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 68543
diff changeset
3 @c 2005, 2006 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.
70435
95f50a235a27 Rename `Emacs and Microsoft Windows' into `Microsoft Windows'.
Eli Zaretskii <eliz@gnu.org>
parents: 70430
diff changeset
5 @node Mac OS, Microsoft Windows, 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
70430
a4ddaa03010e (Mac Input): Mention input from Character Palette.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 70299
diff changeset
70 based on Unicode may not work properly. (Try drag-and-drop if input
a4ddaa03010e (Mac Input): Mention input from Character Palette.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 70299
diff changeset
71 from the Character Palette does not work.) Selecting one of the layouts
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
72 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
73 on the keyboard are interpreted.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
74
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
75 @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
76 @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
77 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
78 @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
79 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
80 @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
81 to @code{nil}.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
82
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
83 @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
84 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
85 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
86 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
87 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
88 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
89 recognized as the third (second) button.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
90
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
91 @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
92 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
93 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
94 @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
95 are exchanged.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
96
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
97 @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
98 @section International Character Set Support on Mac
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
99 @cindex Mac Roman coding system
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
100 @cindex clipboard support (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
101
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
102 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
103 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
104 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
105 @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
106 are used to represent these Mac encodings.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
107
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
108 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
109 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
110 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
111 manual (@pxref{International}).
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
112
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
113 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
114 @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
115 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
116 will be changed when the keyboard layout change is detected next time.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
117
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
118 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
119 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
120 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
121 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
122 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
123 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
124 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
125
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 On Mac, the role of the coding system for selection that is set by
68543
8b6075eda680 (Mac International): Fix xref.
Richard M. Stallman <rms@gnu.org>
parents: 68036
diff changeset
127 @code{set-selection-coding-system} (@pxref{Communication Coding}) is
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
128 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
129 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
130 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
131 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
132 mainly used by applications on Mac OS X.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
133
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
134 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
135 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
136 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
137 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
138 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
139 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
140 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
141 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
142 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
143 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
144 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
145 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
146 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
147 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
148 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
149 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
150
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
151 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
152 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
153 the locale setting is consulted in the following order:
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
154
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
155 @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
156 @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
157 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
158 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
159
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
160 @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
161 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
162 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
163
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 @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
165 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
166 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
167
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 @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
169 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
170 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
171 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
172 @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
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 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
175 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
176 have to customize these variables manually.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
177
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
178 @node Mac Environment Variables
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
179 @section Environment Variables and Command Line Arguments.
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
180 @cindex environment variables (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
181
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 39287
diff changeset
182 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
183 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
184 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
185 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
186 @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
187 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
188
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
189 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
190
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
191 @example
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
192 /Applications/Emacs.app/Contents/MacOS/Emacs -g 80x25 &
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
193 @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
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 @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
196 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
197 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
198 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
199
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 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
201 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
202 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
203 set is @samp{HOME}.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
204
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
205 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
206 form
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
207
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
208 @example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
209 ENV_VAR=VALUE
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
210 @end example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
211
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
212 @noindent
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
213 to resource @samp{STR#} number 128 using @code{ResEdit}. To set up the
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
214 program to use unibyte characters exclusively, for example, add the
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
215 string
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
216
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
217 @example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
218 EMACS_UNIBYTE=1
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
219 @end example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
220
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
221 @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
222 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
223 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
224 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
225
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
226 @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
227 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
228 @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
229
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 @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
231 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
232
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 @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
234 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
235 @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
236
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 @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
238 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
239 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
240
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 @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 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
243 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
244 @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
245
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 @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
247 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
248 @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
249 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
250 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
251
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
252
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
253 @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
254 @section Volumes and Directories on Mac
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
255 @cindex file names (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
256
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
257 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
258
cef93d58fdb4 Change `Mac OS 8 or 9' to `Mac OS Classic'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 64890
diff changeset
259 The directory structure in Mac OS Classic is seen by Emacs as
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
260
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
261 @example
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
262 /@var{volumename}/@var{filename}
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
263 @end example
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
264
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
265 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
266 @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
267 to go up a directory level.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
268
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
269 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
270 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
271 is usually invisible in the Mac @code{Finder}).
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
272
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
273 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
274 @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
275 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
276 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
277 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
278 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
279 @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
280 created.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
281
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
282
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
283 @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
284 @section Specifying Fonts on Mac
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
285 @cindex font names (Mac OS)
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
286
36503
d7815b5b49d7 Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents: 36499
diff changeset
287 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
288 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
289 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
290
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
291 @lisp
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
292 (set-face-attribute 'default nil
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
293 :family "courier" :height 140)
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 @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
295
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 @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
297 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
298 (@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
299
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 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
301 standard X font name:
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
302
36163
159cc113a7b0 Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents: 34201
diff changeset
303 @smallexample
36413
f5625ac53fba Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents: 36263
diff changeset
304 -@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
305 @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
306 @end smallexample
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 @noindent
36503
d7815b5b49d7 Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents: 36499
diff changeset
309 @xref{Font X}. Wildcards are supported as they are on X.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
310
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
311 Emacs on Mac OS Classic uses QuickDraw Text routines for drawing texts
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
312 by default. Emacs on Mac OS X uses @acronym{ATSUI, Apple Type Services
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
313 for Unicode Imaging} as well as QuickDraw Text, and most of the
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
314 characters other than Chinese, Japanese, and Korean ones are drawn using
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
315 the former by default.
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
316
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
317 @acronym{ATSUI}-compatible fonts have maker name @code{apple} and
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
318 charset @code{iso10646-1}. For example 12-point Monaco can be specified
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
319 by the name
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
320 @samp{-apple-monaco-medium-r-normal--12-*-*-*-*-*-iso10646-1}. Note
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
321 that it must be specified in a format containing 14 @samp{-}s (i.e., not
70430
a4ddaa03010e (Mac Input): Mention input from Character Palette.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 70299
diff changeset
322 by @samp{-apple-monaco-medium-r-normal--12-*-iso10646-1}) because every
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
323 @acronym{ATSUI}-compatible font is a scalable one.
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
324
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
325 QuickDraw Text fonts have maker name @code{apple} and various charset
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
326 names other than @code{iso10646-1}. Native Apple fonts in Mac Roman
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
327 encoding has charset @code{mac-roman}. You can specify a
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
328 @code{mac-roman} font for @acronym{ASCII} characters like
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
329
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
330 @smalllisp
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
331 (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
332 '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
333 '(font . "-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman"))
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
334 @end smalllisp
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
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 @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
337 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
338 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
339
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 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
341 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
342 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
343 @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
344 @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
345 @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
346 respectively.
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
347
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
348 The use of @code{create-fontset-from-fontset-spec} (@pxref{Defining
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
349 Fontsets}) for defining fontsets often results in wrong ones especially
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
350 when using only OS-bundled QuickDraw Text fonts. The recommended way to
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
351 use them is to create a fontset using
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
352 @code{create-fontset-from-mac-roman-font}:
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
353
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 @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
355 (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
356 "-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
357 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
358 @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
359
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 @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
361 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
362 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
363
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 @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
365 (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
366 '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
367 @end lisp
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
368
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
369 Single-byte fonts converted from GNU fonts in BDF format, which are not
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
370 in the Mac Roman encoding, have foundry, family, and character sets
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
371 encoded in the names of their font suitcases. E.g., the font suitcase
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
372 @samp{ETL-Fixed-ISO8859-1} contains fonts which can be referred to by
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
373 the name @samp{-ETL-fixed-*-iso8859-1}.
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
374
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
375 @vindex mac-allow-anti-aliasing
70299
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
376 Mac OS X 10.2 or later can use two types of text renderings: Quartz 2D
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
377 (aka Core Graphics) and QuickDraw. By default, Emacs uses the former on
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
378 such versions. It can be changed by setting
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
379 @code{mac-allow-anti-aliasing} to @code{t} (Quartz 2D) or @code{nil}
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
380 (QuickDraw). Both @acronym{ATSUI} and QuickDraw Text drawings are
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
381 affected by the value of this variable.
ca785b8f7171 (Mac International): Now Carbon Emacs has ATSUI support.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 69898
diff changeset
382
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
383
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
384 @node Mac Functions
36165
7ae44c5a0404 One more small cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 36163
diff changeset
385 @section Mac-Specific Lisp Functions
36263
11db0318031d Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents: 36165
diff changeset
386 @cindex Lisp functions specific to Mac OS
34198
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
387
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
388 @findex do-applescript
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
389 The function @code{do-applescript} takes a string argument,
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
390 executes it as an AppleScript command, and returns the result as a
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
391 string.
306a480b3f22 New file.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
392
38892
8ae568af6251 2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 38865
diff changeset
393 @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
394 @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
395 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
396 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
397 @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
398 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
399 @code{do-applescript}.
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
400
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
401 @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
402 @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
403 @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
404 @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
405 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
406 @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
407 @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
408 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
409
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 @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
411 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
412 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
413
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
414 @ignore
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
415 arch-tag: a822c2ab-4273-4997-927e-c153bb71dcf6
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
416 @end ignore