aboutsummaryrefslogtreecommitdiff
path: root/man/neatroff.1
blob: 508cba2ae73410bc875157f91926410cda51ea19 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
.\" first draft by Larry Kollar
.TH neatroff 1
.SH NAME
neatroff \- the neatroff typesetting processor
.SH SYNOPSIS
.I neatroff
.RB [ \-m\c
.IR x ]
.RB [ \-C ]
.RB [ \-T\c
.IR dev ]
.RB [ \-F\c
.IR dir ]
.RB [ \-M\c
.IR dir ]
.RI [ files \&...]
.SH DESCRIPTION
.I Neatroff
is an extended version of AT&T
.IR ditroff ,
supporting TrueType/OpenType fonts
and whole-paragraph formatting.
.I Neatroff
requires the user to construct the pipeline
to format a document.
For example:
.EX
.sp
cat mydoc.t | neateqn | neatroff -ms -Tutf | neatpost | ps2pdf - mydoc.pdf
.EE
.SS Extensions
The following are the most important
.I neatroff
extensions:
.IP \[bu] 3
Like GNU
.IR troff ,
.I neatroff
supports names of arbitrary length for
requests, macro names, number registers, and string variables.
.IP \[bu]
.I Neatroff
supports UTF-8 input
without the need for a preprocessor.
.IP \[bu]
The ``dir'' branch of
.I neatroff
supports right-to-left typesetting
for languages requiring it.
.IP \[bu]
To enable whole-paragraph formatting, add
.B p
in front of the adjustment specification; for example,
.B "ad pb"
fully justifies paragraphs with advanced filling.
Finally, in the ``dir'' branch,
.B "ad k"
supports Kashideh justification.
.SH OPTIONS
The following options are available:
.IP "\-m \fIx\fP" 8
Loads the
.I x
macro package.
.IP "\-C"
Enables compatibility mode
with AT&T
.IR troff .
.IP "\-T \fIdev\fP"
Sets the output device.
The default is
.B utf
for PostScript.
.IP "\-F \fIdir\fP"
Sets the font directory.
The default is typically
/usr/share/neatroff/font.
.IP "\-M \fIdir\fP"
Sets the macro directory.
The default is typically
/usr/share/neatroff/tmac.
.SH FILES
.IP "/usr/share/neatroff/tmac/tmac.x" 4
The
.I x
macro package.
.IP "/usr/share/neatroff/font/*"
Output device directories.
.SH "SEE ALSO"
.IR neatpost (1),
.IR neateqn (1),
.IR neatrefer (1),
.IR neatmkfn (1)
.IP http://litcave.rudi.ir/neatstart.pdf 4
Explains how to compile and install
.IR neatroff ,
and add new fonts.
.IP http://litcave.rudi.ir/neatroff.pdf
Describes the primary differences between
.I neatroff
and other troff-like typesetting systems.