diff options
| author | YAMAMOTO Mitsuharu | 2006-05-01 01:10:29 +0000 |
|---|---|---|
| committer | YAMAMOTO Mitsuharu | 2006-05-01 01:10:29 +0000 |
| commit | 47915f5ffd18150b85edb6beb07f816dc950f5b5 (patch) | |
| tree | 5971eda375e843cc5c8a605387202815144edf86 | |
| parent | fc36394b4b5456392ca891d63842bb59d442656d (diff) | |
| download | emacs-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.texi | 70 |
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} |
| 105 | are used to represent these Mac encodings. | 105 | are used to represent these Mac encodings. |
| 106 | 106 | ||
| 107 | The fontset @code{fontset-standard} is created automatically when | ||
| 108 | Emacs is run on Mac, and used by default. It displays as many kinds | ||
| 109 | of characters as possible using 12-point Monaco as a base font. If | ||
| 110 | you see some character as a hollow box with this fontset, then it's | ||
| 111 | almost 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 |
| 115 | Methods}) or Mac OS to enter international characters. To use the | 108 | Methods}) or Mac OS to enter international characters. To use the |
| 116 | former, see the International Character Set Support section of the | 109 | former, 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 | |||
| 295 | Courier by customizing the default face attributes for all frames: | 288 | Courier 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 |
| 317 | and charset @code{mac-roman}. For example 12-point Monaco can be | 311 | by default. Emacs on Mac OS X uses @acronym{ATSUI, Apple Type Services |
| 318 | specified by the name @samp{-apple-monaco-*-12-*-mac-roman}. When | 312 | for Unicode Imaging} as well as QuickDraw Text, and most of the |
| 319 | using a particular size of scalable fonts, it must be specified in a | 313 | characters other than Chinese, Japanese, and Korean ones are drawn using |
| 320 | format containing 14 @samp{-}s like | 314 | the 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} | 317 | charset @code{iso10646-1}. For example 12-point Monaco can be specified |
| 324 | characters like | 318 | by the name |
| 325 | 319 | @samp{-apple-monaco-medium-r-normal--12-*-*-*-*-*-iso10646-1}. Note | |
| 326 | @lisp | 320 | that it must be specified in a format containing 14 @samp{-}s (i.e., not |
| 321 | by @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 | ||
| 325 | names other than @code{iso10646-1}. Native Apple fonts in Mac Roman | ||
| 326 | encoding 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 |
| 333 | but that does not extend to ISO-8859-1: specifying a @code{mac-roman} | 336 | but 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}, |
| 342 | respectively. | 345 | respectively. |
| 343 | 346 | ||
| 344 | Since Emacs as of the current version uses QuickDraw Text routines | ||
| 345 | for drawing texts, only characters in the charsets listed above can be | ||
| 346 | displayed with the OS-bundled fonts, even if other applications that | ||
| 347 | use @acronym{ATSUI} or Cocoa can display variety of characters with | ||
| 348 | them. | ||
| 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 |
| 351 | Fontsets}) for defining fontsets often results in wrong ones | 348 | Fontsets}) for defining fontsets often results in wrong ones especially |
| 352 | especially when using only OS-bundled fonts. The recommended way is | 349 | when using only OS-bundled QuickDraw Text fonts. The recommended way to |
| 353 | to create a fontset using @code{create-fontset-from-mac-roman-font}: | 350 | use 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 | |||
| 374 | the name @samp{-ETL-fixed-*-iso8859-1}. | 372 | the 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 |
| 378 | 10.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 |
| 379 | rendering (aka CG text rendering) by setting | 377 | such 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} |
| 381 | to sometimes leave some garbages. | 379 | (QuickDraw). Both @acronym{ATSUI} and QuickDraw Text drawings are |
| 380 | affected 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 |