From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from localhost (fantadrom.bsd.lv [local]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTPA id 7871af48 for ; Mon, 31 Dec 2018 22:46:00 -0500 (EST) Date: Mon, 31 Dec 2018 22:46:00 -0500 (EST) X-Mailinglist: mandoc-source Reply-To: source@mandoc.bsd.lv MIME-Version: 1.0 From: schwarze@mandoc.bsd.lv To: source@mandoc.bsd.lv Subject: mandoc: Now that .nf and .fi are implemented in the roff(7) parser and X-Mailer: activitymail 1.26, http://search.cpan.org/dist/activitymail/ Content-Type: text/plain; charset=utf-8 Message-ID: <05f88e3d7d7150ea@fantadrom.bsd.lv> Log Message: ----------- Now that .nf and .fi are implemented in the roff(7) parser and formatters rather than in the man(7) parser and formatters, document them in the roff(7) manual, where they belong, rather than in the man(7) manual. Mention that they imply an output line break, and mention which macros imply these requests. Modified Files: -------------- mandoc: man.7 roff.7 Revision Data ------------- Index: man.7 =================================================================== RCS file: /home/cvs/mandoc/mandoc/man.7,v retrieving revision 1.141 retrieving revision 1.142 diff -Lman.7 -Lman.7 -u -p -r1.141 -r1.142 --- man.7 +++ man.7 @@ -1,7 +1,7 @@ .\" $Id$ .\" .\" Copyright (c) 2009, 2010, 2011, 2012 Kristaps Dzonsons -.\" Copyright (c) 2011-2015, 2017, 2018 Ingo Schwarze +.\" Copyright (c) 2011-2015,2017,2018,2019 Ingo Schwarze .\" Copyright (c) 2017 Anthony Bentley .\" Copyright (c) 2010 Joerg Sonnenberger .\" @@ -101,7 +101,6 @@ but can be found in the alphabetical ref .It Sx IP Ta indented paragraph: Op Ar head Op Ar width .It Sx TP Ta tagged paragraph: Op Ar width .It Sx PD Ta set vertical paragraph distance: Op Ar height -.It Sx fi , nf Ta fill mode and no-fill mode (no arguments) .It Sx in Ta additional indent: Op Ar width .El .Ss Physical markup @@ -163,14 +162,18 @@ request. This is a non-standard GNU extension. In .Xr mandoc 1 , -it does the same as -.Sx \&fi . +it does the same as the +.Xr roff 7 +.Sx \&fi +request (switch to fill mode). .Ss \&EX This is a non-standard GNU extension. In .Xr mandoc 1 , -it does the same as -.Sx \&nf . +it does the same as the +.Xr roff 7 +.Ic \&nf +request (switch to no-fill mode). .Ss \&HP Begin a paragraph whose initial output line is left-justified, but subsequent output lines are indented, with the following syntax: @@ -459,9 +462,6 @@ link description to be shown End a synopsis block started with .Sx \&SY . This is a non-standard GNU extension. -.Ss \&fi -End literal mode started with -.Sx \&nf . .Ss \&in Indent relative to the current indentation: .Pp @@ -472,15 +472,6 @@ If is signed, the new offset is relative. Otherwise, it is absolute. This value is reset upon the next paragraph, section, or sub-section. -.Ss \&nf -Begin literal mode: all subsequent free-form lines have their end of -line boundaries preserved. -May be ended by -.Sx \&fi . -Literal mode is implicitly ended by -.Sx \&SH -or -.Sx \&SS . .Sh MACRO SYNTAX The .Nm @@ -531,9 +522,7 @@ The syntax is as follows: .It Sx \&SM Ta n Ta next-line Ta \& .It Sx \&TH Ta >1, <6 Ta current Ta \& .It Sx \&UC Ta <=1 Ta current Ta \& -.It Sx \&fi Ta 0 Ta current Ta Xr roff 7 .It Sx \&in Ta 1 Ta current Ta Xr roff 7 -.It Sx \&nf Ta 0 Ta current Ta Xr roff 7 .El .Ss Block Macros Block macros comprise a head and body. Index: roff.7 =================================================================== RCS file: /home/cvs/mandoc/mandoc/roff.7,v retrieving revision 1.110 retrieving revision 1.111 diff -Lroff.7 -Lroff.7 -u -p -r1.110 -r1.111 --- roff.7 +++ roff.7 @@ -1,7 +1,7 @@ .\" $Id$ .\" .\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons -.\" Copyright (c) 2010-2018 Ingo Schwarze +.\" Copyright (c) 2010-2019 Ingo Schwarze .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above @@ -908,11 +908,23 @@ This is a Heirloom extension and current Enable or disable an OpenType feature. This is a Heirloom extension and currently ignored. .It Ic \&fi -Switch to fill mode. -See -.Xr man 7 . -Ignored in -.Xr mdoc 7 . +Break the output line and switch to fill mode, +which is active by default but can be ended with the +.Ic \&nf +request. +In fill mode, input from subsequent input lines is added to +the same output line until the next word no longer fits, +at which point the output line is broken. +This request is implied by the +.Xr mdoc 7 +.Ic \&Sh +macro and by the +.Xr man 7 +.Ic \&SH , +.Ic \&SS , +and +.Ic \&EE +macros. .It Ic \&fkern Ar font minkern Control the use of kerning tables for a font. This is a Heirloom extension and currently ignored. @@ -1347,11 +1359,22 @@ Declare the need for the specified minim before the next trap or the bottom of the page. Currently ignored. .It Ic \&nf -Switch to no-fill mode. -See -.Xr man 7 . -Ignored by -.Xr mdoc 7 . +Break the output line and switch to no-fill mode. +Subsequent input lines are kept together on the same output line +even when exceeding the right margin, +and line breaks in subsequent input cause output line breaks. +This request is implied by the +.Xr mdoc 7 +.Ic \&Bd Fl unfilled +and +.Ic \&Bd Fl literal +macros and by the +.Xr man 7 +.Ic \&EX +macro. +The +.Ic \&fi +request switches back to the default fill mode. .It Ic \&nh Turn off automatic hyphenation mode. Currently ignored. -- To unsubscribe send an email to source+unsubscribe@mandoc.bsd.lv