-
Notifications
You must be signed in to change notification settings - Fork 4
/
part3-1-1.xml
77 lines (77 loc) · 3.56 KB
/
part3-1-1.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
<?xml version="1.0" encoding="UTF-8"?>
<html>
<head>
<meta http-equiv="Content-Type" content="text/xml; charset=utf-8"/>
<title>groff (GNU troff)</title>
<link rel="stylesheet" href="css/book.css" type="text/css"/>
</head>
<body>
<h3 id="groff_sec">
groff (GNU troff)
</h3>
<p>
The <a class="term" href="glossary.xml#gnu">GNU</a> project wrote the <a href="commands.xml#cmd_groff"
class="cmd">groff</a> utility as a reimplementation of <a href="commands.xml#cmd_ditroff"
class="cmd">ditroff</a>, which encompassed the functionality of the historical <a class="cmd"
href="commands.xml#cmd_nroff">nroff</a> and <a class="term cmd" href="commands.xml#cmd_troff">troff</a>
utilities. The first version was released in 1990, and it is still actively maintained. <a
href="commands.xml#cmd_groff" class="cmd">groff</a> is significant in that it is the predominant implementation
of <a href="commands.xml#cmd_nroff" class="cmd">nroff</a> and <a href="commands.xml#cmd_troff" class="cmd">troff</a> on
contemporary UNIX operating systems.
</p>
<p>
On systems with <a href="commands.xml#cmd_groff" class="cmd">groff</a> installed, both <a href="commands.xml#cmd_troff"
class="cmd">troff</a> and <a href="commands.xml#cmd_nroff" class="cmd">nroff</a> invoke the underlying <a
href="commands.xml#cmd_groff" class="cmd">groff</a> utility. It is able to produce the classical <a
href="glossary.xml#terminal" class="term">terminal</a> and <a class="term" href="glossary.xml#ps">PS</a> output,
along with more recent support for <a class="term" href="glossary.xml#xhtml">XHTML</a>, <a class="term"
href="glossary.xml#html">HTML</a>, and <a class="term" href="glossary.xml#pdf">PDF</a>. It has strong support
for non-<a class="term" href="glossary.xml#ascii">ASCII</a> output on supporting media. Consult your local <a
href="commands.xml#cmd_groff" class="cmd">groff</a> manual all possible outputs via the <span
class="cmdflag">T</span> flag.
</p>
<p>
The <span class="lang">mdoc</span> implementation in <a href="commands.xml#cmd_groff" class="cmd">groff</a> was entirely
re-written in version 1.17. Prior to this, input documents had some severe restrictions. Most notably, macro lines
were limited to 9 arguments, <a href="macros.xml#macro_bl" class="macro">Bl</a> column macros had a restricted syntax,
and displays such as <a href="macros.xml#macro_bd" class="macro">Bd</a> could not be nested.
</p>
<p>
The <a href="commands.xml#cmd_groff" class="cmd">groff</a> utility is supported on both UNIX and non-UNIX operating systems.
</p>
<h4>
Examples
</h4>
<p>
Paging a manual to a UNIX terminal:
</p>
<div class="cmdline">
groff -Tascii -mandoc file.1 | less
</div>
<p>
To strip the escape-character encoding of output to create clean, printable ASCII output:
</p>
<div class="cmdline">
groff -Tascii -mandoc file.1 | col -b >file.1.txt
</div>
<p>
Generating PS output:
</p>
<div class="cmdline">
groff -Tps -mandoc file.1 >file.1.ps
</div>
<table class="nav">
<tbody>
<tr>
<td class="nav-contents"><a href="toc.xml">Contents</a></td>
<td class="nav-next"><a href="part3-1-2.xml">Next</a></td>
<td class="nav-home"><a href="http://manpages.bsd.lv/index.html">Home</a></td>
<td class="nav-history"><a href="http://manpages.bsd.lv/cgi-bin/cvsweb/part3-1-1.xml?cvsroot=manpages">History</a></td>
</tr>
</tbody>
</table>
<p class="edits">
Last edited by $Author$ on $Date$. Copyright © 2011, Kristaps Dzonsons. CC BY-SA.
</p>
</body>
</html>