Troff - Revision history

Jsummers: /* Links */ Replaced broken link

2016-05-05T20:07:30Z

‎Links: Replaced broken link

Jsummers at 11:54, 6 April 2016

2016-04-06T11:54:39Z

Jsummers at 17:49, 18 December 2014

2014-12-18T17:49:17Z

Jsummers at 16:20, 23 August 2014

2014-08-23T16:20:47Z

Jsummers at 23:26, 7 August 2014

2014-08-07T23:26:26Z

Jsummers at 00:39, 7 August 2014

2014-08-07T00:39:37Z

Jsummers: Created page with "{{FormatInfo |name=troff |formattype=electronic |thiscat=Document |extensions={{ext|tmac}}, {{ext|man}}, {{ext|mom}}, {{ext|ms}}, many others |released=~1976 }} '''troff''' is..."

2014-08-06T22:13:39Z

Created page with "{{FormatInfo |name=troff |formattype=electronic |thiscat=Document |extensions={{ext|tmac}}, {{ext|man}}, {{ext|mom}}, {{ext|ms}}, many others |released=~1976 }} '''troff''' is..."

New page

{{FormatInfo
|name=troff
|formattype=electronic
|thiscat=Document
|extensions={{ext|tmac}}, {{ext|man}}, {{ext|mom}}, {{ext|ms}}, many others
|released=~1976
}}
'''troff''' is a typesetting utility and associated document format, used mainly on Unix-based systems. Its most common use is to render [[Man page|man pages]], but it is capable of much more.

troff is part of a confusing universe of software packages, utilities, and formats with names like troff, nroff, roff, groff, ditroff, TYPSET, and RUNOFF (and some of these names have multiple meanings).

Currently, the most widely-used version of the troff software is ''groff'' (''GNU troff''). Note that the groff software includes utilities named both "groff" and "troff" (as well as "nroff"), which have different functions.

== Macro packages ==
The troff format is usually not used directly; instead, troff files make use of one of the many available macro packages. Macros packages for the groff version of troff may be installed at <code>/usr/share/groff/*/*.tmac</code>.

troff and related utilities usually accept a <code>-m</code> option, to use a macro package. Some macro packages are deliberately given a name that begins with the letter "m", while their internal name has the "m" stripped off. For example, the <code>-man</code> option will read a macro package known as "man", but ''really'' named "an" (the macros would be in a file named "an.tmac"). Apparently, the theory is that <code>-man</code> looks better than the more logical <code>-mman</code> (though the packages often have aliases, so <code>-mman</code> might work as well).

A troff file's filename extension may suggest what macro package to use. Apparently, the contents of the file do not do this.

== Software ==
* [http://www.gnu.org/software/groff/ GNU troff (groff) website]

== See also ==
* [[man page]] (troff format with the "man" macro package)

== Links ==
* [http://www.troff.org/ troff.org]
** [http://www.troff.org/macros.html List of macro packages]
* [[Wikipedia:Troff]]
* [[Wikipedia:Troff macro]]
* [[Wikipedia:Groff (software)]]
* [[Wikipedia:Nroff]]
* [[Wikipedia:Roff]]
* [[Wikipedia:TYPSET and RUNOFF]]
* [[Wikipedia:Runoff (program)]]
* [http://www.netadmintools.com/html/7roff.man.html roff - concepts and history of roff typesetting]

← Older revision		Revision as of 11:54, 6 April 2016
Line 43:		Line 43:
	* [[Wikipedia:Runoff (program)]]		* [[Wikipedia:Runoff (program)]]
	* [http://www.netadmintools.com/html/7roff.man.html roff - concepts and history of roff typesetting]		* [http://www.netadmintools.com/html/7roff.man.html roff - concepts and history of roff typesetting]
		+
		+	[[Category:File formats with too many extensions]]

@@ Line 6: / Line 6: @@
 |released=~1976
 }}
-'''troff''' is a typesetting utility and associated document format, used mainly on Unix-based systems. Its most common use is to render [[Man page|man pages]], but it is capable of much more.
+'''troff''' (pronounced ''TEE-roff'') is a typesetting utility and associated document format, used mainly on Unix-based systems. Its most common use is to render [[Man page|man pages]], but it is capable of much more.
 troff is part of a confusing universe of software packages, utilities, and formats with names like troff, nroff, roff, groff, ditroff, TYPSET, and RUNOFF (and some of these names have multiple meanings).
@@ Line 13: / Line 13: @@
 == Macro packages ==
-The troff format is usually not used directly; instead, troff files make use of one of the many available macro packages. Macro packages for the groff version of troff may be installed at <code>/usr/share/groff/*/*.tmac</code>.
+The troff format is usually not used directly; instead, troff files make use of one of the many available macro packages. Macro packages for the groff version of troff are typically installed at <code>/usr/share/groff/*/*.tmac</code> or a similar location.
 troff and related utilities usually accept a <code>-m</code> option, to use a macro package. Some macro packages are deliberately given a name that begins with the letter "m", while their internal name has the "m" stripped off. For example, the <code>-man</code> option will read a macro package known as "man", but ''really'' named "an" (the macros would be in a file named "an.tmac"). Apparently, the theory is that <code>-man</code> looks better than the more logical <code>-mman</code> (though the packages often have aliases, so <code>-mman</code> might work as well).
@@ Line 20: / Line 20: @@
 == Examples ==
-The nroff utility can help to display troff files on a terminal. For example:
+The nroff utility can display troff files on a terminal. For example:
    $ nroff -ms example.ms | less -R

@@ Line 42: / Line 42: @@
 * [[Wikipedia:TYPSET and RUNOFF]]
 * [[Wikipedia:Runoff (program)]]
-* [http://www.netadmintools.com/html/7roff.man.html roff - concepts and history of roff typesetting]
+* [http://linux.die.net/man/7/roff roff - concepts and history of roff typesetting]
 [[Category:File formats with too many extensions]]

@@ Line 2: / Line 2: @@
 |name=troff
 |formattype=electronic
-|thiscat=Document
+|subcat=Document
 |extensions={{ext|tmac}}, {{ext|man}}, {{ext|mom}}, {{ext|ms}}, many others
 |released=~1976

@@ Line 10: / Line 10: @@
 troff is part of a confusing universe of software packages, utilities, and formats with names like troff, nroff, roff, groff, ditroff, TYPSET, and RUNOFF (and some of these names have multiple meanings).
-Currently, the most widely-used version of the troff software is ''groff'' (''GNU troff''). Note that the groff software includes utilities named both "groff" and "troff" (as well as "nroff"), which have different functions.
+Currently, the most widely-used version of the troff software is ''groff'' (GNU troff). Note that the groff software includes utilities named both "groff" and "troff" (as well as "nroff"), which have different functions.
 == Macro packages ==
@@ Line 17: / Line 17: @@
 troff and related utilities usually accept a <code>-m</code> option, to use a macro package. Some macro packages are deliberately given a name that begins with the letter "m", while their internal name has the "m" stripped off. For example, the <code>-man</code> option will read a macro package known as "man", but ''really'' named "an" (the macros would be in a file named "an.tmac"). Apparently, the theory is that <code>-man</code> looks better than the more logical <code>-mman</code> (though the packages often have aliases, so <code>-mman</code> might work as well).
-A troff file's filename extension may suggest what macro package to use. Supposedly there is a way to indicate this in the content of the file, but for some reason this feature is not always used.
+A troff file's filename extension may suggest what macro package to use. Supposedly there is a way to indicate this in the contents of the file, but for some reason this feature is not always used.
 == Software ==
 * [http://www.gnu.org/software/groff/ GNU troff (groff)]
 == See also ==