I am resubmitting this patch, which I have regenerated against the latest groff source. It changes only three documentation files, no code.
The rationale of the patch is in a post to the groff list, archived at http://lists.gnu.org/archive/html/groff/2011-07/msg00032.html The original patch file I submitted (http://lists.gnu.org/archive/html/groff/2011-12/msg00053.html) was malformed, due to my cut and paste turning some tab characters into strings of spaces. As Werner's energies have been focused elsewhere recently, low-priority groff patches were not being applied for a while, so there seemed little point in submitting this patch correction/update before. From a recent post, it appears now that Bernd Warken has taken up applying documentation patches. So I am resubmitting this one, and have a few other documentation corrections to make in the next few days as well. Thank you.
--- doc/meintro.me.orig 2004-06-12 08:24:08.000000000 -0500 +++ doc/meintro.me 2011-12-26 04:42:27.000000000 -0600 @@ -456,6 +456,14 @@ .q "My thoughts on the subject" , followed by a single blank line. .pp +This request will not leave space at the top of a page. +If you need the requested space to appear regardless of page position, +use the +.b .bl +macro, which has the same syntax as +.b .sp +but always leaves the requested space, even at the top of a page. +.pp The .b .in \ \c .i +N --- doc/meref.me.orig 2011-07-20 13:44:50.000000000 -0500 +++ doc/meref.me 2013-11-12 00:41:17.000000000 -0600 @@ -1298,7 +1298,7 @@ contiguous white space, on the next page if not enough room on this page. -Equivalent to a +Equivalent to putting a .b .sp .i N inside a block. @@ -2088,7 +2088,7 @@ \&.bc M begin new column \&.bi M bold italic \en(bi R display (block) indent -\&.bl M blank lines (even at top of page) +\&.bl M blank lines (even at top of page, in contrast to .sp) \en(bm R bottom title margin \&.bp M\(sc begin page \&.br M\(sc break (start new line) @@ -2198,7 +2198,7 @@ \&.sm M set argument in a smaller pointsize \&.so M\(sc source input file \en(so R additional section title offset -\&.sp M\(sc vertical space +\&.sp M\(sc vertical space (except at top of page, in contrast to .bl) \en(sp R section title pointsize \en(ss R section prespace \&.sx M change section depth --- tmac/groff_me.man.orig 2012-08-08 17:48:50.000000000 -0500 +++ tmac/groff_me.man 2013-11-11 23:45:54.000000000 -0600 @@ -45,7 +45,7 @@ Many .I troff requests are unsafe in conjunction with -this package, however, these requests may be used with +this package; however, these requests may be used with impunity after the first .pp: .TS l l. @@ -58,6 +58,9 @@ \&.ul n underline next n lines .TE .PP +Unlike its default behavior, under the -me macros +the .sp request will not put space at the top of a page. +.PP Output of the .I pic, .I eqn,
_______________________________________________ bug-groff mailing list [email protected] https://lists.gnu.org/mailman/listinfo/bug-groff
