eqn (software)

Part of the troff suite of Unix document layout tools, eqn is a preprocessor that formats equations for printing. A similar program, neqn, accepted the same input as eqn, but produced output tuned to look better in nroff. The eqn program was created in 1974 by Brian Kernighan and Lorinda Cherry. It was implemented using yacc compiler-compiler.[1]

Original author(s)Brian Kernighan,
Lorinda Cherry
Developer(s)AT&T Bell Laboratories
Initial releaseJune 1974; 46 years ago (1974-06)
Operating systemUnix, Unix-like

The input language used by eqn allows the user to write mathematical expressions in much the same way as they would be spoken aloud. The language is defined by a context-free grammar, together with operator precedence and operator associativity rules. The eqn language is similar to the mathematical component of TeX, which appeared several years later, but is simpler and less complete.

An independent compatible implementation of the eqn preprocessor has been developed by GNU as part of groff, the GNU version of troff. The GNU implementation extends the original language by adding a number of new keywords such as smallover and accent. mandoc, a specialised compiler for UNIX man pages, also contains a standalone eqn parser/formatter.

Syntax examplesEdit

Here is how some examples[citation needed] would be written in eqn (with equivalents in TeX for comparison):

TeX eqn formula
a^2 a sup 2  
\sum_{k=1}^N k^2 sum from { k = 1 } to N { k sup 2 }  
x = {-b \pm \sqrt{b^2 - 4ac} \over 2a} x={-b +- sqrt{b sup 2 - 4ac}} over 2a  

Spaces are important in eqn; tokens are delimited only by whitespace characters, tildes ~, braces {} and double-quotes "". Thus f(pi r sup 2) results in  , whereas f( pi r sup 2 ) is needed to give the intended  .


  1. ^ "UNIX Special: Profs Kernighan & Brailsford". Computerphile. September 30, 2015.


External linksEdit