unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 nljust(1)							   nljust(1)




 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.




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 nljust(1)							   nljust(1)




	   -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.





 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 nljust(1)							   nljust(1)




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



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 nljust(1)							   nljust(1)




	   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.

 SEE ALSO
      forder(1), lp(1), pr(1), strord(3C).





























 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000