NAME<\/a> groff_filenames \u2212 filename extensions for roff and groff<\/p>\n Since the evolution of roff<\/i> in the 1970s, a whole bunch of filename extensions for roff<\/i> files were used.<\/p>\n The roff<\/i> extensions refer to preprocessors or macro packages. These extensions are fixed in all Unix<\/i>\u2212like operating systems.<\/p>\n Later on, groff<\/b> added some more extensions. This man page<\/i> is about these filename extensions.<\/p>\n Each roff<\/i> file can be optionally compressed<\/i>. That means that the total filename<\/i> ends with a compressor name<\/i>. So the whole filename has the structure Best-known are the compressor extensions<\/i> .Z<\/b>, .gz<\/b>, and .bzip2<\/b>. Relatively new is .xz<\/b>.<\/p>\n From now on, we will ignore the compressions<\/i> and only comment the structure The Unix manual pages<\/i> are widely called man pages<\/i>. The man page<\/i> style is the best known part of the roff<\/i> language.<\/p>\n The extensions for man<\/i> should be better documented. So this is documented here.<\/p>\n Files written in the man<\/i> language use the following extension: *.<\/b><\/p>\n Man page Sections<\/b> Classic man page sections<\/i>.<\/p>\n In older commercial Unix<\/i> systems, the 3 characters l<\/b>, n<\/b>, and o<\/b> were also used as section<\/i> names. This is today deprecated<\/i>, but there are still documents in this format. Deprecated<\/i> man page sections, which stood for \u201clocal\u201d, \u201cnew\u201d, and \u201cold\u201d, respectively.<\/p>\n Man page Group Extensions<\/b> Examples: is the man page for groff<\/b> in section<\/i> 1<\/b> without a group<\/i><\/p>\n xargs.1posix.gz<\/b><\/p>\n is the man page for the program xargs<\/b> in section<\/i> 1<\/b> and group<\/i> posix<\/b>; moreover it is compressed<\/i> with gz<\/b> (gzip<\/b>).<\/p>\n config.5ssl<\/b><\/p>\n OpenSSL CONF<\/i> library configuration files from section<\/i> 5<\/b> with group<\/i> ssl<\/b>.<\/p>\n dpkg\u2212reconfigure.8cdebconf<\/b><\/p>\n man page for the program dpkg\u2212reconfigure<\/b> in section<\/i> 8<\/b> and group<\/i> cdebconf<\/b>.<\/p>\n Source of man pages<\/b> The names of these 2 styles are taken as extensions<\/i> for the source code files of man pages in the groff<\/i> package. traditional<\/i> Unix-like man page format within groff source files.<\/p>\n A temporary man page file produced from a name<\/i>.man<\/b> man page by a run of make<\/b> within the groff<\/b> source package.<\/p>\n Man page format in BSD.<\/p>\n Man page format in heirloom roff<\/i> .<\/p>\n Files using this extension recognize both man page formats in groff<\/b> and other processors.<\/p>\n Files Using Macro Packages<\/b> There were several roff<\/i> languages, each represented by a macro-package<\/i>. Each of these provided a suitable file name extension<\/i>: roff<\/i> file using the me<\/b> macro package<\/i>.<\/p>\n roff<\/i> file using the mm<\/b> macro package<\/i><\/p>\n roff<\/i> file using the ms<\/b> macro package<\/i><\/p>\n All of these classical roff<\/i> languages and their extensions are still very active in groff<\/b>.<\/p>\n Source Code for Macro Packages (TMAC Files)<\/b> For example, tmac.an<\/b> is the source for the man<\/b> macro package.<\/p>\n In the groff<\/b> source, more suitable file names were integrated, see later on.<\/p>\n Preprocessors<\/b> for the integration of chemical formulas<\/p>\n for the mathematical use of equations<\/p>\n graphical tool<\/p>\n for tables with tbl<\/i><\/p>\n for files using the prefer<\/b> preprocessor<\/i><\/p>\n Classical Roff Files<\/b> for files using the roff<\/i> language of any kind<\/p>\n GNU roff<\/i> groff<\/b> is the actual roff<\/i> standard, both for classical roff<\/i> and new extensions. So even the used new extensions in the source code should be regarded as actual standard. The following extensions are used instead of classical .t<\/b> or .tr<\/b>: general ending for files using the groff language<\/i><\/p>\n Source Code for Macro Packages (TMAC Files)<\/b> Files Using new Macro Packages<\/b> file with swedish mm<\/b> macros<\/i> for groff<\/b><\/p>\n files written in the groff macro package<\/i> mom<\/b><\/p>\n files written in HTML<\/b>-like groff macros<\/i>.<\/p>\n Preprocessors and Postprocessors<\/b> Heidelberger tables, an alternative to the preprocessor tbl<\/i>. See groff_hdtbl<\/b>(7).<\/p>\n files written for the graphical grap<\/b> processor.<\/p>\n for including gremlin<\/b>(1), pictures, see grn<\/b>(1).<\/p>\n transform this file with pdfroff<\/b> of the groff<\/i> system<\/p>\n This document was written by Bernd Warken<\/a>.<\/p>\n History and future<\/p>\n roff<\/b>(7), man\u2212pages<\/b>(7), groff_diff<\/b>(7), groff<\/b>(7)<\/p>\n Compression<\/i><\/p>\n uncompress<\/b>(1posix), gzip2<\/b>(1), bzip2<\/b>(1), xz<\/b>(1)<\/p>\n A man page of the naming form name<\/i>(<\/b>n<\/i>)<\/b> can be read in text mode by<\/p>\n man<\/b> n name<\/i><\/p>\n or in graphical mode (PDF) by<\/p>\n groffer<\/b> n name<\/i><\/p>\n
DESCRIPTION<\/a>
COMPRESSION OF ROFF FILES<\/a>
MAN PAGES<\/a>
TRADITIONAL TROFF EXTENSIONS<\/a>
NEW GROFF EXTENSIONS<\/a>
AUTHORS<\/a>
SEE ALSO<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
DESCRIPTION <\/a> <\/h2>\n
COMPRESSION OF ROFF FILES <\/a> <\/h2>\n
MAN PAGES <\/a> <\/h2>\n
The traditional man page <\/p>\n
The
groff.1<\/b><\/p>\n
There are 2 roff<\/i> languages for writing man pages: man<\/b> and mdoc<\/b>.<\/p>\n
TRADITIONAL TROFF EXTENSIONS <\/a> <\/h2>\n
The classical roff<\/i> languages were interpreted by the traditional troff<\/b> and nroff<\/b> programs.<\/p>\n
In traditional roff<\/i> the source code for the macro packages was stored in TMAC<\/i> files. Their file names have the form:
tmac.<\/b>
Moreover, the following preprocessors<\/i> were used as filename extension:
NEW GROFF EXTENSIONS <\/a> <\/h2>\n
As the classical form tmac.<\/b>
m<\/b>
groff_m<\/b>
Groff<\/i> uses the following new macro packages:
AUTHORS <\/a> <\/h2>\n
SEE ALSO <\/a> <\/h2>\n