What is MIME type "application/x-troff-man"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

application/x-troff-man is a MIME type for Unix manual pages written in roff languages such as troff, nroff, or groff. It marks files that contain unformatted source text for system documentation. These files are later processed by text-formatting tools to present the documentation on-screen in a readable format.

Main use: Display command and system manuals in Unix systems.
Key fact: The source text is written in a markup language that is converted to formatted output at display time.
Application: Provides on-demand help and technical info without storing fully preformatted pages.

Manual pages use file names with extensions like MAN, MS, TR, T, ME, and ROFF. They also appear in numbered sections such as 1, 2, 3, 5, and 8.

For a deeper dive into manual pages, check out this reference.

Associated file extensions

.1, .2, .3, .5, .8, .4, .6, .man, .ms, .7, .tr, .t, .me, .roff

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: application/x-troff-man

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="application/x-troff-man">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'application/x-troff-man');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.1, .2, .3, .5, .8, .4, .6, .man, .ms, .7, .tr, .t, .me, .roff

FAQs

What is the application/x-troff-man MIME type used for?

This MIME type identifies source files for Unix manual pages, commonly known as man pages. These files contain text marked up with roff macros (such as groff or nroff) which the system formats into readable documentation when you run the man command.

Why do these files often have numbered extensions like .1 or .5?

The numbers correspond to specific sections of the Unix manual. For instance, a file ending in .1 describes user commands, while .5 describes file formats. The MIME type application/x-troff-man applies to all these numbered extensions.

Can I view application/x-troff-man files in a web browser?

No, standard web browsers (Chrome, Firefox, Edge) cannot render troff formatting natively. If you navigate to such a file, the browser will likely ask you to download it. To display them on the web, they are usually converted to HTML using tools like man2html.

How do I configure Apache to serve man pages correctly?

You can map the MIME type to the relevant extensions in your .htaccess or httpd.conf file. Add the line: AddType application/x-troff-man .man .1 .2 .3 .4 .5 .6 .7 .8 to ensure browsers recognize the file type correctly.

How do I open these files on Windows?

Since Windows does not have a native man command, you can open the files in a text editor like Notepad++ or VS Code. You will see the raw source code with formatting macros rather than the final layout. Alternatively, use WSL to view them natively.

How can I convert an application/x-troff-man file to PDF?

You can use the groff utility found on most Linux and macOS systems. Run the command groff -man -Tpdf filename.1 > output.pdf to process the source text and generate a standard PDF document.

Is application/x-troff-man the same as text/troff?

They are closely related but distinct. application/x-troff-man specifically indicates files using the man macro package for documentation. The generic text/troff or application/x-troff might imply other macro sets like ms or me, which are used for general typesetting.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.