Debian Codegraph @

texmf-dist/doc/man/man1/aleph.1

raw
1 .TH ALEPH 1 "15 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
4 .if n .ds TX TeX
5 .\"=====================================================================
6 .SH NAME
7 aleph \- extended TeX with Unicode and bidirectional typesetting support
8 .SH SYNOPSIS
9 .B aleph
10 .RI [ options ]
11 .RI [ \fB&\fPformat ]
12 \h'.25' [ \fIfile\fP [ \fImore-input\fP ] \h'.5'|\h'.5' [ \fB\e\fP\fImore-input\fP ]
13 .\"=====================================================================
14 .SH DESCRIPTION
15 Run the Aleph typesetter on
16 .IR file ,
17 usually creating
18 .IR file.dvi .
19 If the file argument has no extension, ".tex" will be appended to it. See
20 .BR tex (1)
21 for details of command-line parsing.
22 .PP
23 Aleph is no longer being actively developed; see Lua\*(TX for current
24 activity with Unicode and \*(TX. Aleph is still maintained and
25 distributed for the sake of supporting existing documents.
26 .PP
27 Aleph is essentially the extended \*(TX engine Omega, plus the
28 .BR etex (1)
29 extensions. Omega was developed starting in the 1990s to support
30 Unicode and bidirectional typesetting. To support this, it implements
31 "Omega translation process" files (\fI.otp\fR), which are compiled into
32 "Omega compiled process" files (\fI.ocp\fR).
33 .PP
34 Omega, and hence Aleph, also has its own extended font formats,
35 analogous to \*(TX's: Omega metric files (\fI.ofm\fR) and Omega virtual
36 fonts (\fI.ovf\fR), along with their corresponding human-readable
37 "property list" forms (\fI.opl\fR and \fI.ovp\fR).
38 .\"=====================================================================
39 .SH OPTIONS
40 See
41 .BR tex (1).
42 The -enc, -mltex, -translate-file, and -8bit options are not present in
43 Aleph. There are no Aleph-specific options.
44 .\"=====================================================================
45 .SH ENVIRONMENT
46 See
47 .BR tex (1).
48 .\"=====================================================================
49 .SH BUGS
50 See
51 .BR tex (1).
52 .\"=====================================================================
53 .SH FILES
54 .TP
55 .I $TEXMFMAIN/tex/plain/config/aleph.ini
56 The driver file that builds the Aleph format file, \fIaleph.fmt\fP, in
57 \*(TX Live.
58 .\"=====================================================================
59 .SH "SEE ALSO"
60 .BR tex (1),
61 .BR luatex (1).
62 .br
63 .BR ofm2opl (1),
64 .BR opl2ofm (1),
65 .BR ovf2ovp (1),
66 .BR ovp2ovf (1).
67 .br
68 .BR otangle (1),
69 .BR odvicopy (1),
70 .BR odvitype (1).
71 .PP
72 Aleph package page on CTAN: https://ctan.org/pkg/aleph
73 .br
74 Omega package page on CTAN: https://ctan.org/pkg/omega
75 .PP
76 Clearly, this manual page is a bare minimum. Unfortunately,
77 there is no comprehensive documentation on either Omega or Aleph.
78 .PP
79 The Web2c (https://tug.org/web2c) and Kpathsea
80 (https://tug.org/kpathsea) manuals have brief mentions of the programs
81 and file formats.
82 .PP
83 Perhaps most usefully, a number of articles were published in TUGboat on
84 their development and usage, mostly by John Plaice and Yannis
85 Haralambous: https://tug.org/TUGboat.
86 .PP
87 Other than that, use the source.
88 .\"=====================================================================
89 .SH AUTHORS
90 \*(TX was created by Donald E. Knuth.
91 The primary authors of the Aleph enhancements are John Plaice and Yannis
92 Haralambous, as they are the authors of Omega. The e-\*(TX extensions
93 were primarily written by Peter Breitenlohner, and added to Aleph by
94 Giuseppe Bilotta.
95 .PP
96 Public discussion list and bug reports: https://lists.tug.org/tex-k