comparison man/macos.texi @ 36503:d7815b5b49d7

Minor clarifications. Explain that one normally specifies face attributes rather than a font name.

36502:3f0def4a4210

@vindex mac-keyboard-text-encoding

  On the Mac, Emacs can use either the @key{option} key or the
@key{command} key as the @key{META} key.  If the value of the variable
@code{mac-command-key-is-meta} is non-@code{nil} (its default value),
Emacs uses the @key{command} key as the @key{META} key.  Otherwise it uses the
@key{option} key as the @key{META} key.

  Most people should want to use the @key{command} key as the @key{META} key,
so that dead-key processing with the @key{option} key will still work.  This is
useful for entering non-ASCII Latin characters directly from the Mac
keyboard, for example.

characters.

  To enter ISO Latin-2 characters directly from the Mac keyboard, set
the value of @code{mac-keyboard-text-encoding} to
@code{kTextEncodingISOLatin2}.  Then let Emacs know that the keyboard
generates Latin-2 codes by typing @kbd{C-x RET k iso-latin-2 RET}.  To
make this setting permanent, put this in your @file{.emacs} init file:

@lisp
(set-keyboard-coding-system 'iso-latin-2)
@end lisp

@section International Character Set Support on the Mac
@cindex Mac Roman coding system
@cindex clipboard support (Mac OS)

  The Mac uses a non-standard encoding for the upper 128 single-byte
characters.  It also deviates from the ISO 2022 standard by using code
points in the range 128-159.  The coding system @code{mac-roman} is used
to represent this Mac encoding.  It is used for editing files stored in
this native encoding, and for displaying file names in Dired mode.

  Any native (non-symbol) Mac font can be used to correctly display
characters in the @code{mac-roman} coding system.

  The fontset @code{fontset-mac} is created automatically when Emacs
is run on the Mac.  It displays characters in the @code{mac-roman}
coding system using 12-point Monaco.

  To insert characters directly in the @code{mac-roman} coding system,
type @kbd{C-x RET k mac-roman RET}, or put this in your @file{.emacs}
init file:

@lisp
(set-keyboard-coding-system 'mac-roman)
@end lisp

  To use the former, see the International Character Set Support section
of the manual.

  To use input methods provided by the Mac OS, set the keyboard coding
system accordingly using the @kbd{C-x RET k} command
(@code{set-keyboard-coding-system}).  For example, for Traditional
Chinese, use @samp{chinese-big5} as keyboard coding system; for
Japanese, use @samp{sjis}, etc.  Then select the desired input method in
the keyboard layout pull-down menu.

into the kill ring when Emacs resumes.  The result is that you can yank
a piece of text and paste it into another Mac application, or cut or copy
one in another Mac application and yank it into a Emacs buffer.

  The encoding of text selections must be specified using the commands
@kbd{C-x RET x} (@code{set-selection-coding-system}) or @kbd{C-x RET X}
(@code{set-next-selection-coding-system}) (e.g., for Traditional
Chinese, use @samp{chinese-big5-mac} and for Japanese,
@samp{sjis-mac}).  @xref{Specify Coding}, for more details.


@node Mac Environment Variables
@section Environment Variables and Command Line Arguments.

@node Mac Font Specs
@section Specifying Fonts on the Mac
@cindex font names (Mac OS)

  Fonts are specified to Emacs on the Mac in the form of a standard X
font name, i.e.

@smallexample
-@var{maker}-@var{family}-@var{weight}-@var{slant}-@var{widthtype}-@var{style}@dots{}
@dots{}-@var{pixels}-@var{height}-@var{horiz}-@var{vert}-@var{spacing}-@var{width}-@var{charset}
@end smallexample

@noindent
@xref{Font X}.  Wildcards
are supported as they are on X.

  Native Apple fonts in Mac Roman encoding has maker name @code{apple}
and charset @code{mac-roman}.  For example 12-point Monaco can be
specified by the name @samp{-apple-monaco-*-12-*-mac-roman}.

36503:d7815b5b49d7

@vindex mac-keyboard-text-encoding

  On the Mac, Emacs can use either the @key{option} key or the
@key{command} key as the @key{META} key.  If the value of the variable
@code{mac-command-key-is-meta} is non-@code{nil} (its default value),
Emacs uses the @key{command} key as the @key{META} key.  Otherwise it
uses the @key{option} key as the @key{META} key.

  Most people should want to use the @key{command} key as the @key{META} key,
so that dead-key processing with the @key{option} key will still work.  This is
useful for entering non-ASCII Latin characters directly from the Mac
keyboard, for example.

characters.

  To enter ISO Latin-2 characters directly from the Mac keyboard, set
the value of @code{mac-keyboard-text-encoding} to
@code{kTextEncodingISOLatin2}.  Then let Emacs know that the keyboard
generates Latin-2 codes, by typing @kbd{C-x @key{RET} k iso-latin-2
@key{RET}}.  To make this setting permanent, put this in your
@file{.emacs} init file:

@lisp
(set-keyboard-coding-system 'iso-latin-2)
@end lisp

@section International Character Set Support on the Mac
@cindex Mac Roman coding system
@cindex clipboard support (Mac OS)

  The Mac uses a non-standard encoding for the upper 128 single-byte
characters.  It also deviates from the ISO 2022 standard by using
character codes in the range 128-159.  The coding system
@code{mac-roman} is used to represent this Mac encoding.  It is used
for editing files stored in this native encoding, and for displaying
file names in Dired mode.

  Any native (non-symbol) Mac font can be used to correctly display
characters in the @code{mac-roman} coding system.

  The fontset @code{fontset-mac} is created automatically when Emacs
is run on the Mac.  It displays characters in the @code{mac-roman}
coding system using 12-point Monaco.

  To insert characters directly in the @code{mac-roman} coding system,
type @kbd{C-x @key{RET} k mac-roman @key{RET}}, or put this in your
@file{.emacs} init file:

@lisp
(set-keyboard-coding-system 'mac-roman)
@end lisp

  To use the former, see the International Character Set Support section
of the manual.

  To use input methods provided by the Mac OS, set the keyboard coding
system accordingly using the @kbd{C-x @key{RET} k} command
(@code{set-keyboard-coding-system}).  For example, for Traditional
Chinese, use @samp{chinese-big5} as keyboard coding system; for
Japanese, use @samp{sjis}, etc.  Then select the desired input method in
the keyboard layout pull-down menu.

into the kill ring when Emacs resumes.  The result is that you can yank
a piece of text and paste it into another Mac application, or cut or copy
one in another Mac application and yank it into a Emacs buffer.

  The encoding of text selections must be specified using the commands
@kbd{C-x @key{RET} x} (@code{set-selection-coding-system}) or @kbd{C-x
@key{RET} X} (@code{set-next-selection-coding-system}) (e.g., for
Traditional Chinese, use @samp{chinese-big5-mac} and for Japanese,
@samp{sjis-mac}).  @xref{Specify Coding}, for more details.


@node Mac Environment Variables
@section Environment Variables and Command Line Arguments.

@node Mac Font Specs
@section Specifying Fonts on the Mac
@cindex font names (Mac OS)

  It is rare that you need to specify a font name in Emacs; usually
you specify face attributes instead.  But when you do need to specify
a font name in Emacs on the Mac, use a standard X font name:

@smallexample
-@var{maker}-@var{family}-@var{weight}-@var{slant}-@var{widthtype}-@var{style}@dots{}
@dots{}-@var{pixels}-@var{height}-@var{horiz}-@var{vert}-@var{spacing}-@var{width}-@var{charset}
@end smallexample

@noindent
@xref{Font X}.  Wildcards are supported as they are on X.

  Native Apple fonts in Mac Roman encoding has maker name @code{apple}
and charset @code{mac-roman}.  For example 12-point Monaco can be
specified by the name @samp{-apple-monaco-*-12-*-mac-roman}.