Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > N

nljust(1)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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):

nljust -w 132 file1 | lp

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.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.