Mercurial > emacs
annotate man/macos.texi @ 54341:80dfe07a1d65
New file (image.c) for Image consolidation:
(COLOR_TABLE_SUPPORT): New define to control whether
color table support is available (X only).
(Bitmap_Record): Common name for x_bitmap_record,
w32_bitmap_record, and mac_bitmap_record.
(XImagePtr): Common name for pointer to XImage or equivalent.
(XImagePtr_or_DC): New type to simplify code sharing; equivalent
to XImagePtr on X+MAC, and to HDC on W32.
(GET_PIXEL): Wrapper for XGetPixel or equivalent.
(NO_PIXMAP): Common name for "None" or equivalent.
(PNG_BG_COLOR_SHIFT): Bits to shift PNG background colors.
(RGB_PIXEL_COLOR): Common type for an integer "pixel color" value.
(PIX_MASK_RETAIN, PIX_MASK_DRAW): Portability macros (from macfns.c).
(FRAME_X_VISUAL, x_defined_color, DefaultDepthOfScreen): Define
with suitable equivalents on W32 and MAC for code sharing.
(XDrawLine): Define on MAC for code sharing.
(Destroy_Image, Free_Pixmap): Wrappers for code sharing.
(IF_LIB_AVAILABLE): Macro to simplify code sharing.
(Vx_bitmap_file_path, Vimage_cache_eviction_delay)
(x_bitmap_height, x_bitmap_width, x_bitmap_pixmap)
(x_reference_bitmap, x_create_bitmap_from_data)
(x_create_bitmap_from_file, x_destroy_bitmap)
(x_destroy_all_bitmaps, x_create_bitmap_mask)
(XGetImage, XPutPixel, XGetPixel, XDestroyImage)
(QCascent, QCmargin, QCrelief, QCconversion, QCcolor_symbols)
(QCheuristic_mask, QCindex, QCmatrix, QCcolor_adjustment, QCmask)
(Qlaplace, Qemboss, Qedge_detection, Qheuristic, Qcenter)
(define_image_type, lookup_image_type, valid_image_p)
(image_error, enum image_value_type, struct image_keyword)
(parse_image_spec, image_spec_value, Fimage_size, Fimage_mask_p)
(make_image, free_image, prepare_image_for_display, image_ascent)
(four_corners_best, image_background, image_background_transparent)
(x_clear_image_1, x_clear_image, x_alloc_image_color)
(make_image_cache, free_image_cache, clear_image_cache)
(Fclear_image_cache, postprocess_image, lookup_image, cache_image)
(forall_images_in_image_cache, x_create_x_image_and_pixmap)
(x_destroy_x_image, x_put_x_image, x_find_image_file, slurp_file)
(find_image_fsspec, image_load_qt_1, image_load_quicktime)
(init_image_func_pointer, image_load_quartz2d)
(struct ct_color, init_color_table, free_color_table)
(lookup_rgb_color, lookup_pixel_color, colors_in_color_table)
(cross_disabled_images, x_to_xcolors, x_from_xcolors)
(x_detect_edges, x_emboss, x_laplace, x_edge_detection)
(x_disable_image, x_build_heuristic_mask)
(XBM support, XPM support, PBM support, PNG support, JPEG support)
(TIFF support, GIF support, Ghostscript support): Consolidate image
code from xfns.c, w32fns.c, and macfns.c.
(syms_of_image): Consolidate image related symbol setup here.
(init_image): Consolidate image related initializations here.
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Thu, 11 Mar 2004 00:28:24 +0000 |
parents | 3649390c0f91 |
children | 0816b427495a |
rev | line source |
---|---|
34198 | 1 @c This is part of the Emacs manual. |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
2 @c Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. |
34198 | 3 @c See file emacs.texi for copying conditions. |
4 @node Mac OS, MS-DOS, Antinews, Top | |
5 @appendix Emacs and the Mac OS | |
6 @cindex Mac OS | |
7 @cindex Macintosh | |
8 | |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
9 Emacs built on Mac OS X supports most of its major features: |
34198 | 10 multiple frames, colors, scroll bars, menu bars, use of the mouse, |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
11 fontsets, international characters, input methods, coding systems, |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
12 asynchronous and synchronous subprocesses, unexec (@code{dump-emacs}), |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
13 and networking (@code{open-network-stream}). Support for various |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
14 image file formats has not been implemented yet. |
34198 | 15 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
16 The following features of Emacs are not yet supported on the Mac OS |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
17 8 or 9: unexec (@code{dump-emacs}), asynchronous subprocesses |
38021 | 18 (@code{start-process}), and networking (@code{open-network-stream}). |
37511
226e5ac0edeb
(Mac OS): Don't say Ispell cannot work: it can, if they have a port
Eli Zaretskii <eliz@gnu.org>
parents:
36875
diff
changeset
|
19 As a result, packages such as Gnus, GUD, and Comint do not work. |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
20 However, synchronous subprocesses (@code{call-process}) are supported. |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
21 Since external programs to handle commands such as @code{print-buffer} |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
22 and @code{diff} are not available on Mac OS 8 or 9, they are not |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
23 supported. |
34198 | 24 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
25 Most of the features that are supported work in the same way as on |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
26 other platforms and are therefore documented in the rest of this |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
27 manual. This section describes the peculiarities of using Emacs under |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
28 the Mac OS. |
34198 | 29 |
30 @menu | |
36163
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
31 * Input: Mac Input. Keyboard input on the Mac. |
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
32 * Intl: Mac International. International character sets on the Mac. |
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
33 * Env: Mac Environment Variables. Setting environment variables for Emacs. |
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
34 * Directories: Mac Directories. Volumes and directories on the Mac. |
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
35 * Font: Mac Font Specs. Specifying fonts on the Mac. |
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
36 * Functions: Mac Functions. Mac-specific Lisp functions. |
34198 | 37 @end menu |
38 | |
39 @node Mac Input | |
40 @section Keyboard Input on the Mac | |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36165
diff
changeset
|
41 @cindex Meta (Mac OS) |
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36165
diff
changeset
|
42 @cindex keyboard coding (Mac OS) |
34198 | 43 @vindex mac-command-key-is-meta |
44 @vindex mac-keyboard-text-encoding | |
45 | |
46 On the Mac, Emacs can use either the @key{option} key or the | |
47 @key{command} key as the @key{META} key. If the value of the variable | |
48 @code{mac-command-key-is-meta} is non-@code{nil} (its default value), | |
36503
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
49 Emacs uses the @key{command} key as the @key{META} key. Otherwise it |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
50 uses the @key{option} key as the @key{META} key. |
34198 | 51 |
52 Most people should want to use the @key{command} key as the @key{META} key, | |
53 so that dead-key processing with the @key{option} key will still work. This is | |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52401
diff
changeset
|
54 useful for entering non-@acronym{ASCII} Latin characters directly from the Mac |
34198 | 55 keyboard, for example. |
56 | |
57 Emacs recognizes the setting in the Keyboard control panel and | |
58 supports international and alternative keyboard layouts (e.g., Dvorak). | |
59 Selecting one of the layouts from the keyboard layout pull-down menu | |
60 will affect how the keys typed on the keyboard are interpreted. | |
61 | |
62 The Mac OS intercepts and handles certain key combinations (e.g., | |
63 @key{command}-@key{SPC} for switching input languages). These will not | |
64 be passed to Emacs. | |
65 | |
66 The Mac keyboard ordinarily generates characters in the Mac Roman | |
67 encoding. To use it for entering ISO Latin-1 characters directly, set | |
68 the value of the variable @code{mac-keyboard-text-encoding} to | |
36413
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
69 @code{kTextEncodingISOLatin1}. Note that not all Mac Roman characters |
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
70 that can be entered at the keyboard can be converted to ISO Latin-1 |
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
71 characters. |
34198 | 72 |
36499
7da7487bbbd8
(Mac Input, Mac Font Specs): Fix typos reported by Dr Francis J. Wright
Eli Zaretskii <eliz@gnu.org>
parents:
36413
diff
changeset
|
73 To enter ISO Latin-2 characters directly from the Mac keyboard, set |
34198 | 74 the value of @code{mac-keyboard-text-encoding} to |
75 @code{kTextEncodingISOLatin2}. Then let Emacs know that the keyboard | |
36503
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
76 generates Latin-2 codes, by typing @kbd{C-x @key{RET} k iso-latin-2 |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
77 @key{RET}}. To make this setting permanent, put this in your |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
78 @file{.emacs} init file: |
34198 | 79 |
80 @lisp | |
36163
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
81 (set-keyboard-coding-system 'iso-latin-2) |
34198 | 82 @end lisp |
83 | |
84 @node Mac International | |
85 @section International Character Set Support on the Mac | |
86 @cindex Mac Roman coding system | |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36165
diff
changeset
|
87 @cindex clipboard support (Mac OS) |
34198 | 88 |
89 The Mac uses a non-standard encoding for the upper 128 single-byte | |
36503
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
90 characters. It also deviates from the ISO 2022 standard by using |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
91 character codes in the range 128-159. The coding system |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
92 @code{mac-roman} is used to represent this Mac encoding. It is used |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
93 for editing files stored in this native encoding, and for displaying |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
94 file names in Dired mode. |
34198 | 95 |
96 Any native (non-symbol) Mac font can be used to correctly display | |
97 characters in the @code{mac-roman} coding system. | |
98 | |
36413
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
99 The fontset @code{fontset-mac} is created automatically when Emacs |
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
100 is run on the Mac. It displays characters in the @code{mac-roman} |
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
101 coding system using 12-point Monaco. |
34198 | 102 |
103 To insert characters directly in the @code{mac-roman} coding system, | |
36875 | 104 type @kbd{C-x @key{RET} k mac-roman @key{RET}}, customize the option |
105 @code{keyboard-coding-system}, or put this in your init file: | |
34198 | 106 |
107 @lisp | |
108 (set-keyboard-coding-system 'mac-roman) | |
109 @end lisp | |
110 | |
111 @noindent | |
112 This is useful for editing documents in native Mac encoding. | |
113 | |
114 You can use input methods provided either by LEIM (@pxref{Input | |
115 Methods}) or the Mac OS to enter international characters. | |
116 | |
117 To use the former, see the International Character Set Support section | |
36875 | 118 of the manual (@pxref{International}). |
34198 | 119 |
120 To use input methods provided by the Mac OS, set the keyboard coding | |
36503
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
121 system accordingly using the @kbd{C-x @key{RET} k} command |
34198 | 122 (@code{set-keyboard-coding-system}). For example, for Traditional |
34201 | 123 Chinese, use @samp{chinese-big5} as keyboard coding system; for |
34198 | 124 Japanese, use @samp{sjis}, etc. Then select the desired input method in |
125 the keyboard layout pull-down menu. | |
126 | |
127 The Mac clipboard and the Emacs kill ring (@pxref{Killing}) are | |
128 connected as follows: the most recent kill is copied to the clipboard | |
129 when Emacs is suspended and the contents of the clipboard is inserted | |
130 into the kill ring when Emacs resumes. The result is that you can yank | |
131 a piece of text and paste it into another Mac application, or cut or copy | |
132 one in another Mac application and yank it into a Emacs buffer. | |
133 | |
134 The encoding of text selections must be specified using the commands | |
36503
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
135 @kbd{C-x @key{RET} x} (@code{set-selection-coding-system}) or @kbd{C-x |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
136 @key{RET} X} (@code{set-next-selection-coding-system}) (e.g., for |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
137 Traditional Chinese, use @samp{chinese-big5-mac} and for Japanese, |
34198 | 138 @samp{sjis-mac}). @xref{Specify Coding}, for more details. |
139 | |
140 | |
141 @node Mac Environment Variables | |
142 @section Environment Variables and Command Line Arguments. | |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36165
diff
changeset
|
143 @cindex environment variables (Mac OS) |
34198 | 144 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
145 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
|
146 of environment variables from the shell from which it is invoked. |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
147 However, when it is run from the Finder as a GUI application, it |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
148 inherits no environment variable values. |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
149 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
150 On Mac OS 8 or 9, environment variables and command line arguments |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
151 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
|
152 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
|
153 set is @samp{HOME}. |
34198 | 154 |
155 The way to set an environment variable is by adding a string of the | |
156 form | |
157 | |
158 @example | |
159 ENV_VAR=VALUE | |
160 @end example | |
161 | |
162 @noindent | |
163 to resource @samp{STR#} number 128 using @code{ResEdit}. To set up the | |
164 program to use unibyte characters exclusively, for example, add the | |
165 string | |
166 | |
167 @example | |
168 EMACS_UNIBYTE=1 | |
169 @end example | |
170 | |
171 | |
172 @node Mac Directories | |
173 @section Volumes and Directories on the Mac | |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36165
diff
changeset
|
174 @cindex file names (Mac OS) |
34198 | 175 |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
44890
diff
changeset
|
176 The directory structure in the Mac OS is seen by Emacs as |
34198 | 177 |
178 @example | |
36163
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
179 /@var{volumename}/@var{filename} |
34198 | 180 @end example |
181 | |
36163
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
182 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
|
183 @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
|
184 to go up a directory level. |
34198 | 185 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
186 On Mac OS 8 or 9, to access files and folders on the desktop, look |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
187 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
|
188 is usually invisible in the Mac @code{Finder}). |
34198 | 189 |
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 On Mac OS 8 or 9, Emacs creates the Mac folder |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
39287
diff
changeset
|
191 @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
|
192 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
|
193 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
|
194 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
|
195 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
|
196 @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
|
197 created. |
34198 | 198 |
199 | |
200 @node Mac Font Specs | |
201 @section Specifying Fonts on the Mac | |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36165
diff
changeset
|
202 @cindex font names (Mac OS) |
34198 | 203 |
36503
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
204 It is rare that you need to specify a font name in Emacs; usually |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
205 you specify face attributes instead. But when you do need to specify |
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
206 a font name in Emacs on the Mac, use a standard X font name: |
34198 | 207 |
36163
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
208 @smallexample |
36413
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
209 -@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
|
210 @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
|
211 @end smallexample |
34198 | 212 |
36163
159cc113a7b0
Small cleanups in usage.
Richard M. Stallman <rms@gnu.org>
parents:
34201
diff
changeset
|
213 @noindent |
36503
d7815b5b49d7
Minor clarifications. Explain that one normally specifies face attributes
Richard M. Stallman <rms@gnu.org>
parents:
36499
diff
changeset
|
214 @xref{Font X}. Wildcards are supported as they are on X. |
34198 | 215 |
36413
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
216 Native Apple fonts in Mac Roman encoding has maker name @code{apple} |
34198 | 217 and charset @code{mac-roman}. For example 12-point Monaco can be |
218 specified by the name @samp{-apple-monaco-*-12-*-mac-roman}. | |
219 | |
220 Native Apple Traditional Chinese, Simplified Chinese, Japanese, and | |
36413
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
221 Korean fonts have charsets @samp{big5-0}, @samp{gb2312.1980-0}, |
f5625ac53fba
Made minor editing changes.
Andrew Choi <akochoi@shaw.ca>
parents:
36263
diff
changeset
|
222 @samp{jisx0208.1983-sjis}, and @samp{ksc5601.1989-0}, respectively. |
34198 | 223 |
224 Single-byte fonts converted from GNU fonts in BDF format, which are not | |
225 in the Mac Roman encoding, have foundry, family, and character sets | |
226 encoded in the names of their font suitcases. E.g., the font suitcase | |
227 @samp{ETL-Fixed-ISO8859-1} contains fonts which can be referred to by | |
228 the name @samp{-ETL-fixed-*-iso8859-1}. | |
229 | |
230 | |
231 @node Mac Functions | |
36165
7ae44c5a0404
One more small cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
36163
diff
changeset
|
232 @section Mac-Specific Lisp Functions |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36165
diff
changeset
|
233 @cindex Lisp functions specific to Mac OS |
34198 | 234 |
235 @findex do-applescript | |
236 The function @code{do-applescript} takes a string argument, | |
237 executes it as an AppleScript command, and returns the result as a | |
238 string. | |
239 | |
38892
8ae568af6251
2001-08-21 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents:
38865
diff
changeset
|
240 @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
|
241 @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
|
242 The function @code{mac-file-name-to-posix} takes a Mac file name and |
38944 | 243 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
|
244 @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
|
245 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
|
246 @code{do-applescript}. |
52401 | 247 |
248 @ignore | |
249 arch-tag: a822c2ab-4273-4997-927e-c153bb71dcf6 | |
250 @end ignore |