=================================================================== RCS file: /cvs/mandoc/roff.7,v retrieving revision 1.55 retrieving revision 1.62 diff -u -p -r1.55 -r1.62 --- mandoc/roff.7 2014/07/07 11:35:06 1.55 +++ mandoc/roff.7 2015/01/20 19:39:34 1.62 @@ -1,4 +1,4 @@ -.\" $Id: roff.7,v 1.55 2014/07/07 11:35:06 schwarze Exp $ +.\" $Id: roff.7,v 1.62 2015/01/20 19:39:34 schwarze Exp $ .\" .\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons .\" Copyright (c) 2010, 2011, 2013, 2014 Ingo Schwarze @@ -15,7 +15,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 7 2014 $ +.Dd $Mdocdate: January 20 2015 $ .Dt ROFF 7 .Os .Sh NAME @@ -239,8 +239,9 @@ pica (~1/6 inch) .It p point (~1/72 inch) .It f -synonym for +scale .Sq u +by 65536 .It v default vertical span .It m @@ -254,7 +255,7 @@ width of rendered .Pq en character .It u -default horizontal span +default horizontal span for the terminal .It M mini-em (~1/100 em) .El @@ -262,7 +263,6 @@ mini-em (~1/100 em) Using anything other than .Sq m , .Sq n , -.Sq u , or .Sq v is necessarily non-portable across output media. @@ -402,7 +402,7 @@ language defines many more requests not implemented in .Ss \&ad Set line adjustment mode. This line-scoped request is intended to have one argument to select -normal, left, right, or centre adjustment for subsequent text. +normal, left, right, or center adjustment for subsequent text. Currently, it is ignored including its arguments, and the number of arguments is not checked. .Ss \&am @@ -543,8 +543,10 @@ one explicit newline character. In order to prevent endless recursion, both groff and .Xr mandoc 1 limit the stack depth for expanding macros and strings -to a large, but finite number. -Do not rely on the exact value of this limit. +to a large, but finite number, and +.Xr mandoc 1 +also limits the length of the expanded input line. +Do not rely on the exact values of these limits. .Ss \&dei Define a .Nm @@ -747,16 +749,18 @@ If the first character of COND is .Pq even page , .Sq r .Pq register accessed , -or .Sq t .Pq troff mode , +or +.Sq v +.Pq vroff mode , COND evaluates to false. .It If COND starts with a parenthesis or with an optionally signed integer number, it is evaluated according to the rules of .Sx Numerical expressions explained below. -It evaluates to true if the the result is positive, +It evaluates to true if the result is positive, or to false if the result is zero or negative. .It Otherwise, the first character of COND is regarded as a delimiter @@ -935,6 +939,11 @@ Turn on no-space mode. This line-scoped request is intended to take no arguments. Currently, it is ignored including its arguments, and the number of arguments is not checked. +.Ss \&pl +Change page length. +This line-scoped request is intended to take one height argument. +Currently, it is ignored including its arguments, +and the number of arguments is not checked. .Ss \&ps Change point size. This line-scoped request is intended to take one numerical argument. @@ -1189,8 +1198,10 @@ Bracket building function; ignored by .Sx Special Characters with names of arbitrary length. .Ss \ec -Interrupt text processing to insert requests or macros; ignored by -.Xr mandoc 1 . +When encountered at the end of an input text line, +the next input text line is considered to continue that line, +even if there are request or macro lines in between. +No whitespace is inserted. .Ss \eD\(aq Ns Ar string Ns \(aq Draw graphics function; ignored by .Xr mandoc 1 . @@ -1347,6 +1358,12 @@ The term refers to groff version 1.15. .Pp .Bl -dash -compact +.It +The +.Sq u +scaling unit is the default terminal unit. +In traditional troff systems, this unit would change depending on the +output media. .It In mandoc, the .Sx \&EQ ,