code-page-define(3)

NAME

code-page-define - Define a named code page

SYNOPSIS

n code-page-define "name"

DESCRIPTION

code-page-define executes the macro file cpname.emf with the "-" and "8859" removed from name, e.g. "iso8859-5" is defined by cpiso5.emf. The file defines the code page with set-char-mask(2) flags C and c and makes it the current code page; in a build without Unicode support it also sets up the display for it (flags M, dp and a, $box-chars(5) and $window-chars(5)). The user's display code page is set up this way when MicroEmacs starts.

With an argument n of 0 a code page not yet defined is defined but the current code page is left as it was, this only gives the Unicode character of each byte, as needed to read a file or a spelling dictionary.

The code page file is executed with the same argument, a new code page file must follow this form:

0 set-char-mask "C" 
set-variable #l0 $result 
set-char-mask "C" "name" 
set-char-mask "c" "unicode-table" 
!if &not @# 
  set-char-mask "C" #l0 
!elif &not &opt "uni" 
  set-char-mask "M" "mapping" 
  . 
  . 
  set-variable .change-font.cp-box 1 
!endif 

where .change-font.cp-box is set when the file sets $box-chars and $window-chars, otherwise codepage.emf sets plain ones.

SEE ALSO

set-char-mask(2), $buffer-encoding(5), change-buffer-encoding(3).

Ref: code-page-define(3) File: m3mac112.3 Date: 2026/10/10

(c) Copyright JASSPA 2026