Unix/Linux Go Back    


OpenSolaris 2009.06 - man page for nroff (opensolaris section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


nroff(1) 				  User Commands 				   nroff(1) 

NAME
       nroff - format documents for display or line-printer

SYNOPSIS
       nroff [-ehiq] [-mname] [-nN] [-opagelist] [-raN] [-sN]
	    [-Tname] [-uN] [filename...]

DESCRIPTION
       The nroff utility formats text in the named filename for typewriter-like devices. See also
         troff(1) .

       If no filename argument is present, nroff reads the standard input. An argument consisting
       of a `-' is taken to be a file name corresponding to the standard input.

OPTIONS
       The  following  options	are  supported.  Options  can appear in any order so long as they
       appear before the files.

       -e	     Produces equally-spaced words in adjusted lines, using full terminal resolu-
		     tion.

       -h	     Uses  output  TAB	characters  during horizontal spacing to speed output and
		     reduces output character count. TAB settings are assumed to be every 8 nomi-
		     nal character widths.

       -i	     Reads the standard input after the input files are exhausted.

       -q	     Does not print output that was read from an .rd request.

       -mname	     Prepends the macro file /usr/share/lib/tmac/name to the input files.

       -nN	     Numbers first generated page N.

       -opagelist    Prints  only  pages whose page numbers appear in the comma-separated list of
		     numbers and ranges. A range N-M means pages N through M; an initial -N means
		     from the beginning to page N; and a final N- means from N to the end.

       -raN	     Sets register a (one-character) to N.

       -sN	     Stops  every  N  pages.  nroff halts prior to every N pages (default N=1) to
		     allow paper loading or changing, and resumes upon receipt of a NEWLINE.

       -Tname	     Prepares output for a device of the specified name. Known names are:

		     37 	   Teletype Corporation Model 37 terminal -- this is the default.

		     lp | tn300    GE -- any line printer or terminal without half-line  capabil-
				   ity.

		     300	   DASI-300.

		     300-12	   DASI-300 -- 12-pitch.

		     300S	   DASI-300S.

		     300S-12	   DASI-300S.

		     382	   DASI-382 (fancy DTC 382).

		     450	   DASI-450 (Diablo Hyterm).

		     450-12	   DASI-450 (Diablo Hyterm) -- 12-pitch.

		     832	   AJ 832.

       -uN	     Set  the emboldening factor for the font mounted in position 3 to N. If N is
		     missing, then set the emboldening factor to 0.

OPERANDS
       The following operand is supported:

       filename    The file containing text to be processed by nroff.

EXAMPLES
       Example 1 Formatting with a macro package

       The following command formats users.guide using the -me macro package, and stopping  every
       4 pages:

	 example% nroff -s4 -me users.guide

ENVIRONMENT VARIABLES
       See    environ(5) 	for  descriptions  of the following environment variables that affect the
       execution of nroff: LC_CTYPE, LC_MESSAGES, and NLSPATH.

FILES
       /usr/tmp/trtmp*

	   temporary file (see NOTES)

       /usr/share/lib/tmac/tmac.*

	   standard macro files

       /usr/share/lib/nterm/*

	   terminal driving tables for nroff

       /usr/share/lib/nterm/README

	   index to terminal description files

ATTRIBUTES
       See   attributes(5)  for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWdoc			   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+

SEE ALSO
         checknr(1) ,   col(1) ,   eqn(1) ,   man(1) ,   tbl(1) ,   troff(1) ,    attributes(5) ,    environ(5) ,    me(5) ,
         ms(5) ,   term(5) 

NOTES
       /usr/tmp is currently a symbolic link to /var/tmp.

       Previous documentation incorrectly described the numeric register yr as being the Last two
       digits of current year. yr is in actuality the number of years since  1900.  To	correctly
       obtain the last two digits of the current year through the year 2099, the definition given
       below of string register yy can be included in a document and subsequently used to display
       a  two-digit year. Notice that any other available one- or two-character register name can
       be substituted for yy.

	 .\" definition of new string register yy--last two digits of year
	 .\" use yr (# of years since 1900) if it is < 100
	 .ie \n(yr<100 .ds yy \n(yr
	 .el \{ 	    .\" else, subtract 100 from yr, store in ny
	 .nr ny \n(yr-100
	 .ie \n(ny>9 \{     .\" use ny if it is two digits
	 .ds yy \n(ny
	 .\" remove temporary number register ny
	 .rr ny \}
	 .el \{.ds yy 0
	 .\" if ny is one digit, append it to 0
	 .as yy \n(ny
	 .rr ny \} \}

SunOS 5.11				    1 Nov 2007					   nroff(1)
Unix & Linux Commands & Man Pages : ©2000 - 2017 Unix and Linux Forums


All times are GMT -4. The time now is 06:08 AM.