|GROFF_FILENAMES(5)||File Formats Manual||GROFF_FILENAMES(5)|
The roff extensions refer to preprocessors or macro packages. These extensions are fixed in all Unix-like operating systems.
Later on, groff added some more extensions. This man page is about these filename extensions.
Best-known are the compressor extensions .Z, .gz, and .bzip2. Relatively new is .xz.
From now on, we will ignore the compressions and only comment the structure <name>.<extension>.
The extensions for man should be better documented. So this is documented here.
Files written in the man language use the following extension: *.<section>[<group>].
- Classic man page sections.
In older commercial Unix systems, the 3 characters l, n, and o were also used as section names. This is today deprecated, but there are still documents in this format.
- Deprecated man page sections, which stood for “local”, “new”, and “old”, respectively.
- is the man page for groff in section 1 without a group
- is the man page for the program xargs in section 1 and group posix; moreover it is compressed with gz (gzip).
- OpenSSL CONF library configuration files from section 5 with group ssl.
- man page for the program dpkg-reconfigure in section 8 and group cdebconf.
The names of these 2 styles are taken as extensions for the source code files of man pages in the groff package.
- traditional Unix-like man page format within groff source files.
- A temporary man page file produced from a name.man man page by a run of make within the groff source package.
- Man page format in BSD.
- Man page format in heirloom roff .
- Files using this extension recognize both man page formats in groff and other processors.
There were several roff languages, each represented by a macro-package. Each of these provided a suitable file name extension:
- roff file using the me macro package.
- roff file using the mm macro package
- roff file using the ms macro package
All of these classical roff languages and their extensions are still very active in groff.
- <package> is the name of the macro package without the leading m character, which is reintegrated by the option -m.
For example, tmac.an is the source for the man macro package.
In the groff source, more suitable file names were integrated, see later on.
- for the integration of chemical formulas
- for the mathematical use of equations
- graphical tool
- for tables with tbl
- for files using the prefer preprocessor
- for files using the roff language of any kind
- general ending for files using the groff language
- file with swedish mm macros for groff
- files written in the groff macro package mom
- files written in HTML-like groff macros.
- History and future
- roff(7), man-pages(7), groff_diff(7), groff(7)
- uncompress(1posix), gzip2(1), bzip2(1), xz(1)
A man page of the naming form name(n) can be read in text mode by
man n name
groffer n name
Gunnar Ritter's Heirloom roff project. You can get this package with the shell command:
$ git clone https://github.com/n-t-roff/heirloom-doctools
|21 June 2021||groff 1.22.4|