=================================================================== RCS file: /cvs/mandoc/eqn.7,v retrieving revision 1.23 retrieving revision 1.30 diff -u -p -r1.23 -r1.30 --- mandoc/eqn.7 2011/07/23 18:41:18 1.23 +++ mandoc/eqn.7 2014/10/10 08:44:24 1.30 @@ -1,4 +1,4 @@ -.\" $Id: eqn.7,v 1.23 2011/07/23 18:41:18 kristaps Exp $ +.\" $Id: eqn.7,v 1.30 2014/10/10 08:44:24 kristaps Exp $ .\" .\" Copyright (c) 2011 Kristaps Dzonsons .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: July 23 2011 $ +.Dd $Mdocdate: October 10 2014 $ .Dt EQN 7 .Os .Sh NAME @@ -23,18 +23,21 @@ .Sh DESCRIPTION The .Nm eqn -language is a equation-formatting language. +language is an equation-formatting language. It is used within .Xr mdoc 7 and .Xr man 7 .Ux manual pages. +It describes the +.Em structure +of an equation, not its mathematical meaning. This manual describes the .Nm language accepted by the .Xr mandoc 1 -utility, which correspond to the Second Edition eqn specification (see +utility, which corresponds to the Second Edition eqn specification (see .Sx SEE ALSO for references). .Pp @@ -72,7 +75,6 @@ box : text | \*qtdefine\*q text text | \*qgfont\*q text | \*qgsize\*q text - | \*qset\*q text text | \*qundef\*q text | box pos box | box mark @@ -81,9 +83,9 @@ box : text | font box | \*qsize\*q text box | \*qleft\*q text eqn [\*qright\*q text] -col : \*qlcol\*q | \*qrcol\*q | \*qccol\*q +col : \*qlcol\*q | \*qrcol\*q | \*qccol\*q | \*qcol\*q text : [^space\e\*q]+ | \e\*q.*\e\*q -pile : \*qlpile\*q | \*qcpile\*q | \*qrpile\*q +pile : \*qlpile\*q | \*qcpile\*q | \*qrpile\*q | \*qpile\*q pos : \*qover\*q | \*qsup\*q | \*qsub\*q | \*qto\*q | \*qfrom\*q mark : \*qdot\*q | \*qdotdot\*q | \*qhat\*q | \*qtilde\*q | \*qvec\*q | \*qdyad\*q | \*qbar\*q | \*qunder\*q @@ -114,7 +116,7 @@ partial (partial differential), inf (infinity), >> (mu The following control statements are available: .Bl -tag -width Ds .It Cm define -Replace all occurances of a key with a value. +Replace all occurrences of a key with a value. Its syntax is as follows: .Pp .D1 define Ar key cvalc @@ -129,7 +131,8 @@ This allows for arbitrary enclosure of terms (not just .D1 define Ar foo cbar bazc .Pp It is an error to have an empty -.Ar key or +.Ar key +or .Ar val . Note that a quoted .Ar key @@ -184,6 +187,7 @@ The and .Ar val are not expanded for replacements. +This statement is a GNU extension. .It Cm undef Unset a previously-defined key. Its syntax is as follows: @@ -196,6 +200,7 @@ is discarded. The .Ar key is not expanded for replacements. +This statement is a GNU extension. .El .Sh COMPATIBILITY This section documents the compatibility of mandoc @@ -270,4 +275,4 @@ was added in 2011. This .Nm reference was written by -.An Kristaps Dzonsons Aq kristaps@bsd.lv . +.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .