unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



asa(1)								       asa(1)



NAME

  asa -	Interprets carriage-control characters

SYNOPSIS

  asa [file...]

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  asa: XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

OPTIONS

   None

OPERANDS

  file
      The pathname of a	file to	be read.  If this parameter is omitted,	stan-
      dard input is read.

DESCRIPTION

  The asa command writes its input files to standard output, mapping
  carriage-control characters from the text files to line-printer control
  sequences.

  The first character of every input line is removed and, depending on the
  character removed, an	action performed on that character and the rest	of
  the line.  If	the character removed is:

  space
      The rest of the line is output without change.

  0   A	newline	character is output, followed by the rest of the input line.

  1   A	form-feed character is output, followed	by the rest of the input
      line.

  +    The newline character of	the previous line is replaced with a
      carriage-return character, which is output, followed by the rest of the
      input line. If + is the first character in the input, + has the same
      effect as	the space character.

  other
      [Tru64 UNIX]  The	character is output, followed by the rest of the
      input line.






EXIT STATUS

  The following	exit values are	returned:

  0   Successful completion.

  >>0  An error occurred.

EXAMPLES

   1.  To view a file (created by a program using FORTRAN-style	carriage con-
       trol characters)	on a terminal:
	    asa	file

   2.  To format the FORTRAN output of a.out and direct	it to the printer:
	    a.out | asa	| lp



ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of asa:

  LANG
      Provides a default value for the internationalization variables that
      are unset	or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments and input files).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  NLSPATH
      Determines the location of message catalogues for	the processing of
      LC_MESSAGES.

SEE ALSO

  Commands:  lp(1)

  Standards:  standards(5)