NAME
nljust — justify lines, left or right, for printing
SYNOPSIS
nljust
[-acilnt]
[-d
digits]
[-e
seq]
[-j
just]
[-m
mode]
[-o
order]
[-r
margin]
[-w
width]
[-x
ck]
[file ...]
DESCRIPTION
nljust
formats for printing data
written in languages with a right-to-left orientation.
It is designed to be used with the
pr
and the
lp
commands (see
pr(1)
and
lp(1)).
nljust
reads the concatenation of input files
(or standard input if none are given)
and produces on standard output
a right-to-left formatted version of its input.
If
-
appears as an input file name,
nljust
reads standard input at that point.
Use
--
to delimit the end of options.
nljust
formats input files for all languages that are
read from right to left.
For languages that have a left-to-right orientation,
the command merely copies input files to standard output.
Options
nljust
recognizes the following options:
- -a
Justify data for all languages,
including those having a left-to-right text orientation.
By default only right-to-left language data is justified.
For all other languages, input files
are directly copied to standard output.
- -c
Select enhanced printer shapes for some Arabic characters.
With this option, two-character combinations
of laam and alif are replaced by a single character.
- -i
Triggers ISO 8859-6 interpretation of the data.
- -d digits
Processes digits for output as hindi, western, or both.
digits
can be
h,
w,
or
both.
- -e seq
Use
seq
as the escape sequence to select the primary character set.
This escape sequence is used by languages
that have too many characters to be accommodated by
ASCII
in a single 256-character set.
In these cases, the
seq
escape sequence can be used to select the non-ASCII
character set.
The
escape
character itself (0x1b) is not given on the command line.
Hewlett-Packard escape sequences are used by default.
- -j just
If
just
is
l,
left justify print lines.
If
just
is
r,
right-justify print lines starting from the
(designated or default) print width column.
The default is right justification.
- -l
Replace leading spaces with alternative spaces.
Some right-to-left character sets have a non-ASCII
or alternative space.
This option can be useful when filtering
pr -n
output (see
pr(1)).
With right justification, the
-l
option causes line numbers to be placed
immediately to the right of the tab character.
Without the
-l
option, right justification causes line numbers
to be placed at the print-width column.
By default, leading spaces are not replaced by alternative spaces.
- -m mode
Indicate
mode
of any file to be formatted.
Mode refers to the text orientation of the file when it was created.
If
mode
is
l,
assume Latin mode.
If
mode
is
n,
assume non-Latin mode.
By default, mode information is obtained from the
LANGOPTS
environment variable.
- -n
Do not terminate lines containing printable characters with a new-line.
By default, print lines are terminated by new-lines.
- -o order
Indicate data
order
of any file to be formatted.
The text orientation of a file can affect the way
its data is arranged.
If
order
is
k,
assume keyboard order.
If
order
is
s,
assume screen order.
By default, order information is obtained from the
LANGOPTS
environment variable.
- -t
Truncate print lines
that do not fit the designated or default line length.
Print lines are folded
(that is, wrapped to next line) by default.
- -x ck
Expand input tabs to column positions
k+1,
2*k+1,
3*k+1,
etc.
Tab characters in the input are expanded to the appropriate number of spaces.
If
k
is 0 or is omitted, default tab settings
at every eighth position is assumed.
If
cd
(any non-digit character) is given,
it is treated as the input tab character.
The default for
c
is the tab character.
nljust
always expands input tabs.
This option provides a way to change the tab character and setting.
If this option is specified, at least one of the parameters
c
or
k
must be given.
- -r margin
Designate a number as the print
margin.
The print margin is the column
where truncation or folding takes place.
The print margin determines
how many characters appear on a single line
and can never exceed the print width.
The print margin is relative to the justification.
If the print margin is 80,
folding or truncation occurs at column 80
starting from the right during a right justification.
Similarly, folding or truncation occurs at column 80
starting from the left during a left justification.
By default, the print margin is set to column 80.
- -w width
Designates a number as the print
width.
The print width is the maximum number of columns in the print line.
Print width determines the start of text
during a right justification.
The larger the print width,
the further to the right the text will start.
By default, an 80-column print width is used.
EXTERNAL INFLUENCES
Environment Variables
The
LANGOPTS
environment variable determines the mode and order of the file.
The syntax of
LANGOPTS
is
[mode][_order].
mode
describes the mode of a file where
l
represents Latin mode and
n
represents non-Latin mode.
Non-Latin mode is assumed for values other than
l
and
n.
order
describes the data order of a file where
k
is keyboard and
s
is screen.
Keyboard order is assumed for values other than
k
and
s.
Mode and order information in
LANGOPTS
can be overridden from the command line.
The
LC_ALL
environment variable determines the direction of a language
(left-to-right or right-to-left)
and whether context analysis of characters is necessary.
The
LC_NUMERIC
environment variable determines
whether a language has alternative numbers.
The
LANG
environment variable determines the language
in which messages are displayed.
International Code Set Support
Single-byte character code sets are supported.
EXAMPLES
Right justify
file1
on a 132-column printer
with a print margin at column 80 (the default):
Right justify
pr
output of
file2
with line numbers on a 132-column printer
with a print margin at column 132:
pr -n file2 | nljust -w 132 -r 132 | lp
WARNINGS
If
pr
with line numbers
(-n
option) is piped to
nljust,
the separator character must be a tab (0x09).
It is the user's responsibility to ensure that the
LANGOPTS
environment variable accurately reflects the status of the file.
Mode and justification must be consistent.
Only non-Latin-mode files can be right justified
in a meaningful way.
Similarly, only Latin-mode files can be safely left justified.
If mode and justification do not match,
the results are undefined.
If present,
alternative numbers always have a left-to-right orientation.
The
nljust
command is HP proprietary, not portable to other vendors'
systems, and will not be provided in future HP-UX releases.
AUTHOR
nljust
was developed by HP.