Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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]

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

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

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

       -e    Produces  equally-spaced words in adjusted	lines, using full ter-
	     minal resolution.

       -h    Uses output TAB characters	during	horizontal  spacing  to	 speed
	     output  and  reduces output character count. TAB settings are as-
	     sumed to be every 8 nominal 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/tmac.name to the  in-
	     put files.

       -nN   Numbers first generated page N.

       -opagelist
	     Prints  only  pages  whose	page numbers appear in the comma-sepa-
	     rated 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	will halt prior	to every N pages  (de-
	     fault  N=1)  to  allow paper loading or changing, and will	resume
	     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 de-
		   fault.

	     lp	| tn300
		   GE -- any line printer or terminal without half-line	 capa-
		   bility.

	     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.

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 may 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 may 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.9			  21Jul	2000			      nroff(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ENVIRONMENT VARIABLES | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nroff&sektion=1&manpath=SunOS+5.9>

home | help