aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorYAMAMOTO Mitsuharu2006-05-01 01:10:29 +0000
committerYAMAMOTO Mitsuharu2006-05-01 01:10:29 +0000
commit47915f5ffd18150b85edb6beb07f816dc950f5b5 (patch)
tree5971eda375e843cc5c8a605387202815144edf86
parentfc36394b4b5456392ca891d63842bb59d442656d (diff)
downloademacs-47915f5ffd18150b85edb6beb07f816dc950f5b5.tar.gz
emacs-47915f5ffd18150b85edb6beb07f816dc950f5b5.zip
(Mac International): Now Carbon Emacs has ATSUI support.
(Mac Environment Variables): Shorten example line. (Mac Font Specs): Shorten lisp lines. Add descriptions for ATSUI.
-rw-r--r--man/macos.texi70
1 files changed, 35 insertions, 35 deletions
diff --git a/man/macos.texi b/man/macos.texi
index 89ce13d1d1b..272609b8392 100644
--- a/man/macos.texi
+++ b/man/macos.texi
@@ -104,13 +104,6 @@ character codes in the range 128-159. The coding systems
104@code{mac-roman}, @code{mac-centraleurroman}, and @code{mac-cyrillic} 104@code{mac-roman}, @code{mac-centraleurroman}, and @code{mac-cyrillic}
105are used to represent these Mac encodings. 105are used to represent these Mac encodings.
106 106
107 The fontset @code{fontset-standard} is created automatically when
108Emacs is run on Mac, and used by default. It displays as many kinds
109of characters as possible using 12-point Monaco as a base font. If
110you see some character as a hollow box with this fontset, then it's
111almost impossible to display it only by customizing font settings
112(@pxref{Mac Font Specs}).
113
114 You can use input methods provided either by LEIM (@pxref{Input 107 You can use input methods provided either by LEIM (@pxref{Input
115Methods}) or Mac OS to enter international characters. To use the 108Methods}) or Mac OS to enter international characters. To use the
116former, see the International Character Set Support section of the 109former, see the International Character Set Support section of the
@@ -195,7 +188,7 @@ invoked from the Finder or the @command{open} command.
195 Command line arguments are specified like 188 Command line arguments are specified like
196 189
197@example 190@example
198/Applications/Emacs.app/Contents/MacOS/Emacs -geometry 80x25 & 191/Applications/Emacs.app/Contents/MacOS/Emacs -g 80x25 &
199@end example 192@end example
200 193
201@noindent 194@noindent
@@ -295,7 +288,8 @@ you specify face attributes instead. For example, you can use 14pt
295Courier by customizing the default face attributes for all frames: 288Courier by customizing the default face attributes for all frames:
296 289
297@lisp 290@lisp
298(set-face-attribute 'default nil :family "courier" :height 140) 291(set-face-attribute 'default nil
292 :family "courier" :height 140)
299@end lisp 293@end lisp
300 294
301@noindent 295@noindent
@@ -313,21 +307,30 @@ standard X font name:
313@noindent 307@noindent
314@xref{Font X}. Wildcards are supported as they are on X. 308@xref{Font X}. Wildcards are supported as they are on X.
315 309
316 Native Apple fonts in Mac Roman encoding has maker name @code{apple} 310 Emacs on Mac OS Classic uses QuickDraw Text routines for drawing texts
317and charset @code{mac-roman}. For example 12-point Monaco can be 311by default. Emacs on Mac OS X uses @acronym{ATSUI, Apple Type Services
318specified by the name @samp{-apple-monaco-*-12-*-mac-roman}. When 312for Unicode Imaging} as well as QuickDraw Text, and most of the
319using a particular size of scalable fonts, it must be specified in a 313characters other than Chinese, Japanese, and Korean ones are drawn using
320format containing 14 @samp{-}s like 314the former by default.
321@samp{-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman}. 315
322 316 @acronym{ATSUI}-compatible fonts have maker name @code{apple} and
323 You can specify a @code{mac-roman} font for @acronym{ASCII} 317charset @code{iso10646-1}. For example 12-point Monaco can be specified
324characters like 318by the name
325 319@samp{-apple-monaco-medium-r-normal--12-*-*-*-*-*-iso10646-1}. Note
326@lisp 320that it must be specified in a format containing 14 @samp{-}s (i.e., not
321by @samp{-apple-monaco-medium-r-normal-12-*-iso10646-1}) because every
322@acronym{ATSUI}-compatible font is a scalable one.
323
324 QuickDraw Text fonts have maker name @code{apple} and various charset
325names other than @code{iso10646-1}. Native Apple fonts in Mac Roman
326encoding has charset @code{mac-roman}. You can specify a
327@code{mac-roman} font for @acronym{ASCII} characters like
328
329@smalllisp
327(add-to-list 330(add-to-list
328 'default-frame-alist 331 'default-frame-alist
329 '(font . "-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman")) 332 '(font . "-apple-monaco-medium-r-normal--13-*-*-*-*-*-mac-roman"))
330@end lisp 333@end smalllisp
331 334
332@noindent 335@noindent
333but that does not extend to ISO-8859-1: specifying a @code{mac-roman} 336but that does not extend to ISO-8859-1: specifying a @code{mac-roman}
@@ -341,16 +344,11 @@ charsets @samp{big5-0}, @samp{gb2312.1980-0},
341@samp{mac-cyrillic}, @samp{mac-symbol}, and @samp{mac-dingbats}, 344@samp{mac-cyrillic}, @samp{mac-symbol}, and @samp{mac-dingbats},
342respectively. 345respectively.
343 346
344 Since Emacs as of the current version uses QuickDraw Text routines
345for drawing texts, only characters in the charsets listed above can be
346displayed with the OS-bundled fonts, even if other applications that
347use @acronym{ATSUI} or Cocoa can display variety of characters with
348them.
349
350 The use of @code{create-fontset-from-fontset-spec} (@pxref{Defining 347 The use of @code{create-fontset-from-fontset-spec} (@pxref{Defining
351Fontsets}) for defining fontsets often results in wrong ones 348Fontsets}) for defining fontsets often results in wrong ones especially
352especially when using only OS-bundled fonts. The recommended way is 349when using only OS-bundled QuickDraw Text fonts. The recommended way to
353to create a fontset using @code{create-fontset-from-mac-roman-font}: 350use them is to create a fontset using
351@code{create-fontset-from-mac-roman-font}:
354 352
355@lisp 353@lisp
356(create-fontset-from-mac-roman-font 354(create-fontset-from-mac-roman-font
@@ -374,11 +372,13 @@ encoded in the names of their font suitcases. E.g., the font suitcase
374the name @samp{-ETL-fixed-*-iso8859-1}. 372the name @samp{-ETL-fixed-*-iso8859-1}.
375 373
376@vindex mac-allow-anti-aliasing 374@vindex mac-allow-anti-aliasing
377 Emacs uses the QuickDraw text rendering by default. On Mac OS X 375 Mac OS X 10.2 or later can use two types of text renderings: Quartz 2D
37810.2 and later, it can be changed so that it uses the Quartz 2D text 376(aka Core Graphics) and QuickDraw. By default, Emacs uses the former on
379rendering (aka CG text rendering) by setting 377such versions. It can be changed by setting
380@code{mac-allow-anti-aliasing} to @code{t}. However, it is reported 378@code{mac-allow-anti-aliasing} to @code{t} (Quartz 2D) or @code{nil}
381to sometimes leave some garbages. 379(QuickDraw). Both @acronym{ATSUI} and QuickDraw Text drawings are
380affected by the value of this variable.
381
382 382
383@node Mac Functions 383@node Mac Functions
384@section Mac-Specific Lisp Functions 384@section Mac-Specific Lisp Functions