From MAILER-DAEMON Sun Jan 01 10:34:11 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RhNQJ-0007dK-Q7
	for mharc-groff@gnu.org; Sun, 01 Jan 2012 10:34:11 -0500
Received: from eggs.gnu.org ([140.186.70.92]:48652)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RhNQH-0007bM-EB
	for groff@gnu.org; Sun, 01 Jan 2012 10:34:10 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RhNQG-0008Pb-5O
	for groff@gnu.org; Sun, 01 Jan 2012 10:34:09 -0500
Received: from helix.usm.uni-muenchen.de ([129.187.204.86]:49629)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RhNQF-0008Og-U3
	for groff@gnu.org; Sun, 01 Jan 2012 10:34:08 -0500
Received: by helix.usm.uni-muenchen.de (Postfix, from userid 2097)
	id 4A4691613051; Sun,  1 Jan 2012 16:34:04 +0100 (CET)
Date: Sun, 1 Jan 2012 16:34:04 +0100
From: Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
To: groff@gnu.org
Message-ID: <20120101153404.GA8712@usm.uni-muenchen.de>
References: <CACRhBXMWyANQajAyJ2h+XoFs5ZANUTiRhGV3BJE5EA7fjEwfjQ@mail.gmail.com>
	<20111230134737.GA1934@usm.uni-muenchen.de>
	<CACRhBXMppmiKSvfQ5c8E7t0qL0+D63fzLfSQbT2GTYUVMU7AkA@mail.gmail.com>
	<CACRhBXPnwuu2qV26RAapEBrsDUXae=aTkGSzXSYXnKPMN1_=5w@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <CACRhBXPnwuu2qV26RAapEBrsDUXae=aTkGSzXSYXnKPMN1_=5w@mail.gmail.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 129.187.204.86
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 01 Jan 2012 15:34:10 -0000



> I would say this part /is/ a bug, since the whole point of
> using the .bl macro, instead of .sp, is that .bl should work
> even when no-space mode is active.
> More specifically, while .bl's documentation doesn't
> explicitly claim to override no-space mode, it does say that
> it works at the top of a page,

If you take a look at how "bl" is defined,

  .de bl
  .br
  .ne \\$1
  .rs
  .sp \\$1
  ..

you can see that it does: the "ne" checks whether the requested
amount of space is still available on the current page.  If it
isn't, this triggers a new page, and the "rs" restores spacing,
to guard against the case that the page header macro has turned
spacing off.  Then the requested amount of space is output.

> which is precisely what it is failing to do here.  And it
> seems to me that altering .bl to ignore no-space mode in
> other contexts wouldn't violate its documented behavior.

As you see above, "bl" already does what you are wanting it
to do.  The problem in your example is that you are using
"bl" inside a diversion (in "(c"), and once "(c" has processed
your text, the "bl" is gone, and there's not much "bl" can do
about that.  Only the space itself remains in the diversion,
and that will be ignored if no-space mode is in effect at
the time the diversion is output.


> [...]
> This can be transformed into an example that doesn't work
> by removing both lines of the magical sentence (leaving
> only "Here is text" in the second paragraph).

This behavior is, unfortunately, due to perhaps the biggest
design weakness in troff: a trap is sprung *after* stuff is
output that reaches beyond the trap position, not before.
So what happens is that the space *is* output (at the bottom
of the page, only you don't see it because it is empty),
which springs the page-bottom trap, and output continues on
the next page with "center me".  Nothing actually gets lost,
although the result may not be what you intended.
(In your working example, it's the "magic" text which springs
the page-bottom trap, so output continues on the next page
with the space.)

Fortunately, you can fix the problem in the same way as before:

  .bl 49
  .pp
  Here is text.
  .pp
  Here is text.
  .(c
  \!.ne 20
  \!.rs
  .bl 20
  center me
  .bl 20
  .)c
  .pp
  Here is text.

You could instead patch "bl" to do this itself, then the
guard against the page header macro's no-space mode will
survive one level of diversion:

  .de bl
  .br
  .ne \\$1
  \!.ne \\$1
  .rs
  \!.rs
  .sp \\$1
  ..

If you're planning to use "bl" inside more deeply
nested diversions, you might think of using a recursive
request-embedding mechanism.




From MAILER-DAEMON Mon Jan 02 06:24:54 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rhg0c-0007NP-Hq
	for mharc-groff@gnu.org; Mon, 02 Jan 2012 06:24:54 -0500
Received: from eggs.gnu.org ([140.186.70.92]:58458)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1Rhg0a-0007NH-R2
	for groff@gnu.org; Mon, 02 Jan 2012 06:24:53 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1Rhg0a-0006HO-29
	for groff@gnu.org; Mon, 02 Jan 2012 06:24:52 -0500
Received: from helix.usm.uni-muenchen.de ([129.187.204.86]:33727)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1Rhg0Z-0006H0-Tg
	for groff@gnu.org; Mon, 02 Jan 2012 06:24:52 -0500
Received: by helix.usm.uni-muenchen.de (Postfix, from userid 2097)
	id CB4871613051; Mon,  2 Jan 2012 12:24:49 +0100 (CET)
Date: Mon, 2 Jan 2012 12:24:49 +0100
From: Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
To: groff@gnu.org
Message-ID: <20120102112449.GA23433@usm.uni-muenchen.de>
References: <CACRhBXMWyANQajAyJ2h+XoFs5ZANUTiRhGV3BJE5EA7fjEwfjQ@mail.gmail.com>
	<20111230134737.GA1934@usm.uni-muenchen.de>
	<CACRhBXMppmiKSvfQ5c8E7t0qL0+D63fzLfSQbT2GTYUVMU7AkA@mail.gmail.com>
	<CACRhBXPnwuu2qV26RAapEBrsDUXae=aTkGSzXSYXnKPMN1_=5w@mail.gmail.com>
	<20120101153404.GA8712@usm.uni-muenchen.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20120101153404.GA8712@usm.uni-muenchen.de>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 129.187.204.86
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 02 Jan 2012 11:24:53 -0000



> You could instead patch "bl" to do this itself [...]

I just noticed that we have to restrict embedding of macros to
non-top-level diversions only, because whatever is embedded at
the top level is passed on to the postprocessor, which in this
case (understandably) complains that it doesn't understand what
it is getting.  So here's a better solution:

  .de bl
  .br
  .@s \\$1
  .sp \\$1
  ..
  .de @s
  .ne \\$1
  .rs
  .if !'\\n(.z'' \!.@s \\$1
  ..

The idea of this is that the space-testing macro "@s"
recursively embeds itself in diversion after diversion,
until the diversion is finally output to the page (the
top-level diversion).




From MAILER-DAEMON Mon Jan 02 07:19:34 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RhgrW-0007fP-Qn
	for mharc-groff@gnu.org; Mon, 02 Jan 2012 07:19:34 -0500
Received: from eggs.gnu.org ([140.186.70.92]:44869)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kristaps@bsd.lv>) id 1RhgrT-0007ds-I3
	for groff@gnu.org; Mon, 02 Jan 2012 07:19:32 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <kristaps@bsd.lv>) id 1RhgrS-00062h-5d
	for groff@gnu.org; Mon, 02 Jan 2012 07:19:31 -0500
Received: from smtp-2.sys.kth.se ([130.237.32.160]:57852)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kristaps@bsd.lv>) id 1RhgrR-00061z-Sb
	for groff@gnu.org; Mon, 02 Jan 2012 07:19:30 -0500
Received: from mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91])
	by smtp-2.sys.kth.se (Postfix) with ESMTP id A58EB14EA15;
	Mon,  2 Jan 2012 13:19:27 +0100 (CET)
X-Virus-Scanned: by amavisd-new at kth.se
Received: from smtp-2.sys.kth.se ([130.237.32.160])
	by mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91])
	(amavisd-new, port 10024)
	with LMTP id mC3vCTPe-PqE; Mon,  2 Jan 2012 13:19:26 +0100 (CET)
X-KTH-Auth: kristaps [193.10.49.5]
X-KTH-mail-from: kristaps@bsd.lv
Received: from ctime.hhs.se (ctime.hhs.se [193.10.49.5])
	by smtp-2.sys.kth.se (Postfix) with ESMTP id 517E614DC54;
	Mon,  2 Jan 2012 13:19:21 +0100 (CET)
Message-ID: <4F01A0C9.5040504@bsd.lv>
Date: Mon, 02 Jan 2012 13:19:21 +0100
From: Kristaps Dzonsons <kristaps@bsd.lv>
User-Agent: Mozilla/5.0 (X11; OpenBSD amd64;
	rv:5.0) Gecko/20110805 Thunderbird/5.0
MIME-Version: 1.0
To: groff@gnu.org
Content-Type: multipart/mixed; boundary="------------060104010205020908050601"
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6, seldom 2.4 (older,
	4)
X-Received-From: 130.237.32.160
Cc: uqs@spoerlein.net
Subject: [Groff] ISO/IEC 9899:2011
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 02 Jan 2012 12:19:32 -0000

This is a multi-part message in MIME format.
--------------060104010205020908050601
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

Hello,

The enclosed patch accepts `-isoC-2011' to print the now-official 
standard name, ISO/IEC 9899:2011, for mdoc.  If it looks alright, I'll 
update mandoc(1) similarly.

Note that this uses `-isoC-2011' instead of `-isoC-11'.  Maybe this is 
confusing, but I drew from how POSIX symbols increment from two to four 
digits when spanning 2000 (e.g. `-p1003.1-96' to `-p1003.1-2001'). 
Sound reasonable?

Thanks!

Kristaps

--------------060104010205020908050601
Content-Type: text/plain;
 name="groff-c11.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="groff-c11.diff"

Index: doc-syms
===================================================================
RCS file: /sources/groff/groff/tmac/doc-syms,v
retrieving revision 1.21
diff -u -p -r1.21 doc-syms
--- doc-syms	29 Oct 2011 16:44:31 -0000	1.21
+++ doc-syms	2 Jan 2012 12:10:13 -0000
@@ -605,6 +605,8 @@
 .ds doc-str-St--isoC           \*[doc-Tn-font-size]ISO/IEC\*[doc-str-St] 9899:1990
 .as doc-str-St--isoC           " (\*[Lq]\*[doc-Tn-font-size]ISO\~C\^90\*[doc-str-St]\*[Rq])
 .als doc-str-St--isoC-90 doc-str-St--isoC
+.ds doc-str-St--isoC-2011      \*[doc-Tn-font-size]ISO/IEC\*[doc-str-St] 9899:2011
+.as doc-str-St--isoC-2011      " (\*[Lq]\*[doc-Tn-font-size]ISO\~C\^11\*[doc-str-St]\*[Rq])
 .ds doc-str-St--isoC-99        \*[doc-Tn-font-size]ISO/IEC\*[doc-str-St] 9899:1999
 .as doc-str-St--isoC-99        " (\*[Lq]\*[doc-Tn-font-size]ISO\~C\^99\*[doc-str-St]\*[Rq])
 .ds doc-str-St--isoC-amd1       \*[doc-Tn-font-size]ISO/IEC\*[doc-str-St] 9899/AMD1:1995
Index: groff_mdoc.man
===================================================================
RCS file: /sources/groff/groff/tmac/groff_mdoc.man,v
retrieving revision 1.55
diff -u -p -r1.55 groff_mdoc.man
--- groff_mdoc.man	29 Oct 2011 16:44:31 -0000	1.55
+++ groff_mdoc.man	2 Jan 2012 12:10:13 -0000
@@ -2036,6 +2036,8 @@ are:
 .St -isoC-90
 .It Li \-isoC\-99
 .St -isoC-99
+.It Li \-isoC\-2011
+.St -isoC-2011
 .El
 .Pp
 .

--------------060104010205020908050601--


From MAILER-DAEMON Tue Jan 03 01:23:59 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rhxmx-00006M-3W
	for mharc-groff@gnu.org; Tue, 03 Jan 2012 01:23:59 -0500
Received: from eggs.gnu.org ([140.186.70.92]:36518)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rhxmu-0008TV-CW
	for groff@gnu.org; Tue, 03 Jan 2012 01:23:56 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rhxmt-0002M1-KO
	for groff@gnu.org; Tue, 03 Jan 2012 01:23:56 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:47115)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rhxmt-0002LV-Ag
	for groff@gnu.org; Tue, 03 Jan 2012 01:23:55 -0500
Received: (qmail invoked by alias); 03 Jan 2012 06:23:53 -0000
Received: from 178-190-207-27.adsl.highway.telekom.at (EHLO localhost)
	[178.190.207.27]
	by mail.gmx.net (mp061) with SMTP; 03 Jan 2012 07:23:53 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX18yjDxi7GkykBFKwZHfCOQYFrQYeWL8w0AqQW6ptF
	iNneszYqhOdmSq
Date: Tue, 03 Jan 2012 07:23:50 +0100 (CET)
Message-Id: <20120103.072350.365921167.wl@gnu.org>
To: kristaps@bsd.lv
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <4F01A0C9.5040504@bsd.lv>
References: <4F01A0C9.5040504@bsd.lv>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: uqs@spoerlein.net, groff@gnu.org
Subject: Re: [Groff] ISO/IEC 9899:2011
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 03 Jan 2012 06:23:57 -0000


> The enclosed patch accepts `-isoC-2011' to print the now-official
> standard name, ISO/IEC 9899:2011, for mdoc.  If it looks alright,
> I'll update mandoc(1) similarly.

Applied, thanks.


    Werner


From MAILER-DAEMON Tue Jan 03 01:35:37 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RhxyD-0000qo-Mf
	for mharc-groff@gnu.org; Tue, 03 Jan 2012 01:35:37 -0500
Received: from eggs.gnu.org ([140.186.70.92]:42229)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RhxyC-0000qg-26
	for groff@gnu.org; Tue, 03 Jan 2012 01:35:37 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RhxyA-0003sc-QU
	for groff@gnu.org; Tue, 03 Jan 2012 01:35:35 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:54416)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RhxyA-0003sU-9K
	for groff@gnu.org; Tue, 03 Jan 2012 01:35:34 -0500
Received: (qmail invoked by alias); 03 Jan 2012 06:35:32 -0000
Received: from 178-190-207-27.adsl.highway.telekom.at (EHLO localhost)
	[178.190.207.27]
	by mail.gmx.net (mp005) with SMTP; 03 Jan 2012 07:35:32 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX1+Ee7RpI6yEZ6KtDNRhmoSoA4GSUmUT76/EefB6Tp
	Ts7Q5ipGtiLzt5
Date: Tue, 03 Jan 2012 07:35:31 +0100 (CET)
Message-Id: <20120103.073531.385445159.wl@gnu.org>
To: schwarze@usta.de
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20111226222159.GP11624@iris.usta.de>
References: <20111226222159.GP11624@iris.usta.de>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 213.165.64.23
Cc: groff@gnu.org
Subject: Re: [Groff] another parallel build race failure
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 03 Jan 2012 06:35:37 -0000


> Given that font/dev and the contrib examples are in different child
> processes of the recursive make system, it doesn't seem possible to
> solve this using clean Makefile dependencies; so i fear the order
> must be enforced by splitting the shell command invoking recursive
> make in the top level Makefile.in.

Patch applied, thanks!


    Werner


From MAILER-DAEMON Tue Jan 03 01:36:56 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RhxzU-00010q-Rf
	for mharc-groff@gnu.org; Tue, 03 Jan 2012 01:36:56 -0500
Received: from eggs.gnu.org ([140.186.70.92]:42371)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RhxzS-00010k-Sh
	for groff@gnu.org; Tue, 03 Jan 2012 01:36:55 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RhxzS-0003wY-02
	for groff@gnu.org; Tue, 03 Jan 2012 01:36:54 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:41872)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RhxzR-0003wT-KQ
	for groff@gnu.org; Tue, 03 Jan 2012 01:36:53 -0500
Received: (qmail invoked by alias); 03 Jan 2012 06:36:52 -0000
Received: from 178-190-207-27.adsl.highway.telekom.at (EHLO localhost)
	[178.190.207.27]
	by mail.gmx.net (mp029) with SMTP; 03 Jan 2012 07:36:52 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX1/Puk9Js6TPjgNRK6mCWkmSwVaKii/VLEDlIOOKXT
	utnwlsUbRIJO3E
Date: Tue, 03 Jan 2012 07:36:51 +0100 (CET)
Message-Id: <20120103.073651.211674058.wl@gnu.org>
To: schwarze@usta.de
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20111226141832.GI11624@iris.usta.de>
References: <20111226141832.GI11624@iris.usta.de>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: pascal@openbsd.org, groff@gnu.org
Subject: Re: [Groff] MAKE_K_FLAG
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 03 Jan 2012 06:36:55 -0000


> Pascal Stumpf drew my attention to the fact that the following line
> in the top-level Makefile.in is causing trouble:
> 
>   MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`
> 
> The problem is that *any* k character anywhere in MAKEFLAGS, for
> example coming from something like
> 
>   make ... FOO=k ...
> 
> is mistaken for a -k flag, forcing some parts of the build to ignore
> errors even when that is not desired, making errors harder to spot.
> [...]

I've sent a mail to Bruno Haible, but I haven't received a response
yet.


    Werner


From MAILER-DAEMON Thu Jan 05 14:38:05 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rit8X-0006Wn-RF
	for mharc-groff@gnu.org; Thu, 05 Jan 2012 14:38:05 -0500
Received: from eggs.gnu.org ([140.186.70.92]:38777)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1Rit8V-0006WG-7Y
	for groff@gnu.org; Thu, 05 Jan 2012 14:38:04 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1Rit8U-000802-2d
	for groff@gnu.org; Thu, 05 Jan 2012 14:38:03 -0500
Received: from mail-ww0-f41.google.com ([74.125.82.41]:51648)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1Rit8T-0007zy-UV
	for groff@gnu.org; Thu, 05 Jan 2012 14:38:02 -0500
Received: by wgbdt12 with SMTP id dt12so1019926wgb.0
	for <groff@gnu.org>; Thu, 05 Jan 2012 11:38:00 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:content-type:content-transfer-encoding;
	bh=hXJ/l0ldkEKTE8+di/3AGEvFIRtCIZigaMFJfDPQziw=;
	b=FW7VjyBKOZKlWudu+1kUynJpA3WR3xtIve4SaBzq2JlpKUaHIbho+DBOE1p6TZ30QW
	DBIJ3lrTUnZNEFyi2m9qxRc4FVEk9jEJ/JFwtNm1XNOG8Cqf85bmoNVfXlcHBAkxZ0y1
	Xey7ayytFn8jxYCR1k6IB1OQBUuuTgbYRrO2o=
MIME-Version: 1.0
Received: by 10.180.19.130 with SMTP id f2mr2440276wie.12.1325792280536; Thu,
	05 Jan 2012 11:38:00 -0800 (PST)
Received: by 10.180.101.42 with HTTP; Thu, 5 Jan 2012 11:38:00 -0800 (PST)
In-Reply-To: <20120101153404.GA8712@usm.uni-muenchen.de>
References: <CACRhBXMWyANQajAyJ2h+XoFs5ZANUTiRhGV3BJE5EA7fjEwfjQ@mail.gmail.com>
	<20111230134737.GA1934@usm.uni-muenchen.de>
	<CACRhBXMppmiKSvfQ5c8E7t0qL0+D63fzLfSQbT2GTYUVMU7AkA@mail.gmail.com>
	<CACRhBXPnwuu2qV26RAapEBrsDUXae=aTkGSzXSYXnKPMN1_=5w@mail.gmail.com>
	<20120101153404.GA8712@usm.uni-muenchen.de>
Date: Thu, 5 Jan 2012 13:38:00 -0600
Message-ID: <CACRhBXO35_MwnF=nFWQzh7p5ZC88U3YMZdFQF-p1Gk=RYskgwQ@mail.gmail.com>
From: Dave Kemper <saint.snit@gmail.com>
To: groff@gnu.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 74.125.82.41
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 05 Jan 2012 19:38:04 -0000

On Sun, Jan 1, 2012 at 9:34 AM, Tadziu Hoffmann
<hoffmann@usm.uni-muenchen.de> wrote:
> Fortunately, you can fix the problem in the same way as before:
>
> =A0.bl 49
> =A0.pp
> =A0Here is text.
> =A0.pp
> =A0Here is text.
> =A0.(c
> =A0\!.ne 20
> =A0\!.rs
> =A0.bl 20
> =A0center me
> =A0.bl 20
> =A0.)c
> =A0.pp
> =A0Here is text.

That does get the job done.  However, knowing that you need to add
those \! lines to have things work as expected requires more knowledge
of the implementation of the -me macro set than I think is warranted.
The -me documentation doesn't specify which macros are implemented using
diversions, and the average user isn't going to read the source to figure
that out.

So, perhaps the patch to the .bl macro as in your subsequent example
ought to be applied to groff's e.tmac (maybe with a comment to explain
what is going on, though e.tmac is pretty light on comments to begin
with, and they all get stripped from the installed version anyway).
Does that seem like a reasonable change?  If so, I can go ahead and
create the patch file if you don't want to do it.

Thanks, Tadziu, for all your work on this.


From MAILER-DAEMON Thu Jan 05 15:06:35 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rita7-0006l2-O2
	for mharc-groff@gnu.org; Thu, 05 Jan 2012 15:06:35 -0500
Received: from eggs.gnu.org ([140.186.70.92]:47466)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1Rita5-0006jZ-12
	for groff@gnu.org; Thu, 05 Jan 2012 15:06:34 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1Rita4-0003nv-1E
	for groff@gnu.org; Thu, 05 Jan 2012 15:06:32 -0500
Received: from helix.usm.uni-muenchen.de ([129.187.204.86]:59283)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1Rita3-0003nZ-So
	for groff@gnu.org; Thu, 05 Jan 2012 15:06:31 -0500
Received: by helix.usm.uni-muenchen.de (Postfix, from userid 2097)
	id 1B3341613051; Thu,  5 Jan 2012 21:06:29 +0100 (CET)
Date: Thu, 5 Jan 2012 21:06:28 +0100
From: Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
To: groff@gnu.org
Message-ID: <20120105200628.GE13517@usm.uni-muenchen.de>
References: <CACRhBXMWyANQajAyJ2h+XoFs5ZANUTiRhGV3BJE5EA7fjEwfjQ@mail.gmail.com>
	<20111230134737.GA1934@usm.uni-muenchen.de>
	<CACRhBXMppmiKSvfQ5c8E7t0qL0+D63fzLfSQbT2GTYUVMU7AkA@mail.gmail.com>
	<CACRhBXPnwuu2qV26RAapEBrsDUXae=aTkGSzXSYXnKPMN1_=5w@mail.gmail.com>
	<20120101153404.GA8712@usm.uni-muenchen.de>
	<CACRhBXO35_MwnF=nFWQzh7p5ZC88U3YMZdFQF-p1Gk=RYskgwQ@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <CACRhBXO35_MwnF=nFWQzh7p5ZC88U3YMZdFQF-p1Gk=RYskgwQ@mail.gmail.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 129.187.204.86
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 05 Jan 2012 20:06:34 -0000


> So, perhaps the patch to the .bl macro as in your subsequent example
> ought to be applied to groff's e.tmac (maybe with a comment to explain
> what is going on, though e.tmac is pretty light on comments to begin
> with, and they all get stripped from the installed version anyway).
> Does that seem like a reasonable change?  If so, I can go ahead and
> create the patch file if you don't want to do it.

Is there a maintainer for the macro package?  If so, maybe the
patch should be applied upstream.  For the space-testing macro
I used a two-character name (in a style similar to other "me"
internal macros), because the "me" macros are also used with
other roffs (notably Plan 9 troff and Heirloom troff).




From MAILER-DAEMON Fri Jan 06 17:50:51 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjIcd-0002OB-79
	for mharc-groff@gnu.org; Fri, 06 Jan 2012 17:50:51 -0500
Received: from eggs.gnu.org ([140.186.70.92]:39500)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RjIca-0002KW-Kh
	for groff@gnu.org; Fri, 06 Jan 2012 17:50:49 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RjIcZ-0000An-C7
	for groff@gnu.org; Fri, 06 Jan 2012 17:50:48 -0500
Received: from scc-mailout.scc.kit.edu ([129.13.185.202]:40855)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RjIcZ-0000Ab-6F
	for groff@gnu.org; Fri, 06 Jan 2012 17:50:47 -0500
Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82])
	by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1)
	id 1RjIcW-0005rd-Th; Fri, 06 Jan 2012 23:50:44 +0100
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1RjIcW-0003gG-Sc; Fri, 06 Jan 2012 23:50:44 +0100
Received: from iris.usta.de ([172.24.96.5] helo=usta.de)
	by donnerwolke.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1RjIcW-0000F3-RY; Fri, 06 Jan 2012 23:50:44 +0100
Received: from schwarze by usta.de with local (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1RjIcW-0005k7-Qv; Fri, 06 Jan 2012 23:50:44 +0100
Date: Fri, 6 Jan 2012 23:50:44 +0100
From: Ingo Schwarze <schwarze@usta.de>
To: Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
Message-ID: <20120106225044.GO30242@iris.usta.de>
References: <CACRhBXMWyANQajAyJ2h+XoFs5ZANUTiRhGV3BJE5EA7fjEwfjQ@mail.gmail.com>
	<20111230134737.GA1934@usm.uni-muenchen.de>
	<CACRhBXMppmiKSvfQ5c8E7t0qL0+D63fzLfSQbT2GTYUVMU7AkA@mail.gmail.com>
	<CACRhBXPnwuu2qV26RAapEBrsDUXae=aTkGSzXSYXnKPMN1_=5w@mail.gmail.com>
	<20120101153404.GA8712@usm.uni-muenchen.de>
	<CACRhBXO35_MwnF=nFWQzh7p5ZC88U3YMZdFQF-p1Gk=RYskgwQ@mail.gmail.com>
	<20120105200628.GE13517@usm.uni-muenchen.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20120105200628.GE13517@usm.uni-muenchen.de>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 129.13.185.202
Cc: groff@gnu.org
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 06 Jan 2012 22:50:49 -0000

Hi Tadziu,

Tadziu Hoffmann wrote on Thu, Jan 05, 2012 at 09:06:28PM +0100:

> Is there a maintainer for the macro package?  If so, maybe the
> patch should be applied upstream.  For the space-testing macro
> I used a two-character name (in a style similar to other "me"
> internal macros), because the "me" macros are also used with
> other roffs (notably Plan 9 troff and Heirloom troff).

In case you receive no other response:

Eric Paul Allman is still alive and happily hacking:

  http://www.neophilic.com/~eric/

I doubt that he is still maintaining his e-macros personally,
but very probably he can at least tell you whether he passed on
maintenance to anybody else or knows about any distribution that
could be considered "upstream".

Yours,
  Ingo


From MAILER-DAEMON Fri Jan 06 18:32:08 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjJGa-00006N-4v
	for mharc-groff@gnu.org; Fri, 06 Jan 2012 18:32:08 -0500
Received: from eggs.gnu.org ([140.186.70.92]:42629)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1RjJGX-0008Uh-SO
	for groff@gnu.org; Fri, 06 Jan 2012 18:32:06 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1RjJGW-0006wI-Pn
	for groff@gnu.org; Fri, 06 Jan 2012 18:32:05 -0500
Received: from smtp02.frii.com ([216.17.135.168]:42046)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1RjJGW-0006wA-KF
	for groff@gnu.org; Fri, 06 Jan 2012 18:32:04 -0500
Received: from [192.168.0.100] (dsl-251-44.dynamic-dsl.frii.net
	[216.17.251.44])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by smtp02.frii.com (FRII) with ESMTP id 78662D9181
	for <groff@gnu.org>; Fri,  6 Jan 2012 16:32:02 -0700 (MST)
Message-ID: <4F078489.4000108@verinet.net>
Date: Fri, 06 Jan 2012 16:32:25 -0700
From: Clarke Echols <clarke@verinet.net>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.24) Gecko/20111109 Thunderbird/3.1.16
MIME-Version: 1.0
To: Groff <groff@gnu.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 216.17.135.168
Subject: [Groff] End-of-page macro problem at end of input file...
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 06 Jan 2012 23:32:06 -0000

I've been using some macros I wrote to produce certain types
of reports, and to print transcripts of presentations, etc.
But I've encountered a problem that puzzles me.

I set a top-of-page trap to handle the page-headings before
continuing normal content text, and a bottom-of-page trap
to set the page number (this code is contained in the
start-up macro before processing the input text file):

 >.  wh 0 set_up_page_header   \" Set top-of-page location for first line
 >.                        \" (This also happens at start of first page)
 >.                            \" Set bottom-of-page traps
 >.  wh -1i print_page_number    \"

The "set_up_page_header" macro does little other than space down to
one inch below top-of-page before processing input text.

The bottom-of-page macro spaces down .5v after the trap is sprung,
then prints the page number (centered) before beginning a new page:

 >.de print_page_number
 >.ev pr_print_pageno
 >.\"              Register `XX' is defined in the text source file:
 >.\"              XX=1 means title page which has no printed page >number.
 >.\"              XX=0 means other pages which all have printed page 
 >numbers.
 >.
 >.  if !\\n(XX \{\
 >.sp .5v
 >.  nf                        \" No fill for page number
 >.  ce 1                      \" Center page number at bottom of page
 >\(mi \\n% \(mi
 >.  fi                        \" Back to normal fill
 >\}
 >.ev
 >\}
 >'bp
 >.
 >..

If XX is non-zero, the page number is not printed, and the 'bp request
is executed.

This all works fine until I get to end-of-file.

At end of file (usually in the middle of the page somewhere), the 'bp
request kicks out a new page, and I get new top-of-page processing
plus a new bottom-of-page page number with an extra blank page at the
end instead of quitting at the bottom of the page where EOF occurred.

I know the 'bp is the cause, but don't know how to handle page
numbering at the bottom of the page while suppressing the 'bp
request after EOF is reached.  As it is now, groff ejects the page
where EOF occurs, but the 'bp in the bottom-of-page macro starts
a new page which is blank except for the page number at the bottom.

I haven't seen this problem before when using these macros, and it's
not clear to me what I should be doing differently to get the desired
end-of-page page number at the bottom of the last page, without
causing a final, extra blank page due to the 'bp.

It has to be something very simple (and very obvious), but I haven't
been able to find any documentation to explain it.

Any clues?

Thanks,

Clarke


From MAILER-DAEMON Fri Jan 06 19:26:32 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjK7E-00078h-6m
	for mharc-groff@gnu.org; Fri, 06 Jan 2012 19:26:32 -0500
Received: from eggs.gnu.org ([140.186.70.92]:32807)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sandals@crustytoothpaste.net>) id 1RjK7A-000766-Ve
	for groff@gnu.org; Fri, 06 Jan 2012 19:26:29 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <sandals@crustytoothpaste.net>) id 1RjK78-0001GR-Oo
	for groff@gnu.org; Fri, 06 Jan 2012 19:26:28 -0500
Received: from qmta11.westchester.pa.mail.comcast.net ([76.96.59.211]:39405)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sandals@crustytoothpaste.net>) id 1RjK78-0000yZ-MB
	for groff@gnu.org; Fri, 06 Jan 2012 19:26:26 -0500
Received: from omta12.westchester.pa.mail.comcast.net ([76.96.62.44])
	by QMTA11.westchester.pa.mail.comcast.net with comcast
	id JQMb1i0050xGWP85BQQ9e0; Sat, 07 Jan 2012 00:24:09 +0000
Received: from castro.crustytoothpaste.net ([98.201.104.241])
	by omta12.westchester.pa.mail.comcast.net with comcast
	id JQQ71i00W5CWozE3YQQ8Yx; Sat, 07 Jan 2012 00:24:08 +0000
Received: from crustytoothpaste.ath.cx
	([IPv6:2001:470:1f05:79:6680:99ff:fe4f:73a0]) (authenticated bits=56)
	by castro.crustytoothpaste.net (8.14.4/8.14.4/Debian-2) with ESMTP id
	q070O3SC018525
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT)
	for <groff@gnu.org>; Sat, 7 Jan 2012 00:24:05 GMT
Date: Sat, 7 Jan 2012 00:24:03 +0000
From: "brian m. carlson" <sandals@crustytoothpaste.net>
To: groff@gnu.org
Message-ID: <20120107002403.GL5411@crustytoothpaste.ath.cx>
Mail-Followup-To: groff@gnu.org
References: <CACRhBXMWyANQajAyJ2h+XoFs5ZANUTiRhGV3BJE5EA7fjEwfjQ@mail.gmail.com>
	<20111230134737.GA1934@usm.uni-muenchen.de>
	<CACRhBXMppmiKSvfQ5c8E7t0qL0+D63fzLfSQbT2GTYUVMU7AkA@mail.gmail.com>
	<CACRhBXPnwuu2qV26RAapEBrsDUXae=aTkGSzXSYXnKPMN1_=5w@mail.gmail.com>
	<20120101153404.GA8712@usm.uni-muenchen.de>
	<CACRhBXO35_MwnF=nFWQzh7p5ZC88U3YMZdFQF-p1Gk=RYskgwQ@mail.gmail.com>
	<20120105200628.GE13517@usm.uni-muenchen.de>
	<20120106225044.GO30242@iris.usta.de>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="bygAmIonOAIqBxQB"
Content-Disposition: inline
In-Reply-To: <20120106225044.GO30242@iris.usta.de>
X-No-CC: If you CC me on this list, I will feed you to Branden Robinson.
X-Machine: Running on vauxhall using GNU/Linux on x86_64 (Linux kernel
	3.1.0-1-amd64)
User-Agent: Mutt/1.5.21 (2010-09-15)
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.3.9
	(castro.crustytoothpaste.net [IPv6:2001:470:1f05:79::1]);
	Sat, 07 Jan 2012 00:24:06 +0000 (UTC)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 76.96.59.211
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 00:26:30 -0000


--bygAmIonOAIqBxQB
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Fri, Jan 06, 2012 at 11:50:44PM +0100, Ingo Schwarze wrote:
> Tadziu Hoffmann wrote on Thu, Jan 05, 2012 at 09:06:28PM +0100:
>=20
> > Is there a maintainer for the macro package?  If so, maybe the
> > patch should be applied upstream.  For the space-testing macro
> > I used a two-character name (in a style similar to other "me"
> > internal macros), because the "me" macros are also used with
> > other roffs (notably Plan 9 troff and Heirloom troff).
>=20
> In case you receive no other response:
>=20
> Eric Paul Allman is still alive and happily hacking:
>=20
>   http://www.neophilic.com/~eric/
>=20
> I doubt that he is still maintaining his e-macros personally,
> but very probably he can at least tell you whether he passed on
> maintenance to anybody else or knows about any distribution that
> could be considered "upstream".

There are two sets of the -me macros.  One is the set that is still used
on BSD systems today.  The other is the set that's part of groff that
was derived from an earlier BSD version and heavily modified.  Which one
you use depends on which system you have: BSDs use their version and
GNU/Linux systems use groff's.

--=20
brian m. carlson / brian with sandals: Houston, Texas, US
+1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only
OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187

--bygAmIonOAIqBxQB
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: Digital signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iQIcBAEBCgAGBQJPB5CjAAoJEL9TXYEfUvaLKPIP/06WZt20UfpG8KAwB2ueDOl8
zQItglMgfnYgLpessezpd2M4WWzmoWQyAVWAEbf+tDJ4KQ4ntSlYsg6tKW1UmRwP
/Bez/xS//3jTQTrFAm71rN65lcPdkE7k9Y2lkhE1VU/rkHJMyhecVGHFq0OsOSbS
nUCru4hhjuJbFCzHpXYuHA1b9Wn449/Fb6fYh/ZLeYvRpLOT9A3O6RhKD5O4agpQ
T9oxOT/XMWYdB2mMo+aWqMY0KVnR3O9/065EU31UKiEKTqUZuIQEagg6EdxKi+Ma
6muBWsZ3raO6jrzafwc9+GmY94x7NUJOU4tFrUtvOuo36LVLq3gP0bEzt8BCjV4C
7IgmbA38X3rmWskMfYYpUWuUx+Os6dii/SnODPqVFLnFLh6x8E8DYrmLALLf9M24
1YW0+LVbTonk732m6fy+/2uHK1DZQ6yReIsoC9QXzTVNpToGawj0sWsoGLj1gbAV
QhdK/GULGrBBMhZAp1QNBKkP2C0XypFSZouuP0UfxqWxlB6NjZVPfE//I959EyNg
17aMz+ebRJ25WPsP/mFqbyO7+6iCDJGIwlrO8XJJiVHeKSCvjsgQiX44WJsnImK4
9UYuscJYJ7EJBj7XgrF2Vla4W4aGfyD5Esbya8OWH4pRbffvpsmiyPSnUVz3ketY
sz1n0L3O7bhnWy9dQ051
=e+3U
-----END PGP SIGNATURE-----

--bygAmIonOAIqBxQB--


From MAILER-DAEMON Sat Jan 07 02:02:25 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjQIL-0001jw-9R
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 02:02:25 -0500
Received: from eggs.gnu.org ([140.186.70.92]:46817)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjQIJ-0001jT-2s
	for groff@gnu.org; Sat, 07 Jan 2012 02:02:23 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjQII-0007CD-7D
	for groff@gnu.org; Sat, 07 Jan 2012 02:02:22 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:60082)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjQIH-0007Bz-Sx
	for groff@gnu.org; Sat, 07 Jan 2012 02:02:22 -0500
Received: (qmail invoked by alias); 07 Jan 2012 07:02:20 -0000
Received: from 178-190-199-254.adsl.highway.telekom.at (EHLO localhost)
	[178.190.199.254]
	by mail.gmx.net (mp019) with SMTP; 07 Jan 2012 08:02:20 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX19w+rJcC3twjrloslRwaKH47vtG38wRI+iRlCZFzr
	CEDgmDTj2JSjd0
Date: Sat, 07 Jan 2012 08:02:17 +0100 (CET)
Message-Id: <20120107.080217.159457058.wl@gnu.org>
To: hoffmann@usm.uni-muenchen.de
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20120105200628.GE13517@usm.uni-muenchen.de>
References: <20120101153404.GA8712@usm.uni-muenchen.de>
	<CACRhBXO35_MwnF=nFWQzh7p5ZC88U3YMZdFQF-p1Gk=RYskgwQ@mail.gmail.com>
	<20120105200628.GE13517@usm.uni-muenchen.de>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: groff@gnu.org
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 07:02:23 -0000


>> So, perhaps the patch to the .bl macro as in your subsequent
>> example ought to be applied to groff's e.tmac (maybe with a comment
>> to explain what is going on, though e.tmac is pretty light on
>> comments to begin with, and they all get stripped from the
>> installed version anyway).  Does that seem like a reasonable
>> change?  If so, I can go ahead and create the patch file if you
>> don't want to do it.
> 
> Is there a maintainer for the macro package?

I'm not aware of any.  

> If so, maybe the patch should be applied upstream.  For the
> space-testing macro I used a two-character name (in a style similar
> to other "me" internal macros), because the "me" macros are also
> used with other roffs (notably Plan 9 troff and Heirloom troff).

Could you provide a patch which I can directly apply to the groff CVS?


    Werner


From MAILER-DAEMON Sat Jan 07 02:57:32 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjR9g-0000sk-7d
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 02:57:32 -0500
Received: from eggs.gnu.org ([140.186.70.92]:59887)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1RjR9c-0000nl-SX
	for groff@gnu.org; Sat, 07 Jan 2012 02:57:29 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1RjR9b-0006iR-E3
	for groff@gnu.org; Sat, 07 Jan 2012 02:57:28 -0500
Received: from mail-wi0-f169.google.com ([209.85.212.169]:53808)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1RjR9b-0006iM-15
	for groff@gnu.org; Sat, 07 Jan 2012 02:57:27 -0500
Received: by wibhq12 with SMTP id hq12so2295091wib.0
	for <groff@gnu.org>; Fri, 06 Jan 2012 23:57:25 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:date:message-id:subject:from:to:content-type;
	bh=o4rv/cVLGHAvp76jjqB1ISHQgwpOMFLDB8kYoExTcsI=;
	b=FDnuCx3NCk6ag/DUbJ8BPNM66buwUea1/hWoPJW0KiEwtN6AbVcnByv0z1njl2iAzl
	tqCNsZ39GnTYJVlweTTV2wzFrMSkOiDztA90F52BY9O1Gcf48s4vQ8Up/77uosLm7weI
	nDBACKo1nh/P9Vv5snTG6OrbXWqKhBzxdeAlc=
MIME-Version: 1.0
Received: by 10.180.91.42 with SMTP id cb10mr1430608wib.15.1325923045576; Fri,
	06 Jan 2012 23:57:25 -0800 (PST)
Received: by 10.180.101.42 with HTTP; Fri, 6 Jan 2012 23:57:25 -0800 (PST)
Date: Sat, 7 Jan 2012 01:57:25 -0600
Message-ID: <CACRhBXOo+OETiVimQUFRTp9cDCJvD-WpEUOnr1hvmHrU4WUEbA@mail.gmail.com>
From: Dave Kemper <saint.snit@gmail.com>
To: groff@gnu.org
Content-Type: text/plain; charset=ISO-8859-1
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 209.85.212.169
Subject: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 07:57:30 -0000

The following is written in the context of typesetting a primarily
continuous-prose work such as a novel.

Some time ago, Steve Izma eloquently posted
(http://lists.gnu.org/archive/html/groff/2004-03/msg00091.html) on why
orphans are fine and widows should be eliminated.  Indeed, the modern
typesetting world follows this principle: in the sampling of novels I
examined, orphans appeared regularly but widows not at all.

Steve's post also lays out some options for eliminating widows.
His method at the time was to re-kern a previous paragraph in such a
way that it ends up being typeset one line shorter or longer, either of
which would eliminate a widow on the next page.  This method has the
distinct advantage that, if done right, it leaves no visible trace to
the reader that anything has been altered.  Its drawback, of course,
is that it must be done manually on a case-by-case basis; there is no
way to automate something like this.

I would like to explore methods that can be automated while preserving
other typesetting principles, particularly the principle that the bottom
lines on every pair of facing pages should align.  This was true of
every book I looked at.

In groff, it is easy to automate the prevention of orphans (using .ne,
which is written into some macro packages' paragraphing macros); widows
are harder, but a few techniques have been put forth on this list over
the years.  However, a common feature of all these techniques -- for both
widows and orphans -- is that their effect is purely localized, moving a
line from the bottom of one page to the top of the next.  None of these
methods preserves bottom-line alignment with the facing page.

In professionally typeset novels, when a page is shortened by one line
to eliminate a widow on the following page, bottom-line alignment is
handled in one of two ways (at least, in the novels where I've been able
to figure out their trick):

 - the leading (aka line spacing) of the page is increased slightly, or
 - the facing page (whether preceding or following) is also shortened
   by one line.

The challenge to automating either of these techniques in groff, of
course, is that often by the time you know the alteration has to be done,
the page to be altered has already been generated.  So any automated
technique would have to involve two passes.

I have some ideas on how such a two-pass system might be implemented,
but before I start hacking, I'd like to make sure I'm not reinventing
a wheel someone else has already perfected.  Does a groff solution for
this exist out there in Internet-land?


From MAILER-DAEMON Sat Jan 07 09:15:30 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjX3S-0000mA-08
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 09:15:30 -0500
Received: from eggs.gnu.org ([140.186.70.92]:49040)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sverre@iki.fi>) id 1RjWed-0004Kx-Gu
	for groff@gnu.org; Sat, 07 Jan 2012 08:49:52 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <sverre@iki.fi>) id 1RjWeb-00006h-UN
	for groff@gnu.org; Sat, 07 Jan 2012 08:49:51 -0500
Received: from smtp.nokia.com ([147.243.1.47]:25704 helo=mgw-sa01.nokia.com)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sverre@iki.fi>) id 1RjWeb-00005u-Iv
	for groff@gnu.org; Sat, 07 Jan 2012 08:49:49 -0500
Received: from [127.0.0.1] (fi-es-colo-nira-a-19-150.europe.nokia.com
	[10.163.19.150])
	by mgw-sa01.nokia.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id
	q07DnT52022237; Sat, 7 Jan 2012 15:49:39 +0200
Message-ID: <4F084D69.5080807@iki.fi>
Date: Sat, 07 Jan 2012 15:49:29 +0200
From: Sverre Slotte <sverre@iki.fi>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US;
	rv:1.9.2.24) Gecko/20111103 Thunderbird/3.1.16
MIME-Version: 1.0
To: Dave Kemper <saint.snit@gmail.com>, groff@gnu.org
References: <CACRhBXOo+OETiVimQUFRTp9cDCJvD-WpEUOnr1hvmHrU4WUEbA@mail.gmail.com>
In-Reply-To: <CACRhBXOo+OETiVimQUFRTp9cDCJvD-WpEUOnr1hvmHrU4WUEbA@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
X-Nokia-AV: Clean
Content-Transfer-Encoding: quoted-printable
X-MIME-Autoconverted: from 8bit to quoted-printable by mgw-sa01.nokia.com id
	q07DnT52022237
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1)
X-Received-From: 147.243.1.47
X-Mailman-Approved-At: Sat, 07 Jan 2012 09:15:27 -0500
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: sverre@iki.fi
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 13:49:52 -0000

On 7.1.2012 09:57, ext Dave Kemper wrote:
> The following is written in the context of typesetting a primarily
> continuous-prose work such as a novel.
>
> Some time ago, Steve Izma eloquently posted
> (http://lists.gnu.org/archive/html/groff/2004-03/msg00091.html) on why
> orphans are fine and widows should be eliminated.  Indeed, the modern
> typesetting world follows this principle: in the sampling of novels I
> examined, orphans appeared regularly but widows not at all.
>
> Steve's post also lays out some options for eliminating widows.
> His method at the time was to re-kern a previous paragraph in such a
> way that it ends up being typeset one line shorter or longer, either of
> which would eliminate a widow on the next page.  This method has the
> distinct advantage that, if done right, it leaves no visible trace to
> the reader that anything has been altered.  Its drawback, of course,
> is that it must be done manually on a case-by-case basis; there is no
> way to automate something like this.
>
> I would like to explore methods that can be automated while preserving
> other typesetting principles, particularly the principle that the botto=
m
> lines on every pair of facing pages should align.  This was true of
> every book I looked at.
>
> In groff, it is easy to automate the prevention of orphans (using .ne,
> which is written into some macro packages' paragraphing macros); widows
> are harder, but a few techniques have been put forth on this list over
> the years.  However, a common feature of all these techniques -- for bo=
th
> widows and orphans -- is that their effect is purely localized, moving =
a
> line from the bottom of one page to the top of the next.  None of these
> methods preserves bottom-line alignment with the facing page.
>
> In professionally typeset novels, when a page is shortened by one line
> to eliminate a widow on the following page, bottom-line alignment is
> handled in one of two ways (at least, in the novels where I've been abl=
e
> to figure out their trick):
>
>   - the leading (aka line spacing) of the page is increased slightly, o=
r
>   - the facing page (whether preceding or following) is also shortened
>     by one line.
>
> The challenge to automating either of these techniques in groff, of
> course, is that often by the time you know the alteration has to be don=
e,
> the page to be altered has already been generated.  So any automated
> technique would have to involve two passes.
>
> I have some ideas on how such a two-pass system might be implemented,
> but before I start hacking, I'd like to make sure I'm not reinventing
> a wheel someone else has already perfected.  Does a groff solution for
> this exist out there in Internet-land?

The web-page http://troff.org/macros.html has (under the To Do section)=20
this interesting entry:

"The -mpm Macro Package" B. W. Kernighan and C. J. Van Wyk.
Describes the -mpm macros, a version of -ms that does automatic page
balancing.

      Author: Brian W. Kernighan
      Author: Christopher J. Van Wyk
       Title: Page Makeup by Postprocessing Text Formatter Output
       Pages: 103-132
   Publisher: USENIX Association
Proceedings: Computing Systems
        Date: Spring 1989
      Volume: 2
  Num in Vol: 2
Institution: AT&T Bell Laboratories

A man-page of -mpm is available on=20
http://man.cat-v.org/plan_9_2nd_ed/6/mpm. It has the following decsriptio=
n:

These troff(1) macros, largely compatible with ms(6), make better pages.
They silently invoke and provide information to a postprocessor that
moves floating figures, avoids widows, and justifies pages vertically by
stretching vertical spaces that result from .PP, .LP, .IP, .QP, .SH,
.NH, .DS/.DE, .EQ/.EN, .TS/.TE, .PS/.PE, .P1/.P2, and .QS/.QE.

HTH, Sverre

--=20
Sverre Slotte  |  Oppibergsgr=E4nden 2 D  |  Phone  +358  9 8558007
sverre@iki.fi  |  02210 Esbo, Finland   |  Mobile +358 50 4839532




From MAILER-DAEMON Sat Jan 07 10:08:12 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjXsS-0007GK-KW
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 10:08:12 -0500
Received: from eggs.gnu.org ([140.186.70.92]:47096)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RjXsP-0007CT-3Y
	for groff@gnu.org; Sat, 07 Jan 2012 10:08:10 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RjXsN-00026h-Pg
	for groff@gnu.org; Sat, 07 Jan 2012 10:08:09 -0500
Received: from relay00.pair.com ([209.68.5.9]:4252)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RjXsN-00026d-IR
	for groff@gnu.org; Sat, 07 Jan 2012 10:08:07 -0500
Received: (qmail 86182 invoked from network); 7 Jan 2012 15:08:05 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay00.pair.com with SMTP; 7 Jan 2012 15:08:05 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id 4CC842E157; Sat,  7 Jan 2012 15:08:05 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 20D962E156;
	Sat,  7 Jan 2012 15:08:05 +0000 (GMT)
To: groff@gnu.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <4F084D69.5080807@iki.fi>
References: <CACRhBXOo+OETiVimQUFRTp9cDCJvD-WpEUOnr1hvmHrU4WUEbA@mail.gmail.com>
	<4F084D69.5080807@iki.fi>
Comments: In-reply-to Sverre Slotte <sverre@iki.fi> message dated "Sat,
	07 Jan 2012 15:49:29 +0200."
Date: Sat, 07 Jan 2012 15:08:05 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120107150805.4CC842E157@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.68.5.9
Cc: Dave Kemper <saint.snit@gmail.com>, Sverre Slotte <sverre@iki.fi>
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 15:08:10 -0000

Hi,

Sverre Slotte wrote:
> The web-page http://troff.org/macros.html has (under the To Do
> section) this interesting entry:
> 
> "The -mpm Macro Package" B. W. Kernighan and C. J. Van Wyk.  Describes
> the -mpm macros, a version of -ms that does automatic page balancing.

It was used and acknowledged in the production of the excellent _The
Practice of Programming_ by Kernighan and Pike.

    http://troff.org/pubs.html#tpop
    "This book was typeset (grap|pic|tbl|eqn|troff -mpm) in Times and
    Lucida San Typewriter by the authors." 

> A man-page of -mpm is available on 
> http://man.cat-v.org/plan_9_2nd_ed/6/mpm.

I'm not sure the source is in modern Plan 9's, but Commander Pike did
post it to comp.os.plan9 in the past.

    http://groups.google.com/group/comp.os.plan9/msg/cef975886f4502be
    http://groups.google.com/group/comp.os.plan9/msg/3459b23689796052

Cheers, Ralph.


From MAILER-DAEMON Sat Jan 07 14:25:56 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rjbts-0002dM-Kl
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 14:25:56 -0500
Received: from eggs.gnu.org ([140.186.70.92]:38223)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1Rjbtq-0002dB-9K
	for groff@gnu.org; Sat, 07 Jan 2012 14:25:55 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1Rjbtp-000563-3J
	for groff@gnu.org; Sat, 07 Jan 2012 14:25:54 -0500
Received: from relay4-d.mail.gandi.net ([217.70.183.196]:37639)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1Rjbto-000554-JC
	for groff@gnu.org; Sat, 07 Jan 2012 14:25:53 -0500
X-Originating-IP: 217.70.178.148
Received: from mfilter20-d.gandi.net (mfilter20-d.gandi.net [217.70.178.148])
	by relay4-d.mail.gandi.net (Postfix) with ESMTP id 4E521172087;
	Sat,  7 Jan 2012 20:25:46 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at mfilter20-d.gandi.net
Received: from relay4-d.mail.gandi.net ([217.70.183.196])
	by mfilter20-d.gandi.net (mfilter20-d.gandi.net [10.0.15.180])
	(amavisd-new, port 10024)
	with ESMTP id 5s79DYg1jF5U; Sat,  7 Jan 2012 20:25:44 +0100 (CET)
X-Originating-IP: 86.74.235.181
Received: from localhost.localdomain (181.235.74.86.rev.sfr.net
	[86.74.235.181]) (Authenticated sender: sygne@ombres.eu)
	by relay4-d.mail.gandi.net (Postfix) with ESMTPSA id 3FD70172071;
	Sat,  7 Jan 2012 20:25:41 +0100 (CET)
Date: Sat, 07 Jan 2012 20:25:16 +0100
From: Pierre-Jean <sygne@ombres.eu>
To: saint.snit@gmail.com, groff@gnu.org
Message-ID: <4f089c1c.dpvro0RfaGHsmfBd%sygne@ombres.eu>
References: <CACRhBXOo+OETiVimQUFRTp9cDCJvD-WpEUOnr1hvmHrU4WUEbA@mail.gmail.com>
In-Reply-To: <CACRhBXOo+OETiVimQUFRTp9cDCJvD-WpEUOnr1hvmHrU4WUEbA@mail.gmail.com>
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 217.70.183.196
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 19:25:55 -0000





Hello Dave,
hello alls,

This is a quite interesting problem, so I hope my opinion may
help.

Dave Kemper <saint.snit@gmail.com> wrote:
> In professionally typeset novels, when a page is shortened by
> one line
> to eliminate a widow on the following page, bottom-line
> alignment is
> handled in one of two ways (at least, in the novels where I've
> been able
> to figure out their trick):
>
>  - the leading (aka line spacing) of the page is increased
>  slightly, or
>  - the facing page (whether preceding or following) is also
>  shortened
>    by one line.

I must add that in nicely typeset books, lines are always on the
same place on the page. So if you look the page in transparency,
you'll see that each line exactly recover the line of the other
side of the page. This is needed when the paper is not
perfectly opaque, but it's also a sign of well done job.

That means that the vertical unit of a page is the line spacing,
and if, for example, you add space before and after titles, you
should take care that the width of the title plus the extra
spaces is proportionnal to an amount of lines.

So, dealing with orphans by changing the line spacing, is just
a "not other choice" solution. You should prefer dealing with
interword and interletter spaces. This is usually invisible.

I'm personnaly doing this manually: I've just created two macros,
".min" and ".max", to minimize and maximize the width of a
paragraph, and I put them where it's needed. 

One can also have this at the beginning of the paragraph macro,
to inform the position of orphans:

.nr orphan \\n[header-width]v+1v
.if \\n(nl=\\n[orphan] .tm Orphan on page \\n%, \\n(.F line
\\n(.c


One solution to automatically deal with that in a multi-pass
invocation of troff could use this trick:

* first pass: for each paragraph, output the position on the page
  of the last word of the paragraph, the position on the line
  of the last word of the paragraph, and the number of lines of
  the paragraph. Also output page breaks caused by macros.
* It is now possible to find the best paragraph that should be
  modified to avoid widows and orphans: it's a long one, with the
  last word near the beginning or the end of the line, with no
  page break between him and the widow.
* A filter could calculate that and add '.min' or '.max' at the
  beginning of the paragraphs that need to be changed before the
  next pass.

Cheers,

Pierre-Jean.


From MAILER-DAEMON Sat Jan 07 16:31:49 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rjdrh-0006F3-6x
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 16:31:49 -0500
Received: from eggs.gnu.org ([140.186.70.92]:37115)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=nhSZQh=7S=schaffter.ca=peter@eigbox.net>)
	id 1Rjdre-0006Ex-Ef
	for groff@gnu.org; Sat, 07 Jan 2012 16:31:47 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <SRS0=nhSZQh=7S=schaffter.ca=peter@eigbox.net>)
	id 1Rjdrc-0003oe-SY
	for groff@gnu.org; Sat, 07 Jan 2012 16:31:46 -0500
Received: from bosmailout11.eigbox.net ([66.96.187.11]:43419)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=nhSZQh=7S=schaffter.ca=peter@eigbox.net>)
	id 1Rjdrc-0003oa-Jn
	for groff@gnu.org; Sat, 07 Jan 2012 16:31:44 -0500
Received: from bosmailscan11.eigbox.net ([10.20.15.11])
	by bosmailout11.eigbox.net with esmtp (Exim) id 1Rjdrb-0000pM-9W
	for groff@gnu.org; Sat, 07 Jan 2012 16:31:43 -0500
Received: from bosimpout01.eigbox.net ([10.20.55.1])
	by bosmailscan11.eigbox.net with esmtp (Exim) id 1Rjdrb-0005c1-5C
	for groff@gnu.org; Sat, 07 Jan 2012 16:31:43 -0500
Received: from bosauthsmtp15.eigbox.net ([10.20.18.15])
	by bosimpout01.eigbox.net with NO UCE
	id JlXi1i0030KWaAJ01lXirw; Sat, 07 Jan 2012 16:31:42 -0500
X-EN-OrigOutIP: 10.20.18.15
X-EN-IMPSID: JlXi1i0030KWaAJ01lXirw
Received: from bas1-ottawa09-2925287607.dsl.bell.ca ([174.92.88.183]
	helo=augustus)
	by bosauthsmtp15.eigbox.net with esmtpsa (TLSv1:AES256-SHA:256)
	(Exim) id 1Rjdra-0007TB-TL
	for groff@gnu.org; Sat, 07 Jan 2012 16:31:43 -0500
Received: from peter by augustus with local (Exim 4.76)
	(envelope-from <peter@schaffter.ca>) id 1RjdrY-0000px-Oi
	for groff@gnu.org; Sat, 07 Jan 2012 16:31:40 -0500
Date: Sat, 7 Jan 2012 16:31:40 -0500
From: Peter Schaffter <peter@schaffter.ca>
To: groff@gnu.org
Message-ID: <20120107213140.GA2688@augustus>
Mail-Followup-To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
References: <CACRhBXOo+OETiVimQUFRTp9cDCJvD-WpEUOnr1hvmHrU4WUEbA@mail.gmail.com>
	<4f089c1c.dpvro0RfaGHsmfBd%sygne@ombres.eu>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <4f089c1c.dpvro0RfaGHsmfBd%sygne@ombres.eu>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-EN-UserInfo: de950a90bfbefba2fd690f5ecdd2f718:712911bb6d01017077352c3c8e2e335d
X-EN-AuthUser: peter@schaffter.ca
Sender: Peter Schaffter <peter@schaffter.ca>
X-EN-OrigIP: 174.92.88.183
X-EN-OrigHost: bas1-ottawa09-2925287607.dsl.bell.ca
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 66.96.187.11
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 21:31:47 -0000

Hi.

On Sat, Jan 07, 2012, Pierre-Jean wrote:

> Dave Kemper <saint.snit@gmail.com> wrote:
> > In professionally typeset novels, when a page is shortened by
> > one line to eliminate a widow on the following page, bottom-line
> > alignment is handled in one of two ways (at least, in the novels
> > where I've been able to figure out their trick):
> >
> >  - the leading (aka line spacing) of the page is increased
> >    slightly, or
> >  - the facing page (whether preceding or following) is also
> >    shortened by one line.

Weighing in on this issue, I have to say that in my thirty+ years of
typesetting, never has changing the leading of continuous prose (aka
running text) been considered acceptable.  In fact, it's impossible
for me to imagine a situation where it would even be useful.  If the
text is unbroken by headings, space between paragraphs, or other
interpolations, adding or subtracting lines to fix orphans or widows
may increase or decrease the amount of text on a page, but doesn't
alter the number of lines that fit on it.

In documents or books where running text does get interrupted, it
has always been standard practice to balance the whitespace around
the disrupting elements in order to achieve properly aligned bottom
margins.  Changing the leading of running text is a no-no.

> That means that the vertical unit of a page is the line spacing,
> and if, for example, you add space before and after titles, you
> should take care that the width of the title plus the extra
> spaces is proportionnal to an amount of lines.

Precisely.  By the way, did you mean the "depth of the title" (not
"width")?  I'm assuming so.

I included in the mom macros a utility, .SHIM, which ensures that
the line of output text immediately following .SHIM lands squarely
on the next available valid baseline.  A valid baseline is one on
which running text would normally fall, assuming an uninterrupted
page of text.  It's a simple way of taking care that "...the depth
of the title plus the extra spaces is proportionnal to an amount of
lines."  .SHIM gets used behind-the-scenes to balance the whitespace
around document titles, heads, subheads, sub-subheads, cited
material, etc., but it can be invoked manually at any time.

> So, dealing with orphans by changing the line spacing, is just
> a "no other choice" solution. You should prefer dealing with
> interword and interletter spaces.

Correct.  The shortening or lengthening of paragraphs to avoid
widows and orphans requires the skillful manipulation of
letter- and word-spacing on a line-by-line basis, not an overall
change of leading that merely expands or contracts the depth of the
text.

Would that the process could be automated, but I have yet to be
shown that it can.  Typography is still, after all these years,
an art that requires a good eye, a deft hand, and human judgment.
 
-- 
Peter Schaffter

Author of The Binbrook Caucus
http://www.schaffter.ca



From MAILER-DAEMON Sat Jan 07 17:13:05 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjeVd-00020F-Dn
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 17:13:05 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33520)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <robert@thorsby.com.au>) id 1RjeVb-000203-M1
	for groff@gnu.org; Sat, 07 Jan 2012 17:13:04 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <robert@thorsby.com.au>) id 1RjeVa-000842-Dz
	for groff@gnu.org; Sat, 07 Jan 2012 17:13:03 -0500
Received: from green.hot.net.au ([202.183.109.12]:49905 helo=Hot.net.au)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <robert@thorsby.com.au>) id 1RjeVZ-00081y-Rb
	for groff@gnu.org; Sat, 07 Jan 2012 17:13:02 -0500
Received: from thorsby.com.au (pool-210.79.25.133.hot.net.au [210.79.25.133])
	by Hot.net.au (8.12.9p1/8.12.9) with ESMTP id q07MCp3w074523
	for <groff@gnu.org>; Sun, 8 Jan 2012 09:12:52 +1100 (EST)
	(envelope-from robert@thorsby.com.au)
Received: from robert (uid 1000) (envelope-from robert@thorsby.com.au)
	id 70054f by thorsby.com.au (DragonFly Mail Agent)
	Sun, 08 Jan 2012 09:12:43 +1100
Date: Sun, 08 Jan 2012 09:11:52 +1100
From: Robert Thorsby <robert@thorsby.com.au>
To: Peter Schaffter <peter@schaffter.ca>
In-Reply-To: <20120107213140.GA2688@augustus> (from peter@schaffter.ca on
	Sun Jan  8 08:31:40 2012)
X-Mailer: Balsa 2.4.1
Message-Id: <1325974312.1697.2-poddy@thorsby.com.au>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: FreeBSD 4.7-5.2 (or MacOS X
	10.2-10.4) (2)
X-Received-From: 202.183.109.12
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 22:13:04 -0000

On 08/01/12 08:31:40, Peter Schaffter wrote:
> > So, dealing with orphans by changing the line spacing, is just
> > a "no other choice" solution. You should prefer dealing with
> > interword and interletter spaces.
>=20
> Correct.  The shortening or lengthening of paragraphs to avoid
> widows and orphans requires the skillful manipulation of
> letter- and word-spacing on a line-by-line basis, not an overall
> change of leading that merely expands or contracts the depth of the
> text.
>=20
> Would that the process could be automated, but I have yet to be
> shown that it can.  Typography is still, after all these years,
> an art that requires a good eye, a deft hand, and human judgment.

Is there an alternative method that is better/faster/cleaner than the use=20
of complementary values for \s and \H? For example,

\s'-100u'\H'+100u'The quick brown fox ...\H'0'\s0

will "shorten" the text by a "little" amount. But finding the smallest=20
value that achieves the requisite effect (usually moving one word up or=20
down a line) is a PITA.

[100u -- 1/10 of a point -- was chosen for the nonce, I usually start=20
with 250u]

Also, this "Poor Man's Track-Kerning" is, of course, not strictly kosher=20
because it affects the inter-word spacing as much as the inter-character=20
spacing. What method do others use?

Robert Thorsby
To be or not to be. -- Shakespeare
To do is to be. -- Nietzsche
To be is to do. -- Sartre
Do be do be do. -- Sinatra



From MAILER-DAEMON Sat Jan 07 17:59:57 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjfEz-0006gt-1y
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 17:59:57 -0500
Received: from eggs.gnu.org ([140.186.70.92]:59709)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RjfEx-0006gl-9P
	for groff@gnu.org; Sat, 07 Jan 2012 17:59:56 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RjfEv-0004ZK-SY
	for groff@gnu.org; Sat, 07 Jan 2012 17:59:55 -0500
Received: from smarthost01.mail.zen.net.uk ([212.23.3.140]:46467)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RjfEv-0004ZD-L5
	for groff@gnu.org; Sat, 07 Jan 2012 17:59:53 -0500
Received: from [88.96.44.206] (helo=deb)
	by smarthost01.mail.zen.net.uk with esmtp (Exim 4.63)
	(envelope-from <Ted.Harding@wlandres.net>)
	id 1RjfEs-0002a6-S8; Sat, 07 Jan 2012 22:59:51 +0000
Content-Length: 3735
Message-ID: <XFMail.20120107225946.Ted.Harding@wlandres.net>
X-Mailer: XFMail 1.5.5 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <1325974312.1697.2-poddy@thorsby.com.au>
Date: Sat, 07 Jan 2012 22:59:46 -0000 (GMT)
Sender: ted@deb
From: (Ted Harding) <Ted.Harding@wlandres.net>
To: groff@gnu.org
Bcc: 
X-Originating-Smarthost01-IP: [88.96.44.206]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 212.23.3.140
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: Ted.Harding@wlandres.net
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 22:59:56 -0000

On 07-Jan-2012 Robert Thorsby wrote:
> On 08/01/12 08:31:40, Peter Schaffter wrote:
>> > So, dealing with orphans by changing the line spacing, is just
>> > a "no other choice" solution. You should prefer dealing with
>> > interword and interletter spaces.
>> 
>> Correct.  The shortening or lengthening of paragraphs to avoid
>> widows and orphans requires the skillful manipulation of
>> letter- and word-spacing on a line-by-line basis, not an overall
>> change of leading that merely expands or contracts the depth of the
>> text.
>> 
>> Would that the process could be automated, but I have yet to be
>> shown that it can.  Typography is still, after all these years,
>> an art that requires a good eye, a deft hand, and human judgment.
> 
> Is there an alternative method that is better/faster/cleaner than the use 
> of complementary values for \s and \H? For example,
> 
> \s'-100u'\H'+100u'The quick brown fox ...\H'0'\s0
> 
> will "shorten" the text by a "little" amount. But finding the smallest 
> value that achieves the requisite effect (usually moving one word up or 
> down a line) is a PITA.
> 
> [100u -- 1/10 of a point -- was chosen for the nonce, I usually start 
> with 250u]
> 
> Also, this "Poor Man's Track-Kerning" is, of course, not strictly kosher 
> because it affects the inter-word spacing as much as the inter-character 
> spacing. What method do others use?
> 
> Robert Thorsby
> To be or not to be. -- Shakespeare
> To do is to be. -- Nietzsche
> To be is to do. -- Sartre
> Do be do be do. -- Sinatra

I've been hesitating about joining in, because (as is
already beginning to emerge) it is potentially a complex
question; and also the kind of solution which should be
preferred is a question of taste, convention, or context,
as well as convenience of use.

For myself, I would generally avoid trying to embed such
things in macros, since a macro is what it is, and will
lack the "on-the-fly" judgment and flexibility that one
will usually want to use.

One important factor is whether or not what you are trying
to typeset is something that you are writing for yourself.
If so, then often simply re-wording your text (but avoiding
any changes of meaning or nuance) is a good approach. But
this is out of the question if what you are typesetting is
something written by someone else which you need to preserve
as it is.

Regarding Robert's "Poor Man's Track-Kerning", with care it
can be nicely combined, to an unobtrusive degree, with equally
unobtrusive "True Track-Kerning" using the .tk request, to
double effect.

While I am at it, I would have thought that Robert's use
of a relative height change \H'+100u' was unnecessary,
since \H'N' (where N is the current point size) will also do.

Another trick is to change the inter-word spacing, using
the .ss request. Thus

.ss 10

reduces the minimum word-space to 10/12 of its default.
Don't forget to reset it when no loner needed by using

.ss 12

Often, the most useful change in text layout for adjusting
the number of lines is pulling back the leftovers of hyphenated
words onto the same line as their parent, since that can often
reduce the number of lines in a paragraph by 1. To do this,
pick and mix the above methods according to taste,

All such approaches imply making the changes to the formatting
after the text has reached definitive final form. If not, then
second thoughts can have complicated knock-on effects.

Just a few somewhat random thoughts. I've been through this
sort of thing too often for it to be easy or quick to summarise!

Ted.
----------------------------------
E-Mail: (Ted Harding) <Ted.Harding@wlandres.net>
Date: 07-Jan-2012
Time: 22:19:28

This message was sent by XFMail
----------------------------------


From MAILER-DAEMON Sat Jan 07 18:37:36 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjfpQ-0004TR-It
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 18:37:36 -0500
Received: from eggs.gnu.org ([140.186.70.92]:37199)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <robert@thorsby.com.au>) id 1RjfpO-0004TK-5E
	for groff@gnu.org; Sat, 07 Jan 2012 18:37:34 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <robert@thorsby.com.au>) id 1RjfpM-00009L-OE
	for groff@gnu.org; Sat, 07 Jan 2012 18:37:34 -0500
Received: from green.hot.net.au ([202.183.109.12]:50574 helo=Hot.net.au)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <robert@thorsby.com.au>) id 1RjfpM-00009A-2T
	for groff@gnu.org; Sat, 07 Jan 2012 18:37:32 -0500
Received: from thorsby.com.au (pool-210.79.25.133.hot.net.au [210.79.25.133])
	by Hot.net.au (8.12.9p1/8.12.9) with ESMTP id q07NbN3w078702
	for <groff@gnu.org>; Sun, 8 Jan 2012 10:37:29 +1100 (EST)
	(envelope-from robert@thorsby.com.au)
Received: from robert (uid 1000) (envelope-from robert@thorsby.com.au)
	id 702597 by thorsby.com.au (DragonFly Mail Agent)
	Sun, 08 Jan 2012 10:37:14 +1100
Date: Sun, 08 Jan 2012 10:36:50 +1100
From: Robert Thorsby <robert@thorsby.com.au>
To: Ted.Harding@wlandres.net
In-Reply-To: <XFMail.20120107225946.Ted.Harding@wlandres.net> (from
	Ted.Harding@wlandres.net on Sun Jan  8 09:59:46 2012)
X-Mailer: Balsa 2.4.1
Message-Id: <1325979410.1666.0-poddy@thorsby.com.au>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: FreeBSD 4.7-5.2 (or MacOS X
	10.2-10.4) (2)
X-Received-From: 202.183.109.12
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 23:37:35 -0000

On 08/01/12 09:59:46, Ted.Harding@wlandres.net wrote:
> I've been hesitating about joining in, because (as is
> already beginning to emerge) it is potentially a complex
> question; and also the kind of solution which should be
> preferred is a question of taste, convention, or context,
> as well as convenience of use.
>=20
> For myself, I would generally avoid trying to embed such
> things in macros, since a macro is what it is, and will
> lack the "on-the-fly" judgment and flexibility that one
> will usually want to use.

As everyone knows, when the discussion turns to tracking, typesetting has=20
assumed the mantle of a black art. Once you use expressions such as "it=20
all depends on what looks good" (artist) or "it depends on the=20
circumstances of the individual case" (lawyer) you have left science,=20
mathematics, computing, and often common sense, far behind.

=20
> While I am at it, I would have thought that Robert's use
> of a relative height change \H'+100u' was unnecessary,
> since \H'N' (where N is the current point size) will also do.

Ah, Ted, hoist with your own petard. :-) It was your original suggestion=20
(some years ago) on this Forum that I was repeating! But, I like your=20
refinement -- apart from elegance, it reduces the risk of mistakes when=20
one is making piddling little adjustments to get that bloody word to=20
wrap. More than once I have adjusted the s value without adjusting the H=20
value; and such a mistake can be difficult to spot.

Robert Thorsby
How should I know if it works? That's what beta testers are for.
I only coded it. -- Linus Torvalds



From MAILER-DAEMON Sat Jan 07 18:50:38 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rjg22-0005h0-OK
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 18:50:38 -0500
Received: from eggs.gnu.org ([140.186.70.92]:54450)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=nhSZQh=7S=schaffter.ca=peter@eigbox.net>)
	id 1Rjg20-0005fa-5T
	for groff@gnu.org; Sat, 07 Jan 2012 18:50:37 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <SRS0=nhSZQh=7S=schaffter.ca=peter@eigbox.net>)
	id 1Rjg1y-0001gv-GZ
	for groff@gnu.org; Sat, 07 Jan 2012 18:50:36 -0500
Received: from bosmailout19.eigbox.net ([66.96.190.19]:50553)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=nhSZQh=7S=schaffter.ca=peter@eigbox.net>)
	id 1Rjg1y-0001gl-Ch
	for groff@gnu.org; Sat, 07 Jan 2012 18:50:34 -0500
Received: from bosmailscan05.eigbox.net ([10.20.15.5])
	by bosmailout19.eigbox.net with esmtp (Exim) id 1Rjg1x-0007HX-CG
	for groff@gnu.org; Sat, 07 Jan 2012 18:50:33 -0500
Received: from bosimpout01.eigbox.net ([10.20.55.1])
	by bosmailscan05.eigbox.net with esmtp (Exim) id 1Rjg1x-0007ts-1J
	for groff@gnu.org; Sat, 07 Jan 2012 18:50:33 -0500
Received: from bosauthsmtp05.eigbox.net ([10.20.18.5])
	by bosimpout01.eigbox.net with NO UCE
	id JnqZ1i00106Zqne01nqZrE; Sat, 07 Jan 2012 18:50:33 -0500
X-EN-OrigOutIP: 10.20.18.5
X-EN-IMPSID: JnqZ1i00106Zqne01nqZrE
Received: from bas1-ottawa09-2925287607.dsl.bell.ca ([174.92.88.183]
	helo=augustus)
	by bosauthsmtp05.eigbox.net with esmtpsa (TLSv1:AES256-SHA:256)
	(Exim) id 1Rjg1w-00084X-SC
	for groff@gnu.org; Sat, 07 Jan 2012 18:50:32 -0500
Received: from peter by augustus with local (Exim 4.76)
	(envelope-from <peter@schaffter.ca>) id 1Rjg1v-0000w8-0r
	for groff@gnu.org; Sat, 07 Jan 2012 18:50:31 -0500
Date: Sat, 7 Jan 2012 18:50:30 -0500
From: Peter Schaffter <peter@schaffter.ca>
To: groff@gnu.org
Message-ID: <20120107235030.GB3491@augustus>
Mail-Followup-To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
References: <20120107213140.GA2688@augustus>
	<1325974312.1697.2-poddy@thorsby.com.au>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1325974312.1697.2-poddy@thorsby.com.au>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-EN-UserInfo: de950a90bfbefba2fd690f5ecdd2f718:712911bb6d01017077352c3c8e2e335d
X-EN-AuthUser: peter@schaffter.ca
Sender: Peter Schaffter <peter@schaffter.ca>
X-EN-OrigIP: 174.92.88.183
X-EN-OrigHost: bas1-ottawa09-2925287607.dsl.bell.ca
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 66.96.190.19
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Jan 2012 23:50:37 -0000

On Sun, Jan 08, 2012, Robert Thorsby wrote:
> Is there an alternative method that is better/faster/cleaner than
> the use of complementary values for \s and \H?  For example,

Track kerning, via the .tk request, and word spacing via .ss.
Changing what used to be called the "set size" of your type (ie the
\s \H combo, which amounts to pseudo-condensing the characters) is
last resort territory, and shouldn't generally be used in running
text at all, unless the running text has the same alteration
throughout.

If you're using the mom macros, .EW <n> (extra white) and .RW <n>
(reduce white) simplify track kerning (the mnemonics are borrowed
from the CompuGraphic 8xxx series command set), and .WS +|-<n>
can be used to adjust the wordspacing.
 
O.T. --
> To be or not to be. -- Shakespeare
> To do is to be. -- Nietzsche
> To be is to do. -- Sartre
> Do be do be do. -- Sinatra

The last time I saw this was on a washroom wall at the University of
Toronto, right beside the now classic, "co ito ergo sum".

-- 
Peter Schaffter

Author of The Binbrook Caucus
http://www.schaffter.ca


From MAILER-DAEMON Sat Jan 07 19:11:25 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjgM9-0007hj-RV
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 19:11:25 -0500
Received: from eggs.gnu.org ([140.186.70.92]:51619)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=NDg/S8=7T=schaffter.ca=peter@eigbox.net>)
	id 1RjgM7-0007hH-BV
	for groff@gnu.org; Sat, 07 Jan 2012 19:11:24 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <SRS0=NDg/S8=7T=schaffter.ca=peter@eigbox.net>)
	id 1RjgM6-0004yM-6s
	for groff@gnu.org; Sat, 07 Jan 2012 19:11:23 -0500
Received: from bosmailout17.eigbox.net ([66.96.184.17]:58243)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=NDg/S8=7T=schaffter.ca=peter@eigbox.net>)
	id 1RjgM6-0004yC-4d
	for groff@gnu.org; Sat, 07 Jan 2012 19:11:22 -0500
Received: from bosmailscan10.eigbox.net ([10.20.15.10])
	by bosmailout17.eigbox.net with esmtp (Exim) id 1RjgM4-00084S-7c
	for groff@gnu.org; Sat, 07 Jan 2012 19:11:20 -0500
Received: from bosimpout02.eigbox.net ([10.20.55.2])
	by bosmailscan10.eigbox.net with esmtp (Exim) id 1RjgM3-0007bZ-Pl
	for groff@gnu.org; Sat, 07 Jan 2012 19:11:19 -0500
Received: from bosauthsmtp15.eigbox.net ([10.20.18.15])
	by bosimpout02.eigbox.net with NO UCE
	id JoBK1i0060KWaAJ01oBKSi; Sat, 07 Jan 2012 19:11:19 -0500
X-EN-OrigOutIP: 10.20.18.15
X-EN-IMPSID: JoBK1i0060KWaAJ01oBKSi
Received: from bas1-ottawa09-2925287607.dsl.bell.ca ([174.92.88.183]
	helo=augustus)
	by bosauthsmtp15.eigbox.net with esmtpsa (TLSv1:AES256-SHA:256)
	(Exim) id 1RjgM3-0003AS-Rj
	for groff@gnu.org; Sat, 07 Jan 2012 19:11:19 -0500
Received: from peter by augustus with local (Exim 4.76)
	(envelope-from <peter@schaffter.ca>) id 1RjgM2-0000xT-1v
	for groff@gnu.org; Sat, 07 Jan 2012 19:11:18 -0500
Date: Sat, 7 Jan 2012 19:11:17 -0500
From: Peter Schaffter <peter@schaffter.ca>
To: groff@gnu.org
Message-ID: <20120108001117.GC3491@augustus>
Mail-Followup-To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
References: <XFMail.20120107225946.Ted.Harding@wlandres.net>
	<1325979410.1666.0-poddy@thorsby.com.au>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1325979410.1666.0-poddy@thorsby.com.au>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-EN-UserInfo: de950a90bfbefba2fd690f5ecdd2f718:712911bb6d01017077352c3c8e2e335d
X-EN-AuthUser: peter@schaffter.ca
Sender: Peter Schaffter <peter@schaffter.ca>
X-EN-OrigIP: 174.92.88.183
X-EN-OrigHost: bas1-ottawa09-2925287607.dsl.bell.ca
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 66.96.184.17
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 00:11:24 -0000

On Sun, Jan 08, 2012, Robert Thorsby wrote:
> As everyone knows, when the discussion turns to tracking,
> typesetting has assumed the mantle of a black art.

Not really, or, if it is a black art, then it's an essential one
to master, possibly _the_ essential one.  No matter where I have
worked, individual letter pair and overall track kerning have
occupied the lion's share of time when it came to preparing final
proofs.

-- 
Peter Schaffter

Author of The Binbrook Caucus
http://www.schaffter.ca


From MAILER-DAEMON Sat Jan 07 20:30:18 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjhaU-00023T-14
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 20:30:18 -0500
Received: from eggs.gnu.org ([140.186.70.92]:40881)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.demon.co.uk>) id 1RjhaR-00022r-QD
	for groff@gnu.org; Sat, 07 Jan 2012 20:30:16 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <deri@chuzzlewit.demon.co.uk>) id 1RjhaQ-0006bL-MX
	for groff@gnu.org; Sat, 07 Jan 2012 20:30:15 -0500
Received: from chuzzlewit.demon.co.uk ([80.177.169.146]:55615
	helo=dombey.localdomain) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.demon.co.uk>) id 1RjhaQ-0006bH-Gb
	for groff@gnu.org; Sat, 07 Jan 2012 20:30:14 -0500
Received: by dombey.localdomain (Postfix, from userid 500)
	id 952A823D4C; Sun,  8 Jan 2012 01:30:12 +0000 (GMT)
From: Deri James <deri@chuzzlewit.demon.co.uk>
To: groff@gnu.org
Date: Sun, 8 Jan 2012 01:30:11 +0000
User-Agent: KMail/1.13.7 (Linux/2.6.38.8-desktop-9.mga; KDE/4.6.5; x86_64; ; )
References: <XFMail.20120107225946.Ted.Harding@wlandres.net>
In-Reply-To: <XFMail.20120107225946.Ted.Harding@wlandres.net>
MIME-Version: 1.0
Content-Type: Text/Plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <201201080130.12075.deri@chuzzlewit.demon.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 80.177.169.146
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 01:30:16 -0000

On Saturday 07 Jan 2012 22:59:46 Ted Harding wrote:
> Just a few somewhat random thoughts. I've been through this
> sort of thing too often for it to be easy or quick to summarise!

I remember reading (on this list) a PHD thesis by Han The Thanh (of pdfTEX 
fame) on micro typography, although the original is now a dead link I think 
I've found it here:-

http://www.pragma-ade.com/pdftex/thesis.pdf

Many thought provoking ideas.

Cheers 

Deri


From MAILER-DAEMON Sat Jan 07 21:15:45 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjiIT-0000zw-Fu
	for mharc-groff@gnu.org; Sat, 07 Jan 2012 21:15:45 -0500
Received: from eggs.gnu.org ([140.186.70.92]:51709)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RjiIQ-0000ww-8j
	for groff@gnu.org; Sat, 07 Jan 2012 21:15:43 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RjiIO-00033b-Nf
	for groff@gnu.org; Sat, 07 Jan 2012 21:15:42 -0500
Received: from smarthost03.mail.zen.net.uk ([212.23.3.142]:60012)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RjiIO-00033X-AB
	for groff@gnu.org; Sat, 07 Jan 2012 21:15:40 -0500
Received: from [88.96.44.206] (helo=deb)
	by smarthost03.mail.zen.net.uk with esmtp (Exim 4.63)
	(envelope-from <Ted.Harding@wlandres.net>)
	id 1RjiIM-0001eG-1s; Sun, 08 Jan 2012 02:15:38 +0000
Content-Length: 2136
Message-ID: <XFMail.20120108021533.Ted.Harding@wlandres.net>
X-Mailer: XFMail 1.5.5 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <201201080130.12075.deri@chuzzlewit.demon.co.uk>
Date: Sun, 08 Jan 2012 02:15:33 -0000 (GMT)
Sender: ted@deb
From: (Ted Harding) <Ted.Harding@wlandres.net>
To: groff@gnu.org
Bcc: 
X-Originating-Smarthost03-IP: [88.96.44.206]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 212.23.3.142
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: Ted.Harding@wlandres.net
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 02:15:43 -0000

On 08-Jan-2012 Deri James wrote:
> On Saturday 07 Jan 2012 22:59:46 Ted Harding wrote:
>> Just a few somewhat random thoughts. I've been through this
>> sort of thing too often for it to be easy or quick to summarise!
> 
> I remember reading (on this list) a PHD thesis by Han The Thanh
> (of pdfTEX fame) on micro typography, although the original is
> now a dead link I think I've found it here:-
> 
> http://www.pragma-ade.com/pdftex/thesis.pdf
> 
> Many thought provoking ideas.
> 
> Cheers 
> Deri

Thanks for updating the link, Deri. Yes, I remember reading
this too, at the time, and also getting a lot of ideas.

For example, I define characters like

.char \[.>] \Z'.'
.char \[,>] \Z','
.char \[;>] \Z';'
.char \[:>] \Z':'
.char \[rq>] \Z'\[rq]'
.char \[qr>] \Z'\[qr]'
.char \[!>] \Z'!'
.char \[lq<] \Z'\h'-\w'\[lq]'u'\[lq]'
.char \[ql<] \Z'\h'-\w'\[lq]'u'\[ql]'
.char \[T<] \h'-0.300n'T

for use at the ends and beginnings of lines. Note the "\[T<]",
which, at the beginning of the line, gives a more pleasing
alignment of "T" with the character[s] above and/or below,
since the "visual impact" of "T" comes more from its vertical
central bar than from its horizontal top bar. The "-0.300n'"
may depend on which font you are using -- and nothing stops
you from using \h'-\n[bsp]u', where \n[bsp] can be defined
as \n[bspTR] or \n[bspBMB] or ... for fonts TimesRoman,
BookmanBold, ... .

For hyphenation it is more tricky, when inevitable. What I do
there (when in a context where I do this "microtypography"),
is to precede the first word in the line which to be output
by:

.ll +\w'\[hy]'u'

(this can occur anywhere in the source for the preceding line).
Then the "-" overhangs the right-hand end of the line by the
right amount. Then reset it with

.ll

(which can occur anywhere in the source for the line with
the hyphen).

And so on -- one can invent any amount of such things, and
the thesis in question gives a lot of ideas).

Ted.
----------------------------------
E-Mail: (Ted Harding) <Ted.Harding@wlandres.net>
Date: 08-Jan-2012
Time: 01:55:30

This message was sent by XFMail
----------------------------------


From MAILER-DAEMON Sun Jan 08 01:41:16 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjmRQ-0007yZ-D1
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 01:41:16 -0500
Received: from eggs.gnu.org ([140.186.70.92]:56407)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjmRN-0007xF-8H
	for groff@gnu.org; Sun, 08 Jan 2012 01:41:14 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjmRM-0007Pk-17
	for groff@gnu.org; Sun, 08 Jan 2012 01:41:13 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:60758)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjmRL-0007PY-Kb
	for groff@gnu.org; Sun, 08 Jan 2012 01:41:11 -0500
Received: (qmail invoked by alias); 08 Jan 2012 06:41:09 -0000
Received: from 178-190-69-84.adsl.highway.telekom.at (EHLO localhost)
	[178.190.69.84]
	by mail.gmx.net (mp019) with SMTP; 08 Jan 2012 07:41:09 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX191Dghq6DN1YnD04iodux/NBf8zu3anFKI0OFcMpV
	0GqkC9VXfpcYhn
Date: Sun, 08 Jan 2012 07:41:06 +0100 (CET)
Message-Id: <20120108.074106.48875857.wl@gnu.org>
To: deri@chuzzlewit.demon.co.uk
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <201201080130.12075.deri@chuzzlewit.demon.co.uk>
References: <XFMail.20120107225946.Ted.Harding@wlandres.net>
	<201201080130.12075.deri@chuzzlewit.demon.co.uk>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 06:41:14 -0000


> I remember reading (on this list) a PHD thesis by Han The Thanh (of
> pdfTEX fame) on micro typography, although the original is now a
> dead link I think I've found it here:-
> 
> http://www.pragma-ade.com/pdftex/thesis.pdf
> 
> Many thought provoking ideas.

All his ideas (or rather, Hermann Zapf's ideas) have been implemented
in pdfTeX.  However, this still doesn't solve the original issue
discussed in this thread.


    Werner


From MAILER-DAEMON Sun Jan 08 07:04:52 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjrUa-0000Sk-H4
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 07:04:52 -0500
Received: from eggs.gnu.org ([140.186.70.92]:49808)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RjrUX-0000Os-PI
	for groff@gnu.org; Sun, 08 Jan 2012 07:04:50 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RjrUW-0003cH-A8
	for groff@gnu.org; Sun, 08 Jan 2012 07:04:49 -0500
Received: from relay3-d.mail.gandi.net ([217.70.183.195]:34334)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>)
	id 1RjrUW-0003c9-08; Sun, 08 Jan 2012 07:04:48 -0500
X-Originating-IP: 217.70.178.146
Received: from mfilter18-d.gandi.net (mfilter18-d.gandi.net [217.70.178.146])
	by relay3-d.mail.gandi.net (Postfix) with ESMTP id 6C2B0A8075;
	Sun,  8 Jan 2012 13:04:46 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at mfilter18-d.gandi.net
Received: from relay3-d.mail.gandi.net ([217.70.183.195])
	by mfilter18-d.gandi.net (mfilter18-d.gandi.net [10.0.15.180])
	(amavisd-new, port 10024)
	with ESMTP id sZtz-gLwH11G; Sun,  8 Jan 2012 13:04:45 +0100 (CET)
X-Originating-IP: 86.74.235.181
Received: from localhost.localdomain (181.235.74.86.rev.sfr.net
	[86.74.235.181]) (Authenticated sender: sygne@ombres.eu)
	by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id 46A94A807F;
	Sun,  8 Jan 2012 13:04:44 +0100 (CET)
Date: Sun, 08 Jan 2012 13:04:15 +0100
From: Pierre-Jean <sygne@ombres.eu>
To: wl@gnu.org, deri@chuzzlewit.demon.co.uk
Message-ID: <4f09863f.TW19unGW/ECWFqcH%sygne@ombres.eu>
References: <XFMail.20120107225946.Ted.Harding@wlandres.net>
	<201201080130.12075.deri@chuzzlewit.demon.co.uk>
	<20120108.074106.48875857.wl@gnu.org>
In-Reply-To: <20120108.074106.48875857.wl@gnu.org>
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 217.70.183.195
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 12:04:50 -0000




Werner LEMBERG <wl@gnu.org> wrote:

>
> > I remember reading (on this list) a PHD thesis by Han The Thanh (of
> > pdfTEX fame) on micro typography, although the original is now a
> > dead link I think I've found it here:-
> >=20
> > http://www.pragma-ade.com/pdftex/thesis.pdf
> >=20
> > Many thought provoking ideas.
>
> All his ideas (or rather, Hermann Zapf's ideas) have been implemented
> in pdfTeX.  However, this still doesn't solve the original issue
> discussed in this thread.

They are also implemented in Heirloom Troff, which I've used for
the thesis of my wife, and which I'm still using for mine. These
functions are really usefull to shorten or expand a paragraph by
one line. For example, here are some macros that I use:

.de typo
.	\" Default typography adjustment.
.	\" Each paragraph use this.
.   padj		\" paragraph at once interword space adjustment.
.				\" to get a regular =C2=AB gris typographique =C2=BB.
.				\" An important thing in my opinion, the first
.				\" thing I've learned to see concerning typography.
.   ss 11 0		\" interword space
.   minss 10	\" In heirloom troff interword space may be shrinked
				\" this command define the minimum interword space
.   letadj 99 99 15 101 101	\" adjust letter space and width
.							\" 1: shorten inter-letter space in %
.							\" 2: shorten letter width in %
.							\" 3: size from which a word may be expanded
.							\" 4: larger inter-letter space in %
.							\" 5: larger letter width in %
.				\" hanging characters at the end of a line.
.				\" to get a better visual alignment.
.				\" 1: font, 2: glyph, 3: hanging width
.   rhang R - 100 \(hy 100 \(en 100 \(em 100 =C2=BB 150
.   rhang I - 100 \(hy 100 \(en 100 \(em 100 =C2=BB 150
.   rhang B - 100 \(hy 100 \(en 100 \(em 100 =C2=BB 150
.				\" One can also use .lhang for the begining of a line.
..
.de min
.   \" minimize paragraphs
.	\" Have to manually insert .min after .PP
.	\" Deal with .ss, .minss, and .letadj
.   padj
.   ss 10 0
.   minss 9
.   letadj 98 98 15 101 101
..
.de max
.   \" maximize paragraphs
.   padj
.   ss 12 0
.   minss 11
.   letadj 100 100 15 102 102
..


As we're talking about that, could we find some way to get
someone working on an implementation of these ideas in groff, via
a google summer of code, a call to donation, or something else?
Would you be interested to work on that Werner? Is there a way to
help?

Last but not least, all this is not only a matter of taste, it's
based on optic laws, and is a way of dealing with optic
illusions. People who are making fonts are also dealing with
optic illusions: to get a perfect visual alignment of glyphs, some must
be higher than others.

Cheers,

Pierre-Jean.



From MAILER-DAEMON Sun Jan 08 07:26:13 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjrpF-0003Pd-Uz
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 07:26:13 -0500
Received: from eggs.gnu.org ([140.186.70.92]:57208)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjrpD-0003On-JR
	for groff@gnu.org; Sun, 08 Jan 2012 07:26:12 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjrpC-00076x-DJ
	for groff@gnu.org; Sun, 08 Jan 2012 07:26:11 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:33545)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RjrpB-00076r-VR
	for groff@gnu.org; Sun, 08 Jan 2012 07:26:10 -0500
Received: (qmail invoked by alias); 08 Jan 2012 12:26:07 -0000
Received: from 178-190-69-84.adsl.highway.telekom.at (EHLO localhost)
	[178.190.69.84]
	by mail.gmx.net (mp007) with SMTP; 08 Jan 2012 13:26:07 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX1+A7BIgCnaAGAUR3CgvlONwnfsPWw5GS2ZjlGMzoI
	gQKUteOMijMv+V
Date: Sun, 08 Jan 2012 13:26:04 +0100 (CET)
Message-Id: <20120108.132604.305384227.wl@gnu.org>
To: sygne@ombres.eu
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <4f09863f.TW19unGW/ECWFqcH%sygne@ombres.eu>
References: <201201080130.12075.deri@chuzzlewit.demon.co.uk>
	<20120108.074106.48875857.wl@gnu.org>
	<4f09863f.TW19unGW/ECWFqcH%sygne@ombres.eu>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 213.165.64.23
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 12:26:12 -0000


>> All his ideas (or rather, Hermann Zapf's ideas) have been
>> implemented in pdfTeX.  However, this still doesn't solve the
>> original issue discussed in this thread.
> 
> They are also implemented in Heirloom Troff, which I've used for the
> thesis of my wife, and which I'm still using for mine.

Yes.  It's probably heretic to say but for serious typography Heirloom
troff offers much more possibilities.

> As we're talking about that, could we find some way to get someone
> working on an implementation of these ideas in groff, via a google
> summer of code, a call to donation, or something else?  Would you be
> interested to work on that Werner?  Is there a way to help?

Alas, I don't have time to do that (and admittedly, I also lack some
drive currently to invest time into groff).  My current work is
concentrated on ttfautohint, FreeType, and LilyPond.


    Werner


From MAILER-DAEMON Sun Jan 08 08:17:28 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rjscq-0005qf-Sv
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 08:17:28 -0500
Received: from eggs.gnu.org ([140.186.70.92]:36981)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1Rjsco-0005qI-FN
	for groff@gnu.org; Sun, 08 Jan 2012 08:17:27 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1Rjscn-0006QA-I2
	for groff@gnu.org; Sun, 08 Jan 2012 08:17:26 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:56629)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1Rjscn-0006Pw-D3
	for groff@gnu.org; Sun, 08 Jan 2012 08:17:25 -0500
Received: by bkaq10 with SMTP id q10so1238749bka.0
	for <groff@gnu.org>; Sun, 08 Jan 2012 05:17:23 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type:content-transfer-encoding;
	bh=wMGAFQuvbRam0nvUA5CLfRSJzr5NuQBWbleI9dYPAgU=;
	b=qdlp42Vy/zDDb2nXYDcMFG97uIwOC5SwQMenNwOmHGQ5F56KTCTvLaOL4pppUXeGHg
	Ktnmrcr9RDI2Hhx/CHYzOEvWuDbjfzbzdjJWvmivZJvQPDrgPWespM63n6qJ5ifhaIiv
	uzsPfMjppjUT7qLrXOSonj+eHEvJAmJJvGjII=
Received: by 10.205.121.14 with SMTP id ga14mr5519346bkc.32.1326028643819;
	Sun, 08 Jan 2012 05:17:23 -0800 (PST)
Received: from ANT ([95.73.139.85]) by mx.google.com with ESMTPS id
	t23sm116927726bkv.10.2012.01.08.05.17.22
	(version=TLSv1/SSLv3 cipher=OTHER);
	Sun, 08 Jan 2012 05:17:23 -0800 (PST)
Date: Sun, 8 Jan 2012 17:17:21 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Clarke Echols <clarke@verinet.net>
Message-Id: <20120108171721.ce8c06478ea456a45ff2ed68@gmail.com>
In-Reply-To: <4F078489.4000108@verinet.net>
References: <4F078489.4000108@verinet.net>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] End-of-page macro problem at end of input file...
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 13:17:27 -0000

Clarke Echols:

> I know the 'bp is the cause, but don't know how to
> handle page numbering at the bottom  of  the  page
> while  suppressing  the  'bp  request after EOF is
> reached.

Do I understand you correctly that you are calling a
'bp  explicitly  in  the  end  of your file?  If so,
maybe you could set up an end-of-input  macro  (.em)
instead,  wherein  you would set a global flag which
would be tested by your end-of-page  macro  and  the
'bp  would  be executed only if the flag is not set,
thereby eliminating the last 'bp?

Anton


From MAILER-DAEMON Sun Jan 08 08:44:01 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rjt2X-0001yQ-5w
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 08:44:01 -0500
Received: from eggs.gnu.org ([140.186.70.92]:60109)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rjt2V-0001xA-6c
	for groff@gnu.org; Sun, 08 Jan 2012 08:44:00 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rjt2U-0002x7-73
	for groff@gnu.org; Sun, 08 Jan 2012 08:43:59 -0500
Received: from relay02.pair.com ([209.68.5.16]:3590)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rjt2U-0002ww-1t
	for groff@gnu.org; Sun, 08 Jan 2012 08:43:58 -0500
Received: (qmail 84953 invoked from network); 8 Jan 2012 13:43:56 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay02.pair.com with SMTP; 8 Jan 2012 13:43:56 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id 2861932AAD; Sun,  8 Jan 2012 13:43:55 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 001FF32AAC;
	Sun,  8 Jan 2012 13:43:55 +0000 (GMT)
To: Clarke Echols <clarke@verinet.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <4F078489.4000108@verinet.net>
References: <4F078489.4000108@verinet.net>
Comments: In-reply-to Clarke Echols <clarke@verinet.net> message dated "Fri,
	06 Jan 2012 16:32:25 -0700."
Date: Sun, 08 Jan 2012 13:43:55 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120108134356.2861932AAD@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.68.5.16
Cc: Groff <groff@gnu.org>
Subject: Re: [Groff] End-of-page macro problem at end of input file...
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 13:44:00 -0000

Hi Clarke,

> .de print_page_number
> .ev pr_print_pageno
> .\"              Register `XX' is defined in the text source file:
> .\"              XX=1 means title page which has no printed page >number.
> .\"              XX=0 means other pages which all have printed page numbers.
> .
> .  if !\\n(XX \{\
> .sp .5v
> .  nf                        \" No fill for page number
> .  ce 1                      \" Center page number at bottom of page
> \(mi \\n% \(mi
> .  fi                        \" Back to normal fill
> \}
> .ev
> \}
> 'bp
> .
> ..

Is there one more \} than \{ here?

Cheers, Ralph.


From MAILER-DAEMON Sun Jan 08 11:02:10 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjvCE-0004SU-DP
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 11:02:10 -0500
Received: from eggs.gnu.org ([140.186.70.92]:56796)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1RjvCC-0004SJ-0L
	for groff@gnu.org; Sun, 08 Jan 2012 11:02:08 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1RjvCA-0007UD-OG
	for groff@gnu.org; Sun, 08 Jan 2012 11:02:07 -0500
Received: from smtp01.frii.com ([216.17.135.167]:42218)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1RjvCA-0007U2-DT
	for groff@gnu.org; Sun, 08 Jan 2012 11:02:06 -0500
Received: from [192.168.0.100] (dsl-251-44.dynamic-dsl.frii.net
	[216.17.251.44])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by smtp01.frii.com (FRII) with ESMTP id 2F5DEE80AD;
	Sun,  8 Jan 2012 09:02:04 -0700 (MST)
Message-ID: <4F09BE15.6030304@verinet.net>
Date: Sun, 08 Jan 2012 09:02:29 -0700
From: Clarke Echols <clarke@verinet.net>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.24) Gecko/20111109 Thunderbird/3.1.16
MIME-Version: 1.0
To: Ralph Corderoy <ralph@inputplus.co.uk>
References: <4F078489.4000108@verinet.net>
	<20120108134356.2861932AAD@orac.inputplus.co.uk>
In-Reply-To: <20120108134356.2861932AAD@orac.inputplus.co.uk>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 216.17.135.167
Cc: Groff <groff@gnu.org>
Subject: Re: [Groff] End-of-page macro problem at end of input file...
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 16:02:09 -0000

On 01/08/2012 06:43 AM, Ralph Corderoy wrote:
> Hi Clarke,
>
>> .de print_page_number
>> .ev pr_print_pageno
>> .\"              Register `XX' is defined in the text source file:
>> .\"              XX=1 means title page which has no printed page>number.
>> .\"              XX=0 means other pages which all have printed page numbers.
>> .
>> .  if !\\n(XX \{\
>> .sp .5v
>> .  nf                        \" No fill for page number
>> .  ce 1                      \" Center page number at bottom of page
>> \(mi \\n% \(mi
>> .  fi                        \" Back to normal fill
>> \}
>> .ev
>> \}
>> 'bp
>> .
>> ..
>
> Is there one more \} than \{ here?
>
> Cheers, Ralph.
>

That was the problem!

Nice catch.  It's annoying when something so obvious is so easily
over looked.

Thanks a bunch.

Clarke


From MAILER-DAEMON Sun Jan 08 13:32:11 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RjxXP-0005HK-FC
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 13:32:11 -0500
Received: from eggs.gnu.org ([140.186.70.92]:42404)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=NDg/S8=7T=schaffter.ca=peter@eigbox.net>)
	id 1RjxXN-0005HE-0i
	for groff@gnu.org; Sun, 08 Jan 2012 13:32:09 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <SRS0=NDg/S8=7T=schaffter.ca=peter@eigbox.net>)
	id 1RjxXL-0002Eo-Mg
	for groff@gnu.org; Sun, 08 Jan 2012 13:32:08 -0500
Received: from bosmailout10.eigbox.net ([66.96.189.10]:49224)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=NDg/S8=7T=schaffter.ca=peter@eigbox.net>)
	id 1RjxXL-0002Ek-JC
	for groff@gnu.org; Sun, 08 Jan 2012 13:32:07 -0500
Received: from bosmailscan21.eigbox.net ([10.20.15.21])
	by bosmailout10.eigbox.net with esmtp (Exim) id 1RjxXK-0004jA-4x
	for groff@gnu.org; Sun, 08 Jan 2012 13:32:06 -0500
Received: from bosimpout02.eigbox.net ([10.20.55.2])
	by bosmailscan21.eigbox.net with esmtp (Exim) id 1RjxXK-0001Me-3v
	for groff@gnu.org; Sun, 08 Jan 2012 13:32:06 -0500
Received: from bosauthsmtp11.eigbox.net ([10.20.18.11])
	by bosimpout02.eigbox.net with NO UCE
	id K6Y61i0040EKspE016Y6f3; Sun, 08 Jan 2012 13:32:06 -0500
X-EN-OrigOutIP: 10.20.18.11
X-EN-IMPSID: K6Y61i0040EKspE016Y6f3
Received: from bas1-ottawa09-2925287607.dsl.bell.ca ([174.92.88.183]
	helo=augustus)
	by bosauthsmtp11.eigbox.net with esmtpsa (TLSv1:AES256-SHA:256)
	(Exim) id 1RjxXJ-0002c5-Ra
	for groff@gnu.org; Sun, 08 Jan 2012 13:32:05 -0500
Received: from peter by augustus with local (Exim 4.76)
	(envelope-from <peter@schaffter.ca>) id 1RjxXI-0002ew-0x
	for groff@gnu.org; Sun, 08 Jan 2012 13:32:04 -0500
Date: Sun, 8 Jan 2012 13:32:03 -0500
From: Peter Schaffter <peter@schaffter.ca>
To: groff@gnu.org
Message-ID: <20120108183203.GA3157@augustus>
Mail-Followup-To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
References: <201201080130.12075.deri@chuzzlewit.demon.co.uk>
	<20120108.074106.48875857.wl@gnu.org>
	<4f09863f.TW19unGW/ECWFqcH%sygne@ombres.eu>
	<20120108.132604.305384227.wl@gnu.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20120108.132604.305384227.wl@gnu.org>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-EN-UserInfo: de950a90bfbefba2fd690f5ecdd2f718:712911bb6d01017077352c3c8e2e335d
X-EN-AuthUser: peter@schaffter.ca
Sender: Peter Schaffter <peter@schaffter.ca>
X-EN-OrigIP: 174.92.88.183
X-EN-OrigHost: bas1-ottawa09-2925287607.dsl.bell.ca
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 66.96.189.10
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 18:32:09 -0000

On Sun, Jan 08, 2012, Werner Lemberg wrote:
> Yes.  It's probably heretic to say but for serious typography Heirloom
> troff offers much more possibilities.

Not heretical at all, merely true, as Pierre-Jean's example
demonstrates.

How radically different is Heirloom troff's code from groff's?  Is
there anything in groff that would conflict with implementations of
.padj, .minss and .letadj?  Their absence, or the absence of
analogous requests, strikes me as a major stumbling block in groff.

-- 
Peter Schaffter

Author of The Binbrook Caucus
http://www.schaffter.ca


From MAILER-DAEMON Sun Jan 08 16:35:43 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rk0P1-0005mN-Ge
	for mharc-groff@gnu.org; Sun, 08 Jan 2012 16:35:43 -0500
Received: from eggs.gnu.org ([140.186.70.92]:46942)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1Rk0Oz-0005lB-1l
	for groff@gnu.org; Sun, 08 Jan 2012 16:35:42 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1Rk0Ox-00029N-UZ
	for groff@gnu.org; Sun, 08 Jan 2012 16:35:41 -0500
Received: from mail.cs.dartmouth.edu ([129.170.212.100]:38209)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <doug@cs.dartmouth.edu>) id 1Rk0Ox-00029H-SF
	for groff@gnu.org; Sun, 08 Jan 2012 16:35:39 -0500
Received: from stowe.cs.dartmouth.edu (stowe.cs.dartmouth.edu [129.170.213.62])
	by mail.cs.dartmouth.edu (8.14.5/8.14.5) with ESMTP id q08LZb4k021997
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT)
	for <groff@gnu.org>; Sun, 8 Jan 2012 16:35:37 -0500
X-DomainKeys: Sendmail DomainKeys Filter v1.0.2 mail.cs.dartmouth.edu
	q08LZb4k021997
Received: from stowe.cs.dartmouth.edu (localhost.localdomain [127.0.0.1])
	by stowe.cs.dartmouth.edu (8.14.5/8.14.1) with ESMTP id q08LZa2Z018967
	for <groff@gnu.org>; Sun, 8 Jan 2012 16:35:36 -0500
Received: (from doug@localhost)
	by stowe.cs.dartmouth.edu (8.14.5/8.14.5/Submit) id q08LZa2e018966
	for groff@gnu.org; Sun, 8 Jan 2012 16:35:36 -0500
From: Doug McIlroy <doug@cs.dartmouth.edu>
Message-Id: <201201082135.q08LZa2e018966@stowe.cs.dartmouth.edu>
Date: Sun, 08 Jan 2012 16:35:36 -0500
To: groff@gnu.org
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 129.170.212.100
Subject: [Groff] groff to RTF or Word
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Jan 2012 21:35:42 -0000

I have a paper composed in notrivial groff (uses pic,
eqn, tbl, and .PSPIC), which I'd like to submit to a
journal that takes any kind of digital text--as
long as it's Word or RTF.  I haven't been able to find
any tool that offers much help in getting from here to 
there. I'd be delighted if somebody could tell me I 
missed something capable.

Doug McIlroy


From MAILER-DAEMON Mon Jan 09 01:10:37 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rk8RJ-0001zN-0y
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 01:10:37 -0500
Received: from eggs.gnu.org ([140.186.70.92]:52067)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <foveal@mail150.pair.com>) id 1Rk6D6-0008Dn-M8
	for groff@gnu.org; Sun, 08 Jan 2012 22:47:49 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <foveal@mail150.pair.com>) id 1Rk6D5-0001cx-Ot
	for groff@gnu.org; Sun, 08 Jan 2012 22:47:48 -0500
Received: from www6.webmail.pair.com ([66.39.3.84]:55575)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <foveal@mail150.pair.com>) id 1Rk6D5-0001ct-LC
	for groff@gnu.org; Sun, 08 Jan 2012 22:47:47 -0500
Received: (qmail 43027 invoked by uid 65534); 9 Jan 2012 03:47:46 -0000
Received: from 198.161.29.197 ([198.161.29.197])
	(SquirrelMail authenticated user foveal@mail150.pair.com)
	by sm.webmail.pair.com with HTTP; Sun, 8 Jan 2012 22:47:46 -0500
Message-ID: <7b32f28b62bb37d904d7df833f8671ad.squirrel@sm.webmail.pair.com>
In-Reply-To: <201201082135.q08LZa2e018966@stowe.cs.dartmouth.edu>
References: <201201082135.q08LZa2e018966@stowe.cs.dartmouth.edu>
Date: Sun, 8 Jan 2012 22:47:46 -0500
From: foveal@mail150.pair.com
To: "Doug McIlroy" <doug@cs.dartmouth.edu>
User-Agent: SquirrelMail/1.4.22 [SVN]
MIME-Version: 1.0
Content-Type: text/plain;charset=utf-8
Content-Transfer-Encoding: 8bit
X-Priority: 3 (Normal)
Importance: Normal
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 66.39.3.84
X-Mailman-Approved-At: Mon, 09 Jan 2012 01:10:33 -0500
Cc: groff@gnu.org
Subject: Re: [Groff] groff to RTF or Word
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 09 Jan 2012 03:47:49 -0000

> I have a paper composed in notrivial groff (uses pic,
> eqn, tbl, and .PSPIC), which I'd like to submit to a
> journal that takes any kind of digital text--as
> long as it's Word or RTF.  I haven't been able to find
> any tool that offers much help in getting from here to
> there. I'd be delighted if somebody could tell me I
> missed something capable.
>
> Doug McIlroy

It has been a while, but I think I was reasonably successful at groffing to PDF
and then importing the PDF into Word.

Mike Bianchi



From MAILER-DAEMON Mon Jan 09 01:37:20 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rk8rA-0006aH-B5
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 01:37:20 -0500
Received: from eggs.gnu.org ([140.186.70.92]:51487)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1Rk8r7-0006Xt-Tq
	for groff@gnu.org; Mon, 09 Jan 2012 01:37:19 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1Rk8r6-0005is-LF
	for groff@gnu.org; Mon, 09 Jan 2012 01:37:17 -0500
Received: from smtp02.frii.com ([216.17.135.168]:35867)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1Rk8r6-0005ij-GW
	for groff@gnu.org; Mon, 09 Jan 2012 01:37:16 -0500
Received: from [192.168.0.100] (dsl-251-44.dynamic-dsl.frii.net
	[216.17.251.44])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by smtp02.frii.com (FRII) with ESMTP id B766BD8BC0;
	Sun,  8 Jan 2012 23:37:14 -0700 (MST)
Message-ID: <4F0A8B34.8020108@verinet.net>
Date: Sun, 08 Jan 2012 23:37:40 -0700
From: Clarke Echols <clarke@verinet.net>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.24) Gecko/20111109 Thunderbird/3.1.16
MIME-Version: 1.0
To: foveal@mail150.pair.com
References: <201201082135.q08LZa2e018966@stowe.cs.dartmouth.edu>
	<7b32f28b62bb37d904d7df833f8671ad.squirrel@sm.webmail.pair.com>
In-Reply-To: <7b32f28b62bb37d904d7df833f8671ad.squirrel@sm.webmail.pair.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 216.17.135.168
Cc: Doug McIlroy <doug@cs.dartmouth.edu>, groff@gnu.org
Subject: Re: [Groff] groff to RTF or Word
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 09 Jan 2012 06:37:19 -0000

On 01/08/2012 08:47 PM, foveal@mail150.pair.com wrote:
>> I have a paper composed in notrivial groff (uses pic,
>> eqn, tbl, and .PSPIC), which I'd like to submit to a
>> journal that takes any kind of digital text--as
>> long as it's Word or RTF.  I haven't been able to find
>> any tool that offers much help in getting from here to
>> there. I'd be delighted if somebody could tell me I
>> missed something capable.
>>
>> Doug McIlroy
>
> It has been a while, but I think I was reasonably successful at groffing to PDF
> and then importing the PDF into Word.
>
> Mike Bianchi
>
>
>

I did a Google search for "convert pdf to word" and selected the link
to:

    http://convertpdftoword.net/

Use browse field and button to find the file on your system, press
the convert button, and you can open it with your local Word program.

I took a groff file and formatted it into PostScript. Used the Linux
ps2pdf command to create a PDF file, did the conversion and opened it
in LibreWriter.  It did a sort of okay job, but dropped all of the
font changes (no bold or italics).



From MAILER-DAEMON Mon Jan 09 01:52:09 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rk95V-0007dr-MI
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 01:52:09 -0500
Received: from eggs.gnu.org ([140.186.70.92]:58808)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rk95T-0007dj-6W
	for groff@gnu.org; Mon, 09 Jan 2012 01:52:07 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rk95S-0007Kl-5Z
	for groff@gnu.org; Mon, 09 Jan 2012 01:52:07 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:51852)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rk95R-0007Kf-Ng
	for groff@gnu.org; Mon, 09 Jan 2012 01:52:06 -0500
Received: (qmail invoked by alias); 09 Jan 2012 06:52:03 -0000
Received: from 77.119.9.75.wireless.dyn.drei.com (EHLO localhost) [77.119.9.75]
	by mail.gmx.net (mp023) with SMTP; 09 Jan 2012 07:52:03 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX1/16x96zun1Z3MKr5rpb19G90lKAjfRWyhAB7VPlG
	RfSycyXd9oOvMx
Date: Mon, 09 Jan 2012 07:51:53 +0100 (CET)
Message-Id: <20120109.075153.216338150.wl@gnu.org>
To: peter@schaffter.ca
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20120108183203.GA3157@augustus>
References: <4f09863f.TW19unGW/ECWFqcH%sygne@ombres.eu>
	<20120108.132604.305384227.wl@gnu.org>
	<20120108183203.GA3157@augustus>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 09 Jan 2012 06:52:08 -0000


> How radically different is Heirloom troff's code from groff's?

Heirloom troff is essentially using TeX's algorithm (with slight
simplifications, AFAIK) to format paragraphs.

> Is there anything in groff that would conflict with implementations
> of .padj, .minss and .letadj?  Their absence, or the absence of
> analogous requests, strikes me as a major stumbling block in groff.

It would be necessary to completely rewrite the paragraph formatting
algorithm.


    Werner


From MAILER-DAEMON Mon Jan 09 11:12:31 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RkHpn-00022Q-Gy
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 11:12:31 -0500
Received: from eggs.gnu.org ([140.186.70.92]:49660)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kollar@windstream.net>) id 1RkHpi-00021O-10
	for groff@gnu.org; Mon, 09 Jan 2012 11:12:29 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <kollar@windstream.net>) id 1RkHpc-0003z6-Ai
	for groff@gnu.org; Mon, 09 Jan 2012 11:12:25 -0500
Received: from pacmmta53.windstream.net ([162.39.147.112]:63101)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kollar@windstream.net>) id 1RkHpc-0003xe-4c
	for groff@gnu.org; Mon, 09 Jan 2012 11:12:20 -0500
X-WS-COS: WSOB802
X-Cloudmark-Category: Undefined:Undefined
X-Cloudmark-Analysis: v=1.1 cv=ItSgKUvEgpuArvFeGcEX9ho8h0+4pTt73K5WgrMP114=
	c=1 sm=0 a=pAfMX2rzoXQA:10 a=UT_QgiwtmQIA:10 a=kj9zAlcOel0A:10
	a=FTCQuhMVqN2lshzFd-wA:9 a=CjuIK1q_8ugA:10
	a=Xk+YgzcmsGoUE9NXLNffdw==:117
X-Cloudmark-Score: 0
Authentication-Results: pacmmta53 smtp.user=kollar@windstream.net;
	auth=pass (PLAIN)
Received: from [166.137.13.166] ([166.137.13.166:59670] helo=[10.128.169.177])
	by pacmmta53 (envelope-from <kollar@windstream.net>)
	(ecelerity 2.2.3.47 r(39824M)) with ESMTPA
	id 7F/95-21063-3D11B0F4; Mon, 09 Jan 2012 11:12:09 -0500
References: <201201082135.q08LZa2e018966@stowe.cs.dartmouth.edu>
In-Reply-To: <201201082135.q08LZa2e018966@stowe.cs.dartmouth.edu>
Mime-Version: 1.0 (1.0)
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii
Message-Id: <961EE1CB-AEC3-49F6-BEF3-06407485BE0D@windstream.net>
X-Mailer: iPhone Mail (9A405)
From: Larry Kollar <kollar@windstream.net>
Date: Mon, 9 Jan 2012 11:11:56 -0500
To: Doug McIlroy <doug@cs.dartmouth.edu>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 162.39.147.112
Cc: "groff@gnu.org" <groff@gnu.org>
Subject: Re: [Groff] groff to RTF or Word
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 09 Jan 2012 16:12:29 -0000

On Jan 8, 2012, at 4:35 PM, Doug McIlroy <doug@cs.dartmouth.edu> wrote:

> I have a paper composed in notrivial groff (uses pic,
> eqn, tbl, and .PSPIC), which I'd like to submit to a
> journal that takes any kind of digital text--as
> long as it's Word or RTF.  I haven't been able to find
> any tool that offers much help in getting from here to=20
> there. I'd be delighted if somebody could tell me I=20
> missed something capable.

You might try converting to HTML and import that into Word. You can get reas=
onable HTML out of groff using grohtml and some cleanup (HTML Tidy is good f=
or this), except for tables. I have an awk filter that converts simple tbl i=
nput to HTML though.

-- Larry=


From MAILER-DAEMON Mon Jan 09 11:28:33 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RkI5J-0005gE-I2
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 11:28:33 -0500
Received: from eggs.gnu.org ([140.186.70.92]:46875)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gaius@glam.ac.uk>) id 1RkI56-0005Yf-Ap
	for groff@gnu.org; Mon, 09 Jan 2012 11:28:29 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <gaius@glam.ac.uk>) id 1RkI51-0006Xi-JB
	for groff@gnu.org; Mon, 09 Jan 2012 11:28:20 -0500
Received: from mta3.glam.ac.uk ([193.63.147.53]:58259)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <gaius@glam.ac.uk>) id 1RkI51-0006XL-5v
	for groff@gnu.org; Mon, 09 Jan 2012 11:28:15 -0500
Received: from j228-gm.comp.glam.ac.uk ([193.63.148.84])
	by mta3.glam.ac.uk with esmtp (Exim 4.76)
	(envelope-from <gaius@glam.ac.uk>)
	id 1RkI4r-0005Ym-FR; Mon, 09 Jan 2012 16:28:05 +0000
Received: from gaius by j228-gm.comp.glam.ac.uk with local (Exim 4.72)
	(envelope-from <gaius@glam.ac.uk>)
	id 1RkI2w-0003Ms-Ml; Mon, 09 Jan 2012 16:26:06 +0000
From: Gaius Mulley <gaius@glam.ac.uk>
To: Larry Kollar <kollar@windstream.net>
References: <201201082135.q08LZa2e018966@stowe.cs.dartmouth.edu>
	<961EE1CB-AEC3-49F6-BEF3-06407485BE0D@windstream.net>
Date: Mon, 09 Jan 2012 16:26:06 +0000
In-Reply-To: <961EE1CB-AEC3-49F6-BEF3-06407485BE0D@windstream.net> (Larry
	Kollar's message of "Mon, 9 Jan 2012 11:11:56 -0500")
Message-ID: <87fwfosuzl.fsf@j228-gm.comp.glam.ac.uk>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-detected-operating-system: by eggs.gnu.org: FreeBSD 6.x (1)
X-Received-From: 193.63.147.53
Cc: Doug McIlroy <doug@cs.dartmouth.edu>, "groff@gnu.org" <groff@gnu.org>
Subject: Re: [Groff] groff to RTF or Word
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 09 Jan 2012 16:28:29 -0000

--=-=-=

Larry Kollar <kollar@windstream.net> writes:

> On Jan 8, 2012, at 4:35 PM, Doug McIlroy <doug@cs.dartmouth.edu> wrote:
>
>> I have a paper composed in notrivial groff (uses pic,
>> eqn, tbl, and .PSPIC), which I'd like to submit to a
>> journal that takes any kind of digital text--as
>> long as it's Word or RTF.  I haven't been able to find
>> any tool that offers much help in getting from here to 
>> there. I'd be delighted if somebody could tell me I 
>> missed something capable.
>
> You might try converting to HTML and import that into Word. You can
> get reasonable HTML out of groff using grohtml and some cleanup (HTML
> Tidy is good for this), except for tables. I have an awk filter that
> converts simple tbl input to HTML though.
>
> -- Larry

Hi,

I convert to html and use a script to generate rtf:

$ make 3.rtf
groff -P-r -P-b -s -p -t -e -Thtml -mgp 3.n > 3.html
../../SHELL/html2rtf 3.html
rm 3.html


the script is:


--=-=-=
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=html2rtf
Content-Transfer-Encoding: base64
Content-Description: html2rtf

IyEvdXNyL2Jpbi9wZXJsCiMKIyBIVE1MMlJURiAgLS0gIE1ha2UgYW4gUlRGIHJlbmRlcmluZyBv
ZiBhbiBIVE1MIGZpbGUuCiMKJGh0bWwycnRmX3ZlcnNpb24gPSAnSFRNTDJSVEYgdjEuMWEnOyAg
ICMgYnkgc2VhbkBxcmQub3JnCiRodG1sMnJ0Zl9yZXZpc2lvbiA9IAogICAgJyBUaW1lLXN0YW1w
OiA8MTk5Ny0xMS0yNSAyMjoyNTozMCBNU1Qgc2J1cmtlQGJhYmVsLmxpbmcubnd1LmVkdT4gJzsK
IyBUaGlzIHBhY2thZ2UgaXMgQ29weXJpZ2h0IDE5OTYtIGJ5IFNlYW4gTS4gQnVya2UsIHNlYW5A
cXJkLm9yZwojCiMgU2VlIHRoZSBkb2NzIGF0IGh0dHA6Ly93d3cubGluZy5ud3UuZWR1L35zYnVy
a2UvaHRtbDJydGYvCiMgIFF1aWNrIHVzYWdlIHN1bW1hcnk6ICAgIGh0bWwycnRmLnBsIGlucHV0
Lmh0bWwKIwojIGh0bWwycnRmIGlzIGZyZWUgc29mdHdhcmU7IHlvdSBjYW4gcmVkaXN0cmlidXRl
IGl0IGFuZC9vciBtb2RpZnkgaXQKIyB1bmRlciB0aGUgdGVybXMgb2YgdGhlIEdOVSBHZW5lcmFs
IFB1YmxpYyBMaWNlbnNlIGFzIHB1Ymxpc2hlZCBieSB0aGUKIyBGcmVlIFNvZnR3YXJlIEZvdW5k
YXRpb247IGVpdGhlciB2ZXJzaW9uIDIsIG9yIChhdCB5b3VyIG9wdGlvbikgYW55CiMgbGF0ZXIg
dmVyc2lvbi4KIwojIGh0bWwycnRmIGlzIGRpc3RyaWJ1dGVkIGluIHRoZSBob3BlIHRoYXQgaXQg
d2lsbCBiZSB1c2VmdWwsIGJ1dAojIFdJVEhPVVQgQU5ZIFdBUlJBTlRZOyB3aXRob3V0IGV2ZW4g
dGhlIGltcGxpZWQgd2FycmFudHkgb2YKIyBNRVJDSEFOVEFCSUxJVFkgb3IgRklUTkVTUyBGT1Ig
QSBQQVJUSUNVTEFSIFBVUlBPU0UuICBTZWUgdGhlIEdOVQojIEdlbmVyYWwgUHVibGljIExpY2Vu
c2UgZm9yIG1vcmUgZGV0YWlscy4KIwojIFRvIHNlZSBhIGNvcHkgb2YgdGhlIEdOVSBHZW5lcmFs
IFB1YmxpYyBMaWNlbnNlLCBzZWUKIyBodHRwOi8vd3d3Lmxpbmcubnd1LmVkdS9+c2J1cmtlL2du
dV9yZWxlYXNlLmh0bWwsIG9yIHdyaXRlIHRvIHRoZQojIEZyZWUgU29mdHdhcmUgRm91bmRhdGlv
biwgNjc1IE1hc3MgQXZlLCBDYW1icmlkZ2UsIE1BIDAyMTM5LCBVU0EuCiMgLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCgojIyBDb25m
aWd1cmFibGVzIGZvbGxvdy4uLgokZGVidWcgPSAxOwogIyAwIG1ha2VzIHRoaXMgcHJvZ3JhbSB0
b3RhbGx5IHF1aWV0IGV4Y2VwdCBmb3IgZXJyb3JzIG9yIHdhcm5pbmdzCiAjICAgIC0tIGdvb2Qg
Zm9yIHVzZSwgc2F5LCBpbiBhIGJhdGNoIGZpbGUKICMgMSBtYWtlcyB0aGlzIHByb2dyYW0gc2F5
IGZyaWVuZGx5IHRoaW5ncyBsaWtlIHNheSB3aGF0IGZpbGUKICMgICAgaXQncyB3b3JraW5nIG9u
LgogIyBhYm92ZSAxIG1ha2VzIGl0IHNwaXQgb3V0IHRoZSBSVEYgY29kZSBvbiBTVERPVVQgYXMg
d2VsbCBhcyB0byBhIGZpbGUuCgoKIyBIZXJlIHNldCB0aGUgbmFtZSBvZiB0aGUgZm9udHMgdG8g
dXNlIGZvciBwcm9wb3J0aW9uYWwgKG5vcm1hbCkKIyBhbmQgbW9ub3NwYWNlIChDT0RFLCBQUkUp
IHRleHQuICBUaGV5IGhhdmUgdG8gYmUgdGhlIGV4YWN0ICg/KSBuYW1lCiMgb2YgdGhlIGZvbnRz
IGFzIHRoZXkgZXhpc3Qgb24geW91ciBzeXN0ZW0uCiRwcm9wb3J0aW9uYWxfZm9udCA9ICdUaW1l
cyBOZXcgUm9tYW4nOwogICMgQWx0ZXJuYXRlbHksIGNob29zZSwgc2F5LCAnQXJpYWwnLCBvciBt
YXliZSAnT3B0aW1hJyBvciBhIFNjaG9vbGJvb2suCiAgIyBTdXBlcnBpbXBzIHVzZSAnRG9tQ2Fz
dWFsIEJUJyBvciAnQ29vcGVyIEJsayBCVCcKJG1vbm9zcGFjZV9mb250ID0gJ0NvdXJpZXIgTmV3
JzsKCiMgVGhlc2UgZGV0ZXJtaW5lIHdoYXQgY2hhcmFjdGVycyBzdHlsZXMKIyBhcmUgcmVuZGVy
ZWQgYXMgd2hhdCBmb250IGF0dHJpYnV0ZXMuCkBpdGFsaWNfc3R5bGVzID0gKCdJJywgJ0NJVEUn
LCAnVkFSJyk7CkBib2xkX3N0eWxlcyA9ICgnU1RST05HJywgJ0InLCAnREVGTicpOwpAdW5kZXJs
aW5lX3N0eWxlcyA9ICgnVScsICdFTScpOwoKJHRhYiA9IDcyMDsgIyBkaXN0YW5jZSBiZXR3ZWVu
IHRhYiBzdG9wcywgaW4gdHdpcHMuICA3MjAgdHdpcHMgPSAuNSBpbmNoZXMuCgojIEhvdyB0byBy
ZW5kZXIgaG9yaXpvbnRhbCBydWxlcwokaHJfc3R5bGUgPSAnXHFjXGVtZGFzaFxlbWRhc2hcZW1k
YXNoJzsKCiMgZm9yIGEgZmFuY2llciBhbmQgbGFyZ2VyIEhSLCB1c2UgJ1xxY3tcZnMxMDBcYiB+
fScKIyBXaXNobGlzdDogd3JpdGUgbG9naWMgdGhhdCdsbCBzcGl0IG91dCBkaWZmZXJlbnQgL2tp
bmRzLyBvZiBIUnMKIyAgZGVwZW5kaW5nIG9uIHRoZSBpbmRlbnQgbGV2ZWw/CgokcGFyYWdyYXBo
X3NwYWNlX2JlZm9yZSA9IDkwOwogICMgRWFjaCA8UD4gaXMgcHJlY2VkZWQgYnkgdGhpcyBtYW55
IHR3aXBzIG9mIHNwYWNlIGRvd253YXJkCiAgIyB0d2lwID09IDEvMTQ0MHRoIG9mIGFuIGluY2gg
PT0gMS8yMHRoIG9mIGEgcG9pbnQKICAjICAoQ2YuIHBvaW50ID0gMS83Mm5kIG9mIGFuIGluY2gp
CiRoZWFkaW5nX3NwYWNlX2JlZm9yZSA9ICRwYXJhZ3JhcGhfc3BhY2VfYmVmb3JlICogMjsKICAj
IEVhY2ggaGVhZGluZyBzdHlsZSAoSDEtSDYpIGlzIHByZWNlZGVkIGJ5IHRoaXMgbWFueQogICMg
dHdpcHMgb2Ygc3BhY2UgZG93bndhcmQuCgpAaGVhZGluZ19zdHlsZXMgPSAoICdcZnM1NSAnLCAn
XGZzNTAgJywgJ1xmczQ1ICcsCgkJJ1xmczQwICcsICdcZnMzNSAnLCAnXGZzMzAgJyk7CgkjIFN0
eWxlcyBmb3IgdGhlIGhlYWRpbmdzLCBzdGFydGluZyBmcm9tIEgxLCBlbmRpbmcgd2l0aCBINgoJ
IyBcXGZzNDAgbWVhbnMgMjAtcG9pbnQsIFxcZnM1MCBtZWFucyAyNS1wb2ludCwgZXRjLgoKI1do
YXQgZm9sbG93cyBpcyB0aGUgYXNzb2NpYXRpb24gb2YgdGhlIGNvbnRlbnRzIG9mIGFtcGVyc2Fu
ZCBlbnRpdGllcwojIHRvIHdoYXQgdGhleSBleHBhbmQgZG8uICBJJ3ZlIHF1b3RlZCBhbGwgOC1i
aXQgdmFsdWVzIGhlcmUganVzdCBzbwojIHRoZSBQRVJMIHNjcmlwdHMgZG9lc24ndCBnZXQgbWFu
Z2VkIGluIHRyYW5zaXQuCiMgWW91IGNhbiBhZGQgYW55dGhpbmcgeW91IHdhbnQgaGVyZS4KCiVl
bnRpdGllcyA9IHNwbGl0KC9bIFxuXSosWyBcbl0qLywKInN6bGlnLFx4ZGYsZXRoLFx4ZjAsRVRI
LFx4ZDAsdGhvcm4sXHhmZSxUSE9STixceGRlLHl1bWwsXHhmZiwKeWFjdXRlLFx4ZmQsWWFjdXRl
LFx4ZGQsdXVtbCxceGZjLFV1bWwsXHhkYyx1Z3JhdmUsXHhmOSwKVWdyYXZlLFx4ZDksdWNpcmMs
XHhmYixVY2lyYyxceGRiLHVhY3V0ZSxceGZhLFVhY3V0ZSxceGRhLApvY2lyYyxceGY0LE9jaXJj
LFx4ZDQsCm90aWxkZSxceGY1LE90aWxkZSxceGQ1LG9zbGFzaCxceGY4LE9zbGFzaCxceGQ4LG9n
cmF2ZSxceGYyLApPZ3JhdmUsXHhkMixvYWN1dGUsXHhmMyxPYWN1dGUsXHhkMyxudGlsZGUsXHhm
MSxOdGlsZGUsXHhkMSwKaXVtbCxceGVmLEl1bWwsXHhjZixpZ3JhdmUsXHhlYyxJZ3JhdmUsXHhj
YyxpY2lyYyxceGVlLApJY2lyYyxceGNlLGlhY3V0ZSxceGVkLElhY3V0ZSxceGNkLGV1bWwsXHhl
YixFdW1sLFx4Y2IsCmVncmF2ZSxceGU4LEVncmF2ZSxceGM4LGVjaXJjLFx4ZWEsRWNpcmMsXHhj
YSxlYWN1dGUsXHhlOSwKRWFjdXRlLFx4YzksY2NlZGlsLFx4ZTcsQ2NlZGlsLFx4YzcsYWVsaWcs
XHhlNixBRWxpZyxceGM2LAphdGlsZGUsXHhlMyxBdGlsZGUsXHhjMyxhZ3JhdmUsXHhlMCxBZ3Jh
dmUsXHhjMCxhY2lyYyxceGUyLApBY2lyYyxceGMyLGFhY3V0ZSxceGUxLEFhY3V0ZSxceGMxLG91
bWwsXHhmNixPdW1sLFx4ZDYsYXJpbmcsXHhlNSwKQXJpbmcsXHhjNSxhdW1sLFx4ZTQsQXVtbCxc
eGM0LHF1b3QsXCIsYW1wLFwmLGd0LFw+LGx0LFw8LApjb3B5LFx4YTkscmVnLFx4YWUsCmVuc3As
XFxlbnNwYWNlICxlbXNwLFxcZW1zcGFjZSAsbmJzcCxcXH4sXCM5MixcXFxcLFwjMTIzLFxcXHss
XCMxMjUsXFxcfSwKXCMxMyxcXHBhcixcIzEwLFxccGFyLFwjMDEzLFxccGFyLFwjMDEwLFxccGFy
IiApOwogICMgVGhvc2UgbGFzdCB0d28gbGluZXMgYXJlIFJURi1zcGVjaWZpYy4gIEV2ZXJ5dGhp
bmcgYmVmb3JlIGlzIHJldXNhYmxlCiAgIyBpbiBub24tUlRGIHRoaW5ncy4KCgojIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
IyMjCiMjIEVORCBvZiBjb25zdGFudHMgJiBjb25maWd1cmFibGVzLgojIyBEb24ndCBjaGFuZ2Ug
YW55dGhpbmcgZnJvbSBoZXJlIG9uLCB1bmxlc3MgeW91IHJlYWxseSBrbm93CiMjICB3aGF0IHlv
dSdyZSBkb2luZy4KIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIwoKJGNoYXJzZXQgPSAnXGZjaGFyc2V0MjU1JzsKICAj
IDI1NSA9IE9FTSwgc3VwcG9zZWRseSBhIGdvb2QgYXBwcm94aW1hdGlvbiBvZiBJU08tTGF0aW4t
MQoKJHBhcmFncmFwaF9zcGFjZV9iZWZvcmUgPSAiXFxzYiRwYXJhZ3JhcGhfc3BhY2VfYmVmb3Jl
IjsKJGhlYWRpbmdfc3BhY2VfYmVmb3JlID0gIlxcc2IkaGVhZGluZ19zcGFjZV9iZWZvcmUiOwoK
JGZvbnR0YWJsZSA9ICJcXGRlZmYwIHtcXGZvbnR0YmwKe1xcZjBcXGZyb21hbiAkY2hhcnNldCAk
cHJvcG9ydGlvbmFsX2ZvbnQ7fQp7XFxmMVxcZm1vZGVybiAkY2hhcnNldCAkbW9ub3NwYWNlX2Zv
bnQ7fX0iOwoKIyBZb3UgY2FuIGFkZCBhZGRpdGlvbmFsIGZvbnRzIHRvIHRoZSBmb250IHRhYmxl
IHRoZXJlIGlmIHlvdSB3YW50CiMgdG8gdXNlIHRoZW0sIGZvciBoZWFkaW5ncywgc2F5LgojIEUu
Zy4sIHRvIGFkZCBBcmlhbCBhcyBhIHRoaXJkIGZvbnQgYW5kIHRvIGhhdmUgaGVhZGluZ3MgaW4g
aXQsIGdvOgojICAgJGZvbnR0YWJsZSA9ICJcXGRlZmYwIHtcXGZvbnR0YmwKIyAgIHtcXGYwXFxm
cm9tYW4gJGNoYXJzZXQgJHByb3BvcnRpb25hbF9mb250O30KIyAgIHtcXGYxXFxmbW9kZXJuICRj
aGFyc2V0ICRtb25vc3BhY2VfZm9udDt9fSI7CiMgICB7XFxmMlxcZnN3aXNzICRjaGFyc2V0IEFy
aWFsO319IjsKIwojIFRoZW4gdG8gY2hhbmdlIHRoZSBoZWFkaW5nIHN0eWxlcyB0byBBcmlhbCBi
b2xkIGl0YWxpYzoKIyAgIEBoZWFkaW5nX3N0eWxlcyA9ICggJ1xmczU1XGYyXGJcaSAnLCAnXGZz
NTBcZjJcYlxpICcsICdcZnM0NVxmMlxiXGkgJywKIyAgIAkJJ1xmczQwXGYyXGJcaSAnLCAnXGZz
MzVcZjJcYlxpICcsICdcZnMzMFxmMlxiXGkgJyk7CiMKIyBEb24ndCBmb3JnZXQgJGNoYXJzZXQs
IG9yIHRoZSBjaGFyYWN0ZXIgdHJhbnNsYXRpb24gd29uJ3Qgd29yay4KIwojIE5vdGUgdGhlIGZv
bnQgZmFtaWx5IG5hbWVzIC0tIEFyaWFsJ3MgaXMgInN3aXNzIi4gIFNQRUNJRllJTkcgVEhFIEZB
TUlMWQojIE5BTUUgSVMgT1BUSU9OQUwuICBTZWUgdGhlIFJURiBzcGVjcyBmb3IgdGhlIGFsbG93
YWJsZSBmYW1pbHkgbmFtZXMuCgokKiA9IDE7ICAjZG9uJ3QgYXNzdW1lIGVhY2ggc3RyaW5nIGlz
IGp1c3Qgb25lIGxpbmUgbG9uZy4KCiRpbml0ID0gIntcXHJ0ZjFcXGFuc2kgJGZvbnR0YWJsZQp7
XFxjb2xvcnRibFxccmVkMFxcZ3JlZW4wXFxibHVlMDt9CntcXHN0eWxlc2hlZXR7XFxmczIwIFxc
c25leHQwIE5vcm1hbDt9fVxuIjsKCiR1bmRlcmxpbmVfcmUgPSAnKCcgLiBqb2luKCd8JywgQHVu
ZGVybGluZV9zdHlsZXMpIC4gJyknOwokaXRhbGljX3JlID0gJygnIC4gam9pbignfCcsIEBpdGFs
aWNfc3R5bGVzKSAuICcpJzsKJGJvbGRfcmUgPSAnKCcgLiBqb2luKCd8JywgQGJvbGRfc3R5bGVz
KSAuICcpJzsKJGNsb3NlX3JlID0gJygnIC4gam9pbignfCcsIEB1bmRlcmxpbmVfc3R5bGVzLAoJ
CUBpdGFsaWNfc3R5bGVzLCBAYm9sZF9zdHlsZXMpIC4gJyknOwoKIyMjIyMjIyMjIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIwokc3Rh
bXAgPSAkaHRtbDJydGZfdmVyc2lvbjsKaWYgKCRodG1sMnJ0Zl9yZXZpc2lvbiA9fiAvXDwoW15c
Pl0rKS8pIHsKICRodG1sMnJ0Zl9yZXZpc2lvbiA9ICQxOyAgIyBndXNzeSBpdCB1cC4KICRodG1s
MnJ0Zl9yZXZpc2lvbiA9fiB0ci8gL18vOwogJHN0YW1wIC49ICcgKHJldmlzaW9uICcgLiAkaHRt
bDJydGZfcmV2aXNpb24gLiAnKSc7Cn0KCnByaW50ICJTdGFydGluZyAkc3RhbXBcbiIgaWYgKCRk
ZWJ1ZyA+IDApOwoKZm9yZWFjaCAkZmlsZSAoQEFSR1YpIHsKICMgcmVzZXQgc29tZSBzdGF0ZXMK
ICRwcmVfc3RhdGUgPSAwOwogdW5kZWYgQGxpc3RfbGV2ZWw7CiB1bmRlZiBAbGlzdF90eXBlOwoK
IGRpZSAiQ2FuJ3Qgb3BlbiBpbnB1dCBmaWxlICRmaWxlIiB1bmxlc3Mgb3BlbihJTkZJTEUsICRm
aWxlKTsKIHByaW50ICJDb252ZXJ0aW5nICRmaWxlXG4iIGlmICgkZGVidWcgPiAwKTsKICRpbnN0
cmVhbSA9IGpvaW4oJycsIDxJTkZJTEU+KTsKIGNsb3NlKElORklMRSk7CgogdW5kZWYoQGxpc3Rf
dHlwZSk7ICAjIGNsZWFyICdlbSBmb3IgZWFjaCBmaWxlCiB1bmRlZihAbGlzdF9sZXZlbCk7Cgog
IyBDYXRjaCB0aGUgZG9jdW1lbnQgbWV0YS1pbmZvcm1hdGlvbgogIyBmaXJzdCB1cCwgdGhlIHRp
dGxlIQogaWYgKCRpbnN0cmVhbSA9fiAvPFRJVExFPihbXjxdKyk8XC9USVRMRT4vaSkgewogICR0
aXRsZSA9ICQxOwogfSBlbHNlIHsKICAkdGl0bGUgPSAkZmlsZTsKIH0KICR0aXRsZSA9fiB0ci9c
bnt9XFwvIF9fXy87ICMgc2FmZXRpZnkgdGhlc2Uga29va3kgaWxsZWdhbCBjaGFyYWN0ZXJzIQoK
ICMgc2Vjb25kIHVwLCB0aGUgYXV0aG9yIQogaWYgKCRpbnN0cmVhbSA9fiAvPExJTktccytSRVZc
cyo9XHMqTUFERVxzK0hSRUZccyo9XHMqIihbXiJdKykiL2kpIHsKICAkYXV0aG9yID0gJDE7CiAg
aWYgKCRhdXRob3IgPX4gL15tYWlsdG86L2kpIHsKICAgJGF1dGhvciA9ICQnOwogIH0KIH0gZWxz
ZSB7CiAgJGF1dGhvciA9ICcnOwogfQogJGF1dGhvciA9fiB0ci9cbnt9XFwvIF9fXy87ICMgc2Fm
ZXRpZnkgdGhlc2Uga29va3kgaWxsZWdhbCBjaGFyYWN0ZXJzIQoKICMgdGhpcmQgdXAsIGtleXdv
cmRzIQogaWYgKCRpbnN0cmVhbSA9fiAvPE1FVEFccytIVFRQLUVRVUlWXHMqPVxzKiJLZXl3b3Jk
cyJccytDb250ZW50XHMqPVxzKiIoW14iXSspIi9pKSB7CiAgJGtleXdvcmRzID0gJDE7CiB9IGVs
c2UgewogICRrZXl3b3JkcyA9ICcnOwogfQogJGtleXdvcmRzID1+IHRyL1xue31cXC8gX19fLzsg
IyBzYWZldGlmeSB0aGVzZSBrb29reSBpbGxlZ2FsIGNoYXJhY3RlcnMhCgogIyBUaGUgdGltZS1z
dGFtcCBvZiB0aGUgSFRNTCBmaWxlIGlzIGNvcGllZCBpbnRvIHRoZSAiQ3JlYXRpb24gVGltZSIg
b2YKICMgdGhlIFJURiBmaWxlLiAgVGhlIG1vbWVudCB3aGVuIHRoZSBjb252ZXJzaW9uIGhhcHBl
bnMgaXMgc3R1Y2sgaW50bwogIyB0aGUgIlJldmlzaW9uIFRpbWUiIG9mIHRoZSBmaWxlLCBhbmQg
d2lsbCBiZSBvdmVyd3JpdHRlbiBpZi93aGVuIHlvdQogIyBtYWtlIChhbmQgc2F2ZSkgY2hhbmdl
cyB0byB0aGUgUlRGIGZpbGUgaW4geW91ciB3b3JkIHByb2Nlc3Nvci4KCiAoJGp1bmssICRqdW5r
LCAkanVuaywgJGp1bmssICRqdW5rLCAkanVuaywgJGp1bmssICRqdW5rLCAkanVuaywgCiAgICAg
ICAgJGZpbGV0aW1lLCAkanVuaywgJGp1bmssICRqdW5rKSA9IHN0YXQoJGZpbGUpOyAKICMgR2V0
IHRoZSBpbnB1dCBmaWxlJ3MgbGFzdCByZXZpc2lvbiBkYXRlLCBpbiBVTklYIGZvcm1hdAoKICMg
Tm93IGNvb2sgdXAgdGhlIGluaXQgc3RyaW5nIGZvciB0aGlzIGZpbGUuCiAkbXlpbml0ID0gJGlu
aXQgLiAie1xcaW5mbyBcbntcXHRpdGxlICR0aXRsZX1cbiIKICAgIC4gIntcXGNyZWF0aW0iIC4g
JnVuaXh0aW1lMnJ0ZigkZmlsZXRpbWUpIC4gIn1cbntcXHJldnRpbSIKICAgIC4gJnVuaXh0aW1l
MnJ0Zih0aW1lKCkpIC4gIn1cbntcXGF1dGhvciAkYXV0aG9yfVxue1xca2V5d29yZHMgJGtleXdv
cmRzfSIKICAgIC4gIntcXGRvY2NvbW0gQ29udmVydGVkIGZyb20gJGZpbGUgYnk6ICRzdGFtcCwg
YnkgU2VhbiBNLiBCdXJrZSAoc2VhblxAUVJELm9yZyl9fVxuIjsKCiAjIE9LLCBlbmQgb2YgbWV0
YWluZm9ybWF0aW9uIGdpZy4KCiBpZiAoJGluc3RyZWFtID1+IC88Qk9EWVtePl0qPi9pICkgewog
ICRpbnN0cmVhbSA9ICQnOwogICRpbnN0cmVhbSA9fiBzLyAqPFwvKEJPRFl8SFRNTCk+Ly9pZzsK
IH0gZWxzZSB7CiAgd2FybiAiTm8gQk9EWSB0YWcgZm91bmQgaW4gJGZpbGUgLi4uIGNvbnZlcnNp
b24gbWF5IGJlIGRlZXBseSBmbGF3ZWQuXG4iOwogfQogJGluc3RyZWFtID1+IHMvW3t9XFxdL1xc
JCYvZzsgIyBFc2NhcGUgb3V0IGJyYWNrZXRzIGFuZCBcJ3MKIAogIyAkaW5zdHJlYW0gPX4gcy88
IS0tXHMqKFteLV0qKVxzKi0tPi8vZzsgICMgS2lsbCBTR01MIGNvbW1lbnRzCiAjICRpbnN0cmVh
bSA9fiBzLzwhLS1ccyooW14tXSopXHMqLS0+L3tcXHBsYWluIFxcdiAkJn0vZzsgICMgS2lsbCBT
R01MIGNvbW1lbnRzCgogIyBPa2F5LCBub3cgd2Ugc3RhcnQgcmVhbGx5IGNoZXdpbmcgb24gdGhl
IEhUTUwgYW5kIGNodW5rIGJ5IGNodW5rCiAjIHJlcGxhY2luZyBpdCB3aXRoIHRoZSBjb3JyZWN0
IFJURiBjb2RlLgogIAogJGluc3RyZWFtID1+IHMvPChcL1BSRXxcL1tVT0RdTHxcL0hbMS02XVte
Pl0qfEJMT0NLUVVPVEV8XC9CTE9DS1FVT1RFfEhSKVtePl0qPi8kJjxQPi9pZzsKICMgcHV0IDxQ
PidzIGFmdGVyIDwvUFJFPnMsICBjbG9zZS1VTC9PTC9ETHMsIGNsb3NlLURMJ3MsIAogIyAgICAg
IEJMT0NLUVVPVEVzLCBjbG9zZS1CTE9RVU9URXMsIGNsb3NlLUg/cywgYW5kIEhScwoKICRpbnN0
cmVhbSA9fiBzL1xzKjxQPlxzKig8SFsxLTZSXVtePl0qPikvJDEvaWc7CiAjIGtpbGwgUCdzIGJl
Zm9yZSBoZWFkaW5ncyBvciBIUnMuCgogJGluc3RyZWFtID1+IHMvPFA+WyBcdFxuXSo8KFBSRXxb
VU9EXUx8TEl8SFJ8QkxPQ0tRVU9URSk+LzwkMT4vaWc7CiAjIGtpbGwgPFA+J3MgYmVmb3JlIDxQ
UkU+LCBVTC9PTC9ETHMsIERMJ3MsIEJMT0NLUVVPVEVzLCBIUidzLCBhbmQgTEkncwoKICMgSGFu
ZGxlIHdoaXRlc3BhY2UsIFBSRXMsIGFuZCBQcwogJGluc3RyZWFtID1+IHMvKDxcLz9QUkVbXj5d
Kj58PFBSRT4pfCg8XC8/UFtePl0qPil8KFxzKykvJnBhcnNlX3AoJCYpL2llZzsKICMgTm90ZSB0
aGUgZXh0cmVtZWx5IHBvd2VyZnVsIHVzZSBvZiBzL0EvJkIvaWVnIGFzIGEgYm9ndXMgcGFyc2Vy
IGhlcmU7CiAjIHRoaXMgc3Vic3RpdHV0ZXMgZm9yIGEgbWVzc3kgd2hpbGUoKSBsb29wLiAgV29y
c2hpcCBzL0EvJkIvaWVnICEhCgogIyBOb3cgaGFuZGxlIGNoYXJhY3RlciBzdHlsZXMKICRpbnN0
cmVhbSA9fiBzLzwkdW5kZXJsaW5lX3JlPlxzKi97XFx1bCAvaWc7CiAkaW5zdHJlYW0gPX4gcy88
JGl0YWxpY19yZT5ccyove1xcaSAvaWc7CiAkaW5zdHJlYW0gPX4gcy88JGJvbGRfcmU+XHMqL3tc
XGIgL2lnOwogJGluc3RyZWFtID1+IHMvXHMqPFwvJGNsb3NlX3JlPi99L2lnOwogJGluc3RyZWFt
ID1+IHMvPENPREU+XHMqL3tcXGYxIC9pZzsKICRpbnN0cmVhbSA9fiBzL1xzKjxcL0NPREU+L30v
aWc7CiAkaW5zdHJlYW0gPX4gcy88U1VCPlxzKi97XFxzdWIgL2lnOwogJGluc3RyZWFtID1+IHMv
XHMqPFwvU1VCPi99L2lnOwogJGluc3RyZWFtID1+IHMvPFNVUD5ccyove1xcc3VwZXIgL2lnOwog
JGluc3RyZWFtID1+IHMvXHMqPFwvU1VQPi99L2lnOwoKCgogIyBOb3cgaGFuZGxlIHRoZSBvdGhl
ciBzdHJ1Y3R1cmFsIGNvZGVzCiAjICBGaXJzdCwgaGVhZGluZ3MKICRpbnN0cmVhbSA9fiBzLzxI
KFsxLTZdKVtePl0qPlxzKi9cblxccGFyXFxwYXJkXFxwYXJkJGhlYWRpbmdfc3BhY2VfYmVmb3Jl
XHtcXHBsYWluICRoZWFkaW5nX3N0eWxlc1skMS0xXS9pZzsKCgogJGluc3RyZWFtID1+IHMvPFwv
SFsxLTZdPlxzKi9cfVxuL2lnOwogIyAgTm93LCBvdGhlciBzdHJ1Y3R1cmFsIHRhZ3MKICRpbnN0
cmVhbSA9fiBzL1sgXSo8KEhSfEJSfFB8QkxPQ0tRVU9URXxcL0JMT0NLUVVPVEV8VUx8XC9VTHxM
SXxcL0xJfERMfERUfEREfFwvREx8T0x8XC9PTClbXj5dKj5bIF0qLyZwYXJzZV9zdHJ1Y3R1cmUo
JDEpL2llZzsKCgogIyBXaGF0ZXZlciB0YWdzIGFyZSBsZWZ0LCBoaWRlICdlbS0tIHdlIGRvbid0
IGtub3cgaG93IHRvIGRlYWwgd2l0aCAnZW0uCiAkaW5zdHJlYW0gPX4gcy88W14+XSs+L1x7XFxw
bGFpbiBcXHYgJCZcfS9nOwoKICMgQWxtb3N0IHRoZXJlIC0tIHJlc29sdmUgZW50aXRpZXMKICRp
bnN0cmVhbSA9fiBzL1wmKFteXDtdezEsOX0pOy8mcmVzb2x2ZV9lbnRpdHkoJDEpL2VnOwoKICMg
TGFzdCBzdGVwLS0gcXVvdGUgdGhlIDgtYml0IGNoYXJhY3RlcnMKICRpbnN0cmVhbSA9fiBzLyhb
XHg4MC1ceGZmXSkvIlxcJyIuKHVucGFjaygiSDIiLCQxKSkvZWc7CgogIyMjCiAjIE91dHB1dCBp
dCBhbGwKICRvdXRuYW1lID0gJGZpbGU7CiBpZiAoJG91dG5hbWUgPX4gL1wuaHRtbD8vaSkgewog
ICRvdXRuYW1lID1+IHMvXC5odG1sPy8ucnRmL2k7CiB9IGVsc2UgewogICRvdXRuYW1lIC49ICcu
cnRmJzsKIH0KCiBkaWUgIkNhbid0IG9wZW4gb3V0cHV0IGZpbGUgJG91dG5hbWUiIHVubGVzcyBv
cGVuIChPVVRGSUxFLCAiPiAkb3V0bmFtZSIpOwogcHJpbnQgIldyaXRpbmcgJG91dG5hbWVcbiIg
aWYgKCRkZWJ1ZyA+IDApOwogcHJpbnQgT1VURklMRSAoJG15aW5pdCk7CiBwcmludCBPVVRGSUxF
ICgkaW5zdHJlYW0pOwogcHJpbnQgT1VURklMRSAoIn1cbiIpOwogaWYgKCRkZWJ1ZyA+IDEpIHsK
ICBwcmludCAiPT09ICRmaWxlID09PVxuJG15aW5pdCI7CiAgcHJpbnQgJGluc3RyZWFtOwogIHBy
aW50ICJ9XG4iOwogfQogY2xvc2UgKE9VVEZJTEUpOwp9CnByaW50ICJEb25lLlxuIiBpZiAoJGRl
YnVnID4gMCk7CgojIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjCgpzdWIgcGFyc2VfcCB7CiAjIERlYWwgd2l0aCB3aGl0
ZXNwYWNlLCBQUkUsIGFuZCBQJ3MuCiAjIFRvIGJlIGNhbGxlZCBvbmx5IGJ5IHRoZSBzL0EvJkIv
aWVnIGV4cHJlc3Npb24gdXAgdGhlcmUuCiAjIHJlbWVtYmVyIHRoYXQgJHByZV9zdGF0ZSBpcyBn
bG9iYWw7IGl0cyB2YWx1ZSBpcyAwIG9yIDEKIGxvY2FsKCRpbnB1dCkgPSAkX1swXTsgIyB0aGUg
dGhpbmcgdGhhdCBtYXRjaGVkCgogJGlucHV0ID1+IHRyL2Etei9BLVovOwogaWYgKCRpbnB1dCA9
fiAvPFBSRS8pIHsgICAjIFBSRSB0YWdzCiAgJHByZV9zdGF0ZSA9IDE7CiAgcmV0dXJuICJcblxc
cGFyZFxccGFyXFxmMSAiOyAgIyBub3RlIHRoYXQgYSBQUkUgaW1wbGllcyBhIG5ld2xpbmUKCQkJ
IyBhbHNvIGxldCdzIHN3aXRjaCB0byB0aGUgbW9ub3NwYWNlIGZvbnQKIH0gZWxzaWYgKCRpbnB1
dCA9fiAvPFwvUFJFLykgeyAgIyBjbG9zZSBQUkUncwogICRwcmVfc3RhdGUgPSAwOwogIHJldHVy
biAnXGYwICc7ICAjIGJhY2sgdG8gdGhlIHByb3BvcnRpb25hbCBmb250CiB9IGVsc2lmICgkaW5w
dXQgPX4gL148UD58PFBbIFxuXHRdKy8pIHsgICAgIyBQIHRhZ3MKICAkcHJlX3N0YXRlID0gMDsK
ICByZXR1cm4gJzxQPic7CiB9IGVsc2lmICgkaW5wdXQgPX4gL148XC9QPi8pIHsgICMgY2xvc2Ut
UCdzCiAgJHByZV9zdGF0ZSA9IDA7CiAgcmV0dXJuICcnOwogfSBlbHNpZiAoJGlucHV0ID1+IC9e
WyBcblx0XSskLykgeyAgICMgd2hpdGVzcGFjZQogIGlmICgkcHJlX3N0YXRlID09IDApIHsKICAg
cmV0dXJuICcgJzsgIyBjb2xsYXBzZSBhbGwgd2hpdGVzcGFjZQogIH0gZWxzZSB7ICMgd2UncmUg
aW4gYSBQUkUgZW50aXR5LS0gZmlkZGxlIHdpdGggd2hpdGVzcGFjZQogICAkaW5wdXQgPX4gcy9c
bi9cblxccGFyZFxccGFyIC9nOwogICByZXR1cm4gJGlucHV0OwogIH0KIH0KfQoKIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
IyMjIwoKc3ViIHBhcnNlX3N0cnVjdHVyZSB7CiAjIEBsaXN0X3R5cGUgaXMgZ2xvYmFsCiAjIEBs
aXN0X2xldmVsIGlzIGdsb2JhbAogIyB0aGUgRklSU1QgZWxlbWVudCBvZiBlYWNoIGxpc3QgaXMg
dGhlIG1vc3QgY3VycmVudCBvbmUuCiBsb2NhbCgkaW5fdGFnKSA9ICRfWzBdOwogbG9jYWwoJGxf
aW5kZW50LCAkZGVwdGgpOwogJGluX3RhZyA9fiB0ci9hLXovQS1aLzsKCiAkZGVwdGggPSBAbGlz
dF9sZXZlbDsgICNub3RlIHRoYXQgREwgZG9lc24ndCBhZmZlY3QgdGhpcyBzdGFjawogJGxfaW5k
ZW50ID0gJHRhYiAqICRkZXB0aDsKCiBpZiAoJGluX3RhZyBlcSAnVUwnKSB7CiAgdW5zaGlmdChA
bGlzdF9sZXZlbCwgMCk7ICAgI2p1c3QgYSBwbGFjZWhvbGRlcgogIHVuc2hpZnQoQGxpc3RfdHlw
ZSwgJ1VMJyk7ICNzdG9yZSB0aGUgbGlzdCB0eXBlCiAgcmV0dXJuICcnOwogfSBlbHNpZiAoJGlu
X3RhZyBlcSAnT0wnKSB7CiAgdW5zaGlmdChAbGlzdF9sZXZlbCwgMCk7ICAgI3dpbGwgZ2V0IGlu
Y3JlbWVudGVkCiAgdW5zaGlmdChAbGlzdF90eXBlLCAnT0wnKTsgI3N0b3JlIHRoZSBsaXN0IHR5
cGUKICByZXR1cm4gJyc7CiB9IGVsc2lmICgkaW5fdGFnIGVxICcvT0wnIHx8ICRpbl90YWcgZXEg
Jy9VTCcgfHwgJGluX3RhZyBlcSAnL0JMT0NLUVVPVEUnKSB7CiAgc2hpZnQoQGxpc3RfbGV2ZWwp
OwogIHNoaWZ0KEBsaXN0X3R5cGUpOwogICNyZXR1cm4gJ1xccGFyXFxwYXJkJzsKCiB9IGVsc2lm
ICgkaW5fdGFnIGVxICdMSScpIHsKICBpZigkbGlzdF90eXBlWzBdIGVxICdVTCcpIHsKICAgcmV0
dXJuICJcblxccGFyXFxwYXJkXFxsaSRsX2luZGVudFxcYnVsbGV0ICAiOwogIH0gZWxzaWYgKCRs
aXN0X3R5cGVbMF0gZXEgJ09MJykgewogICArKyRsaXN0X2xldmVsWzBdOwogICByZXR1cm4gIlxu
XFxwYXJcXHBhcmRcXGxpJGxfaW5kZW50IHtcXGIgJGxpc3RfbGV2ZWxbMF19XC4gIjsKICB9ICMg
ZWxzZSB3aGF0IHRoZSBoZWxsIGFyZSB3ZSBkb2luZyBzYXlpbmcgJ0xJJz8KIH0gZWxzaWYgKCRp
bl90YWcgZXEgJy9MSScpIHsKICAjdW1tbT8KCiB9IGVsc2lmICgkaW5fdGFnIGVxICdCTE9DS1FV
T1RFJykgewogIHVuc2hpZnQoQGxpc3RfbGV2ZWwsMCk7ICAgIyBhIGR1bW15IHBsYWNlaG9sZGVy
CiAgdW5zaGlmdChAbGlzdF90eXBlLCdCTE9DS1FVT1RFJyk7ICAjIG5vdCB0b28gY29udGVudGZ1
bCBlaXRoZXIKICByZXR1cm4gJyc7CgogfSBlbHNpZiAoJGluX3RhZyBlcSAnREwnIHx8ICRpbl90
YWcgZXEgJy9ETCcpIHsKICAjIGxhIGxhIGxhLCBJJ20gZG9pbmcgbm90aGluZywgbGEgbGEgbGEu
CgogfSBlbHNpZiAoJGluX3RhZyBlcSAnUCcgfHwgJGluX3RhZyBlcSAnRFQnKSB7CiAgIyBub3Rl
IHRoYXQgRFQgaXMganVzdCBsaWtlIGEgUAogIHJldHVybiAiXG5cXHBhclxccGFyZCRwYXJhZ3Jh
cGhfc3BhY2VfYmVmb3JlXFxsaSRsX2luZGVudCAiOwoKIH0gZWxzaWYgKCRpbl90YWcgZXEgJ0RE
JykgewogICMganVzdCBsaWtlIGEgUCwgYnV0IGp1c3Qgb25lIG1vcmUgaWRlbnQgbGV2ZWwgaW4s
IGFuZCB3aXRob3V0CiAgIyAkcGFyYWdyYXBoX3NwYWNlX2JlZm9yZQogIHJldHVybiAiXG5cXHBh
clxccGFyZFxcbGkiIC4gKCRsX2luZGVudCArICR0YWIpIC4gJyAnOwoKIH0gZWxzaWYgKCRpbl90
YWcgZXEgJy9EVCcpIHsKICAjIHVtbW0/CiB9IGVsc2lmICgkaW5fdGFnIGVxICcvREQnKSB7CiAg
IyB1bW1tPwoKIH0gZWxzaWYgKCRpbl90YWcgZXEgJ0JSJykgewogIHJldHVybiAiXG5cXHBhclxc
cGFyZFxcbGkkbF9pbmRlbnQgIjsKCiB9IGVsc2lmICgkaW5fdGFnIGVxICdIUicpIHsKICByZXR1
cm4gIlxuXFxwYXJcXHBhcmRcXGxpJGxfaW5kZW50ICRocl9zdHlsZSAiOwogICMgbm90ZSB0aGF0
IHRoZXJlIGlzIGluZGVudGluZy0tIHNvIHRoYXQgYSBIUiBpbiB0aGUgbWlkZGxlIG9mIGEgbGlz
dAogICMgY2FuIGJlIGNlbnRlcmVkIGRpZmZlcmVudGx5IGZyb20gb25lIG91dHNpZGUgYSBsaXN0
CiB9CgogcmV0dXJuICcnOwp9CgojIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjCnN1YiB1bml4dGltZTJydGYgewogbG9j
YWwoJGludGltZSwgJHNlYywgJG1pbiwgJGhyLCAkZHksICRtbywgJHlyLCAkanVuayk7CgogJGlu
dGltZSA9ICRfWzBdOwoKICgkc2VjLCAkbWluLCAkaHIsICRkeSwgJG1vLCAkeXIsICRqdW5rLCAk
anVuaywgJGp1bmspID0gbG9jYWx0aW1lKCRpbnRpbWUpOwogIyBOb3RlIHRoYXQgdGhpcyBpcyBs
b2NhbCB0aW1lLgoKICsrJG1vOyAgIyBOb3RlIHRoYXQgUEVSTCBjb3VudHMgbW9udGhzIGZyb20g
SmFudWFyeT0wCiAgICAgICAgICMgIGJ1dCBSVEYgY291bnRzIGZyb20gSmFudWFyeT0xCiAkeXIg
Kz0gMTkwMDsKCiByZXR1cm4gIlxceXIkeXJcXG1vJG1vXFxkeSRkeVxcaHIkaHJcXG1pbiRtaW5c
XHNlYyRzZWMiOwp9CgojIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjCnN1YiByZXNvbHZlX2VudGl0eSB7CiAgICBsb2Nh
bCgkaW4sICRvdXQpOwogICAgJGluID0gJF9bMF07CgogICAgJG91dCA9ICRlbnRpdGllc3skaW59
OwogICAgaWYgKGRlZmluZWQoJG91dCkpIHsgI2Vhc2lseSByZXNvbHZhYmxlCglyZXR1cm4gJG91
dDsKICAgIH0gZWxzaWYgKCRpbiA9fiAvXlwjKFswLTldKykkLykgewoJcmV0dXJuIHBhY2soIkMi
LCAkMSk7CiAgICB9IGVsc2UgewoJcmV0dXJuICcmJyAuICRpbiAuICc7JzsgI21ha2UgaXQgdW5j
aGFuZ2VkLgogICAgfQoKfQoKIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
IyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIwoKCg==
--=-=-=


as Larry suggests it doesn't handle tables but it does a reasonable job
with titles, basic formatting and font changes,

regards,
Gaius

--=-=-=--


From MAILER-DAEMON Mon Jan 09 14:41:32 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RkL64-0001QD-CC
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 14:41:32 -0500
Received: from eggs.gnu.org ([140.186.70.92]:59927)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1RkL61-0001Nt-Bq
	for groff@gnu.org; Mon, 09 Jan 2012 14:41:30 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1RkL5z-0004ln-SX
	for groff@gnu.org; Mon, 09 Jan 2012 14:41:29 -0500
Received: from mail-ww0-f49.google.com ([74.125.82.49]:44704)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <saint.snit@gmail.com>) id 1RkL5z-0004lC-O7
	for groff@gnu.org; Mon, 09 Jan 2012 14:41:27 -0500
Received: by wgbdt13 with SMTP id dt13so1653169wgb.30
	for <groff@gnu.org>; Mon, 09 Jan 2012 11:41:26 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type;
	bh=JYLsjRBn0Zn4q3xA0iVRt1yRJQoK9o+DHWYjvjxUUz8=;
	b=oTeonMh/L08s6Rj6lBWILqscSA1E7p1Uy0j1RKYzyJbUTMsXgPMvQpS4oU0sYD5k8K
	6WHJdOtNCdYIONqVHiqEPOXjS3kJdVagCUOMSqijdwW/RGOg/j7iK1uwx8m2PKqjUAbz
	heSipv0CEAve7QLGeHsmfod3qPgQwnfLPxQ2s=
MIME-Version: 1.0
Received: by 10.181.13.17 with SMTP id eu17mr30076079wid.12.1326138086480;
	Mon, 09 Jan 2012 11:41:26 -0800 (PST)
Received: by 10.180.101.42 with HTTP; Mon, 9 Jan 2012 11:41:26 -0800 (PST)
In-Reply-To: <XFMail.20120107225946.Ted.Harding@wlandres.net>
References: <1325974312.1697.2-poddy@thorsby.com.au>
	<XFMail.20120107225946.Ted.Harding@wlandres.net>
Date: Mon, 9 Jan 2012 13:41:26 -0600
Message-ID: <CACRhBXPkaLJfg9m4bEXnUwEkXMu-mM-bJ+p_g_OY0sZ9JQhQgA@mail.gmail.com>
From: Dave Kemper <saint.snit@gmail.com>
To: Ted.Harding@wlandres.net
Content-Type: text/plain; charset=ISO-8859-1
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 74.125.82.49
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 09 Jan 2012 19:41:30 -0000

On Sat, Jan 7, 2012 at 4:59 PM, Ted Harding <Ted.Harding@wlandres.net> wrote:
> I've been hesitating about joining in, because (as is
> already beginning to emerge) it is potentially a complex
> question; and also the kind of solution which should be
> preferred is a question of taste, convention, or context,
> as well as convenience of use.

You're right; let me provide a little more context.

I agree that manipulating track kerning, or the wording of the text,
are the most elegant ways to solve the problem.  But these are, as Peter
points out, manual and time-consuming processes.

The published novels I surveyed were largely mass-market fiction,
published by major publishers.  They may not have taken the time to
use typesetting best practices, but what they used were "pretty good
practices" -- ones that, by and large, looked like they could have
been automated.

In particular, it was quite common in these books for the occasional
pair of pages to have one fewer lines than the norm; in other words, if
a standard page had 40 lines, sometimes pairs of facing pages would each
have 39 lines to prevent what would have otherwise been a widow on either
the second of the two facing pages, or the next page after the turn.
So the bottom margins on these two pages would align with each other,
but not with those of other pages.  This was common enough that it seems
to be a fairly accepted practice.

This is the kind of solution I am looking for: one that provides "pretty
good" results on par with what a major publisher would use, but without
requiring the level of time and care required to really fine-tune.

Regarding the ideas put forth on this topic:

The overview of an algorithm that Pierre-Jean posted is similar to what
I was thinking could be one way to do this: run groff one time with
macros that print to stdout information about where each paragraph is
placed on the page, then feed this output into something that figures
out where adjustments have to be made to eliminate widows, and ideally
generates groff code to make those adjustments.

Right now, the "something" above is the "here magic happens" part of
my idea.  I can code this myself if I need to, but an existing solution
is of course preferable.

There may be one in the -mpm macro package (thanks, Sverre and Ralph),
but I haven't been able to get it working so far.  I'm not sure if it's
compatible with groff at all: its tmac file depends on something called
tmac.srefs which doesn't exist in groff.  I also get a slew of errors
trying to compile the C++ code of the post-processor, which could indicate
anything from a missing command-line switch to a fundamental environmental
incompatibility (the code was developed on a Plan 9 platform).  I'm not
sure how much energy to devote to trying to figure all this out, since
it's unclear to me from -mpm's documentation whether it even does what
I want.


From MAILER-DAEMON Mon Jan 09 15:14:03 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RkLbX-0003Tp-DO
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 15:14:03 -0500
Received: from eggs.gnu.org ([140.186.70.92]:43749)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RkLbT-0003Su-Mt
	for groff@gnu.org; Mon, 09 Jan 2012 15:14:01 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RkLaw-0001ZK-Ja
	for groff@gnu.org; Mon, 09 Jan 2012 15:13:59 -0500
Received: from relay4-d.mail.gandi.net ([217.70.183.196]:46320)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RkLaw-0001ZC-0b
	for groff@gnu.org; Mon, 09 Jan 2012 15:13:26 -0500
X-Originating-IP: 217.70.178.131
Received: from mfilter11-d.gandi.net (mfilter11-d.gandi.net [217.70.178.131])
	by relay4-d.mail.gandi.net (Postfix) with ESMTP id AEAA11720BB;
	Mon,  9 Jan 2012 21:13:20 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at mfilter11-d.gandi.net
Received: from relay4-d.mail.gandi.net ([217.70.183.196])
	by mfilter11-d.gandi.net (mfilter11-d.gandi.net [10.0.15.180])
	(amavisd-new, port 10024)
	with ESMTP id qROnsbIErtfZ; Mon,  9 Jan 2012 21:13:19 +0100 (CET)
X-Originating-IP: 86.74.235.141
Received: from localhost.localdomain (141.235.74.86.rev.sfr.net
	[86.74.235.141]) (Authenticated sender: sygne@ombres.eu)
	by relay4-d.mail.gandi.net (Postfix) with ESMTPSA id 93B151720D9;
	Mon,  9 Jan 2012 21:13:18 +0100 (CET)
Date: Mon, 09 Jan 2012 21:12:43 +0100
From: Pierre-Jean <sygne@ombres.eu>
To: Ted.Harding@wlandres.net, saint.snit@gmail.com
Message-ID: <4f0b4a3b.zOgB3CUQmsozc5m2%sygne@ombres.eu>
References: <1325974312.1697.2-poddy@thorsby.com.au>
	<XFMail.20120107225946.Ted.Harding@wlandres.net>
	<CACRhBXPkaLJfg9m4bEXnUwEkXMu-mM-bJ+p_g_OY0sZ9JQhQgA@mail.gmail.com>
In-Reply-To: <CACRhBXPkaLJfg9m4bEXnUwEkXMu-mM-bJ+p_g_OY0sZ9JQhQgA@mail.gmail.com>
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: multipart/mixed;
	boundary="=_4f0b4a3b.LcSDzbDC6BUMEJHXL5SsSL6Z24SQd4LYHWVzoXfmoGAcDusb"
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 217.70.183.196
Cc: groff@gnu.org
Subject: Re: [Groff] holistic widow elimination
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 09 Jan 2012 20:14:01 -0000

This is a multi-part message in MIME format.

--=_4f0b4a3b.LcSDzbDC6BUMEJHXL5SsSL6Z24SQd4LYHWVzoXfmoGAcDusb
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

Dave Kemper <saint.snit@gmail.com> wrote:

> There may be one in the -mpm macro package (thanks, Sverre and Ralph),
> but I haven't been able to get it working so far.  I'm not sure if it's
> compatible with groff at all: its tmac file depends on something called
> tmac.srefs which doesn't exist in groff. 

tmac.srefs seems to be part of the plan9 troff. It is the code of tmac.s
which format refer output. There is a modified version of it in Heirloom
troff, which I join to this mail.


It should be compatible with groff, if you use the corresponding pm macro,
which I also join.

Cheers,

Pierre-Jean.


--=_4f0b4a3b.LcSDzbDC6BUMEJHXL5SsSL6Z24SQd4LYHWVzoXfmoGAcDusb
Content-Type: text/plain;
 charset=us-ascii
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="srefs"

.\"
.\" Changes by Gunnar Ritter, Freiburg i. Br., Germany, October 2005.
.\"
.\" Derived from Plan 9 v4 /sys/lib/tmac/tmac.srefs
.\"
.\" Copyright (C) 2003, Lucent Technologies Inc. and others.
.\" All Rights Reserved.
.\"
.\" Distributed under the terms of the Lucent Public License Version 1.02.
.\"
.\"
.\"	Sccsid @(#)srefs	1.4 (gritter) 10/30/05
.\"
.\" REFER macros .... citations
.de []
.][ \\$1
..
.de ][
.if \\$1>5 .tm Bad arg to []
.[\\$1
..
.if n .ds [. [
.if t .ds [. \s-2\v'-.4m'\f1
.if n .ds .] ]
.if t .ds .] \v'.4m'\s+2\fP
.if n .ds [o ""
.if n .ds [c ""
.if t .ds [o ``
.if t .ds [c ''
.\" the next lines deal with the problem of .[1] or [1].
.\" refer will write "linexxx\*(<.[1]\*(>.
.\" and either "<." or ">." should produce the .;
.\" similarly for ,
.if n .ds >. .
.if t .ds <. .
.if n .ds >, ,
.if t .ds <, ,
.de [5 \" tm style
.FS
.IP "\\*([F.\0"
.nr %T 2
\\*([A, \\f2\\*([T\\f1,
.ie \\n(TN \\*([M.
.el Bell Laboratories internal memorandum (\\*([D).
.RT
.FE
..
.de [0 \" other
.FS
.nr [: 0
.if !"\\*([F"" .IP "\\*([F.\0"
.if !"\\*([A"" \{.nr [: 1
\\*([A\c\}
.if !"\\*([T"" \{.if \\n([:>0 ,
.nr [: 1
\\f2\\*([T\\f1\c\}
.if !"\\*([O""\{.if \\n([:>0 ,
.nr [: 1
.if \\n([O>0 .nr [: 0
\\*([O\c
.if \\n([O>0 \& \c\}
.if !"\\*([D"" \{.if \\n([:>0 ,
.nr [: 1
\\*([D\c\}
.if \\n([:>0 \&.
.if !"\\*([%"" Cited p. \\*([%.
.RT
.FE
..
.de [1 \" journal article
.nr %T 1 \" title font
.FS
.if !"\\*([R"" .rm [C
.if !"\\*([F"" .IP "\\*([F.\0"
.if !"\\*([A"" \\*([A,
.if !"\\*([T"" \\*([o\\*([T,\\*([c
\\f2\\*([J\\f1\c
.if !"\\*([C"" , \\*([C\c
.if !"\\*([V"" .if n ,\& Vol.\&\c
.if !"\\*([V"" \& \\f3\\*([V\\f1\c
.if !"\\*([N"" (\\*([N)\c
.if !"\\*([P"" \{\
.ie \\n([P>0 , pp.\ \&\c
.el , p.\ \&\c
\\*([P\c\}
.if !"\\*([I"" .if "\\*([R"" , \\*([I\c
.if !"\\*([O"" .if \\n([O=0 , \\*([O\c
.if !"\\*([D"" \& (\\*([D)\c
\&.
.if !"\\*([O"" .if \\n([O>0  \\*([O
.if !"\\*([%"" Cited p. \\*([%.
.RT
.FE
..
.de [2 \" book
.FS
.nr %T 2
.if !"\\*([F"" .IP "\\*([F.\0"
.if !"\\*([A"" \\*([A,
.if !"\\*([T"" \\f2\\*([T,\\f1
\\*([I\c
.if !"\\*([C"" , \\*([C\c
.if !"\\*([D"" \& (\\*([D)\c
\&.
.if !"\\*([G"" Gov't. ordering no. \\*([G.
.if !"\\*([O"" \\*([O
.if !"\\*([%"" Cited p. \\*([%.
.RT
.FE
..
.de [4 \" report
.FS
.if !"\\*([F"" .IP "\\*([F.\0"
.nr %T 1
\\*([A, \\*([o\\*([T,\\*([c
\\*([R\c
.if !"\\*([G"" \& (\\*([G)\c
.if !"\\*([I"" ,  \\*([I\c
.if !"\\*([C"" ,  \\*([C\c
.if !"\\*([D"" \& (\\*([D)\c
\&.
.if !"\\*([O"" \\*([O
.if !"\\*([%"" Cited p. \\*([%.
.RT
.FE
..
.de [3 \" article in book
.FS
.nr %T 1
.if !"\\*([F"" .IP "\\*([F.\0"
.if !"\\*([A"" \\*([A,
.if !"\\*([T"" \\*([o\\*([T,\\*([c
.if !"\\*([P"" pp. \\*([P
in \\f2\\*([B\\f1\c
.if !"\\*([E"" , ed. \\*([E\c
.if !"\\*([I"" , \\*([I\c
.if !"\\*([C"" , \\*([C\c
.if !"\\*([D"" \& (\\*([D)\c
\&.
.if !"\\*([O"" \\*([O
.if !"\\*([%"" Cited p. \\*([%.
.RT
.FE
..
.de ]<
.[<
..
.de [<
.LP
.rm FS FE
..
.de [>
.]>
..
.de ]>
.sp
..
.de ]-
.[-
..
.de [-
.rm [V [P [A [T
.rm [N [C [B [O
.rm [R [I [E [D
.rm [G [%
..
.de ]]
.\"this is never executed and just uses up an end-of-file bug.
..

--=_4f0b4a3b.LcSDzbDC6BUMEJHXL5SsSL6Z24SQd4LYHWVzoXfmoGAcDusb
Content-Type: application/octet-stream
Content-Transfer-Encoding: base64
Content-Disposition: attachment;
 filename="pm"

LlwiCi5cIiBDaGFuZ2VzIGJ5IEd1bm5hciBSaXR0ZXIsIEZyZWlidXJnIGkuIEJyLiwgR2Vy
bWFueSwgT2N0b2JlciAyMDA1LgouXCIKLlwiIERlcml2ZWQgZnJvbSBQbGFuIDkgc291cmNl
IGNvZGUgcHVibGlzaGVkIGF0IHRoZSA5ZmFucyBsaXN0IGJ5IFJvYiBQaWtlLAouXCIgPGh0
dHA6Ly9saXN0cy5jc2UucHN1LmVkdS9hcmNoaXZlcy85ZmFucy8yMDAyLUZlYnJ1YXJ5LzAx
NTc3My5odG1sPgouXCIKLlwiIENvcHlyaWdodCAoQykgMjAwMywgTHVjZW50IFRlY2hub2xv
Z2llcyBJbmMuIGFuZCBvdGhlcnMuCi5cIiBBbGwgUmlnaHRzIFJlc2VydmVkLgouXCIKLlwi
IERpc3RyaWJ1dGVkIHVuZGVyIHRoZSB0ZXJtcyBvZiB0aGUgTHVjZW50IFB1YmxpYyBMaWNl
bnNlIFZlcnNpb24gMS4wMi4KLlwiCi5cIgouXCIJU2Njc2lkIEAoIylwbS5pbgkxLjUgKGdy
aXR0ZXIpIDEwLzMwLzA1Ci5cIgouXCIgMTAvMjIvOTIgYWN0aXZhdGUgbmV4dCBsaW5lIGJl
Zm9yZSBpbnN0YWxsaW5nCi5waSAvaGxtL2xpYi9wbQouCi4JCVwiIElaIC0gaW5pdGlhbGl6
YXRpb24KLmRlIElaCi5mcCAxIFIJCQlcIiBmb3JjZSBhIGZvbnQgb3V0IGludG8gcHJlZml4
Ci5uciBQUyAxMAkJXCIgcG9pbnQgc2l6ZQoubnIgVlMgMTIJCVwiIGxpbmUgc3BhY2luZwou
cHMgXFxuKFBTCi5pZSBcXG4oVlM+PTQxIC52cyBcXG4oVlN1Ci5lbCAudnMgXFxuKFZTcAou
bnIgTEwgNmkJCVwiIGxpbmUgbGVuZ3RoCi5sbCBcXG4oTEx1Ci5uciBMVCBcXG4oLmwJCVwi
IHRpdGxlIGxlbmd0aAoubHQgXFxuKExUdQouaWYgIVxcbihITSAubnIgSE0gMWkgICBcIiB0
b3Agb2YgcGFnZQouaWYgIVxcbihGTSAubnIgRk0gMWkJXCIgZm9vdGVyIG1hcmdpbgouaWYg
IVxcbihGTyAubnIgRk8gXFxuKC5wLVxcbihGTQlcIiBib3R0b20gb2YgcGFnZQouCQkJXCIg
dG8gc2V0IHRleHQgaHQgdG8gTiwgc2V0IEZPIHRvIE4gKyBcbihITS4gIGRlZmF1bHQgaXMg
MTBpCi5wbCAzMjc2N3UJCVwiIHNhZmV0eSBmaXJzdDogYmlnIHBhZ2VzIGZvciBwbQouaWYg
IVxcbihQTyAubnIgUE8gXFxuKC5vdQlcIiBwYWdlIG9mZnNldAoubnIgUEkgNW4JCVwiIC5Q
UCBwYXJhZ3JhcGggaW5kZW50Ci5uciBRSSA1bgkJXCIgLlFTIGluZGVudAoubnIgREkgNW4J
CVwiIC5EUyBpbmRlbnQKLm5yIFBEIDAuM3YJCVwiIHBhcmFncmFwaCB2ZXJ0aWNhbCBzZXBh
cmF0aW9uCi5uciBUUyAwLjV2CQlcIiBzcGFjZSBhcm91bmQgdGFibGVzCi5uciBLZiAwLjV2
CQlcIiBzcGFjZSBhcm91bmQgLktGLy5LRQoubnIgS3MgMC41dgkJXCIgc3BhY2UgYXJvdW5k
IC5LUy8uS0UKLgoubnIgUDEgLjRpCQlcIiBpbmRlbnQgZm9yIC5QMS8uUDIKLm5yIGRQIDEJ
CVwiIGRlbHRhIHBvaW50IHNpemUgZm9yIHByb2dyYW1zIGluIC5QMS8uUDIKLm5yIGRWIDJw
CQlcIiBkZWx0YSB2ZXJ0aWNhbCBmb3IgcHJvZ3JhbXMKLm5yIGRUIDgJCVwiIGRlbHRhIHRh
YiBzdG9wIGZvciBwcm9ncmFtcwoubnIgRFYgLjV2CQlcIiBzcGFjZSBiZWZvcmUgc3RhcnQg
b2YgcHJvZ3JhbQoubnIgSVAgMAkJXCIgPwoubnIgSVIgMAkJXCIgPwoubnIgSTEgXFxuKFBJ
dQouZXYgMQouaWYgIVxcbihGTCAubnIgRkwgXFxuKExMdQlcIiBmb290bm90ZSBsZW5ndGgK
LmxsIFxcbihGTHUKLnBzIDgJCQlcIiB0ZXh0IHNpemUgJiBsZWFkaW5nIGluIGZvb3Rub3Rl
Ci52cyAxMHAKLmV2Ci5pZiAHXFwqKENIBwcgLmRzIENIICJcKGh5IFxcXFxuKFBOIFwoaHkK
LmRzICMgI1xcXFxuKC5jIFxcXFxuKC5GCi4KLgouTUUJXCIgaW5pdGlhbGl6ZSBkYXRlIHN0
cmluZ3MKLnJtIE1FCi4JXCIgIGFjY2VudHM6ICBcKidlIFwqYGUgXCo6dSBcKl5lIFwqfm4g
XCp2YSBcKixjCi5kcyAnIFxoJ1x3J2UndSo0LzEwJ1x6XChhYVxoJy1cdydlJ3UqNC8xMCcK
LmRzIGAgXGgnXHcnZSd1KjQvMTAnXHpcKGdhXGgnLVx3J2UndSo0LzEwJwouZHMgOiBcXHYn
LTAuNm0nXFxoJygxdS0oXFxcXG4oLmZ1JTJ1KSkqMC4xM20rMC4wMG0nXFx6LlxcaCcwLjJt
J1xcei5cXGgnLSgoMXUtKFxcXFxuKC5mdSUydSkpKjAuMTNtKzAuMjBtKSdcXHYnMC42bScK
LmRzIF4gXFxcXGs6XFxoJy1cXFxcbiguZnUrMXUvMnUqMnUrXFxcXG4oLmZ1LTF1KjAuMTNt
KzAuMDZtJ1xcel5cXGgnfFxcXFxuOnUnCi5kcyB+IFxcXFxrOlxcaCctXFxcXG4oLmZ1KzF1
LzJ1KjJ1K1xcXFxuKC5mdS0xdSowLjEzbSswLjA2bSdcXHp+XFxoJ3xcXFxcbjp1JwouZHMg
diBcXFxcazpcXFxcaCcrXFxcXHcnZSd1LzR1J1xcXFx2Jy0wLjZtJ1xcXFxzNnZcXFxcczBc
XFxcdicwLjZtJ1xcXFxoJ3xcXFxcbjp1JwouZHMgLCBcXFxcazpcXFxcaCdcXFxcdydjJ3Uq
MC40dSdcXFxceixcXFxcaCd8XFxcXG46dScKLi4KLgouCi4JCVwiIFNQIC0gZ2VuZXJhdGUg
cGFkZGFibGUgc3BhY2UKLmRlIFNQCi5icgoubnIgWCAxdgouaWYgXFxuKC4kIC5uciBYIFxc
JDF2Ci5pZSAnXFwkMidleGFjdGx5JyBce1wKXHYnXFxuWHUnXCBcaCctXHcnXCAndSdcYwou
c3AgXFwkMVx9Ci5lbCAuWCAiU1AgXFxuWCBcXCQyIgouLgouCQlcIiBORSAtIG5lZWQgc3Bh
Y2Ugb24gdGhpcyBwYWdlCi5kZSBORQoubnIgWCAxdgouaWYgXFxuKC4kIC5uciBYIFxcJDF2
Ci5YICJORSBcXG5YIFxcJDIiCi4uCi4JCVwiIEJQLCBGTCwgRkMgLSBiZWdpbiBwYWdlLCBm
bHVzaCBmaWd1cmVzLCBmbHVzaCBjb2x1bW4KLmRlIEJQCi5icgouWCBDTUQgQlAKLi4KLmRl
IEZMCi5icgouWCBDTUQgRkwKLi4KLmRlIEZDCi5icgouWCBDTUQgRkMKLi4KLgkJXCIgWCAt
IGdlbmVyYXRlIGFuIHggWCAuLi4gY29tbWFuZCBpbiB0aGUgb3V0cHV0Ci5kZSBYCi4uLi5p
ZSAnXFxuKC56JycgXFwheCBYIFxcJDEgXFwkMiBcXCQzIFxcJDQgXFwkNSBcXCQ2IFxcJDcg
XFwkOCBcXCQ5Ci4uLi5lbCBcXCEuWCAiXFwkMSBcXCQyIFxcJDMgXFwkNCBcXCQ1IFxcJDYg
XFwkNyBcXCQ4IFxcJDkKLi4uCi5pZiAhJ1xcbigueicnIC5pZiBcXG4oLiQ9MSBcXCEuWCAi
XFwkMQouaWYgISdcXG4oLnonJyAuaWYgXFxuKC4kPTIgXFwhLlggIlxcJDEgXFwkMgouaWYg
ISdcXG4oLnonJyAuaWYgXFxuKC4kPTMgXFwhLlggIlxcJDEgXFwkMiBcXCQzCi5pZiAhJ1xc
bigueicnIC5pZiBcXG4oLiQ+MyBcXCEuWCAiXFwkMSBcXCQyIFxcJDMgXFwkNCBcXCQ1IFxc
JDYgXFwkNyBcXCQ4IFxcJDkKLmlmICdcXG4oLnonJyAuaWYgXFxuKC4kPTEgXFwheCBYIFxc
JDEgXFwqIwouaWYgJ1xcbigueicnIC5pZiBcXG4oLiQ9MiBcXCF4IFggXFwkMSBcXCQyIFxc
KiMKLmlmICdcXG4oLnonJyAuaWYgXFxuKC4kPTMgXFwheCBYIFxcJDEgXFwkMiBcXCQzIFxc
KiMKLmlmICdcXG4oLnonJyAuaWYgXFxuKC4kPTQgXFwheCBYIFxcJDEgXFwkMiBcXCQzIFxc
JDQgXFwqIwouaWYgJ1xcbigueicnIC5pZiBcXG4oLiQ+NCBcXCF4IFggXFwkMSBcXCQyIFxc
JDMgXFwkNCBcXCQ1IFxcJDYgXFwkNyBcXCQ4IFxcJDkgXFwqIwouLgouCQlcIiBEQSAtIGZv
cmNlIGRhdGUKLmRlIERBCi5pZiBcXG4oLiQgLmRzIERZIFxcJDEgXFwkMiBcXCQzIFxcJDQK
LmRzIENGIFxcKihEWQouLgouCQlcIiBORCAtIHNldCBuZXcgb3Igbm8gZGF0ZQouZGUgTkQK
LmRzIERZIFxcJDEgXFwkMiBcXCQzIFxcJDQKLnJtIENGCi4uCi5kZSBNRQkJXCIgTUUgLSBz
ZXQgbW9udGggc3RyaW5ncwouaWYgXFxuKG1vLTAgLmRzIE1PIEphbnVhcnkKLmlmIFxcbiht
by0xIC5kcyBNTyBGZWJydWFyeQouaWYgXFxuKG1vLTIgLmRzIE1PIE1hcmNoCi5pZiBcXG4o
bW8tMyAuZHMgTU8gQXByaWwKLmlmIFxcbihtby00IC5kcyBNTyBNYXkKLmlmIFxcbihtby01
IC5kcyBNTyBKdW5lCi5pZiBcXG4obW8tNiAuZHMgTU8gSnVseQouaWYgXFxuKG1vLTcgLmRz
IE1PIEF1Z3VzdAouaWYgXFxuKG1vLTggLmRzIE1PIFNlcHRlbWJlcgouaWYgXFxuKG1vLTkg
LmRzIE1PIE9jdG9iZXIKLmlmIFxcbihtby0xMCAuZHMgTU8gTm92ZW1iZXIKLmlmIFxcbiht
by0xMSAuZHMgTU8gRGVjZW1iZXIKLmlmIFxcbihkdy0wIC5kcyBEVyBTdW5kYXkKLmlmIFxc
bihkdy0xIC5kcyBEVyBNb25kYXkKLmlmIFxcbihkdy0yIC5kcyBEVyBUdWVzZGF5Ci5pZiBc
XG4oZHctMyAuZHMgRFcgV2VkbmVzZGF5Ci5pZiBcXG4oZHctNCAuZHMgRFcgVGh1cnNkYXkK
LmlmIFxcbihkdy01IC5kcyBEVyBGcmlkYXkKLmlmIFxcbihkdy02IC5kcyBEVyBTYXR1cmRh
eQouaWYgIlxcKihEWSIiIC5kcyBEWSBcXCooTU8gXFxuKGR5LCAxOVxcbih5cgouLgouCQlc
IiBGUCAtIGZvbnQgcG9zaXRpb24gZm9yIGEgZmFtaWx5Ci5kZSBGUAouaWYgJ1xcJDEncGFs
YXRpbm8nXHtcCi4JZnAgMSBQQQouCWZwIDIgUEkKLglmcCAzIFBCCi4JZnAgNCBQWFx9Ci5p
ZiAnXFwkMSdjZW50dXJ5J1x7XAouCWllICdcXCooLlQnMjAyJ1x7XAouCQlmcCAxIE5SIENl
bnRzYgouCQlmcCAyIE5JIENlbnRJCi4JCWZwIDMgTkIgQ2VudEIKLgkJZnAgNCBOWCBDZW50
QklcfQouCWVsIFx7XAouCQlmcCAxIE5SCi4JCWZwIDIgTkkKLgkJZnAgMyBOQgouCQlmcCA0
IE5YXH1cfQouaWYgJ1xcJDEnaGVsdmV0aWNhJ1x7XAouCWZwIDEgSAouCWZwIDIgSEkKLglm
cCAzIEhCCi4JZnAgNCBIWFx9Ci5pZiAnXFwkMSdiZW1ibydce1wKLglpZSAnXFwqKC5UJzIw
Midce1wKLgkJZnAgMSBCMSBCZW1ibwouCQlmcCAyIEIyIEJlbWJvSQouCQlmcCAzIEIzIEJl
bWJvQgouCQlmcCA0IEI0IEJlbWJvQklcfQouCWVsIFx7XAouCQlmcCAxIEIxCi4JCWZwIDIg
QjIKLgkJZnAgMyBCMwouCQlmcCA0IEI0XH1cfQouaWYgJ1xcJDEnb3B0aW1hJ1x7XAouCWZw
IDEgUiBPcHRpbWEKLglmcCAyIEkgT3B0aW1hSQouCWZwIDMgQiBPcHRpbWFCCi4JZnAgNCBC
SSBPcHRpbWFCSVx9Ci5pZiAnXFwkMSdzb3V2ZW5pcidce1wKLglmcCAxIFIgU291dmVuaXIK
LglmcCAyIEkgU291dmVuaXJJCi4JZnAgMyBCIFNvdXZlbmlyQgouCWZwIDQgQkkgU291dmVu
aXJCSVx9Ci5pZiAnXFwkMSdtZWxpb3InXHtcCi4JZnAgMSBSIE1lbGlvcgouCWZwIDIgSSBN
ZWxpb3JJCi4JZnAgMyBCIE1lbGlvckIKLglmcCA0IEJJIE1lbGlvckJJXH0KLmlmICdcXCQx
J3RpbWVzJ1x7XAouCWZwIDEgUgouCWZwIDIgSQouCWZwIDMgQgouCWZwIDQgQklcfQouLgou
CQlcIiBUTCAtIHRpdGxlCi5kZSBUTAouYnIKLmlmICFcXG4oMVQgLkJHCi4uLi5oeSAwCi5m
dCAzCi5wcyBcXG4oUFMrMnAKLnZzIFxcbihWUysycAoubGwgXFxuKExMdQouY2UgMTAwCQlc
IiB0dXJuZWQgb2ZmIGluIC5SVAouc3AgLjVpCi4uCi4JCVwiIEFVIC0gcmVtZW1iZXIgYXV0
aG9yKHMpCi5kZSBBVQouZnQgMQoucHMgXFxuKFBTCi5pZSBcXG4oVlM+PTQxIC52cyBcXG4o
VlN1Ci5lbCAudnMgXFxuKFZTcAouU1AgLjUKLi4KLgkJXCIgQUkgLSBhdXRob3IncyBpbnN0
aXR1dGlvbgouZGUgQUkKLlNQIC4yNQouZnQgMgouLgouCQlcIiBBQiAtIGJlZ2luIGFic3Ry
YWN0Ci5kZSBBQgoubnIgQUIgMQkgIFwiIHdlJ3JlIGluIGFic3RyYWN0Ci5pZiAhXFxuKDFU
IC5CRwouZnQgMQoucHMgXFxuKFBTCi52cyBcXG4oVlNwCi5jZQouaW4gK1xcbigubHUvMTJ1
Ci5sbCAtXFxuKC5sdS8xMnUKLlNQIDEKLmllIFxcbiguJCBcXCQxCi5lbCBBQlNUUkFDVAou
U1AgLjc1IAouUlQKLi4KLgkJXCIgQUUgLSBlbmQgb2YgYWJzdHJhY3QKLmRlIEFFCi5icgou
bnIgQUIgMAouaW4gMAoubGwgXFxuKExMdQoucHMgXFxuKFBTCi5pZSBcXG4oVlM+PTQxIC52
cyBcXG4oVlN1Ci5lbCAudnMgXFxuKFZTcAouU1AKLi4KLgkJXCIgMkMgLSAyIGNvbHVtbnMK
LmRlIDJDCi5NQyAyCi4uCi4JCVwiIDFDIC0gMSBjb2x1bW4KLmRlIDFDCi5NQyAxCi4uCi4J
CVwiIE1DIC0gbXVsdGlwbGUgY29sdW1ucwouZGUgTUMKLmJyCi5pZiBcXG4oMVQgLlJUCi5p
ZiBcXG4oMVQgLk5QCi5pZiAhXFxuKE9MIC5uciBPTCBcXG4oTEwKLmlmIFxcbihDVz0wIC5u
ciBDVyBcXG4oTEwqNy8xNQouaWYgXFxuKEdXPTAgLm5yIEdXIFxcbihMTC0oMipcXG4oQ1cp
Ci5uciB4IFxcbihDVytcXG4oR1cKLmlmICJcXCQxIiIgLk1DIDIKLmlmIFxcJDE9MSBce1wK
LglYIE1DIDEgMAouCW5yIExMIFxcbihPTHVcfQouaWYgXFwkMT0yIFx7XAouCVggTUMgMiBc
XG54Ci4JbnIgTEwgXFxuKENXdVx9Ci5sbCBcXG4oTEx1Ci5pZiBcXCQxPjIgLnRtIC1tcG0g
Y2FuJ3QgaGFuZGxlIG1vcmUgdGhhbiB0d28gY29sdW1ucwouaWYgXFxuKDFUIC5SVAouLgou
CQlcIiBUUyAtIHRhYmxlIHN0YXJ0LCBURSAtIHRhYmxlIGVuZDsgIGFsc28gVEMsIFRRLCBU
SAouZGUgVFMKLmJyCi5pZiAhXFxuKDFUIC5SVAouU1AgXFxuKFRTdSBUUwouWCAiVVMgVFMK
LmlmIAdcXCQxB0gHIC5UUQoubnIgSVggMQouLgouZGUgVEMKLm5yIFRaIFxcbigubHUKLmlm
IFxcbiguJCAubnIgVFogXFwkMW4KLnRhIFxcbihUWnVSCi4uCi5kZSBURAouTFAKLm5yIFRa
IDAKLi4KLmRlIFRRCi5kaSBUVAoubnIgSVQgMQouLgouZGUgVEgKLmlmIFxcbiguZD4wLjV2
IFx7XAouCW5yIFQuIDAKLglUIyAwXH0KLmRpCi5uciBUUSBcXG4oLmkKLm5yIEhUIDEKLmlu
IDAKLm1rICNhCi5tayAjYgoubWsgI2MKLm1rICNkCi5tayAjZQoubWsgI2YKLlRUCi5pbiBc
XG4oVFF1Ci5tayAjVAouLgouCQlcIiBURSAtIHRhYmxlIGVuZAouZGUgVEUKLm5yIElYIDAK
LmlmIFxcbihJVCAuaWYgIVxcbihIVCBce1wKLglkaQouCW5yIEVGIFxcbigudQouCW5mCi4J
VFQKLglpZiBcXG4oRUYgLmZpXH0KLm5yIElUIDAKLm5yIEhUIDAKLnJtIGErIGIrIGMrIGQr
IGUrIGYrIGcrIGgrIGkrIGorIGsrIGwrIG4rIG0rCi5yciAzMiAzMyAzNCAzNSAzNiAzNyAz
OCA0MCA3OSA4MCA4MSA4MgoucnIgYXwgYnwgY3wgZHwgZXwgZnwgZ3wgaHwgaXwganwga3wg
bHwgbXwKLnJyIGEtIGItIGMtIGQtIGUtIGYtIGctIGgtIGktIGotIGstIGwtIG0tCi5YICJF
TkQgVVMgVEUKLlNQIFxcbihUU3UgVEUKLmJwCi4uCi4JCVwiIEVRIC0gZXF1YXRpb24sIGJy
ZWFrb3V0IGFuZCBkaXNwbGF5Ci5kZSBFUQoubnIgRUYgXFxuKC51Ci5ybSBFRQoubnIgTEUg
MQlcIiAxIGlzIGNlbnRlcgouZHMgRUwgXFwkMQouaWYgIlxcJDEiTCIgXHtcCi4JZHMgRUwg
XFwkMgouCW5yIExFIDBcfQouaWYgIlxcJDEiQyIgLmRzIEVMIFxcJDIKLmlmICJcXCQxIlIi
IFx7XAouCWRzIEVMIFxcJDIgXCIgMiBpcyByaWdodCBhZGp1c3QKLgluciBMRSAyXH0KLmlm
ICJcXCQxIkkiIFx7XAouCW5yIExFIDAKLglpZiAiXFwkMyIiIC5kcyBFRSBcXGgnfDEwbicK
LgllbCAuZHMgRUUgXFxoJ1xcJDMnCi4JZHMgRUwgXFwkMlx9Ci5pZiBcXG4oWUUgLm5mCi5k
aSBFWgouLgouCQlcIiBFTiAtIGVuZCBvZiBlcXVhdGlvbgouZGUgRU4gCi5icgouZGkKLnJt
IEVaCi5uciBaTiBcXG4oZG4KLmlmIFxcbihaTiAuaWYgIVxcbihZRSAuTFAKLmlmICFcXG4o
Wk4gLmlmICEiXFwqKEVMIiIgLm5yIFpOIDEKLmlmIFxcbihaTiBce1wKLglTUCAuNXYgRVEK
LglYICJVUyBFUSJcfQoncGMKLmlmIFxcbihCRCAubnIgTEUgMCBcIiBkb24ndCBjZW50ZXIg
aWYgYmxvY2sgZGlzcGxheSBvciBtYXJrL2xpbmV1cAouaWYgXFxuKE1LIFx7XAouCWlmIFxc
bihMRT0xIC5kcyBFRSBcXGgnfDEwbicKLgluciBMRSAwXH0KJ2x0IFxcbigubHUKLmlmICFc
XG4oRVAgLmlmIFxcbihaTiBce1wKLglpZiBcXG4oTEU9MSAudGwgXCh0c1wodHNcXCooMTBc
KHRzXFwqKEVMXCh0cwouCWlmIFxcbihMRT0yIC50bCBcKHRzXCh0c1wodHNcXCooMTBcXCoo
RUxcKHRzCi4JaWYgIVxcbihMRSBce1wKLgkJaWYgIVxcbihCRCAudGwgXCh0c1xcKihFRVxc
KigxMFwodHNcKHRzXFwqKEVMXCh0cwouCQlpZiBcXG4oQkQgLmlmIFxcbihCRDxcXHdcKHRz
XFwqKDEwXCh0cyAubnIgQkQgXFx3XCh0c1xcKigxMFwodHMKLgkJaWYgXFxuKEJEIFwhXFwq
KDEwXFx0XFwqKEVMXH1cfQouaWYgXFxuKEVQIC5pZiBcXG4oWk4gXHtcCi4JaWYgXFxuKExF
PTEgLnRsIFwodHNcXCooRUxcKHRzXFwqKDEwXCh0c1wodHMKLglpZiBcXG4oTEU9MiAudGwg
XCh0c1xcKihFTFwodHNcKHRzXFwqKDEwXCh0cwouCWlmICFcXG4oTEUgXHtcCi4JCWlmICFc
XG4oQkQgLnRsIFwodHNcXCooRUxcXCooRUVcXCooMTBcKHRzXCh0c1wodHMKLgkJaWYgXFxu
KEJEIC5pZiBcXG4oQkQ8XFx3XCh0c1xcKigxMFwodHMgLm5yIEJEIFxcd1wodHNcXCooMTBc
KHRzCi4JCWlmIFxcbihCRCBcIVxcaCctXFxcXG4oLml1J1xcKihFTFxcaCd8MCdcXCooMTBc
fVx9CidsdCBcXG4oTEx1CidwYyAlCi5pZiBcXG4oWUUgLmlmIFxcbihFRiAuZmkKLmlmIFxc
bihaTiAuWCAiRU5EIFVTIEVRIgouaWYgXFxuKFpOIC5TUCAuNXYgRU4KLmlmIFxcbihaTiAu
YnAKLi4KLgkJXCIgUFMgLSBzdGFydCBwaWN0dXJlCi5kZSBQUwkJCVwiICQxIGlzIGhlaWdo
dCwgJDIgaXMgd2lkdGgsIGluIGluY2hlcwouYnIKLm5yIFggMC4zNXYKLmlmIFxcJDE+MCAu
WCAiU1AgXFxuWCBQUyIKLmllIFxcJDE+MCAubnIgJDEgXFwkMQouZWwgLm5yICQxIDAKLlgg
IlVTIFBTIFxcJDEKLmluIChcXG4oLmx1LVxcJDIpLzJ1Ci4uCi4JCVwiIFBFIC0gZW5kIG9m
IHBpY3R1cmUKLmRlIFBFCi5pbgouWCAiRU5EIFVTIFBFCi5uciBYIC42NXYKLmlmIFxcbigk
MT4wIC5YICJTUCBcXG5YIFBFIgouYnAKLi4KLmRlIElTCVwiIGZvciAtbXBtIG9ubHkKLktT
Ci4uCi5kZSBJRQouS0UKLmJwCi4uCi4JCVwiIE5QIC0gbmV3IHBhZ2UKLmRlIE5QCi5ldiAy
Ci5icAouaWYgXFxuKEtGPTAgXHtcCi4JbnIgUFggXFxuKC5zCi4JbnIgUEYgXFxuKC5mCi4J
bnIgUFYgXFxuKC52Ci4JbHQgXFxuKExUdQouCXBzIFxcbihQUwouCXZzIFxcbihQUysyCi4J
ZnQgMQouCWlmIFxcbihQTyAucG8gXFxuKFBPdQlcIiB3aHkgaXNuJ3QgdGhpcyByZXNldD8/
PwouCVBUIFxcJDEKLglicAouCXJzCi4JQlQKLglicAouCW5yICUjICsxCi4JcHMgXFxuKFBY
Ci4JdnMgXFxuKFBWdQouCWZ0IFxcbihQRiBcfQouZXYKLi4KLgouZHMgJWUgLnRsICdcXCoo
TEgnXFwqKENIJ1xcKihSSCcKLmRzICVvIC50bCAnXFwqKExIJ1xcKihDSCdcXCooUkgnCi5k
cyAlRSAudGwgJ1xcKihMRidcXCooQ0YnXFwqKFJGJwouZHMgJU8gLnRsICdcXCooTEYnXFwq
KENGJ1xcKihSRicKLgouCQlcIiBQVCAtIHBhZ2UgdGl0bGUKLmRlIFBUCi5uciBQTiBcXG4o
JSMKLlggIlBUIFxcbiglIwouc3AgXFxuKEhNdS8ydQouaWYgXFxuKE9MIC5sdCBcXG4oT0x1
CQlcIiB3aHkgaXNuJ3QgdGhpcyByZXNldD8/PwouaWYgXFxuKEJUPjAgLmlmIFxcbiglIyUy
IFxcKiglbwouaWYgXFxuKEJUPjAgLmlmICFcXG4oJSMlMiBcXCooJWUKLmlmIFxcbihCVD0w
IC50bCAnXDAnJycJCVwiIHB1dCBvdXQgc29tZXRoaW5nIG9yIHNwYWNpbmcgaXMgY3VyZGxl
ZAouWCAiRU5EIFBUIFxcbiglIwouLgouCQlcIiBCVCAtIGJvdHRvbSB0aXRsZQouZGUgQlQK
LlggIkJUIFxcbiglIwouc3AgfFxcbihGTXUvMnUrXFxuKEZPdS0xdgouaWYgXFxuKCUjJTIg
XFwqKCVPCi5pZiAhXFxuKCUjJTIgXFwqKCVFCi5uciBCVCBcXG4oQlQrMQouWCAiRU5EIEJU
IFxcbiglIwouLgouCQlcIiBLUyAtIG5vbi1mbG9hdGluZyBrZWVwCi5kZSBLUwouYnIKLmlm
ICJcXG4oLnoiIiAuTlAgIFwiIGRlZmVuZHMgcG9vcmx5IGFnYWluc3QgaW5jbHVkaW5nIGh0
IG9mIHBhZ2Ugc3R1ZmYgaW4gZGl2ZXJzaW9uIGZvciAuQjEKLlggIlVTIEtTIDAKLm5yIEtT
ICsxCi5TUCBcXG4oS3N1Ci4uCi4JCVwiIEtGIC0gZmxvYXRpbmcga2VlcAouZGUgS0YKLmV2
IDEKLmJyCi5pZiBcXG4oS1M+MCAudG0gS0Ygd29uJ3Qgd29yayBpbnNpZGUgS1MsIGxpbmUg
XFxuKC5jLCBmaWxlIFxcbiguRgouaWYgXFxuKEtGPjAgLnRtIEtGIHdvbid0IHdvcmsgaW5z
aWRlIEtGLCBsaW5lIFxcbiguYywgZmlsZSBcXG4oLkYKLm5yIEtGIDEKLm5yIDEwIDAKLglp
ZiAhJ1xcJDEnJyAubnIgMTAgXFwkMXUKLglpZiAnXFwkMSdib3R0b20nIC5uciAxMCBcXG4o
Rk91LTF1Ci4JaWYgJ1xcJDEndG9wJyAubnIgMTAgXFxuKEhNCi4JaWYgXFxuKDEwIC5YICJV
RiBcXG4oMTAgS0YiCi4JaWYgIVxcbigxMCAuWCAiVUYgXFxuKEhNIEtGIgouCW5yIFggXFxu
KEZPdS0ydQouCWlmIFxcbigxMCAuWCAiVUYgXFxuKDEwIEtGIgouCWlmICFcXG4oMTAgLlgg
IlVGIFxcblggS0YiCi5uciBTSiBcXG4oLnUKLnBzIFxcbihQUwouaWYgXFxuKFZTPjQwIC52
cyBcXG4oVlN1Ci5pZiBcXG4oVlM8PTM5IC52cyBcXG4oVlNwCi5sbCBcXG4oTEx1Ci5sdCBc
XG4oTFR1Ci5TUCBcXG4oS2Z1Ci4uCi4JCVwiIEtFIC0gZW5kIG9mIEtTL0tGCi5kZSBLRQou
YnAKLmllIFxcbihLUz4wIFx7XAouCVNQIFxcbihLc3UKLglYICJFTkQgVVMgS1MKLgluciBL
UyAtMSBcfQouZWwgLmllIFxcbihLRj4wIFx7XAouCVNQIFxcbihLZnUKLgluciBLRiAwCi4J
WCAiRU5EIFVGIEtGIgouCWlmIFxcbihTSiAuZmkKLglldiBcfQouZWwgLnRtIC5LRSB3aXRo
b3V0IHByZWNlZGluZyAuS1Mgb3IgLktGLCBsaW5lIFxcbiguYywgZmlsZSBcXG4oLkYKLi4K
LgouCQlcIiBEUyAtIGRpc3BsYXkuIC5EUyBDIGNlbnRlcjsgTCBsZWZ0LWFkanVzdDsgSSBp
bmRlbnQgKGRlZmF1bHQpCi5kZSBEUwkJXCIgICQyID0gYW1vdW50IG9mIGluZGVudAouS1MK
Lm5mCi5cXCQxRCBcXCQyIFxcJDEKLmZ0IDEKLmlmICFcXG4oSUYgXHtcCi4JcHMgXFxuKFBT
Ci4JaWYgXFxuKFZTPjQwIC52cyBcXG4oVlN1Ci4JaWYgXFxuKFZTPD0zOSAudnMgXFxuKFZT
cFx9Ci4uCi5kZSBECi5JRCBcXCQxCi4uCi5kZSBDRAouWEQKLmNlIDEwMDAKLi4KLmRlIElE
Ci5YRAouaWYgXFxuKC4kPTAgLmluICtcXG4oREl1Ci5pZiBcXG4oLiQ9MSAuaWYgIlxcJDEi
SSIgLmluICtcXG4oREl1Ci5pZiBcXG4oLiQ9MSAuaWYgISJcXCQxIkkiIC5pbiArXFwkMW4K
LmlmIFxcbiguJD4xIC5pbiArXFwkMm4KLi4uLi5pbiArMC41aQouLi4uLmlmIFxcbiguJCAu
aWYgISJcXCQxIkkiIC5pZiAhIlxcJDEiIiAuaW4gXFxuKERJdQouLi4uLmlmIFxcbiguJCAu
aWYgISJcXCQxIkkiIC5pZiAhIlxcJDEiIiAuaW4gK1xcJDFuCi4uCi5kZSBMRAouWEQKLi4K
LmRlIFhECi5uZgoubnIgT0kgXFxuKC5pCi5TUCBcXG4oRFZ1Ci4uCi4JCVwiIEJEIC0gYmxv
Y2sgZGlzcGxheTogc2F2ZSBldmVyeXRoaW5nLCB0aGVuIGNlbnRlciBpdC4KLmRlIEJECi5Y
RAoubnIgQkQgMQoubmYKLmluIFxcbihPSXUKLmRpIERECi4uCi4JCVwiIERFIC0gZGlzcGxh
eSBlbmQKLmRlIERFCi5jZSAwCi5pZiBcXG4oQkQ+MCAuWEYKLm5yIEJEIDAKLmluIFxcbihP
SXUKLlNQIFxcbihEVnUKLktFCi5maQouLgouCQlcIiBYRiAtIGZpbmlzaCBhIGJsb2NrIGRp
c3BsYXkgdG8gYmUgcmVjZW50ZXJlZC4KLmRlIFhGCi5kaQouaWYgXFxuKGRsPlxcbihCRCAu
bnIgQkQgXFxuKGRsCi5pZiBcXG4oQkQ8XFxuKC5sIC5pbiAoXFxuKC5sdS1cXG4oQkR1KS8y
dQoubnIgRUkgXFxuKC5sLVxcbiguaQoudGEgXFxuKEVJdVIKLm5mCi5ERAouaW4gXFxuKE9J
dQouLgouCi4KLgkJXCIgU0ggLSAodW5udW1iZXJlZCkgc2VjdGlvbiBoZWFkaW5nCi5kZSBT
SAouUlQKLm5yIFggMXYKLm5yIFkgM3YKLmlmIFxcbigxVCAuTlAKLmlmIFxcbigxVCAuWCAi
TkUgXFxuWSBTSCIJXCIgc2hvdWxkIHRoZXNlIGJlIHJldmVyc2VkLCBjaGFuZ2UgWSB0byA0
dgouaWYgXFxuKDFUIC5YICJTUCBcXG5YIFNICi5mdCAzCi4uCi4JCVwiIE5IIC0gbnVtYmVy
ZWQgaGVhZGluZwouZGUgTkgKLlJUCi5uciBYIDF2Ci5uciBZIDN2Ci5pZiBcXG4oMVQgLk5Q
Ci5pZiBcXG4oMVQgLlggIk5FIFxcblkgTkgiCVwiIHNob3VsZCB0aGVzZSBiZSByZXZlcnNl
ZCwgY2hhbmdlIFkgdG8gNHYKLmlmIFxcbigxVCAuWCAiU1AgXFxuWCBOSAouZnQgMwoubnIg
TlMgXFwkMQouaWYgIVxcbiguJCAubnIgTlMgMQouaWYgIVxcbihOUyAubnIgTlMgMQoubnIg
SFxcbihOUyArMQouaWYgIVxcbihOUy00IC5uciBINSAwCi5pZiAhXFxuKE5TLTMgLm5yIEg0
IDAKLmlmICFcXG4oTlMtMiAubnIgSDMgMAouaWYgIVxcbihOUy0xIC5uciBIMiAwCi5pZiAh
XFwkMSAuaWYgXFxuKC4kIC5uciBIMSAxCi5kcyBTTiBcXG4oSDEuCi5pZiBcXG4oTlMtMSAu
YXMgU04gXFxuKEgyLgouaWYgXFxuKE5TLTIgLmFzIFNOIFxcbihIMy4KLmlmIFxcbihOUy0z
IC5hcyBTTiBcXG4oSDQuCi5pZiBcXG4oTlMtNCAuYXMgU04gXFxuKEg1LgpcXCooU04KLi4K
LgkJXCIgUlQgLSByZXNldCBhdCBiZWdpbm5pbmcgb2YgZWFjaCBQUCwgTFAsIGV0Yy4KLmRl
IFJUCi5pZiAhXFxuKEFCIC5pZiAhXFxuKDFUIC5CRwouY2UgMAouaWYgIVxcbihBQiAuaWYg
IVxcbihLRiAuaWYgIVxcbihJRiAuaWYgIVxcbihJWCAuaWYgIVxcbihCRSAuZGkKLmlmIFxc
bihRUCBce1wKLglsbCArXFxuKFFJdQouCWluIC1cXG4oUUl1Ci4JbnIgUVAgLTFcfQouaWYg
IVxcbihBQiBce1wKLglsbCBcXG4oTEx1XH0KLmlmICFcXG4oSUYgLmlmICFcXG4oQUIgXHtc
Ci4JcHMgXFxuKFBTCi4JaWUgXFxuKFZTPj00MSAudnMgXFxuKFZTdQouCWVsIC52cyBcXG4o
VlNwXH0KLmllIFxcbihJUCBce1wKLglpbiBcXG4oSVxcbihJUnUKLgluciBJUCAtMVx9Ci5l
bCAuaWYgIVxcbihJUiBce1wKLgluciBJMSBcXG4oUEl1Ci4JbnIgSTIgMAouCW5yIEkzIDAK
LgluciBJNCAwCi4JbnIgSTUgMFx9Ci5pZiAhXFxuKEFCIC5mdCAxCi50YSA1biAxMG4gMTVu
IDIwbiAyNW4gMzBuIDM1biA0MG4gNDVuIDUwbiA1NW4gNjBuIDY1biA3MG4gNzVuIDgwbgou
ZmkKLi4KLgkJXCIgQkcgLSBiZWdpbiwgZXhlY3V0ZSBhdCBmaXJzdCBUTCwgQUIsIE5ILCBT
SCwgUFAsIGV0Yy4KLmRlIEJHCQlcIglJWiBoYXMgYmVlbiBjYWxsZWQsIHNvIHJlZ2lzdGVy
cyBoYXZlIHNvbWUgdmFsdWUKLmJyCi5pZiBcXG4oQ1c+MCAuaWYgXFxuKExMPTAgLm5yIExM
IFxcbihDVytcXG4oQ1crXFxuKEdXCi5sbCBcXG4oTEx1Ci5sdCBcXG4oTEx1Ci5wbyBcXG4o
UE91Ci5uciBZRSAxCQlcIiBvayB0byBjYXVzZSBicmVhayBpbiAuRVEgKGVhcmxpZXIgb25l
cyB3b24ndCkKLmV2IDAKLmh5IDE0Ci5ldgouZXYgMQouaHkgMTQKLmV2Ci5ldiAyCi5oeSAx
NAouZXYKLm5yIDFUIDEKLlggIlBBUk0gTlAgXFxuKEhNCi5YICJQQVJNIEZPIFxcbihGTwou
aWYgIVxcbiglIyAubnIgJSMgMQouLgouCQlcIiBQUCAtIHBhcmFncmFwaAouZGUgUFAKLlJU
Ci5pZiBcXG4oMVQgLk5QCi5pZiBcXG4oMVQgLlggIlNQIFxcbihQRCBQUCIKLmlmIFxcbigx
VCAuWCAiQlMgMiBQUCIKLnRpICtcXG4oUEl1Ci4uCi4JCVwiIExQIC0gbGVmdCBhbGlnbmVk
IHBhcmFncmFwaAouZGUgTFAKLlJUCi5pZiBcXG4oMVQgLk5QCi5pZiBcXG4oMVQgLlggIlNQ
IFxcbihQRCBMUCIKLmlmIFxcbigxVCAuWCAiQlMgMiBMUCIKLi4KLgkJXCIgSVAgLSBpbmRl
bnRlZCBwYXJhZ3JhcGgKLmRlIElQCi5SVAouaWYgIVxcbihJUCAubnIgSVAgKzEKLmlmIFxc
bigxVCAuTlAKLmlmIFxcbigxVCAuWCAiU1AgXFxuKFBEIFBQIgouaWYgXFxuKDFUIC5YICJC
UyAyIElQIgoubnIgSVUgXFxuKElSKzEKLmlmIFxcbiguJD4xIC5uciBJXFxuKElVIFxcJDJu
K1xcbihJXFxuKElSdQouaWYgXFxuKElcXG4oSVU9MCAubnIgSVxcbihJVSBcXG4oUEl1K1xc
bihJXFxuKElSdQouaW4gXFxuKElcXG4oSVV1Ci5uciBUWSBcXG4oVFotXFxuKC5pCi5uciBK
USBcXG4oSVxcbihJVS1cXG4oSVxcbihJUgoudGEgXFxuKEpRdSBcXG4oVFl1UgouaWYgXFxu
KC4kIFx7XAoudGkgXFxuKElcXG4oSVJ1ClwmXFwkMVx0XGNcfQouLgouCQlcIiBRUCAtIHF1
b3RlZCBwYXJhZ3JhcGggKHdpdGhpbiBJUCkKLmRlIFFQCi5SVAouaWYgXFxuKDFUIC5OUAou
aWYgXFxuKDFUIC5YICJTUCBcXG4oUEQgUVAiCi5pZiBcXG4oMVQgLlggIkJTIDIgUVAiCi5u
ciBRUCAxCi5pbiArXFxuKFFJdQoubGwgLVxcbihRSXUKLnRpIFxcbiguaXUKLi4KLgkJXCIg
UlMgLSBwcmVwYXJlIGZvciBkb3VibGUgaW5kZW50aW5nCi5kZSBSUwoubnIgSVMgXFxuKElQ
Ci5SVAoubnIgSVAgXFxuKElTCi5uciBJVSBcXG4oSVIKLm5yIElSICsxCi5pZiAhXFxuKElc
XG4oSVIgLm5yIElcXG4oSVIgXFxuKElcXG4oSVUrXFxuKFBJdQouaW4gXFxuKElcXG4oSVJ1
Ci5uciBUWSBcXG4oVFotXFxuKC5pCi50YSBcXG4oVFl1UgouLgouCQlcIiBSRSAtIHJldHJl
YXQgdG8gdGhlIGxlZnQKLmRlIFJFCi5uciBJUyBcXG4oSVAKLlJUCi5uciBJUCBcXG4oSVMK
LmlmIFxcbihJUj4wIC5uciBJUiAtMQouaW4gXFxuKElcXG4oSVJ1Ci4uCi4JCVwiIEIgLSBi
b2xkIGZvbnQKLmRlIEIKLm5yIFBRIFxcbiguZgouZnQgMwouaWYgXFxuKC4kIFwmXFwkMVxc
ZlxcbihQUVxcJDIKLi4KLgkJXCIgQkkgLSBib2xkIGl0YWxpYwouZGUgQkkKLm5yIFBRIFxc
biguZgouZnQgNAouaWYgXFxuKC4kIFwmXFwkMVxcZlxcbihQUVxcJDIKLi4KLgkJXCIgUiAt
IFJvbWFuIGZvbnQKLmRlIFIKLm5yIFBRIFxcbiguZgouZnQgMQouaWYgXFxuKC4kIFwmXFwk
MVxmXFxuKFBRXFwkMgouLgouCQlcIiBJIC0gaXRhbGljIGZvbnQKLmRlIEkKLm5yIFBRIFxc
biguZgouZnQgMgouaWYgXFxuKC4kIFwmXFwkMVxeXGZcXG4oUFFcXCQyCi4uCi4JCVwiIENX
IC0gY29uc3RhbnQgd2lkdGggZm9udCBmcm9tIC1tcwouZGUgQ1cKLm5yIFBRIFxcbiguZgou
aWYgXFxuKC4kPTAgLmZ0IENXCi5pZiBcXG4oLiQ+MCBcJVwmXFwkM1xmKENXXFwkMVxcZlxc
bihQUVxcJDIKLi4KLmRlIElUCQlcIiBkaXR0byB0byBpdGFsaWNpemUgYXJndW1lbnQKLm5y
IFNmIFxcbiguZgpcJVwmXFwkM1xmMlxcJDFcZlxcbihTZlwmXFwkMgouLgouCQlcIiBUQSAt
IHRhYnMgc2V0IGluIGVucyBvciBjaGFycwouZGUgVEEKLnRhIFxcJDFuIFxcJDJuIFxcJDNu
IFxcJDRuIFxcJDVuIFxcJDZuIFxcJDduIFxcJDhuIFxcJDluCi4uCi4JCVwiIFNNIC0gbWFr
ZSBzbWFsbGVyIHNpemUKLmRlIFNNCi5pZSBcXG4oLiQgXCZcXCQzXHMtMlxcJDFcczBcXCQy
Ci5lbCAucHMgLTIKLi4KLgkJXCIgTEcgLSBtYWtlIGxhcmdlciBzaXplCi5kZSBMRwouaWUg
XFxuKC4kIFwmXFwkM1xzKzJcXCQxXHMwXFwkMgouZWwgLnBzICsyCi4uCi4JCVwiIE5MIC0g
cmV0dXJuIHRvIG5vcm1hbCBzaXplCi5kZSBOTAoucHMgXFxuKFBTCi4uCi4JCVwiIEZTIC0g
YmVnaW4gZm9vdG5vdGUKLmRlIEZTCi5pZiBcXG4oSUY+MCAudG0gLkZTIHdpdGhpbiAuRlMv
LkZFLCBsaW5lIFxcbiguYywgZmlsZSBcXG4oLkYKLmlmIFxcbihLRj4wIC50bSAuRlMgd29u
J3Qgd29yayBpbnNpZGUgLktGLCBsaW5lIFxcbiguYywgZmlsZSBcXG4oLkYKLmlmIFxcbihL
Uz4wIC50bSAuRlMgd29uJ3Qgd29yayBpbnNpZGUgLktTLCBsaW5lIFxcbiguYywgZmlsZSBc
XG4oLkYKLm5yIElGIDEKLmV2IDEKLnBzIFxcbihQUy0yCi5pZSBcXG4oVlM+PTQxIC52cyBc
XG4oVlN1LTJwCi5lbCAudnMgXFxuKFZTcC0ycAoubGwgXFxuKExMdQouYnIKLm5yIFggXFxu
KEZPdQouWCAiQkYgXFxuWCBGUwouU1AgLjN2Ci4uLi5GQQlcIiBkZWxldGVkIGJ5IGF1dGhv
cml0eSBvZiBjdncsIDEwLzE3Lzg4Ci4uCi4JCVwiIEZFIC0gZW5kIGZvb3Rub3RlCi5kZSBG
RQouaWYgIVxcbihJRiAudG0gLkZFIHdpdGhvdXQgLkZTLCBsaW5lIFxcbiguYywgZmlsZSBc
XG4oLkYKLmJyCi5YICJFTkQgQkYgRkUKLmJwCi5ldgoubnIgSUYgMAouLgouCQlcIiBGQSAt
IHRoZSBsaW5lIGZvciBhIGZvb3Rub3RlCi5kZSBGQQpcbCcxaScKLmJyCi4uCi4JCVwiIFRt
IC0gbWVzc2FnZSB0byBiZSBwYXNzZWQgb24KLmRlIFRtCi5ldiAyCi5pZiBcXG4oLiQ9MSAu
WCAiVE0gXFwkMQouaWYgXFxuKC4kPTIgLlggIlRNIFxcJDEgXFwkMgouaWYgXFxuKC4kPTMg
LlggIlRNIFxcJDEgXFwkMiBcXCQzCi5pZiBcXG4oLiQ9NCAuWCAiVE0gXFwkMSBcXCQyIFxc
JDMgXFwkNAouaWYgXFxuKC4kPTUgLlggIlRNIFxcJDEgXFwkMiBcXCQzIFxcJDQgXFwkNQou
aWYgXFxuKC4kPTYgLlggIlRNIFxcJDEgXFwkMiBcXCQzIFxcJDQgXFwkNSBcXCQ2Ci5pZiBc
XG4oLiQ9NyAuWCAiVE0gXFwkMSBcXCQyIFxcJDMgXFwkNCBcXCQ1IFxcJDYgXFwkNwouaWYg
XFxuKC4kPTggLlggIlRNIFxcJDEgXFwkMiBcXCQzIFxcJDQgXFwkNSBcXCQ2IFxcJDcgXFwk
OAouaWYgXFxuKC4kPTkgLlggIlRNIFxcJDEgXFwkMiBcXCQzIFxcJDQgXFwkNSBcXCQ2IFxc
JDcgXFwkOCBcXCQ5Ci5icgouZXYKLi4KLmRlIE1ICkFUJlQgQmVsbCBMYWJvcmF0b3JpZXMK
TXVycmF5IEhpbGwsIE5ldyBKZXJzZXkgMDc5NzQKLi4KLmRlIEhPCkFUJlQgQmVsbCBMYWJv
cmF0b3JpZXMKSG9sbWRlbCwgTmV3IEplcnNleSAwNzczMwouLgouZGUgV0gKQVQmVCBCZWxs
IExhYm9yYXRvcmllcwpXaGlwcGFueSwgTmV3IEplcnNleSAwNzk4MQouLgouZGUgSUgKQVQm
VCBCZWxsIExhYm9yYXRvcmllcwpOYXBlcnZpbGxlLCBJbGxpbm9pcyA2MDU0MAouLgouCQlc
IiBVTCAtIHVuZGVybGluZSBhcmd1bWVudCwgZG9uJ3QgaXRhbGljaXplCi5kZSBVTApcXCQx
XGwnfDBcKHVsJ1xcJDIKLi4KLgkJXCIgVVggLSBwcmludCAkMiBVTklYICQxCi5kZSBVWAou
aWUgXFxuKFVYIFxcJDJccy0xVU5JWFxzMFxcJDEKLmVsIFx7XApcXCQyXHMtMVVOSVhcXHMw
XFwkMVwocmcKLm5yIFVYIDFcfQouLgouCQlcIiBRUyAtIHN0YXJ0IHF1b3RlCi5kZSBRUwou
YnIKLkxQCi5pbiArXFxuKFFJdQoubGwgLVxcbihRSXUKLi4KLgkJXCIgUUUgLSBlbmQgcXVv
dGUKLmRlIFFFCi5icgoubGwgK1xcbihRSXUKLmluIC1cXG4oUUl1Ci5MUAouLgouCQlcIiAg
QjEgLSBiZWdpbiBib3hlZCBzdHVmZgouZGUgQjEKLmJyCi5kaSBCQgoubnIgQkMgMAouaWYg
IlxcJDEiQyIgLm5yIEJDIDEKLm5yIEJFIDEKLi4KLgkJXCIgQjIgLSBlbmQgYm94ZWQgc3R1
ZmYKLmRlIEIyIAouYnIKLm5yIEJJIDFuCi5pZiBcXG4oLiQ+MCAubnIgQkkgXFwkMW4KLmRp
Ci5uciBCRSAwCi5uciBCVyBcXG4oZGwKLm5yIEJIIFxcbihkbgoubmUgXFxuKEJIdStcXG4o
LlZ1Ci5uciBCUSBcXG4oLmoKLm5mCi50aSAwCi5pZiBcXG4oQkM+MCAuaW4gKyhcXG4oLmx1
LVxcbihCV3UpLzJ1Ci5pbiArXFxuKEJJdQoubHMgMQouQkIKLmxzCi5pbiAtXFxuKEJJdQou
bnIgQlcgKzIqXFxuKEJJCi5zcCAtMQpcbCdcXG4oQld1XCh1bCdcTCctXFxuKEJIdSdcbCd8
MFwodWwnXGgnfDAnXEwnXFxuKEJIdScKLmlmIFxcbihCQz4wIC5pbiAtKFxcbigubHUtXFxu
KEJXdSkvMnUKLmlmIFxcbihCUSAuZmkKLmJyCi4uCi4JCVwiIEJYIC0gYm94ZWQgc3R1ZmYK
LmRlIEJYClwoYnJcfFxcJDFcfFwoYnJcbCd8MFwocm4nXGwnfDBcKHVsJwouLgouCi4JXCIg
bWFjcm9zIGZvciBwcm9ncmFtcywgZXRjLgouCi5pZwoJcHJvZ3JhbXMgYXJlIGRpc3BsYXll
ZCBiZXR3ZWVuIC5QMS8uUDIgcGFpcnMKCWRlZmF1bHQgaXMgdG8gaW5kZW50IGJ5IDEvMiBp
bmNoLCBub2ZpbGwsIGRQIHNtYWxsZXIKCS5QMSB4IGNhdXNlcyBhbiBpbmRlbnQgb2YgeCBp
bnN0ZWFkLgoKCS5QMyBjYW4gYmUgdXNlZCB0byBzcGVjaWZ5IG9wdGlvbmFsIHBhZ2UtYnJl
YWsgcG9pbnRzCglpbnNpZGUgLlAxLy5QMgouLgouCi4JCVwiIFAxIC0gc3RhcnQgb2YgcHJv
Z3JhbQouZGUgUDEKLm5yICQxIFxcbihQMQouaWYgXFxuKC4kIC5uciAkMSBcXCQxbgouYnIK
LlggIlNQIFxcbihEViBQMSIKLlggIlVTIFAxIgouaW4gXFxuKCQxdQoubmYKLm5yIHYgXFxu
KC52Ci5wcyAtXFxuKGRQCi52cyAtXFxuKGRWdQouZnQgQ1cKLm5yIHQgXFxuKGRUKlxcdyd4
J3UKLnRhIDF1KlxcbnR1IDJ1KlxcbnR1IDN1KlxcbnR1IDR1KlxcbnR1IDV1KlxcbnR1IDZ1
KlxcbnR1IDd1KlxcbnR1IDh1KlxcbnR1IDl1KlxcbnR1IDEwdSpcXG50dSAxMXUqXFxudHUg
MTJ1KlxcbnR1IDEzdSpcXG50dSAxNHUqXFxudHUKLi4KLgkJXCIgUDIgLSBlbmQgb2YgcHJv
Z3JhbQouZGUgUDIKLmJyCi5wcyBcXG4oUFMKLnZzIFxcbnZ1Ci5mdCAxCi5pbgouWCAiRU5E
IFVTIFAxCi5YICJTUCBcXG4oRFYgUDIiCi5maQouLgouCQlcIiBQMyAtIHByb3ZpZGVzIG9w
dGlvbmFsIHVucGFkZGVkIGJyZWFrIGluIFAxL1AyCi5kZSBQMwoubnIgeCBcXG4oRFYKLm5y
IERWIDAKLlAyCi5QMSBcXG4oJDF1Ci5uciBEViBcXG54Ci4uCi5kZSBbClsKLi4KLmRlIF0K
XQouLgouSVoKLnJtIElaCi5zbyAvaGxtL2xpYi9kb2N0b29scy90bWFjL3NyZWZzCg==

--=_4f0b4a3b.LcSDzbDC6BUMEJHXL5SsSL6Z24SQd4LYHWVzoXfmoGAcDusb--


From MAILER-DAEMON Mon Jan 09 21:15:45 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RkRFZ-00043k-Cu
	for mharc-groff@gnu.org; Mon, 09 Jan 2012 21:15:45 -0500
Received: from eggs.gnu.org ([140.186.70.92]:38532)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bruno@clisp.org>) id 1RkRFW-00043a-OH
	for groff@gnu.org; Mon, 09 Jan 2012 21:15:43 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bruno@clisp.org>) id 1RkRFV-0003AX-9t
	for groff@gnu.org; Mon, 09 Jan 2012 21:15:42 -0500
Received: from mo-p00-ob.rzone.de ([81.169.146.162]:48830)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bruno@clisp.org>) id 1RkRFU-0003AR-AW
	for groff@gnu.org; Mon, 09 Jan 2012 21:15:41 -0500
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; t=1326161738; l=2288;
	s=domk; d=haible.de;
	h=Content-Type:Content-Transfer-Encoding:MIME-Version:References:
	In-Reply-To:Date:Subject:Cc:To:From:X-RZG-CLASS-ID:X-RZG-AUTH;
	bh=aSXwL6hPdhB1Ln3PgiMmyuvIM5s=;
	b=PGpRY0SsfH0VJ2Fx+qd47tKiFSXjTkptPxOKprbt/SnL0B8LAHHzqDzBLNI+sHiV2YF
	Pf+iOAsVYdYJVORDU7GgLiP3jdZtMBizK9h90D0uM/Uwr0oRbhIR60kfzb9j2FeyZcjtT
	+dHee6DPdJdMauEP8IXh7lnrMv430262ADQ=
X-RZG-AUTH: :Ln4Re0+Ic/6oZXR1YgKryK8brksyK8dozXDwHXjf9hj/zDNRbvc44/6LjQ==
X-RZG-CLASS-ID: mo00
Received: from linuix.haible.de
	(dslb-088-068-071-136.pools.arcor-ip.net [88.68.71.136])
	by smtp.strato.de (cohen mo8) (RZmta 27.3 DYNA|AUTH)
	with ESMTPA id f06fe9o0A05Ynq ; Tue, 10 Jan 2012 03:15:28 +0100 (MET)
From: Bruno Haible <bruno@clisp.org>
To: groff@gnu.org
Bcc: bruno@haible.de
Date: Tue, 10 Jan 2012 03:15:46 +0100
Message-ID: <4474449.lWL7ku9IWE@linuix>
User-Agent: KMail/4.7.4 (Linux/3.1.0-1.2-desktop; KDE/4.7.4; x86_64; ; )
In-Reply-To: <20111226141832.GI11624@iris.usta.de>
References: <20111226141832.GI11624@iris.usta.de>
MIME-Version: 1.0
Content-Transfer-Encoding: 7Bit
Content-Type: text/plain; charset="us-ascii"
X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta)
X-Received-From: 81.169.146.162
Cc: Ingo Schwarze <schwarze@usta.de>, pascal@openbsd.org
Subject: Re: [Groff] MAKE_K_FLAG
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 10 Jan 2012 02:15:43 -0000

Hi,

Werner asked me to answer this.

Ingo Schwarze wrote:
> Pascal Stumpf drew my attention to the fact that the following line
> in the top-level Makefile.in is causing trouble:
> 
>   MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`
> 
> The problem is that *any* k character anywhere in MAKEFLAGS,
> for example coming from something like
> 
>   make ... FOO=k ...
> 
> is mistaken for a -k flag, forcing some parts of the build to
> ignore errors even when that is not desired, making errors harder
> to spot.

Indeed. The test Makefile found in
http://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.68/html_node/The-Make-Macro-MAKEFLAGS.html
confirms what you say.

Makefiles generated by Automake use this idiom:

        for f in x $$MAKEFLAGS; do \
          case $$f in \
            *=* | --[!k]*);; \
            *k*) keepgoing=yes;; \
          esac; \
        done; \

> Pascal found
> 
>   http://lists.gnu.org/archive/html/groff/2006-01/msg00075.html
> 
> but we don't quite understand the reasoning given there, as
> both BSD make and GNU make pass down -k to recursive make
> child processes anyway, without doing anything special.
> 
> So it seems one could just remove MAKE_K_FLAG completely
> without any adverse effect

I cannot confirm what you say. With GNU make, I get:

$ cat Makefile
MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`

all :
        echo MAKE='$(MAKE)', MAKEFLAGS='$(MAKEFLAGS)'
        $(MAKE) $(MAKEFLAGS) foo
        $(MAKE) $(MAKE_K_FLAG) foo

foo :

$ make
echo MAKE='make', MAKEFLAGS=''
MAKE=make, MAKEFLAGS=
make  foo
...

$ make -k
echo MAKE='make', MAKEFLAGS='k'
MAKE=make, MAKEFLAGS=k
make k foo
...

$ make FOO=kit
echo MAKE='make', MAKEFLAGS='FOO=kit'
MAKE=make, MAKEFLAGS=FOO=kit
make FOO=kit foo
...

$ make -k FOO=kit
echo MAKE='make', MAKEFLAGS='k -- FOO=kit'
MAKE=make, MAKEFLAGS=k -- FOO=kit
make k -- FOO=kit foo
...

Looking back at
http://lists.gnu.org/archive/html/groff/2006-01/msg00075.html
the right thing to do IMO is to fix the definition of MAKE_K_FLAG:
Please replace the line

  MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`

with

  MAKE_K_FLAG=`for f in x $(MAKEFLAGS); do \
                 case $$f in \
                   *=* | --[!k]*);; \
                   *k*) echo ' -k ';; \
                 esac; \
               done`

Bruno



From MAILER-DAEMON Tue Jan 10 02:38:34 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RkWHy-00085r-FN
	for mharc-groff@gnu.org; Tue, 10 Jan 2012 02:38:34 -0500
Received: from eggs.gnu.org ([140.186.70.92]:35734)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RkWHv-00083J-Rm
	for groff@gnu.org; Tue, 10 Jan 2012 02:38:32 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RkWHv-0005Cl-5O
	for groff@gnu.org; Tue, 10 Jan 2012 02:38:31 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:41428)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RkWHu-0005CR-Qx
	for groff@gnu.org; Tue, 10 Jan 2012 02:38:31 -0500
Received: (qmail invoked by alias); 10 Jan 2012 07:38:28 -0000
Received: from 77.119.217.137.wireless.dyn.drei.com (EHLO localhost)
	[77.119.217.137]
	by mail.gmx.net (mp059) with SMTP; 10 Jan 2012 08:38:28 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX18g+BVmY3YgBEYEC4IOAbPAwqAK3QE83X/tPDI17R
	NbQM+awGO53hG1
Date: Tue, 10 Jan 2012 08:38:25 +0100 (CET)
Message-Id: <20120110.083825.525924630.wl@gnu.org>
To: bruno@clisp.org
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <4474449.lWL7ku9IWE@linuix>
References: <20111226141832.GI11624@iris.usta.de> <4474449.lWL7ku9IWE@linuix>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: schwarze@usta.de, pascal@openbsd.org, groff@gnu.org
Subject: Re: [Groff] MAKE_K_FLAG
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 10 Jan 2012 07:38:32 -0000


> Please replace the line
> 
>   MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`
> 
> with
> 
>   MAKE_K_FLAG=`for f in x $(MAKEFLAGS); do \
>                  case $$f in \
>                    *=* | --[!k]*);; \
>                    *k*) echo ' -k ';; \
>                  esac; \
>                done`

Done, thanks!


    Werner


From MAILER-DAEMON Tue Jan 10 08:58:31 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RkcDf-0006R8-6d
	for mharc-groff@gnu.org; Tue, 10 Jan 2012 08:58:31 -0500
Received: from eggs.gnu.org ([140.186.70.92]:49719)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Pascal.Stumpf@cubes.de>) id 1RkaTI-0005Is-1V
	for groff@gnu.org; Tue, 10 Jan 2012 07:06:36 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Pascal.Stumpf@cubes.de>) id 1RkaTB-0004tC-Gq
	for groff@gnu.org; Tue, 10 Jan 2012 07:06:32 -0500
Received: from smtprelay01.ispgateway.de ([80.67.18.43]:38938)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Pascal.Stumpf@cubes.de>) id 1RkaTB-0004rJ-8J
	for groff@gnu.org; Tue, 10 Jan 2012 07:06:25 -0500
Received: from [62.224.148.6] (helo=tau.local.cubes.de)
	by smtprelay01.ispgateway.de with esmtpsa (TLSv1:AES256-SHA:256)
	(Exim 4.68) (envelope-from <Pascal.Stumpf@cubes.de>)
	id 1RkaT1-0005jE-Uw; Tue, 10 Jan 2012 13:06:16 +0100
Received: from cubes.de (pascal@aias [192.168.135.104])
	by tau.local.cubes.de (8.14.3/8.14.3/Debian-9.4) with ESMTP id
	q0AC6EKd014128; Tue, 10 Jan 2012 13:06:15 +0100
Message-Id: <201201101206.q0AC6EKd014128@tau.local.cubes.de>
To: Bruno Haible <bruno@clisp.org>
In-reply-to: <4474449.lWL7ku9IWE@linuix>
References: <20111226141832.GI11624@iris.usta.de> <4474449.lWL7ku9IWE@linuix>
Comments: In-reply-to Bruno Haible <bruno@clisp.org>
	message dated "Tue, 10 Jan 2012 03:15:46 +0100."
Date: Tue, 10 Jan 2012 13:06:11 +0100
From: Pascal Stumpf  <Pascal.Stumpf@cubes.de>
X-Df-Sender: NzAxNjc0
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 80.67.18.43
X-Mailman-Approved-At: Tue, 10 Jan 2012 08:58:29 -0500
Cc: Ingo Schwarze <schwarze@usta.de>, groff@gnu.org
Subject: Re: [Groff] MAKE_K_FLAG
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 10 Jan 2012 12:06:36 -0000

Hi,

On Tue, 10 Jan 2012 03:15:46 +0100, Bruno Haible wrote:
> Hi,
> 
> Werner asked me to answer this.
> 
> Ingo Schwarze wrote:
> > Pascal Stumpf drew my attention to the fact that the following line
> > in the top-level Makefile.in is causing trouble:
> > 
> >   MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`
> > 
> > The problem is that *any* k character anywhere in MAKEFLAGS,
> > for example coming from something like
> > 
> >   make ... FOO=k ...
> > 
> > is mistaken for a -k flag, forcing some parts of the build to
> > ignore errors even when that is not desired, making errors harder
> > to spot.
> 
> Indeed. The test Makefile found in
> http://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.68/html_
> node/The-Make-Macro-MAKEFLAGS.html
> confirms what you say.
> 
> Makefiles generated by Automake use this idiom:
> 
>         for f in x $$MAKEFLAGS; do \
>           case $$f in \
>             *=* | --[!k]*);; \
>             *k*) keepgoing=yes;; \
>           esac; \
>         done; \
> 
> > Pascal found
> > 
> >   http://lists.gnu.org/archive/html/groff/2006-01/msg00075.html
> > 
> > but we don't quite understand the reasoning given there, as
> > both BSD make and GNU make pass down -k to recursive make
> > child processes anyway, without doing anything special.
> > 
> > So it seems one could just remove MAKE_K_FLAG completely
> > without any adverse effect
> 
> I cannot confirm what you say. With GNU make, I get:
> 
> $ cat Makefile
> MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`
> 
> all :
>         echo MAKE='$(MAKE)', MAKEFLAGS='$(MAKEFLAGS)'
>         $(MAKE) $(MAKEFLAGS) foo

You don't use $(MAKE) $(MAKEFLAGS).  $(MAKEFLAGS) will always affect
recursive $(MAKE) invocations, even if you don't see the flags on
the command line.  Trying to use it this way is even wrong for GNU make,
since its format is quite different to the flags as they have been
passed on the command line.  For instance, 'gmake -k FOO=k' will result
in MAKEFLAGS == 'k -- FOO=k'.

Consider this example:

$ cat Makefile
all:
	echo $(MAKEFLAGS)
	cd sub && $(MAKE)
$ cat sub/Makefile
all:
	echo $(MAKEFLAGS)
$ gmake -k
echo k
k
cd sub && gmake
gmake[1]: Entering directory `/home/pascal/src/mystuff/gmake/sub'
echo wk
wk
gmake[1]: Leaving directory `/home/pascal/src/mystuff/gmake/sub'
$ 

So make will automatically pass down anything in $(MAKEFLAGS).
MAKE_K_FLAG is unnecessary.

>         $(MAKE) $(MAKE_K_FLAG) foo
> 
> foo :
> 
> $ make
> echo MAKE='make', MAKEFLAGS=''
> MAKE=make, MAKEFLAGS=
> make  foo
> ...
> 
> $ make -k
> echo MAKE='make', MAKEFLAGS='k'
> MAKE=make, MAKEFLAGS=k
> make k foo
> ...
> 
> $ make FOO=kit
> echo MAKE='make', MAKEFLAGS='FOO=kit'
> MAKE=make, MAKEFLAGS=FOO=kit
> make FOO=kit foo
> ...
> 
> $ make -k FOO=kit
> echo MAKE='make', MAKEFLAGS='k -- FOO=kit'
> MAKE=make, MAKEFLAGS=k -- FOO=kit
> make k -- FOO=kit foo
> ...
> 
> Looking back at
> http://lists.gnu.org/archive/html/groff/2006-01/msg00075.html
> the right thing to do IMO is to fix the definition of MAKE_K_FLAG:
> Please replace the line
> 
>   MAKE_K_FLAG=`case "$(MAKEFLAGS)" in *k*) echo ' -k ';; esac`
> 
> with
> 
>   MAKE_K_FLAG=`for f in x $(MAKEFLAGS); do \
>                  case $$f in \
>                    *=* | --[!k]*);; \
>                    *k*) echo ' -k ';; \
>                  esac; \
>                done`
> 
> Bruno
> 
> 


From MAILER-DAEMON Fri Jan 20 19:04:22 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RoORS-00018n-OO
	for mharc-groff@gnu.org; Fri, 20 Jan 2012 19:04:22 -0500
Received: from eggs.gnu.org ([140.186.70.92]:34185)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RoORR-00018g-9M
	for groff@gnu.org; Fri, 20 Jan 2012 19:04:21 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RoORQ-0002S1-BG
	for groff@gnu.org; Fri, 20 Jan 2012 19:04:21 -0500
Received: from cssun.mathcs.emory.edu ([170.140.150.1]:56387)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RoORQ-0002Qh-7Y
	for groff@gnu.org; Fri, 20 Jan 2012 19:04:20 -0500
Received: from [170.140.150.64] (mathsunf [170.140.150.64])
	by cssun.mathcs.emory.edu (8.13.8+Sun/8.13.8) with ESMTP id
	q0L04IdH012589
	for <groff@gnu.org>; Fri, 20 Jan 2012 19:04:18 -0500 (EST)
Message-ID: <4F1A00F7.9080009@mathcs.emory.edu>
Date: Fri, 20 Jan 2012 19:04:07 -0500
From: Ken Mandelberg <km@mathcs.emory.edu>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.24) Gecko/20111109 Lightning/1.0b2 Thunderbird/3.1.16
MIME-Version: 1.0
To: groff@gnu.org
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: quoted-printable
X-MIME-Autoconverted: from 8bit to quoted-printable by cssun.mathcs.emory.edu
	id q0L04IdH012589
X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta)
X-Received-From: 170.140.150.1
Subject: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 21 Jan 2012 00:04:22 -0000

It seems like AU/AT with the MM macros is not working properly.

Here is a simple test
*********************
.AU "John Smith"
.AT "CEO"
.MT 5
.P
testing
.FC
.SG
**********************

What comes out is:
**********************

                                                    January 20, 2012



        testing

                                      Yours very truly,



        =E2=80=90=E2=80=90                            John Smith

************************

What should come out is:
************************

                                                     January 20, 2012


        testing

                                      Yours very truly,



                                      John Smith
                                      CEO

*************************

So the AT title string never comes out, and there is an extraneous "--".

Is there a bug or am I missing something?


From MAILER-DAEMON Sat Jan 21 05:36:08 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RoYIq-0002pk-Uc
	for mharc-groff@gnu.org; Sat, 21 Jan 2012 05:36:08 -0500
Received: from eggs.gnu.org ([140.186.70.92]:52966)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RoYIo-0002oz-AK
	for groff@gnu.org; Sat, 21 Jan 2012 05:36:07 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RoYIn-0007OF-AF
	for groff@gnu.org; Sat, 21 Jan 2012 05:36:06 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:65068)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RoYIn-0007O8-4p
	for groff@gnu.org; Sat, 21 Jan 2012 05:36:05 -0500
Received: by bkbzx1 with SMTP id zx1so1315655bkb.0
	for <groff@gnu.org>; Sat, 21 Jan 2012 02:36:03 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type:content-transfer-encoding;
	bh=HaMFQHo6iJFqZwym/6V+PFmqHrZ4HqQ14cu3kGCImZ0=;
	b=H6ThwK5Otd5mbJbyZJiguBRzWZkPvdU/GXmu+bibgedpJBBqdzShp0hkj8+CxiFR/u
	sUi9bX3mOvu5VsTKm+zrVm+Qz17bVTR/mjYFuub77d4OtSIboqjiFVYzAsbrD+dDbnyD
	kxP6tWKCD5pwbQjkmtZLjDkbm7wJ7EIVAkLTU=
Received: by 10.205.122.134 with SMTP id gg6mr470380bkc.41.1327142163599;
	Sat, 21 Jan 2012 02:36:03 -0800 (PST)
Received: from ANT ([95.72.31.209])
	by mx.google.com with ESMTPS id d2sm12647557bky.11.2012.01.21.02.36.01
	(version=TLSv1/SSLv3 cipher=OTHER);
	Sat, 21 Jan 2012 02:36:02 -0800 (PST)
Date: Sat, 21 Jan 2012 14:35:59 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Ken Mandelberg <km@mathcs.emory.edu>
Message-Id: <20120121143559.1835a94ae7da28647a2206a3@gmail.com>
In-Reply-To: <4F1A00F7.9080009@mathcs.emory.edu>
References: <4F1A00F7.9080009@mathcs.emory.edu>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 21 Jan 2012 10:36:07 -0000

Ken Mandelberg:

> It  seems  like  AU/AT  with  the MM macros is not
> working properly.

The problem is with the  Memorandum-style  signature
macro.

Without .warn in the beginning of your file you were
missing several warnings from Groff.  I added it and
saw  where  the  errors were.  It turns out that the
.SG macro requires that at least four  arguments  be
passed to the .AU macro.  This example works:

  .warn
  .TL "Anton's title"
  .MT 5
  .AU Smith J. Location Dept.
  .AT "CEO"
  .P
  testing
  .FC
  .SG

The  "--"  you are talking about are two field divi-
sors, between location, department and initials, and
the signature macro seems to handle them incorrectly
when at least one of them is empty.

Anton


From MAILER-DAEMON Sun Jan 22 01:15:21 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Roqi1-0002E5-Lj
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 01:15:21 -0500
Received: from eggs.gnu.org ([140.186.70.92]:44660)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <siteshwar@gmail.com>) id 1Roq6K-0008Ig-Ts
	for groff@gnu.org; Sun, 22 Jan 2012 00:36:25 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <siteshwar@gmail.com>) id 1Roq6J-0003rA-Vb
	for groff@gnu.org; Sun, 22 Jan 2012 00:36:24 -0500
Received: from mail-pw0-f41.google.com ([209.85.160.41]:61430)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <siteshwar@gmail.com>) id 1Roq6J-0003r3-PI
	for groff@gnu.org; Sun, 22 Jan 2012 00:36:23 -0500
Received: by pbdu6 with SMTP id u6so1258426pbd.0
	for <groff@gnu.org>; Sat, 21 Jan 2012 21:36:22 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:date:message-id:subject:from:to:content-type;
	bh=oZX0tnhVUlBS7wCEVavImTPg9KlsjacXdTqJaNBoBH0=;
	b=qRWxKr72z8cNFaNP2DdNMkNWKMcjKMOyiyC61BfQdXd7C5AsTuTEj1SG4+dM1/fNXc
	gqM3f43+DplenQGikW3S2n4bpW/BCaOx1auKEF3hCHAvyY7c/pELmrO1LBIHGXEqYXc/
	5EuE6KYI48Y8632pcjkTDfR8fbsMbmyWf9qO4=
MIME-Version: 1.0
Received: by 10.68.72.8 with SMTP id z8mr10335162pbu.111.1327210582270; Sat,
	21 Jan 2012 21:36:22 -0800 (PST)
Received: by 10.142.110.19 with HTTP; Sat, 21 Jan 2012 21:36:22 -0800 (PST)
Date: Sun, 22 Jan 2012 11:06:22 +0530
Message-ID: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
From: Siteshwar Vashisht <siteshwar@gmail.com>
To: groff@gnu.org
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.160.41
X-Mailman-Approved-At: Sun, 22 Jan 2012 01:15:20 -0500
Content-Type: text/plain; charset=ISO-8859-1
X-Content-Filtered-By: Mailman/MimeDel 2.1.14
Subject: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 05:36:25 -0000

Hi,

Is there any option in groff to parse only a specifiec section of man page
? For e.g. when I say

groff -X -P -resolution -P100 -man passwd

It parses and shows me the whole page. What if I want to parse only OPTIONS
section ? I am looking for something like :-

groff -X -P -resolution -P100 -man -parse-section "OPTIONS" passwd

Regards,
Siteshwar
-- 
"A belief may be larger than a fact."
Vannevar Bush

From MAILER-DAEMON Sun Jan 22 04:07:44 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RotOq-0000PW-TB
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 04:07:44 -0500
Received: from eggs.gnu.org ([140.186.70.92]:35068)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RotOo-0000Ns-3J
	for groff@gnu.org; Sun, 22 Jan 2012 04:07:43 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RotOm-0006QS-KK
	for groff@gnu.org; Sun, 22 Jan 2012 04:07:42 -0500
Received: from smarthost02.mail.zen.net.uk ([212.23.3.141]:37817)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RotOm-0006Pu-Fx
	for groff@gnu.org; Sun, 22 Jan 2012 04:07:40 -0500
Received: from [88.96.44.206] (helo=deb)
	by smarthost02.mail.zen.net.uk with esmtp (Exim 4.72)
	(envelope-from <Ted.Harding@wlandres.net>)
	id 1RotOj-0001Px-1o; Sun, 22 Jan 2012 09:07:37 +0000
Content-Length: 1582
Message-ID: <XFMail.20120122090731.Ted.Harding@wlandres.net>
X-Mailer: XFMail 1.5.5 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
Date: Sun, 22 Jan 2012 09:07:31 -0000 (GMT)
Sender: ted@deb
From: (Ted Harding) <Ted.Harding@wlandres.net>
To: groff@gnu.org
Bcc: 
X-Originating-Smarthost02-IP: [88.96.44.206]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 212.23.3.141
Cc: Siteshwar Vashisht <siteshwar@gmail.com>
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: Ted.Harding@wlandres.net
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 09:07:43 -0000

On 22-Jan-2012 Siteshwar Vashisht wrote:
> Hi,
> Is there any option in groff to parse only a specifiec
> section of man page? For e.g. when I say
> 
> groff -X -P -resolution -P100 -man passwd
> 
> It parses and shows me the whole page. What if I want to
> parse only OPTIONS section ? I am looking for something like :-
> 
> groff -X -P -resolution -P100 -man -parse-section "OPTIONS" passwd
> 
> Regards,
> Siteshwar
> -- 
> "A belief may be larger than a fact."
> Vannevar Bush

No, groff always processes the entire document as presented
in the troff source for the document.

The only way to achieve what you want would be to edit the
source for "passwd", incorporating ".if [...]" requests
so that what is compiled by groff could depend on options
defined in the command-line. The option for that would
then be like

  groff .... -dSection="OPTIONS" ....

and then, for every section in the man-page, include a ".if"
statement such that

a) If the string register "Section" is not defined then
   include the section;

b) If "Section" is defined, then include the section if
   "Section" matches the name of th section.

Even then, this would only output a single section. If you
wanted to choose more than one section you would have to
devise a more complicated system! (Could be done, but no-one
is going to re-write the man pages like this anyway)!

Ted.

-------------------------------------------------
E-Mail: (Ted Harding) <Ted.Harding@wlandres.net>
Date: 22-Jan-2012  Time: 09:07:26
This message was sent by XFMail
-------------------------------------------------


From MAILER-DAEMON Sun Jan 22 04:58:39 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RouC7-0006ce-Dw
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 04:58:39 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33009)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RouC5-0006WN-20
	for groff@gnu.org; Sun, 22 Jan 2012 04:58:37 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RouC3-00045F-Lk
	for groff@gnu.org; Sun, 22 Jan 2012 04:58:37 -0500
Received: from smarthost03.mail.zen.net.uk ([212.23.3.142]:43986)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1RouC3-000457-E6
	for groff@gnu.org; Sun, 22 Jan 2012 04:58:35 -0500
Received: from [88.96.44.206] (helo=deb)
	by smarthost03.mail.zen.net.uk with esmtp (Exim 4.63)
	(envelope-from <Ted.Harding@wlandres.net>)
	id 1RouC1-0006ls-BM; Sun, 22 Jan 2012 09:58:33 +0000
Content-Length: 1847
Message-ID: <XFMail.20120122095827.Ted.Harding@wlandres.net>
X-Mailer: XFMail 1.5.5 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <XFMail.20120122090731.Ted.Harding@wlandres.net>
Date: Sun, 22 Jan 2012 09:58:27 -0000 (GMT)
Sender: ted@deb
From: (Ted Harding) <Ted.Harding@wlandres.net>
To: groff@gnu.org
Bcc: 
X-Originating-Smarthost03-IP: [88.96.44.206]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 212.23.3.142
Cc: Siteshwar Vashisht <siteshwar@gmail.com>
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: Ted.Harding@wlandres.net
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 09:58:38 -0000

Follow-up to my previous reply:

On 22-Jan-2012 Ted Harding wrote:
> On 22-Jan-2012 Siteshwar Vashisht wrote:
>> Hi,
>> Is there any option in groff to parse only a specifiec
>> section of man page? For e.g. when I say
>> 
>> groff -X -P -resolution -P100 -man passwd
>> 
>> It parses and shows me the whole page. What if I want to
>> parse only OPTIONS section ? I am looking for something like :-
>> 
>> groff -X -P -resolution -P100 -man -parse-section "OPTIONS" passwd
>> 
>> Regards,
>> Siteshwar
>> -- 
>> "A belief may be larger than a fact."
>> Vannevar Bush
> 
> No, groff always processes the entire document as presented
> in the troff source for the document.
> [...]
> Ted.

Am alternative approach to achieveing the effect you seek
could be to pass the source for .../man1/passwd through
a custom-writer pre-filter (via a command-line-invoked
paramatrised shell script, say).

The structure of a man-page is very straightforward.
There are a few initial set-up lines, then a series of
sections each introduced by a line like

.SH "NAME"
[...]
.SH "SYNOPSIS"
[...]
.SH "DESCRIPTION"
[...]

etc. The rest of the file is of this form, and there are
no final lines which must be used.

So the script would need to recognise lines beginning ".SH".
For the first such occurrence, if the name is not the one
you have specified, then suppress throughput until the
occurrence of the ".SH" section you seek.

If it is the one you seek, then continue throughput.

Once within throughput of the section you seek, continue
until the next occurrence of a ".SH" line and thereafter
suppress throughput until the end of file.

Ted.

-------------------------------------------------
E-Mail: (Ted Harding) <Ted.Harding@wlandres.net>
Date: 22-Jan-2012  Time: 09:58:21
This message was sent by XFMail
-------------------------------------------------


From MAILER-DAEMON Sun Jan 22 06:53:51 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rovzb-0001uL-Bj
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 06:53:51 -0500
Received: from eggs.gnu.org ([140.186.70.92]:51921)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RovzZ-0001uA-7l
	for groff@gnu.org; Sun, 22 Jan 2012 06:53:49 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RovzY-0008LD-9o
	for groff@gnu.org; Sun, 22 Jan 2012 06:53:49 -0500
Received: from relay02.pair.com ([209.68.5.16]:3625)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RovzY-0008L9-5n
	for groff@gnu.org; Sun, 22 Jan 2012 06:53:48 -0500
Received: (qmail 4608 invoked from network); 22 Jan 2012 11:53:46 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay02.pair.com with SMTP; 22 Jan 2012 11:53:46 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id 05E4C1F84E; Sun, 22 Jan 2012 11:53:45 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id D327C1F84D;
	Sun, 22 Jan 2012 11:53:45 +0000 (GMT)
To: Siteshwar Vashisht <siteshwar@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
Comments: In-reply-to Siteshwar Vashisht <siteshwar@gmail.com> message dated
	"Sun, 22 Jan 2012 11:06:22 +0530."
Date: Sun, 22 Jan 2012 11:53:45 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120122115346.05E4C1F84E@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.68.5.16
Cc: groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 11:53:50 -0000

Hi Siteshwar,

> What if I want to parse only OPTIONS section ? I am looking for
> something like :-
> 
> groff -X -P -resolution -P100 -man -parse-section "OPTIONS" passwd

Can you tell us why you want to do this?  Is it only -X output you're
interested in, for example.

Cheers, Ralph.


From MAILER-DAEMON Sun Jan 22 07:18:37 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RowNZ-0004hL-VY
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 07:18:37 -0500
Received: from eggs.gnu.org ([140.186.70.92]:46304)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RowNX-0004hE-6g
	for groff@gnu.org; Sun, 22 Jan 2012 07:18:36 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RowNV-0002aB-NW
	for groff@gnu.org; Sun, 22 Jan 2012 07:18:35 -0500
Received: from mailout.scc.kit.edu ([129.13.185.202]:32797)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RowNV-0002Zx-J0
	for groff@gnu.org; Sun, 22 Jan 2012 07:18:33 -0500
Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82])
	by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1)
	id 1RowNS-0007df-V8; Sun, 22 Jan 2012 13:18:30 +0100
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>) id 1RowNT-0008Cp-1C
	for groff@gnu.org; Sun, 22 Jan 2012 13:18:31 +0100
Received: from iris.usta.de ([172.24.96.5] helo=usta.de)
	by donnerwolke.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>) id 1RowNT-0002Ut-0L
	for groff@gnu.org; Sun, 22 Jan 2012 13:18:31 +0100
Received: from schwarze by usta.de with local (Exim 4.72)
	(envelope-from <schwarze@usta.de>) id 1RowNS-0005id-OW
	for groff@gnu.org; Sun, 22 Jan 2012 13:18:30 +0100
Date: Sun, 22 Jan 2012 13:18:30 +0100
From: Ingo Schwarze <schwarze@usta.de>
To: groff@gnu.org
Message-ID: <20120122121830.GC15211@iris.usta.de>
References: <alpine.BSO.2.00.1201152021020.2282@morgaine.smi.sendmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <alpine.BSO.2.00.1201152021020.2282@morgaine.smi.sendmail.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 129.13.185.202
Subject: [Groff] XBD == "X/Open Base Definitions"
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 12:18:36 -0000

Hi,

Philip Guenther pointed out to me that the acronym "XBD" stands for
"X/Open Base Definitions", not "X/Open System Interface Definitions",
see for example:

  http://pubs.opengroup.org/onlinepubs/007908799/

Hence, i propose the following patch to mdoc(7).

If you agree with this, i will update mandoc(1) as well.

Thanks for your consideration,
  Ingo


Index: tmac/doc-syms
===================================================================
RCS file: /sources/groff/groff/tmac/doc-syms,v
retrieving revision 1.22
diff -u -r1.22 doc-syms
--- tmac/doc-syms	3 Jan 2012 06:23:44 -0000	1.22
+++ tmac/doc-syms	22 Jan 2012 12:16:17 -0000
@@ -661,7 +661,7 @@
 .as doc-str-St--susv3          " (\*[Lq]\*[doc-Tn-font-size]SUSv3\*[doc-str-St]\*[Rq])
 .ds doc-str-St--svid4          System\~V Interface Definition, Fourth Edition
 .as doc-str-St--svid4          " (\*[Lq]\*[doc-Tn-font-size]SVID\*[doc-str-St]\^4\*[Rq])
-.ds doc-str-St--xbd5           \*[doc-Tn-font-size]X/Open\*[doc-str-St] System Interface Definitions Issue\~5
+.ds doc-str-St--xbd5           \*[doc-Tn-font-size]X/Open\*[doc-str-St] Base Definitions Issue\~5
 .as doc-str-St--xbd5           " (\*[Lq]\*[doc-Tn-font-size]XBD\*[doc-str-St]\^5\*[Rq])
 .ds doc-str-St--xcu5           \*[doc-Tn-font-size]X/Open\*[doc-str-St] Commands and Utilities Issue\~5
 .as doc-str-St--xcu5           " (\*[Lq]\*[doc-Tn-font-size]XCU\*[doc-str-St]\^5\*[Rq])


From MAILER-DAEMON Sun Jan 22 08:53:53 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Roxrl-00020k-Gt
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 08:53:53 -0500
Received: from eggs.gnu.org ([140.186.70.92]:39551)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kollar@windstream.net>) id 1Roxrj-00020e-7s
	for groff@gnu.org; Sun, 22 Jan 2012 08:53:51 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <kollar@windstream.net>) id 1Roxri-0006pX-Em
	for groff@gnu.org; Sun, 22 Jan 2012 08:53:51 -0500
Received: from pacmmta51.windstream.net ([162.39.147.110]:52551)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kollar@windstream.net>) id 1Roxri-0006pD-Bw
	for groff@gnu.org; Sun, 22 Jan 2012 08:53:50 -0500
X-WS-COS: WSOB804
X-Cloudmark-Category: Undefined:Undefined
X-Cloudmark-Analysis: v=1.1 cv=wi2J7rgTjtt66PGN7+JMAiX4/IqmFavmjTO+nE+rCy4=
	c=1 sm=0 a=DbJEbES67aEA:10 a=UT_QgiwtmQIA:10 a=kj9zAlcOel0A:10
	a=pGLkceISAAAA:8 a=tPJQBFlAxrifmLBIDWQA:9 a=CjuIK1q_8ugA:10
	a=MSl-tDqOz04A:10 a=1xJVTn61lcaeFoIsTVSasg==:117
X-Cloudmark-Score: 0
Authentication-Results: pacmmta51 smtp.user=kollar@windstream.net;
	auth=pass (PLAIN)
Received: from [71.30.12.128] ([71.30.12.128:61598] helo=[192.168.1.102])
	by pacmmta51 (envelope-from <kollar@windstream.net>)
	(ecelerity 2.2.3.47 r(39824M)) with ESMTPA
	id 42/49-15653-9E41C1F4; Sun, 22 Jan 2012 08:53:45 -0500
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
In-Reply-To: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
Mime-Version: 1.0 (1.0)
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii
Message-Id: <84A98ED7-B54E-4AED-86D6-A6914C9F83E7@windstream.net>
X-Mailer: iPhone Mail (9A405)
From: Larry Kollar <kollar@windstream.net>
Date: Sun, 22 Jan 2012 08:53:43 -0500
To: "groff@gnu.org" <groff@gnu.org>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 162.39.147.110
Cc: Siteshwar Vashisht <siteshwar@gmail.com>
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 13:53:52 -0000


On Jan 22, 2012, at 12:36 AM, Siteshwar Vashisht <siteshwar@gmail.com> wrote=
:

> Is there any option in groff to parse only a specifiec section of man page=

> ? For e.g. when I say
>=20
> groff -X -P -resolution -P100 -man passwd
>=20
> It parses and shows me the whole page. What if I want to parse only OPTION=
S
> section ? I am looking for something like :-
>=20
> groff -X -P -resolution -P100 -man -parse-section "OPTIONS" passwd

If you know what section immediately follows, and you're working at the cons=
ole, you could pipe the output through awk:

nroff -man apage.1 | awk '/^OPTIONS/, /^DESC/'

-- Larry=


From MAILER-DAEMON Sun Jan 22 09:19:03 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RoyG7-00057F-QT
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 09:19:03 -0500
Received: from eggs.gnu.org ([140.186.70.92]:40168)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RoyG2-00053i-D5
	for groff@gnu.org; Sun, 22 Jan 2012 09:18:59 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RoyG0-0000tu-JI
	for groff@gnu.org; Sun, 22 Jan 2012 09:18:58 -0500
Received: from vic.ffii.org ([82.197.166.218]:34939)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RoyFz-0000tg-Os
	for groff@gnu.org; Sun, 22 Jan 2012 09:18:56 -0500
Received: from relay02.pair.com ([209.68.5.16])
	by vic.ffii.org with smtp (Exim 4.63 #1) id 1RoyFq-0000vP-QW
	for groff@ffii.org; Sun, 22 Jan 2012 15:18:54 +0100
Received: (qmail 29222 invoked from network); 22 Jan 2012 14:18:30 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay02.pair.com with SMTP; 22 Jan 2012 14:18:30 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id 5BC3E25207; Sun, 22 Jan 2012 14:18:29 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 3815E25206;
	Sun, 22 Jan 2012 14:18:29 +0000 (GMT)
To: Siteshwar Vashisht <siteshwar@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <CADVQ=8U63GZnRJ0cLwsgra2y1j-eoaDipx-K0jFeh-+yRm_Neg@mail.gmail.com>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>
	<CADVQ=8U63GZnRJ0cLwsgra2y1j-eoaDipx-K0jFeh-+yRm_Neg@mail.gmail.com>
Comments: In-reply-to Siteshwar Vashisht <siteshwar@gmail.com> message dated
	"Sun, 22 Jan 2012 19:27:30 +0530."
Date: Sun, 22 Jan 2012 14:18:29 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120122141829.5BC3E25207@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 82.197.166.218
Cc: groff@ffii.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: groff@ffii.org
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 14:19:01 -0000

Hi Siteshwar,

> No, I am in no way interested in X. I am working on a shell, and the
> idea is to show suggestions for command line options on pressing tab.
> So let's say on pressing "ls<TAB>", I will get all the command line
> options for ls command. Now a good idea is to fetch these options from
> manual pages.
>
> @Larry, I am trying to do same thing with Python. Since I need to
> parse the structure of OPTIONS section for completions. Any suggestion
> for parsing man page sections are welcome ?

Not every man page has an OPTIONS section so you may need to fall back
on something else, e.g. SYNOPSIS, but perhaps formatting the machine
page to text and plucking stuff from it would be cheapest.

    $ man dmesg | sed '/^OPTIONS/p; 1,//d; /^[^ ]/Q'
    OPTIONS
      -c   Clear the ring buffer contents after printing.

      -r   Print the raw message buffer, i.e., don't strip the log level prefixes.

      -s bufsize
           Use a buffer of size bufsize to query the kernel ring buffer.  This is 16392 by
           default.  (The default kernel syslog buffer size was 4096 at first, 8192 since
           1.3.54, 16384 since 2.1.113.)  If you have set the kernel buffer to be larger than
           the default then this option can be used to view the entire buffer.

      -n level
           Set the level at which logging of messages is done to the console.  For example, -n
           1 prevents all messages, except panic messages, from appearing on the console.  All
           levels of messages are still written to /proc/kmsg, so syslogd(8) can still be used
           to control exactly where kernel messages appear.  When the -n option is used, dmesg
           will not print or clear the kernel ring buffer.

           When both options are used, only the last option on the command line will have an
           effect.

    $

Cheers, Ralph.


From MAILER-DAEMON Sun Jan 22 09:21:02 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RoyI2-0005jN-8n
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 09:21:02 -0500
Received: from eggs.gnu.org ([140.186.70.92]:42174)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <siteshwar@gmail.com>) id 1Roxx8-0002dH-4c
	for groff@gnu.org; Sun, 22 Jan 2012 08:59:27 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <siteshwar@gmail.com>) id 1Roxx6-0007KP-Iz
	for groff@gnu.org; Sun, 22 Jan 2012 08:59:26 -0500
Received: from mail-pw0-f41.google.com ([209.85.160.41]:43656)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <siteshwar@gmail.com>) id 1Roxx6-0007KL-CI
	for groff@gnu.org; Sun, 22 Jan 2012 08:59:24 -0500
Received: by pbdu6 with SMTP id u6so1393559pbd.0
	for <groff@gnu.org>; Sun, 22 Jan 2012 05:59:23 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type;
	bh=/aRAu/THmboJzZi64nEDMaiAGsG0eXTPoaI4Lpi+IZk=;
	b=ZCLYuzDYdj9Qi4usYWGy2R0RmhxD1Q2uq0sjLuc1FzNXnQI/jA4vwLD384V77gx2Ey
	JoxI0SL65FonByqCN+nKKYu6IzPWZNHQFAFio6ha3UMWHZl7iifk09GpGb0xGq1Ko8ks
	hdHPQfeFF1vyzy3U8C5sGurQOdSqD1xhsqRU4=
MIME-Version: 1.0
Received: by 10.68.72.8 with SMTP id z8mr13319314pbu.111.1327240763324; Sun,
	22 Jan 2012 05:59:23 -0800 (PST)
Received: by 10.142.110.19 with HTTP; Sun, 22 Jan 2012 05:59:23 -0800 (PST)
In-Reply-To: <20120122115346.05E4C1F84E@orac.inputplus.co.uk>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>
Date: Sun, 22 Jan 2012 19:29:23 +0530
Message-ID: <CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
From: Siteshwar Vashisht <siteshwar@gmail.com>
To: Ralph Corderoy <ralph@inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.160.41
X-Mailman-Approved-At: Sun, 22 Jan 2012 09:20:59 -0500
Content-Type: text/plain; charset=ISO-8859-1
X-Content-Filtered-By: Mailman/MimeDel 2.1.14
Cc: groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 13:59:27 -0000

Hi,

No, I am in no way interested in X. I am working on a shell, and the idea
is to show suggestions for command line options on pressing tab. So let's
say on pressing "ls<TAB>", I will get all the command line options for ls
command. Now a good idea is to fetch these options from manual pages.

@Larry, I am trying to do same thing with Python. Since I need to parse the
structure of OPTIONS section for completions. Any suggestion for parsing
man page sections are welcome ?

Regards,
Siteshwar


On Sun, Jan 22, 2012 at 5:23 PM, Ralph Corderoy <ralph@inputplus.co.uk>wrote:

> Hi Siteshwar,
>
> > What if I want to parse only OPTIONS section ? I am looking for
> > something like :-
> >
> > groff -X -P -resolution -P100 -man -parse-section "OPTIONS" passwd
>
> Can you tell us why you want to do this?  Is it only -X output you're
> interested in, for example.
>
> Cheers, Ralph.
>



-- 
"A belief may be larger than a fact."
Vannevar Bush

From MAILER-DAEMON Sun Jan 22 10:57:36 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RoznU-0003L4-Bo
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 10:57:36 -0500
Received: from eggs.gnu.org ([140.186.70.92]:43882)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RoznR-0003KT-Fo
	for groff@gnu.org; Sun, 22 Jan 2012 10:57:34 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RoznQ-00037q-82
	for groff@gnu.org; Sun, 22 Jan 2012 10:57:33 -0500
Received: from mailout.scc.kit.edu ([129.13.185.202]:33189)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1RoznP-00037m-V7
	for groff@gnu.org; Sun, 22 Jan 2012 10:57:32 -0500
Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82])
	by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1)
	id 1RoznO-0003OP-DE; Sun, 22 Jan 2012 16:57:30 +0100
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1RoznO-0002gR-Gq; Sun, 22 Jan 2012 16:57:30 +0100
Received: from hera.usta.de ([172.24.64.3])
	by donnerwolke.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1RoznO-0002rt-FP; Sun, 22 Jan 2012 16:57:30 +0100
Received: from schwarze by hera.usta.de with local (Exim 4.76)
	(envelope-from <schwarze@usta.de>)
	id 1RoznO-0002Iq-6v; Sun, 22 Jan 2012 16:57:30 +0100
Date: Sun, 22 Jan 2012 16:57:29 +0100
From: Ingo Schwarze <schwarze@usta.de>
To: Siteshwar Vashisht <siteshwar@gmail.com>
Message-ID: <20120122155729.GA26723@usta.de>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>
	<CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 129.13.185.202
Cc: groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 15:57:34 -0000

Hi,

Siteshwar Vashisht wrote on Sun, Jan 22, 2012 at 07:29:23PM +0530:

> I am working on a shell, and the idea is to show suggestions for
> command line options on pressing tab. So let's say on pressing
> "ls<TAB>", I will get all the command line options for ls
> command.  Now a good idea is to fetch these options from manual
> pages.

OUCH.

No, please don't.
This is a misguided, terrible idea in so many ways.

 1) Do not bloat the shell.
    If there are two programs in userland that you don't want to
    be large, complicated, fragile, and slow, it's init(8) and
    the shell.  The shell is a critical component of the system,
    it is not the right place for bells and whistles.  And you
    don't want yet more non-standards-compliant features in the
    shell.  Shells diverge too much from each other and have too
    much bloat already.

 2) Do not bloat *any* utility program with unrelated bells
    and whistles.  That's just not the Unix way.
    Write small, focussed tools that make life easy when used
    in concert.
    For finding command line options, there is man(1).
    Most programs have a one-line usage() message, too.
    There is no need to do the same thing again, in a third place.

 3) Options typically are a dash and one character.
    If any frequently needed option is called
    --hey-look-i-invented-a-fantastically-long-name,
    that's a bug in the program; fix it, call it -l
    if it's really needed for every second invocation.
    If you need it twice a year, fine, type it in.
    No problem to solve here, move on.

 4) Whatever you do, it will be crude guesswork.
    Different systems document options in different ways.
    Heck, different *programs* document options in different ways.
    There are different languages for producing documentation,
    both the source and the output look different.
    Some systems install manual source code only, some
    install preformatted pages only, some install them gzip'ed,
    some don't, some cache them, some don't, some install them
    in this directory, some in another, some use man.conf(5),
    some use manpath(1), i could go on and on...
    Even if documentation authors try to follow some usual
    way, many get it wrong and the results are hard to parse;
    after all, most documentation authors are programmers in
    the first place and don't know or care that much about the
    finer points of formatting documentation.  In any case,
    you don't want crude guesswork in the shell.
    Or even if you accept that, it will maybe work half of
    the time on your own computer, but almost nowhere else.

 5) How are you going to find out whether you are even looking
    at the right manual?  There may be different versions of
    ls(1):  The native one, the UCB one, the GNU one, and then
    there may be a POSIX manual which doesn't correspond to any
    actual implementation.  Different packages are installed
    everywhere, and the file system layout is different
    everywhere, as well.

 6) You are trying to do semantic analysis with groff(7).
    Bad idea, don't do that, that's not at all what Roff
    is about, and Roff is doing a terrible job in that area -
    simply because it's beside the point, it was designed to
    produce high-quality typesetting output.
    If you want to do semantic analysis, use tools written
    for semantic analysis, like the mandoc(3) libraries
    written by Kristaps Dzonsons.  But *PLEASE*, don't link
    those into a shell...

 7) Even though the mdoc(7) language, allowing concise
    semantic annotations, was invented more than 20 years
    ago (and already used for the Net/1 4.4BSD release),
    most manuals still use the old-fashioned man(7) format
    nowadays - which doesn't even provide specific markup
    for command line options!  So, what are you even going
    to parse for?  You have almost nothing to work on in the
    first place, not even mandoc(3) will be able to help you
    much with man(7) input, even if you have the source code...

 8) ...

I'm sure i could go on like this.
But why should i?
Why kill a dead horse again and again to get it even more dead?

This is utterly hopeless.
Just drop the whole project.

Yours,
  Ingo


From MAILER-DAEMON Sun Jan 22 11:24:11 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rp0DD-0006CY-Kl
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 11:24:11 -0500
Received: from eggs.gnu.org ([140.186.70.92]:50009)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1Rp0DB-0006CN-MC
	for groff@gnu.org; Sun, 22 Jan 2012 11:24:10 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1Rp0DA-00064g-2E
	for groff@gnu.org; Sun, 22 Jan 2012 11:24:09 -0500
Received: from smtp01.frii.com ([216.17.135.167]:47491)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <clarke@verinet.net>) id 1Rp0D9-00064V-Sk
	for groff@gnu.org; Sun, 22 Jan 2012 11:24:08 -0500
Received: from [192.168.0.100] (dsl-251-44.dynamic-dsl.frii.net
	[216.17.251.44])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by smtp01.frii.com (FRII) with ESMTP id 5A276E80D4;
	Sun, 22 Jan 2012 09:24:05 -0700 (MST)
Message-ID: <4F1C3852.10602@verinet.net>
Date: Sun, 22 Jan 2012 09:24:50 -0700
From: Clarke Echols <clarke@verinet.net>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.24) Gecko/20111109 Thunderbird/3.1.16
MIME-Version: 1.0
To: Ingo Schwarze <schwarze@usta.de>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>	<CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
	<20120122155729.GA26723@usta.de>
In-Reply-To: <20120122155729.GA26723@usta.de>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 216.17.135.167
Cc: Siteshwar Vashisht <siteshwar@gmail.com>, groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 16:24:11 -0000

On 01/22/2012 08:57 AM, Ingo Schwarze wrote:
> Hi,
>
> Siteshwar Vashisht wrote on Sun, Jan 22, 2012 at 07:29:23PM +0530:
>
>> I am working on a shell, and the idea is to show suggestions for
>> command line options on pressing tab. So let's say on pressing
>> "ls<TAB>", I will get all the command line options for ls
>> command.  Now a good idea is to fetch these options from manual
>> pages.

I agree with Ingo.  Unix man pages are supposed to have a well-defined
sequence and format.  I was responsible for HP-UX manpages at HP for
several years.  Man pages are not broken.  Experienced users know how
they work and know how to use them.  Inexperienced users need to learn.

This isn't "Windows for Dummies" who can't be bothered with actually
learning to use something as simple as a scroll bar along the side of
their terminal window.  If they want to find something, the old "vi"
tools of '/' to search for a word or phrase, Ctrl-F to page forward,
and Ctrl-B to page backward are quite helpful.

There is no need to show off your programming expertise.  It's like
web designers who want to impress the world with their fancy ability
to use Java Script or their artistic ability to make web pages
"beautiful", while completely destroying the web page's ability to
sell a product or inform and educate the visitor.

The elegance of Unix is in its operational simplicity.

If you want to show off your fancy "user-friendly" programming
skills, go work on Microsoft stuff.  Microsoft Word is so great that
I charge an extra 25% on my already not-cheap rates when a client
insists I produce my work in Word, preventing me from using vim
and groff to get better results, faster, with less effort.

It ain't broke.  Don't fix it. (Translation for non-American English
natives: If it's working already, don't repair it.)

>
> OUCH.
>
> No, please don't.
> This is a misguided, terrible idea in so many ways.
>
>   1) Do not bloat the shell.
>      If there are two programs in userland that you don't want to
>      be large, complicated, fragile, and slow, it's init(8) and
>      the shell.  The shell is a critical component of the system,
>      it is not the right place for bells and whistles.  And you
>      don't want yet more non-standards-compliant features in the
>      shell.  Shells diverge too much from each other and have too
>      much bloat already.
>
>   2) Do not bloat *any* utility program with unrelated bells
>      and whistles.  That's just not the Unix way.
>      Write small, focussed tools that make life easy when used
>      in concert.
>      For finding command line options, there is man(1).
>      Most programs have a one-line usage() message, too.
>      There is no need to do the same thing again, in a third place.
>
>   3) Options typically are a dash and one character.
>      If any frequently needed option is called
>      --hey-look-i-invented-a-fantastically-long-name,
>      that's a bug in the program; fix it, call it -l
>      if it's really needed for every second invocation.
>      If you need it twice a year, fine, type it in.
>      No problem to solve here, move on.
>
>   4) Whatever you do, it will be crude guesswork.
>      Different systems document options in different ways.
>      Heck, different *programs* document options in different ways.
>      There are different languages for producing documentation,
>      both the source and the output look different.
>      Some systems install manual source code only, some
>      install preformatted pages only, some install them gzip'ed,
>      some don't, some cache them, some don't, some install them
>      in this directory, some in another, some use man.conf(5),
>      some use manpath(1), i could go on and on...
>      Even if documentation authors try to follow some usual
>      way, many get it wrong and the results are hard to parse;
>      after all, most documentation authors are programmers in
>      the first place and don't know or care that much about the
>      finer points of formatting documentation.  In any case,
>      you don't want crude guesswork in the shell.
>      Or even if you accept that, it will maybe work half of
>      the time on your own computer, but almost nowhere else.
>
>   5) How are you going to find out whether you are even looking
>      at the right manual?  There may be different versions of
>      ls(1):  The native one, the UCB one, the GNU one, and then
>      there may be a POSIX manual which doesn't correspond to any
>      actual implementation.  Different packages are installed
>      everywhere, and the file system layout is different
>      everywhere, as well.
>
>   6) You are trying to do semantic analysis with groff(7).
>      Bad idea, don't do that, that's not at all what Roff
>      is about, and Roff is doing a terrible job in that area -
>      simply because it's beside the point, it was designed to
>      produce high-quality typesetting output.
>      If you want to do semantic analysis, use tools written
>      for semantic analysis, like the mandoc(3) libraries
>      written by Kristaps Dzonsons.  But *PLEASE*, don't link
>      those into a shell...
>
>   7) Even though the mdoc(7) language, allowing concise
>      semantic annotations, was invented more than 20 years
>      ago (and already used for the Net/1 4.4BSD release),
>      most manuals still use the old-fashioned man(7) format
>      nowadays - which doesn't even provide specific markup
>      for command line options!  So, what are you even going
>      to parse for?  You have almost nothing to work on in the
>      first place, not even mandoc(3) will be able to help you
>      much with man(7) input, even if you have the source code...
>
>   8) ...
>
> I'm sure i could go on like this.
> But why should i?
> Why kill a dead horse again and again to get it even more dead?
>
> This is utterly hopeless.
> Just drop the whole project.
>
> Yours,
>    Ingo
>
>



From MAILER-DAEMON Sun Jan 22 12:16:11 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rp11X-0000H0-Se
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 12:16:11 -0500
Received: from eggs.gnu.org ([140.186.70.92]:41812)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rp11V-0000FX-JP
	for groff@gnu.org; Sun, 22 Jan 2012 12:16:10 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rp11U-0003cs-EL
	for groff@gnu.org; Sun, 22 Jan 2012 12:16:09 -0500
Received: from relay01.pair.com ([209.68.5.15]:2964)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rp11U-0003cR-2i
	for groff@gnu.org; Sun, 22 Jan 2012 12:16:08 -0500
Received: (qmail 88839 invoked from network); 22 Jan 2012 17:16:01 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay01.pair.com with SMTP; 22 Jan 2012 17:16:01 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id 3951E202FC; Sun, 22 Jan 2012 17:16:01 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 0C2711FCA6;
	Sun, 22 Jan 2012 17:16:01 +0000 (GMT)
To: groff@gnu.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <20120122155729.GA26723@usta.de>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>
	<CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
	<20120122155729.GA26723@usta.de>
Comments: In-reply-to Ingo Schwarze <schwarze@usta.de> message dated "Sun,
	22 Jan 2012 16:57:29 +0100."
Date: Sun, 22 Jan 2012 17:16:01 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120122171601.3951E202FC@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.68.5.15
Cc: Siteshwar Vashisht <siteshwar@gmail.com>
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: groff@gnu.org
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 17:16:10 -0000

Hi,

Ingo Schwarze wrote:
> This is a misguided, terrible idea in so many ways.

Clarke Echols wrote:
> I agree with Ingo.  Unix man pages are supposed to have a well-defined
> sequence and format.

(Many, the majority?, don't comply on common Linux systems,
unfortunately.)

Neither of you are allowing that Siteshwar may be doing this for his own
personal enjoyment, for learning more, for a project to work on, or
something that he'd like to use.

bash(1) already has command_not_found_handle() and I'm sure I've heard
of something that displays help, e.g. attempts `foo --help' on a
keypress;  perhaps that was with readline help.  Anyway, disliking the
inelegance of it shouldn't curtail Siteshwar's exploration.  I did a
half-baked Fortran-to-C in sh when I was learning.  :-)

Cheers, Ralph.


From MAILER-DAEMON Sun Jan 22 12:52:08 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rp1aK-0004FZ-7u
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 12:52:08 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33494)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1Rp1aD-0003up-JY
	for groff@gnu.org; Sun, 22 Jan 2012 12:52:05 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1Rp1aB-0006xm-UZ
	for groff@gnu.org; Sun, 22 Jan 2012 12:52:01 -0500
Received: from smarthost04.mail.zen.net.uk ([212.23.3.143]:50077)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Ted.Harding@wlandres.net>) id 1Rp1aB-0006xR-N2
	for groff@gnu.org; Sun, 22 Jan 2012 12:51:59 -0500
Received: from [88.96.44.206] (helo=deb)
	by smarthost04.mail.zen.net.uk with esmtp (Exim 4.72)
	(envelope-from <Ted.Harding@wlandres.net>)
	id 1Rp1a9-0004Y7-Dy; Sun, 22 Jan 2012 17:51:57 +0000
Content-Length: 1643
Message-ID: <XFMail.20120122175150.Ted.Harding@wlandres.net>
X-Mailer: XFMail 1.5.5 on Linux
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <20120122171601.3951E202FC@orac.inputplus.co.uk>
Date: Sun, 22 Jan 2012 17:51:50 -0000 (GMT)
Sender: ted@deb
From: (Ted Harding) <Ted.Harding@wlandres.net>
To: groff@gnu.org
Bcc: 
X-Originating-Smarthost04-IP: [88.96.44.206]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 212.23.3.143
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: Ted.Harding@wlandres.net
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 17:52:06 -0000

On 22-Jan-2012 Ralph Corderoy wrote:
> Hi,
> Ingo Schwarze wrote:
>> This is a misguided, terrible idea in so many ways.
> 
> Clarke Echols wrote:
>> I agree with Ingo.  Unix man pages are supposed to have a
>> well-defined sequence and format.
> 
> (Many, the majority?, don't comply on common Linux systems,
> unfortunately.)
> 
> Neither of you are allowing that Siteshwar may be doing this
> for his own personal enjoyment, for learning more, for a project
> to work on, or something that he'd like to use.
> 
> bash(1) already has command_not_found_handle() and I'm sure
> I've heard of something that displays help, e.g. attempts
> `foo --help' on a keypress; perhaps that was with readline help.
> Anyway, disliking the inelegance of it shouldn't curtail
> Siteshwar's exploration. I did a half-baked Fortran-to-C in sh
> when I was learning.  :-)
> 
> Cheers, Ralph.

Which reminds me of the time, back in the early 1980s, when I
wrote a serial-terminal program for my then CP/M-80 machine.
The BASIC that shipped with the machine was too slow for the
phone-line serial connection (1200 baud at the time), so I
wrote it in FORTRAN (the only compilable language I could
obtain for the machine at the time). It worked OK.

Then, later, I found a C compiler (Aztec C, if anyone remembers
that)[*] and that worked even better (and was an interesting
exercise in learning C).

Ted.
[*] http://en.wikipedia.org/wiki/Aztec_C

-------------------------------------------------
E-Mail: (Ted Harding) <Ted.Harding@wlandres.net>
Date: 22-Jan-2012  Time: 17:51:45
This message was sent by XFMail
-------------------------------------------------


From MAILER-DAEMON Sun Jan 22 14:35:36 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rp3CS-00045I-Ul
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 14:35:36 -0500
Received: from eggs.gnu.org ([140.186.70.92]:44824)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1Rp3CP-00042Y-Vq
	for groff@gnu.org; Sun, 22 Jan 2012 14:35:35 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1Rp3CN-0002Tt-QL
	for groff@gnu.org; Sun, 22 Jan 2012 14:35:33 -0500
Received: from mailout.scc.kit.edu ([129.13.185.202]:54368)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>) id 1Rp3CN-0002Tg-F0
	for groff@gnu.org; Sun, 22 Jan 2012 14:35:31 -0500
Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82])
	by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1)
	id 1Rp3CL-0000pF-4k; Sun, 22 Jan 2012 20:35:29 +0100
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1Rp3CL-00065D-4u; Sun, 22 Jan 2012 20:35:29 +0100
Received: from iris.usta.de ([172.24.96.5] helo=usta.de)
	by donnerwolke.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1Rp3CL-0003VE-3U; Sun, 22 Jan 2012 20:35:29 +0100
Received: from schwarze by usta.de with local (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1Rp3CK-0007rG-N0; Sun, 22 Jan 2012 20:35:28 +0100
Date: Sun, 22 Jan 2012 20:35:27 +0100
From: Ingo Schwarze <schwarze@usta.de>
To: groff@gnu.org
Message-ID: <20120122193527.GA31560@iris.usta.de>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>
	<CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
	<20120122155729.GA26723@usta.de>
	<20120122171601.3951E202FC@orac.inputplus.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20120122171601.3951E202FC@orac.inputplus.co.uk>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 129.13.185.202
Cc: Siteshwar Vashisht <siteshwar@gmail.com>
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 19:35:35 -0000

Hi,

Ralph Corderoy wrote on Sun, Jan 22, 2012 at 05:16:01PM +0000:
> Clarke Echols wrote:

>> I agree with Ingo.  Unix man pages are supposed to have a well-defined
>> sequence and format.

> (Many, the majority?, don't comply on common Linux systems,
> unfortunately.)

Right, which is exactly why parsing manuals is so difficult,
and not really a healthy task for beginners.

> Neither of you are allowing that Siteshwar may be doing this for his own
> personal enjoyment, for learning more, for a project to work on, or
> something that he'd like to use.

Oh, of course i am.

However, in case he is planning to do it for enjoyment or learning -
there are so many useful things that need to be done.  About two years
ago, i sent some yp(8) patches to Mats O. Jansson, asking for a review,
and was quite suprised about his response, which roughly went like this:
"Right, i wrote that code in my youth, in a playful way, because i
wanted to learn about yp(8).  I have moved on to other projects a
decade ago.  Feel free to send patches, yes, if i see anything
dangerous, i'll tell you, but if you don't hear anything, go ahead
and commit, i don't claim ownership of that code any longer."
The point is, the code has been so stable during that decade that it
didn't even need a maintainer; with a bit of polishing now and then
by whoever was around, it remained in production quality.

There is no need to choose stupid projects for learning;
actually, you not only *produce* less, you also *learn* less
in a project that is bound for failure right from the start.

In case he needs it for a project or wants to use it - it would be
cruel not to tell him that the project is probably going to fail.

I mean, he is asking for advice, and obviously knows rather little
about roff(1) and man(7).

  "How do i best shoot my knee?
   Should i hold the gun this way or that?"

We *should* tell him that he should better not aim at his knee
at all, or at least pay attention that no other people
are standing behind his back, right?

> bash(1)

Maybe, but i don't really know; i stopped using that one about
a decade ago.

Yours,
  Ingo


From MAILER-DAEMON Sun Jan 22 18:18:49 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rp6gT-00064S-4g
	for mharc-groff@gnu.org; Sun, 22 Jan 2012 18:18:49 -0500
Received: from eggs.gnu.org ([140.186.70.92]:59877)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rp6gR-00064M-Og
	for groff@gnu.org; Sun, 22 Jan 2012 18:18:48 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rp6gQ-0008UE-Im
	for groff@gnu.org; Sun, 22 Jan 2012 18:18:47 -0500
Received: from relay01.pair.com ([209.68.5.15]:1159)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rp6gQ-0008U8-DM
	for groff@gnu.org; Sun, 22 Jan 2012 18:18:46 -0500
Received: (qmail 52963 invoked from network); 22 Jan 2012 23:18:45 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay01.pair.com with SMTP; 22 Jan 2012 23:18:45 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id C8408274DA; Sun, 22 Jan 2012 23:18:44 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id A1D8D27492;
	Sun, 22 Jan 2012 23:18:44 +0000 (GMT)
to: groff@gnu.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <20120122193527.GA31560@iris.usta.de>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>
	<CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
	<20120122155729.GA26723@usta.de>
	<20120122171601.3951E202FC@orac.inputplus.co.uk>
	<20120122193527.GA31560@iris.usta.de>
Comments: In-reply-to Ingo Schwarze <schwarze@usta.de> message dated "Sun,
	22 Jan 2012 20:35:27 +0100."
Date: Sun, 22 Jan 2012 23:18:44 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120122231844.C8408274DA@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.68.5.15
Cc: Siteshwar Vashisht <siteshwar@gmail.com>
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: groff@gnu.org
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 22 Jan 2012 23:18:48 -0000

Hi,

Ingo Schwarze wrote:
> There is no need to choose stupid projects for learning; actually, you
> not only *produce* less, you also *learn* less in a project that is
> bound for failure right from the start.

It may be learning less but reaching a dead end and looking back and
learning from it, perhaps that has unique value.  One that isn't learnt
by being set tasks or scratching someone else's itch.

Cheers, Ralph.


From MAILER-DAEMON Mon Jan 23 01:13:04 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpD9M-0007x4-Ma
	for mharc-groff@gnu.org; Mon, 23 Jan 2012 01:13:04 -0500
Received: from eggs.gnu.org ([140.186.70.92]:58388)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <fish@ridiculousfish.com>) id 1Rp7uM-0004Pz-PV
	for groff@gnu.org; Sun, 22 Jan 2012 19:37:15 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <fish@ridiculousfish.com>) id 1Rp7uL-0007LP-N2
	for groff@gnu.org; Sun, 22 Jan 2012 19:37:14 -0500
Received: from mail6.webfaction.com ([74.55.86.74]:39608
	helo=smtp.webfaction.com) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <fish@ridiculousfish.com>) id 1Rp7uL-0007LJ-JQ
	for groff@gnu.org; Sun, 22 Jan 2012 19:37:13 -0500
Received: from [10.0.1.106] (c-98-248-29-71.hsd1.ca.comcast.net [98.248.29.71])
	by smtp.webfaction.com (Postfix) with ESMTP id B106A59D064F
	for <groff@gnu.org>; Sun, 22 Jan 2012 18:37:11 -0600 (CST)
From: ridiculous_fish <fish@ridiculousfish.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
Date: Sun, 22 Jan 2012 16:37:10 -0800
Message-Id: <22DD623D-D95A-4BA0-ADFB-E7C658E8B1EF@ridiculousfish.com>
To: groff@gnu.org
Mime-Version: 1.0 (Apple Message framework v1251.1)
X-Mailer: Apple Mail (2.1251.1)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 74.55.86.74
X-Mailman-Approved-At: Mon, 23 Jan 2012 01:13:02 -0500
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Jan 2012 00:37:15 -0000

Hello! I'm working with Siteshwar on these shell enhancements. At the =
cost of straying
off-topic, I hope I can clarify our intent, and convince you that this =
is a worthwhile
effort.

Ingo Schwarze wrote on Sun, 22 Jan 2012 16:57:29 +0100:

> Do not bloat the shell.

This is key to our philosophy. In fact, we started on this project as a =
reaction to what
we perceive as bloat in shells like bash, whose man page is about half =
the length of the
first Harry Potter novel.

Our intent is to produce a shell with less internal complexity, and far =
less user-facing
complexity, than popular shells.

While we like the idea of man pages contributing to completions, we have =
not settled on an
architecture for it yet. What if we described the feature as a separate =
script that scans
installed man pages and outputs a shell completion file? Would that be =
able to slip by
your Unix-philosophy-radar?

> Do not bloat *any* utility program with unrelated bells and =
whistles...Options typically
> are a dash and one character.

It sounds like you are reacting against the idea of shell command =
completions altogether.
That ship sailed long ago: bash, tcsh, and zsh all know how to complete =
options, both long
and short. A shell that hopes to succeed today cannot realistically omit =
this feature.

> Whatever you do, it will be crude guesswork... How are you going to =
find out whether you
> are even looking at the right manual?

We don't expect perfection, only an improvement on how shell completions =
work today, which
requires users to install some monster static list of commands =
invariably designed only
for GNU tools (and even then, special-cased for various Linux =
distributions). We're aware
that scanning man pages is a sucky solution and will get a lot wrong; we =
just think that
the current design sucks harder and gets more wrong.

Our belief is that man pages, while imperfect, will nevertheless have =
much better fidelity
to the installed system than whatever static list happens to be up at
http://www.caliban.org/bash/ . As a longtime BSD contributor, I hope you =
can appreciate
our attempt to make this existing feature more platform-agnostic.

-Peter



From MAILER-DAEMON Mon Jan 23 07:13:07 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpIln-0008Az-AV
	for mharc-groff@gnu.org; Mon, 23 Jan 2012 07:13:07 -0500
Received: from eggs.gnu.org ([140.186.70.92]:32864)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RpIlh-00088p-Ju
	for groff@gnu.org; Mon, 23 Jan 2012 07:13:05 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RpIld-0007Ss-FY
	for groff@gnu.org; Mon, 23 Jan 2012 07:13:01 -0500
Received: from relay3-d.mail.gandi.net ([217.70.183.195]:35980)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <sygne@ombres.eu>) id 1RpIld-0007SH-AG
	for groff@gnu.org; Mon, 23 Jan 2012 07:12:57 -0500
X-Originating-IP: 217.70.178.141
Received: from mfilter13-d.gandi.net (mfilter13-d.gandi.net [217.70.178.141])
	by relay3-d.mail.gandi.net (Postfix) with ESMTP id 349B4A8099;
	Mon, 23 Jan 2012 13:12:52 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at mfilter13-d.gandi.net
Received: from relay3-d.mail.gandi.net ([217.70.183.195])
	by mfilter13-d.gandi.net (mfilter13-d.gandi.net [10.0.15.180])
	(amavisd-new, port 10024)
	with ESMTP id UmuSrjYlopnT; Mon, 23 Jan 2012 13:12:50 +0100 (CET)
X-Originating-IP: 86.74.235.141
Received: from localhost.localdomain (141.235.74.86.rev.sfr.net
	[86.74.235.141]) (Authenticated sender: sygne@ombres.eu)
	by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id 9C8F1A807B;
	Mon, 23 Jan 2012 13:12:50 +0100 (CET)
Date: Mon, 23 Jan 2012 13:10:48 +0100
From: Pierre-Jean <sygne@ombres.eu>
To: groff@gnu.org, fish@ridiculousfish.com
Message-ID: <4f1d4e48.zhyoNH1F0WRaNAgc%sygne@ombres.eu>
References: <22DD623D-D95A-4BA0-ADFB-E7C658E8B1EF@ridiculousfish.com>
In-Reply-To: <22DD623D-D95A-4BA0-ADFB-E7C658E8B1EF@ridiculousfish.com>
User-Agent: Heirloom mailx 12.5 7/5/10
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 217.70.183.195
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Jan 2012 12:13:05 -0000

ridiculous_fish <fish@ridiculousfish.com> wrote:

> Our intent is to produce a shell with less internal complexity, and far less user-facing
> complexity, than popular shells.
>

Hello,

I suppose that you know the shell fish: It's doing what you
want concerning completion of options. You could have a look
at it.

It has a lot of new features, and aim to give a better command
line interface than other shells... It didn't convince me at
all, but I'm happy to see that people are still interesting
in improving command line interface.



From MAILER-DAEMON Mon Jan 23 08:36:37 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpK4b-0003Tm-8o
	for mharc-groff@gnu.org; Mon, 23 Jan 2012 08:36:37 -0500
Received: from eggs.gnu.org ([140.186.70.92]:53583)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RpK4U-00034P-7F
	for groff@gnu.org; Mon, 23 Jan 2012 08:36:35 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RpK4O-0001BX-G6
	for groff@gnu.org; Mon, 23 Jan 2012 08:36:30 -0500
Received: from ws-mr2.cc.emory.edu ([170.140.50.232]:49427)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RpK4O-0001BN-Cu
	for groff@gnu.org; Mon, 23 Jan 2012 08:36:24 -0500
Received: from [192.168.10.22] (emoryfloatdmz.cc.emory.edu [170.140.52.254])
	(authenticated bits=0)
	by ws-mr2.cc.emory.edu (8.13.8/8.13.1) with ESMTP id q0NDaLBH016531
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
	for <groff@gnu.org>; Mon, 23 Jan 2012 08:36:21 -0500
Message-ID: <4F1D6255.90709@mathcs.emory.edu>
Date: Mon, 23 Jan 2012 08:36:21 -0500
From: Ken Mandelberg <km@mathcs.emory.edu>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.25) Gecko/20111214 Lightning/1.0b2 Thunderbird/3.1.17
MIME-Version: 1.0
To: groff@gnu.org
Content-Type: text/plain; charset=UTF-8; format=flowed
X-Emory-MailScanner-Information: Please contact the ISP for more information
X-Emory-MailScanner-ID: q0NDaLBH016531
X-Emory-MailScanner: Found to be clean
X-Emory-MailScanner-SpamCheck: not spam, SpamAssassin (not cached,
	score=1.99, required 8, autolearn=disabled, SMTP_AUTH 2.00,
	T_RP_MATCHES_RCVD -0.01)
X-Emory-MailScanner-SpamScore: s
X-Emory-MailScanner-From: km@mathcs.emory.edu
Content-Transfer-Encoding: quoted-printable
X-MIME-Autoconverted: from 8bit to quoted-printable by ws-mr2.cc.emory.edu id
	q0NDaLBH016531
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 170.140.50.232
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Jan 2012 13:36:36 -0000


Anton Shepelev wrote, On 01/21/2012 05:35 AM:
> Ken Mandelberg:
>
>> It  seems  like  AU/AT  with  the MM macros is not
>> working properly.
>
> The problem is with the  Memorandum-style  signature
> macro.
>
> Without .warn in the beginning of your file you were
> missing several warnings from Groff.  I added it and
> saw  where  the  errors were.  It turns out that the
> ..SG macro requires that at least four  arguments  be
> passed to the .AU macro.  This example works:
>
>    .warn
>    .TL "Anton's title"
>    .MT 5
>    .AU Smith J. Location Dept.
>    .AT "CEO"
>    .P
>    testing
>    .FC
>    .SG
>
> The  "--"  you are talking about are two field divi-
> sors, between location, department and initials, and
> the signature macro seems to handle them incorrectly
> when at least one of them is empty.
>
> Anton


Anton

I'm missing something. I tried your example and this is what I get:

**********
        testing

                                      Yours very truly,



        Location=E2=80=90Dept.=E2=80=90J.             Smith
***********

If I move the .MT 5 down after the .AT I get

***********
       Charge Case Anton=E2=80=99s title



                                                    January 22, 2012



        testing

                                      Yours very truly,



        Location=E2=80=90Dept.=E2=80=90J.             Smith
*************

Still no CEO.

I'm trying to convert from the AT&T roff code on Solaris to groff on=20
Linux. On Solaris I get CEO.




From MAILER-DAEMON Mon Jan 23 10:15:59 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpLcl-0003rh-Kq
	for mharc-groff@gnu.org; Mon, 23 Jan 2012 10:15:59 -0500
Received: from eggs.gnu.org ([140.186.70.92]:43968)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpLce-0003qJ-AY
	for groff@gnu.org; Mon, 23 Jan 2012 10:15:57 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpLcV-0007w9-0P
	for groff@gnu.org; Mon, 23 Jan 2012 10:15:52 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:56261)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpLcU-0007vt-Re
	for groff@gnu.org; Mon, 23 Jan 2012 10:15:42 -0500
Received: by bkbzx1 with SMTP id zx1so2735233bkb.0
	for <groff@gnu.org>; Mon, 23 Jan 2012 07:15:41 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type:content-transfer-encoding;
	bh=CQsaa/6fyU7LnXqxLWD6FUKh4Ie2bL2oSRGREdf1IU8=;
	b=QaqAuQUzZYfYHP3tHdidEMU+sfg0LrX11fxShzcOYschIpPf4Zkc9SCmKj1CRldnNw
	lzryk3ITnMsgyXMS4bYDKcK+ylTBO5bG1UyEx775+T5h0vk1vm92q2+PeVKrw7OVPiZf
	5KBOth8ZAza+aI2v12ikWhgj5/eQoFRS1Yvgk=
Received: by 10.204.130.129 with SMTP id t1mr3391806bks.33.1327331741199;
	Mon, 23 Jan 2012 07:15:41 -0800 (PST)
Received: from erp07.git.ru ([94.79.3.82])
	by mx.google.com with ESMTPS id a17sm29025607bkz.7.2012.01.23.07.15.39
	(version=SSLv3 cipher=OTHER); Mon, 23 Jan 2012 07:15:40 -0800 (PST)
Date: Mon, 23 Jan 2012 19:15:29 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Ken Mandelberg <km@mathcs.emory.edu>
Message-Id: <20120123191529.a707ae1382ea132de770d27c@gmail.com>
In-Reply-To: <4F1CAB5C.4020707@mathcs.emory.edu>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120121143559.1835a94ae7da28647a2206a3@gmail.com>
	<4F1CAB5C.4020707@mathcs.emory.edu>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Jan 2012 15:15:58 -0000

Ken Mandelberg:

> Still no CEO.

Sorry, I missed this part.  I looked into m.tmac and
found that the Memorandum-style signature  does  not
include  the  title (.AT).  The only place where the
title is used is in  the  ms.cov  -- ms-style  cover
page activated by .COVER ms.

The  curent  implemenation of .SG for either letter-
syle (.LT) or Memorandum-style (.MT)  does  not  use
the title.  If you are sure that it should, than let
people on the mailing list know -- I  see  you  only
replied to me this time.

> I'm  trying  to convert from the AT&T roff code on
> Solaris to groff on Linux. On Solaris I get CEO.

Now I see.  If Werner approves it, I may  look  into
how to output the title in .SG.

Anton


From MAILER-DAEMON Mon Jan 23 14:28:54 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpPZW-0001FQ-9r
	for mharc-groff@gnu.org; Mon, 23 Jan 2012 14:28:54 -0500
Received: from eggs.gnu.org ([140.186.70.92]:56883)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RpPZS-0001El-MJ
	for groff@gnu.org; Mon, 23 Jan 2012 14:28:51 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RpPZR-0003kc-Ao
	for groff@gnu.org; Mon, 23 Jan 2012 14:28:50 -0500
Received: from mailout-de.gmx.net ([213.165.64.22]:40402)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RpPZQ-0003iO-RJ
	for groff@gnu.org; Mon, 23 Jan 2012 14:28:49 -0500
Received: (qmail invoked by alias); 23 Jan 2012 19:28:47 -0000
Received: from 178-191-186-167.adsl.highway.telekom.at (EHLO localhost)
	[178.191.186.167]
	by mail.gmx.net (mp028) with SMTP; 23 Jan 2012 20:28:47 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX1+XhBxK2piXQN7GY/b2hWFAvvDd0oOZ1YVRfY/+tx
	fmPOwBNaRMrhFC
Date: Mon, 23 Jan 2012 20:28:45 +0100 (CET)
Message-Id: <20120123.202845.201296611.wl@gnu.org>
To: anton.txt@gmail.com
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20120123191529.a707ae1382ea132de770d27c@gmail.com>
References: <20120121143559.1835a94ae7da28647a2206a3@gmail.com>
	<4F1CAB5C.4020707@mathcs.emory.edu>
	<20120123191529.a707ae1382ea132de770d27c@gmail.com>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.22
Cc: km@mathcs.emory.edu, groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Jan 2012 19:28:51 -0000

> Now I see.  If Werner approves it, I may  look  into
> how to output the title in .SG.

Please do so!  I have virtually no time for groff, unfortunately.


    Werner


From MAILER-DAEMON Mon Jan 23 17:46:03 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpSeJ-000784-CA
	for mharc-groff@gnu.org; Mon, 23 Jan 2012 17:46:03 -0500
Received: from eggs.gnu.org ([140.186.70.92]:41944)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RpSeG-00076a-Bs
	for groff@gnu.org; Mon, 23 Jan 2012 17:46:01 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RpSeF-00047H-B9
	for groff@gnu.org; Mon, 23 Jan 2012 17:46:00 -0500
Received: from helix.usm.uni-muenchen.de ([129.187.204.86]:36716)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RpSeF-000479-6T
	for groff@gnu.org; Mon, 23 Jan 2012 17:45:59 -0500
Received: by helix.usm.uni-muenchen.de (Postfix, from userid 2097)
	id 373671613051; Mon, 23 Jan 2012 23:45:56 +0100 (CET)
Date: Mon, 23 Jan 2012 23:45:56 +0100
From: Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
To: groff@gnu.org
Message-ID: <20120123224556.GB16889@usm.uni-muenchen.de>
References: <20120101153404.GA8712@usm.uni-muenchen.de>
	<CACRhBXO35_MwnF=nFWQzh7p5ZC88U3YMZdFQF-p1Gk=RYskgwQ@mail.gmail.com>
	<20120105200628.GE13517@usm.uni-muenchen.de>
	<20120107.080217.159457058.wl@gnu.org>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="OgqxwSJOaUobr8KG"
Content-Disposition: inline
In-Reply-To: <20120107.080217.159457058.wl@gnu.org>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 129.187.204.86
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Jan 2012 22:46:01 -0000


--OgqxwSJOaUobr8KG
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline



> Could you provide a patch which I can directly apply to the
> groff CVS?

Attached.  Log message should probably include something to
the effect of "make .bl work inside blocks" or so.


By the way, I've also figured out why the centering of wide
blocks in the "me" macros does not work correctly: the macros
change the line width to 6.0 inches, but the indent for blocks
is computed in environment 1 which retains the default line
width of 6.5 inches. Thus, blocks get formatted to a width
of 6 inches but are printed with an indent of .25 inches and
thus stick out at the right. (I had originally thought that
the indent was intentional (and we should therefore reduce
the line width), but this appears not to be the case.)



--OgqxwSJOaUobr8KG
Content-Type: text/x-patch; charset=us-ascii
Content-Disposition: attachment; filename="e.tmac.patch"

--- e.tmac.orig	2012-01-23 19:25:54.000000000 +0100
+++ e.tmac	2012-01-23 22:32:07.000000000 +0100
@@ -511,9 +511,14 @@
 .
 .de bl			\" *** contiguous blank lines
 .br
+.@s \\$1
+.sp \\$1
+..
+.
+.de @s			\" --- diversion-surviving space test
 .ne \\$1
 .rs
-.sp \\$1
+.if !'\\n(.z'' \!.@s \\$1
 ..
 .
 .de n1			\" *** line numbering 1

--OgqxwSJOaUobr8KG--


From MAILER-DAEMON Tue Jan 24 00:09:55 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpYdn-0006xu-Fb
	for mharc-groff@gnu.org; Tue, 24 Jan 2012 00:09:55 -0500
Received: from eggs.gnu.org ([140.186.70.92]:47669)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1RpYdj-0006xk-TV
	for groff@gnu.org; Tue, 24 Jan 2012 00:09:52 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1RpYdi-0006ha-PT
	for groff@gnu.org; Tue, 24 Jan 2012 00:09:51 -0500
Received: from mail18.sea5.speakeasy.net ([69.17.117.20]:44322)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jklowden@schemamania.org>) id 1RpYdi-0006gl-DU
	for groff@gnu.org; Tue, 24 Jan 2012 00:09:50 -0500
Received: (qmail 23113 invoked from network); 24 Jan 2012 04:42:58 -0000
Received: by simscan 1.4.0 ppid: 14337, pid: 18797, t: 0.0266s
	scanners: clamav: 0.88.2/m:52/d:10739
Received: from mxperim3.sea5.speakeasy.net ([69.17.117.68])
	(envelope-sender <jklowden@schemamania.org>)
	by mail18.sea5.speakeasy.net (qmail-ldap-1.03) with SMTP
	for <groff@gnu.org>; 24 Jan 2012 04:42:58 -0000
Received: from localhost (localhost [127.0.0.1])
	by mxperim3.sea5.speakeasy.net (Postfix) with ESMTP id 6A16A43C54
	for <groff@gnu.org>; Mon, 23 Jan 2012 20:42:58 -0800 (PST)
X-Virus-Scanned: Debian amavisd-new at mxperim3.sea5.speakeasy.net
Received: from mxperim3.sea5.speakeasy.net ([127.0.0.1])
	by localhost (mxperim3.sea5.speakeasy.net [127.0.0.1]) (amavisd-new,
	port 10024) with ESMTP id ZAb7eeZlbRIS for <groff@gnu.org>;
	Mon, 23 Jan 2012 20:42:58 -0800 (PST)
Received: from oak.schemamania.org (dsl254-083-208.nyc1.dsl.speakeasy.net
	[216.254.83.208]) by mxperim3.sea5.speakeasy.net (Postfix) with ESMTP
	for <groff@gnu.org>; Mon, 23 Jan 2012 20:42:57 -0800 (PST)
Received: from oak.schemamania.org (localhost [IPv6:::1])
	by oak.schemamania.org (Postfix) with SMTP id CA12530E125E
	for <groff@gnu.org>; Mon, 23 Jan 2012 23:42:56 -0500 (EST)
Date: Mon, 23 Jan 2012 23:42:56 -0500
From: "James K. Lowden" <jklowden@schemamania.org>
To: groff@gnu.org
Message-Id: <20120123234256.8fa5638b.jklowden@schemamania.org>
In-Reply-To: <CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>
	<CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
X-Mailer: Sylpheed 3.0.2 (GTK+ 2.20.1; x86_64--netbsd)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6, seldom 2.4 (older,
	4)
X-Received-From: 69.17.117.20
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 24 Jan 2012 05:09:53 -0000

On Sun, 22 Jan 2012 19:29:23 +0530
Siteshwar Vashisht <siteshwar@gmail.com> wrote:

> I am working on a shell, and the idea
> is to show suggestions for command line options on pressing tab. So
> let's say on pressing "ls<TAB>", I will get all the command line
> options for ls command. Now a good idea is to fetch these options
> from manual pages.

Yes, it is.  

Opinions on shells and shell-goodness vary.  Otherwise we wouldn't have
the vast ghastly variety we do.  (csh is considered harmful, you
know.)  

Contrary to Ingo, I encourage you.  Two observatoins for the pot:

1.  Twenty-five years ago I used a non-unix shell so far ahead of its
time nothing like it has been seen before or since.  It was a
command-line with ncurses-like forms.  You could type the options on
the command line but, if at any time you became confused, you could
press <mumble> and a whole form appeared.  Fill out the form, press
Return, and you were off.  Fully programmable, nicely interactive on
demand, with integrated help.  Unix shells are crude indeed by
comparison.  

2.  I'm sure what Ted says about mdoc/man is true, that man pages in
general lack the semantic information you need to be used in the way
you want.  That said, inferences are possible.  The existence of
unroff suggests inferences might be useful for a significant
fraction.  (I haven't used it, but you might want to take a look.)  

(Some will definitely defeat you.  I can't find an example now, but some
man pages don't even structure the option descriptions as an itemized
list; some describe the options in running text, in paragraphs.) 

The problem can be broken into two parts: the creation of semantic
information from man pages, and the use of that semantic information by
your shell.  

Suppose you used, say, unroff to populate a database of commands and
their options, and wrote two utilities: one to update that database
both as the man pages were updated (perhaps using cron),  and another to
accept manual overrides for man pages not amenable to semantic
extraction. Now you have a user-extensible system, and your shell
doesn't know about or care about man/mdoc/whatever.  

A design with an intermediate database lets you attack the problem from
both ends.  You can work at turns on producing the information
(populating the database) and on using it in your shell.  You can focus
on the utilities you think are interesting, maybe by sorting your own
shell's command history.  And when you hit a man page that's totally
hopeless, you can still fall back on using your brain to populate the
database based on what you see on the screen.  

Good luck with it.  It might be fun.  After all, that was the idea in
the first place, right?  

--jkl


From MAILER-DAEMON Tue Jan 24 01:27:57 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpZrJ-00074j-MA
	for mharc-groff@gnu.org; Tue, 24 Jan 2012 01:27:57 -0500
Received: from eggs.gnu.org ([140.186.70.92]:45473)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <fish@ridiculousfish.com>) id 1RpZrG-00074d-LK
	for groff@gnu.org; Tue, 24 Jan 2012 01:27:55 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <fish@ridiculousfish.com>) id 1RpZrF-0006sr-Fu
	for groff@gnu.org; Tue, 24 Jan 2012 01:27:54 -0500
Received: from mail6.webfaction.com ([74.55.86.74]:46041
	helo=smtp.webfaction.com) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <fish@ridiculousfish.com>) id 1RpZrF-0006sl-Bm
	for groff@gnu.org; Tue, 24 Jan 2012 01:27:53 -0500
Received: from [10.0.1.106] (c-98-248-29-71.hsd1.ca.comcast.net [98.248.29.71])
	by smtp.webfaction.com (Postfix) with ESMTP id 3678F26EC2E5;
	Tue, 24 Jan 2012 00:26:08 -0600 (CST)
Mime-Version: 1.0 (Apple Message framework v1251.1)
Content-Type: text/plain; charset=us-ascii
From: ridiculous_fish <fish@ridiculousfish.com>
In-Reply-To: <4f1d4e48.zhyoNH1F0WRaNAgc%sygne@ombres.eu>
Date: Mon, 23 Jan 2012 22:26:05 -0800
Content-Transfer-Encoding: quoted-printable
Message-Id: <68DFD5C6-41E6-4C18-A29F-E5D671DE1FB6@ridiculousfish.com>
References: <22DD623D-D95A-4BA0-ADFB-E7C658E8B1EF@ridiculousfish.com>
	<4f1d4e48.zhyoNH1F0WRaNAgc%sygne@ombres.eu>
To: Pierre-Jean <sygne@ombres.eu>
X-Mailer: Apple Mail (2.1251.1)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 74.55.86.74
Cc: groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 24 Jan 2012 06:27:55 -0000


On Jan 23, 2012, at 4:10 AM, Pierre-Jean wrote:

> Hello,
>=20
> I suppose that you know the shell fish: It's doing what you
> want concerning completion of options. You could have a look
> at it.
>=20
> It has a lot of new features, and aim to give a better command
> line interface than other shells... It didn't convince me at
> all, but I'm happy to see that people are still interesting
> in improving command line interface.
>=20

Well! In fact, "our" shell is a fork of fish. I tried fish and liked =
what I saw, but ran into show stopping bugs. I started this project to =
resolve those bugs.

We aim to fix the most serious issues, like frequent hangs on slow NFS =
filesystems and excessive I/O at startup. We're also improving its =
internal structure, and adding features that mesh with its =
user-friendly, it-just-works-no-configuration-necessary vision. =
Automatically inferring completions, instead of requiring manual entry, =
is in line with that philosophy. Or at least we think so!

Anyways, thanks to everyone for the suggestions and feedback!
-Peter



From MAILER-DAEMON Tue Jan 24 03:02:42 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpbL0-0007W9-8z
	for mharc-groff@gnu.org; Tue, 24 Jan 2012 03:02:42 -0500
Received: from eggs.gnu.org ([140.186.70.92]:51860)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpbKs-0007Tn-CC
	for groff@gnu.org; Tue, 24 Jan 2012 03:02:40 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpbKm-0003eL-8p
	for groff@gnu.org; Tue, 24 Jan 2012 03:02:34 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:57232)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpbKl-0003eG-T0
	for groff@gnu.org; Tue, 24 Jan 2012 03:02:28 -0500
Received: by bkbzx1 with SMTP id zx1so3502190bkb.0
	for <groff@gnu.org>; Tue, 24 Jan 2012 00:02:26 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type:content-transfer-encoding;
	bh=V9YYXTvr10bwkCRZSzGBCwEfNmscG9ZGRTI87FEmKig=;
	b=Yrtl5kg0V/h5odJZ5S3LXmPbEk82CyfbtdNIqaVbu/bC5cYrgA/tN6CCG81sPxvZHl
	taTQZQXT9wXZhm7jehngiA5xVlfaVu+LuXb2/hrJl7/B8eyQmMNlOlJdTuPA+0bIng2H
	nz85K1ONQef1VgmBRKNR+nt7H0JDo143Z6cCc=
Received: by 10.204.156.135 with SMTP id x7mr4578496bkw.138.1327392146817;
	Tue, 24 Jan 2012 00:02:26 -0800 (PST)
Received: from erp07.git.ru ([94.79.3.82])
	by mx.google.com with ESMTPS id d2sm34369012bky.11.2012.01.24.00.02.25
	(version=SSLv3 cipher=OTHER); Tue, 24 Jan 2012 00:02:25 -0800 (PST)
Date: Tue, 24 Jan 2012 12:02:15 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Siteshwar Vashisht <siteshwar@gmail.com>
Message-Id: <20120124120215.d2d4226457cb5583724428b6@gmail.com>
In-Reply-To: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 24 Jan 2012 08:02:40 -0000

Vannevar Bush:

> It  parses  and shows me the whole page. What if I
> want to parse only OPTIONS section ? I am  looking
> for something like :-
>
>    groff -X -P -resolution -P100 -man -parse-section "OPTIONS" passwd

Here is my quick, dirty and incomplete solution:

   .nr skip 0u \" Flag to indicate whether the current text is to be skipped
   .am TH      \" Have to append .TH, because the man macros are initialized
   .           \" inside .TH
   .
   .   de scls end \" Couldn't make this part work:
   .      br       \" Can't covert a diversion to a string
   .      di       \" usable for comparison with the current title
   .      in
   .      ds sectxt \\\\*[secn]\"Collecting the input line after call to SH
   .      SH-N \\\\*[sectxt]\"and passing ti to SH-N as parameter.
   .   end
   .   rn SH SH-orig \" Rename the original SH so as to prepend it.
   .   de SH end     \" The definition of the new SH
   .      ie '\\\\$*'' \{\\"Title given on the next input line
   .         in 0
   .         it 1 scls \"Input trap to capture the next input line
   .         di secn   \"Inside this diversion
   .      \}
   .      el .SH-N \\\\$* \" Title given as parameter
   .   end
   .
   .   de SH-N end
   .      nr b-print 0
   .      if '\\\\*[secf]''       .nr b-print 1
   .      if '\\\\*[secf]'\\\\$1' .nr b-print 1
   .      ie \\\\n[b-print] \{\
   .         if \\\\n[skip] \{\
   .            nr skip 0
   .            br
   .            di
   .            ch devnull
   .         \}
   .         SH-orig \\\\$*
   .      \}
   .      el \{\
   .         if !\\\\n[skip] \{\
   .            nr skip 1u
   .            br
   .            di devnull
   .         \}
   .      \}
   .   end
   ..
   .TH 1 Title
   .SH One
   Text of section One
   .P
   Another paragraph
   .SH Two
   Text of section Two
   .SH Three
   Text of section Three

See how it works by processing the file with groff:

   Print whole file:
      groff -Tascii -man secfilter.man -P-cbu> secfilter.txt

   Print individual sections:
      groff -Tascii -man -dsecf=One   secfilter.man -P-cbu> secfilter.txt
      groff -Tascii -man -dsecf=Two   secfilter.man -P-cbu> secfilter.txt
      groff -Tascii -man -dsecf=Three secfilter.man -P-cbu> secfilter.txt

Anton


From MAILER-DAEMON Tue Jan 24 04:15:36 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RpcTY-0006kZ-B1
	for mharc-groff@gnu.org; Tue, 24 Jan 2012 04:15:36 -0500
Received: from eggs.gnu.org ([140.186.70.92]:56915)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpcTQ-0006hy-Uz
	for groff@gnu.org; Tue, 24 Jan 2012 04:15:34 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpcTP-0004QJ-N0
	for groff@gnu.org; Tue, 24 Jan 2012 04:15:28 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:57415)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpcTP-0004Pp-HP
	for groff@gnu.org; Tue, 24 Jan 2012 04:15:27 -0500
Received: by bkbzx1 with SMTP id zx1so3553262bkb.0
	for <groff@gnu.org>; Tue, 24 Jan 2012 01:15:26 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type:content-transfer-encoding;
	bh=dnPy8FeV3apog2Eldp3HOAzzSk+5CfI8LBxYRa+d9XE=;
	b=jweM1V+DLsD2DHvsgNM3ccuM6icnGS+VE1PlyqDxh9XR3Hx5SpVJ1Iyr1gU01O4gol
	tayNYfJwdB0XM3UyqVF1xIsKmbmWVTC4eVGQvau90o60DuVoU9yEo/YQFIvZx2PwixxN
	hrfeeDoWkis6TH/KTqXal+rCYWjNOXEvTzXYw=
Received: by 10.205.136.19 with SMTP id ii19mr4674208bkc.60.1327396526634;
	Tue, 24 Jan 2012 01:15:26 -0800 (PST)
Received: from erp07.git.ru ([94.79.3.82])
	by mx.google.com with ESMTPS id iu2sm34865933bkb.0.2012.01.24.01.15.25
	(version=SSLv3 cipher=OTHER); Tue, 24 Jan 2012 01:15:26 -0800 (PST)
Date: Tue, 24 Jan 2012 13:15:14 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Siteshwar Vashisht <siteshwar@gmail.com>
Message-Id: <20120124131514.349939b329a13294e40a9b7e@gmail.com>
In-Reply-To: <20120124120215.d2d4226457cb5583724428b6@gmail.com>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120124120215.d2d4226457cb5583724428b6@gmail.com>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 24 Jan 2012 09:15:34 -0000

Dear Siteshwar, excuse me for addressing you as Van-
nevar Bush.

Anton


From MAILER-DAEMON Tue Jan 24 08:48:30 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rpgjd-0004a9-VX
	for mharc-groff@gnu.org; Tue, 24 Jan 2012 08:48:29 -0500
Received: from eggs.gnu.org ([140.186.70.92]:42755)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1Rpgjb-0004Yi-1s
	for groff@gnu.org; Tue, 24 Jan 2012 08:48:28 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpgjW-0007rw-Un
	for groff@gnu.org; Tue, 24 Jan 2012 08:48:27 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:37844)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RpgjW-0007rc-PZ
	for groff@gnu.org; Tue, 24 Jan 2012 08:48:22 -0500
Received: by bkbzx1 with SMTP id zx1so3810350bkb.0
	for <groff@gnu.org>; Tue, 24 Jan 2012 05:48:21 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type;
	bh=F9hLyurPG9lNsBcSk5iVW080G4+h1dWsuCJjs/VWnMs=;
	b=M8E6sP40AEKHJZB9NkSK6Yreyxug/W0vKNQA1EQ7EVeqMgcwEKwPP237JaooDdq20T
	Sp7vk57slfCVqHT7slICmorMPD4pm1llpRzo4XfHHW8Kq3nwtWRrGNQXSqsdC8GMh5Ga
	jhNRUknKF1rMZKwerG0RtarhGvMQzXLa4gIY4=
Received: by 10.204.129.220 with SMTP id p28mr5038750bks.8.1327412901505;
	Tue, 24 Jan 2012 05:48:21 -0800 (PST)
Received: from erp07.git.ru ([94.79.3.82])
	by mx.google.com with ESMTPS id a17sm36437944bkz.7.2012.01.24.05.48.19
	(version=SSLv3 cipher=OTHER); Tue, 24 Jan 2012 05:48:20 -0800 (PST)
Date: Tue, 24 Jan 2012 17:48:09 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Siteshwar Vashisht <siteshwar@gmail.com>
Message-Id: <20120124174809.5cd88a522c31eade48dd654e@gmail.com>
In-Reply-To: <20120124120215.d2d4226457cb5583724428b6@gmail.com>
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>
	<20120124120215.d2d4226457cb5583724428b6@gmail.com>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: multipart/mixed;
	boundary="Multipart=_Tue__24_Jan_2012_17_48_09_+0400_sD0EP=NxMIexdHMq"
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 24 Jan 2012 13:48:28 -0000

This is a multi-part message in MIME format.

--Multipart=_Tue__24_Jan_2012_17_48_09_+0400_sD0EP=NxMIexdHMq
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

Please, add the following two lines to the beginning
of the file:

   .warn
   .if !d secf .ds secf \" If not specified on commandline, init secf here.

I somehow missed them when copying.

I have attached the full working file for convenience.

Anton

--Multipart=_Tue__24_Jan_2012_17_48_09_+0400_sD0EP=NxMIexdHMq
Content-Type: application/x-troff-man;
 name="secfilter.man"
Content-Disposition: attachment;
 filename="secfilter.man"
Content-Transfer-Encoding: base64

Lndhcm4NCi5pZiAhZCBzZWNmIC5kcyBzZWNmIFwiIElmIG5vdCBzcGVjaWZpZWQgb24gY29tbWFu
ZGxpbmUsIGluaXQgc2VjZiBoZXJlLg0KLm5yIHNraXAgMHUgXCIgRmxhZyB0byBpbmRpY2F0ZSB3
aGV0aGVyIHRoZSBjdXJyZW50IHRleHQgaXMgdG8gYmUgc2tpcHBlZA0KLmFtIFRIICAgICAgXCIg
SGF2ZSB0byBhcHBlbmQgLlRILCBiZWNhdXNlIHRoZSBtYW4gbWFjcm9zIGFyZSBpbml0aWFsaXpl
ZA0KLiAgICAgICAgICAgXCIgaW5zaWRlIC5USA0KLg0KLiAgIGRlIHNjbHMgZW5kIFwiIENvdWxk
bid0IG1ha2UgdGhpcyBwYXJ0IHdvcms6DQouICAgICAgYnIgICAgICAgXCIgQ2FuJ3QgY292ZXJ0
IGEgZGl2ZXJzaW9uIHRvIGEgc3RyaW5nDQouICAgICAgZGkgICAgICAgXCIgdXNhYmxlIGZvciBj
b21wYXJpc29uIHdpdGggdGhlIGN1cnJlbnQgdGl0bGUNCi4gICAgICBpbg0KLiAgICAgIGRzIHNl
Y3R4dCBcXFxcKltzZWNuXVwiQ29sbGVjdGluZyB0aGUgaW5wdXQgbGluZSBhZnRlciBjYWxsIHRv
IFNIDQouICAgICAgU0gtTiBcXFxcKltzZWN0eHRdXCJhbmQgcGFzc2luZyB0aSB0byBTSC1OIGFz
IHBhcmFtZXRlci4NCi4gICBlbmQNCi4gICBybiBTSCBTSC1vcmlnIFwiIFJlbmFtZSB0aGUgb3Jp
Z2luYWwgU0ggc28gYXMgdG8gcHJlcGVuZCBpdC4NCi4gICBkZSBTSCBlbmQgICAgIFwiIFRoZSBk
ZWZpbml0aW9uIG9mIHRoZSBuZXcgU0gNCi4gICAgICBpZSAnXFxcXCQqJycgXHtcXCJUaXRsZSBn
aXZlbiBvbiB0aGUgbmV4dCBpbnB1dCBsaW5lDQouICAgICAgICAgaW4gMA0KLiAgICAgICAgIGl0
IDEgc2NscyBcIklucHV0IHRyYXAgdG8gY2FwdHVyZSB0aGUgbmV4dCBpbnB1dCBsaW5lDQouICAg
ICAgICAgZGkgc2VjbiAgIFwiSW5zaWRlIHRoaXMgZGl2ZXJzaW9uDQouICAgICAgXH0NCi4gICAg
ICBlbCAuU0gtTiBcXFxcJCogXCIgVGl0bGUgZ2l2ZW4gYXMgcGFyYW1ldGVyDQouICAgZW5kDQou
DQouICAgZGUgU0gtTiBlbmQNCi4gICAgICBuciBiLXByaW50IDANCi4gICAgICBpZiAnXFxcXCpb
c2VjZl0nJyAgICAgICAubnIgYi1wcmludCAxDQouICAgICAgaWYgJ1xcXFwqW3NlY2ZdJ1xcXFwk
MScgLm5yIGItcHJpbnQgMQ0KLiAgICAgIGllIFxcXFxuW2ItcHJpbnRdIFx7XA0KLiAgICAgICAg
IGlmIFxcXFxuW3NraXBdIFx7XA0KLiAgICAgICAgICAgIG5yIHNraXAgMA0KLiAgICAgICAgICAg
IGJyDQouICAgICAgICAgICAgZGkNCi4gICAgICAgICAgICBjaCBkZXZudWxsDQouICAgICAgICAg
XH0NCi4gICAgICAgICBTSC1vcmlnIFxcXFwkKg0KLiAgICAgIFx9DQouICAgICAgZWwgXHtcDQou
ICAgICAgICAgaWYgIVxcXFxuW3NraXBdIFx7XA0KLiAgICAgICAgICAgIG5yIHNraXAgMXUNCi4g
ICAgICAgICAgICBicg0KLiAgICAgICAgICAgIGRpIGRldm51bGwNCi4gICAgICAgICBcfQ0KLiAg
ICAgIFx9DQouICAgZW5kDQouLg0KLlRIIDEgVGl0bGUNCi5TSCBPbmUNClRleHQgb2Ygc2VjdGlv
biBPbmUNCi5QDQpBbm90aGVyIHBhcmFncmFwaA0KLlNIIFR3bw0KVGV4dCBvZiBzZWN0aW9uIFR3
bw0KLlNIIFRocmVlDQpUZXh0IG9mIHNlY3Rpb24gVGhyZWU=

--Multipart=_Tue__24_Jan_2012_17_48_09_+0400_sD0EP=NxMIexdHMq--


From MAILER-DAEMON Tue Jan 24 20:22:09 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RprYv-00039H-Ir
	for mharc-groff@gnu.org; Tue, 24 Jan 2012 20:22:09 -0500
Received: from eggs.gnu.org ([140.186.70.92]:60097)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <corky1951@comcast.net>) id 1RprYs-000395-ME
	for groff@gnu.org; Tue, 24 Jan 2012 20:22:07 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <corky1951@comcast.net>) id 1RprYr-0002jg-FV
	for groff@gnu.org; Tue, 24 Jan 2012 20:22:06 -0500
Received: from qmta02.emeryville.ca.mail.comcast.net ([76.96.30.24]:33498)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <corky1951@comcast.net>) id 1RprYr-0002jV-5R
	for groff@gnu.org; Tue, 24 Jan 2012 20:22:05 -0500
Received: from omta21.emeryville.ca.mail.comcast.net ([76.96.30.88])
	by qmta02.emeryville.ca.mail.comcast.net with comcast
	id Rd9m1i0031u4NiLA2dN3ZK; Wed, 25 Jan 2012 01:22:03 +0000
Received: from [192.168.1.201] ([98.203.142.76])
	by omta21.emeryville.ca.mail.comcast.net with comcast
	id RdN21i00d1f6R9u8hdN33k; Wed, 25 Jan 2012 01:22:03 +0000
Message-ID: <4F1F59D4.5030604@comcast.net>
Date: Tue, 24 Jan 2012 17:24:36 -0800
From: Charlie Kester <corky1951@comcast.net>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US;
	rv:1.9.2.24) Gecko/20111114 Icedove/3.1.16
MIME-Version: 1.0
To: groff@gnu.org
References: <CADVQ=8WdpndXPJBskiambmJvc_Bu=DJg1hXGL98J40_hxwHrBw@mail.gmail.com>	<20120122115346.05E4C1F84E@orac.inputplus.co.uk>	<CADVQ=8X0Svi-EECDvMaJuKh_gWU7GeTaVHVvhJjkv0j6LTkc0w@mail.gmail.com>
	<20120123234256.8fa5638b.jklowden@schemamania.org>
In-Reply-To: <20120123234256.8fa5638b.jklowden@schemamania.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 76.96.30.24
Subject: Re: [Groff] Parsing specific section of man page
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 01:22:07 -0000

On 01/23/2012 08:42 PM, James K. Lowden wrote:

> The problem can be broken into two parts: the creation of semantic
> information from man pages, and the use of that semantic information by
> your shell.
>
> Suppose you used, say, unroff to populate a database of commands and
> their options, and wrote two utilities: one to update that database
> both as the man pages were updated (perhaps using cron),  and another to
> accept manual overrides for man pages not amenable to semantic
> extraction. Now you have a user-extensible system, and your shell
> doesn't know about or care about man/mdoc/whatever.

The most "Unix-y" solution would be to use a text file or files for the 
"database", so that users can edit it with whatever tool they prefer.

If needed for performance reasons, you could follow terminfo's example 
and compile the database into a binary form.

Text files would also make it easy for other developers to write tools 
to work with the database.  Someone's bound to come up with ways to use 
this info that you never imagined.


From MAILER-DAEMON Wed Jan 25 02:10:12 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rpwzk-00015b-BN
	for mharc-groff@gnu.org; Wed, 25 Jan 2012 02:10:12 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33500)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rpwzd-0000yg-0W
	for groff@gnu.org; Wed, 25 Jan 2012 02:10:09 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RpwzY-0000Nu-Fj
	for groff@gnu.org; Wed, 25 Jan 2012 02:10:04 -0500
Received: from mailout-de.gmx.net ([213.165.64.22]:45786)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RpwzY-0000No-1O
	for groff@gnu.org; Wed, 25 Jan 2012 02:10:00 -0500
Received: (qmail invoked by alias); 25 Jan 2012 07:09:58 -0000
Received: from 77.117.209.65.wireless.dyn.drei.com (EHLO localhost)
	[77.117.209.65]
	by mail.gmx.net (mp032) with SMTP; 25 Jan 2012 08:09:58 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX19/gIca3U1/PLIsF0KBK8EUtuqf7ds4LZfcNN4Ibc
	Cc1hShxNJYO78x
Date: Wed, 25 Jan 2012 08:09:55 +0100 (CET)
Message-Id: <20120125.080955.373318824.wl@gnu.org>
To: hoffmann@usm.uni-muenchen.de
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20120123224556.GB16889@usm.uni-muenchen.de>
References: <20120105200628.GE13517@usm.uni-muenchen.de>
	<20120107.080217.159457058.wl@gnu.org>
	<20120123224556.GB16889@usm.uni-muenchen.de>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.22
Cc: groff@gnu.org
Subject: Re: [Groff] odd interaction between .bl and .(c in -me macros
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 07:10:09 -0000

>> Could you provide a patch which I can directly apply to the
>> groff CVS?
> 
> Attached.  Log message should probably include something to the
> effect of "make .bl work inside blocks" or so.

Applied, thanks!

> By the way, I've also figured out why the centering of wide blocks
> in the "me" macros does not work correctly: the macros change the
> line width to 6.0 inches, but the indent for blocks is computed in
> environment 1 which retains the default line width of 6.5
> inches. Thus, blocks get formatted to a width of 6 inches but are
> printed with an indent of .25 inches and thus stick out at the
> right. (I had originally thought that the indent was intentional
> (and we should therefore reduce the line width), but this appears
> not to be the case.)

This cries for another patch :-)

However, in case you are interested in helping, I need a GNU copyright
assignment since the number of patches you have provided over the
years already exceeds a non-trivial amount.  Sorry for the
inconvenience.


   Werner


======================================================================


Please email the following information to assign@gnu.org, and we
will send you the assignment form for your past and future changes.

Please use your full legal name (in ASCII characters) as the subject
line of the message.
----------------------------------------------------------------------
REQUEST: SEND FORM FOR PAST AND FUTURE CHANGES

[What is the name of the program or package you're contributing to?]


[Did you copy any files or text written by someone else in these changes?
Even if that material is free software, we need to know about it.]


[Do you have an employer who might have a basis to claim to own
your changes?  Do you attend a school which might make such a claim?]


[For the copyright registration, what country are you a citizen of?]


[What year were you born?]


[Please write your email address here.]


[Please write your postal address here.]





[Which files have you changed so far, and which new files have you written
so far?]


From MAILER-DAEMON Wed Jan 25 02:12:31 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rpx1z-0001PB-5d
	for mharc-groff@gnu.org; Wed, 25 Jan 2012 02:12:31 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33753)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rpx1w-0001P4-4g
	for groff@gnu.org; Wed, 25 Jan 2012 02:12:29 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rpx1r-0000aL-ND
	for groff@gnu.org; Wed, 25 Jan 2012 02:12:28 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:37856)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1Rpx1r-0000aH-BO
	for groff@gnu.org; Wed, 25 Jan 2012 02:12:23 -0500
Received: (qmail invoked by alias); 25 Jan 2012 07:12:20 -0000
Received: from 77.117.209.65.wireless.dyn.drei.com (EHLO localhost)
	[77.117.209.65]
	by mail.gmx.net (mp063) with SMTP; 25 Jan 2012 08:12:20 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX189RnBaQ/o9gtj2zAVJxvzEKU8vhc3MA5zMqX9tT9
	O6iXIUBebxLWZn
Date: Wed, 25 Jan 2012 08:12:15 +0100 (CET)
Message-Id: <20120125.081215.240730276.wl@gnu.org>
To: schwarze@usta.de
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20120122121830.GC15211@iris.usta.de>
References: <alpine.BSO.2.00.1201152021020.2282@morgaine.smi.sendmail.com>
	<20120122121830.GC15211@iris.usta.de>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: groff@gnu.org
Subject: Re: [Groff] XBD == "X/Open Base Definitions"
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 07:12:29 -0000

> Philip Guenther pointed out to me that the acronym "XBD" stands for
> "X/Open Base Definitions", not "X/Open System Interface Definitions",
> see for example:
> 
>   http://pubs.opengroup.org/onlinepubs/007908799/
> 
> Hence, i propose the following patch to mdoc(7).
> 
> If you agree with this, i will update mandoc(1) as well.

Applied, thanks.


    Werner


From MAILER-DAEMON Wed Jan 25 06:53:15 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rq1Pf-0003sp-92
	for mharc-groff@gnu.org; Wed, 25 Jan 2012 06:53:15 -0500
Received: from eggs.gnu.org ([140.186.70.92]:40943)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1Rq1PZ-0003sO-O3
	for groff@gnu.org; Wed, 25 Jan 2012 06:53:13 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1Rq1PU-0005fL-SQ
	for groff@gnu.org; Wed, 25 Jan 2012 06:53:09 -0500
Received: from srv052.fs-itsolutions.de ([83.151.25.206]:36257)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1Rq1PU-0005fA-L4
	for groff@gnu.org; Wed, 25 Jan 2012 06:53:04 -0500
Received: from localhost (localhost [127.0.0.1])
	by srv052.fs-itsolutions.de (Postfix) with ESMTP id 4953D14A0C3A
	for <groff@gnu.org>; Wed, 25 Jan 2012 12:53:01 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at srv052.fs-itsolutions.de
Received: from srv052.fs-itsolutions.de ([127.0.0.1])
	by localhost (srv052.fs-itsolutions.de [127.0.0.1]) (amavisd-new,
	port 10024) with ESMTP id cTp3LyGjpL9b for <groff@gnu.org>;
	Wed, 25 Jan 2012 12:53:00 +0100 (CET)
Received: from november.winter.de (p5B2BB13A.dip.t-dialin.net [91.43.177.58])
	by srv052.fs-itsolutions.de (Postfix) with ESMTPA id D291E14A0C13
	for <groff@gnu.org>; Wed, 25 Jan 2012 12:53:00 +0100 (CET)
Date: Wed, 25 Jan 2012 12:53:48 +0100
From: volker@volker-wolfram.de (Volker Wolfram)
To: groff@gnu.org
Message-ID: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
User-Agent: Heirloom mailx 12.4 7/29/08
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 83.151.25.206
Subject: [Groff] Turn text upside down
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 11:53:13 -0000

Hi all,

how can I turn text upside down, will say: rotate by 180 degrees?

Can anyone give an advice.

Regards,

echo "HUE\a"
-- 
Volker Wolfram
good old europe

We have joy we have fun
there's no LINUX in the SUN.


From MAILER-DAEMON Wed Jan 25 13:41:18 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rq7mY-0007ro-H8
	for mharc-groff@gnu.org; Wed, 25 Jan 2012 13:41:18 -0500
Received: from eggs.gnu.org ([140.186.70.92]:59779)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rq7mW-0007r2-AW
	for groff@gnu.org; Wed, 25 Jan 2012 13:41:17 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rq7mU-0005AA-Tp
	for groff@gnu.org; Wed, 25 Jan 2012 13:41:16 -0500
Received: from relay01.pair.com ([209.68.5.15]:4606)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1Rq7mU-00059u-Pj
	for groff@gnu.org; Wed, 25 Jan 2012 13:41:14 -0500
Received: (qmail 67389 invoked from network); 25 Jan 2012 18:41:12 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay01.pair.com with SMTP; 25 Jan 2012 18:41:12 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id A8CF820073; Wed, 25 Jan 2012 18:41:11 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 71A771FB9D;
	Wed, 25 Jan 2012 18:41:11 +0000 (GMT)
To: volker@volker-wolfram.de (Volker Wolfram)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
References: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
Comments: In-reply-to volker@volker-wolfram.de (Volker Wolfram) message dated
	"Wed, 25 Jan 2012 12:53:48 +0100."
Date: Wed, 25 Jan 2012 18:41:11 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120125184111.A8CF820073@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.68.5.15
Cc: groff@gnu.org
Subject: Re: [Groff] Turn text upside down
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: groff@gnu.org
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 18:41:17 -0000

Hi Volker,

> how can I turn text upside down, will say: rotate by 180 degrees?

Do you only need this for a particular output, e.g. Postscript?

Cheers, Ralph.


From MAILER-DAEMON Wed Jan 25 15:52:13 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rq9pF-0003yi-Ix
	for mharc-groff@gnu.org; Wed, 25 Jan 2012 15:52:13 -0500
Received: from eggs.gnu.org ([140.186.70.92]:48360)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1Rq9pD-0003yT-Nd
	for groff@gnu.org; Wed, 25 Jan 2012 15:52:12 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1Rq9pC-0008Lq-S6
	for groff@gnu.org; Wed, 25 Jan 2012 15:52:11 -0500
Received: from srv052.fs-itsolutions.de ([83.151.25.206]:43540)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1Rq9pC-0008Lh-HN
	for groff@gnu.org; Wed, 25 Jan 2012 15:52:10 -0500
Received: from localhost (localhost [127.0.0.1])
	by srv052.fs-itsolutions.de (Postfix) with ESMTP id 64C6C14A0C3A
	for <groff@gnu.org>; Wed, 25 Jan 2012 21:52:08 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at srv052.fs-itsolutions.de
Received: from srv052.fs-itsolutions.de ([127.0.0.1])
	by localhost (srv052.fs-itsolutions.de [127.0.0.1]) (amavisd-new,
	port 10024) with ESMTP id hT49ovO-3JMT for <groff@gnu.org>;
	Wed, 25 Jan 2012 21:52:08 +0100 (CET)
Received: from november.winter.de (p5B2BB13A.dip.t-dialin.net [91.43.177.58])
	by srv052.fs-itsolutions.de (Postfix) with ESMTPA id E7A2114A0C13
	for <groff@gnu.org>; Wed, 25 Jan 2012 21:52:07 +0100 (CET)
Date: Wed, 25 Jan 2012 21:52:56 +0100
From: volker@volker-wolfram.de (Volker Wolfram)
To: groff@gnu.org
Cc: groff@gnu.org
Message-ID: <4f206ba8.JelMHjjzqwvN8yxT%volker@volker-wolfram.de>
References: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
	<20120125184111.A8CF820073@orac.inputplus.co.uk>
In-Reply-To: <20120125184111.A8CF820073@orac.inputplus.co.uk>
User-Agent: Heirloom mailx 12.4 7/29/08
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 83.151.25.206
Subject: Re: [Groff] Turn text upside down
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 20:52:12 -0000

Ralph Corderoy <ralph@inputplus.co.uk> wrote:

> Hi Volker,
>
> > how can I turn text upside down, will say: rotate by 180 degrees?
>
> Do you only need this for a particular output, e.g. Postscript?
>
> Cheers, Ralph.
Hi all,

yes, my output is written in Postscript for printing pocketmods.

Can you give my any help?

Regards,

echo "HUE\a"
-- 
Volker Wolfram
good old europe

We have joy we have fun
there's no LINUX in the SUN.


From MAILER-DAEMON Wed Jan 25 16:23:44 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RqAJk-0000eU-BM
	for mharc-groff@gnu.org; Wed, 25 Jan 2012 16:23:44 -0500
Received: from eggs.gnu.org ([140.186.70.92]:58077)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RqAJh-0000d8-Th
	for groff@gnu.org; Wed, 25 Jan 2012 16:23:43 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RqAJg-0003qn-JR
	for groff@gnu.org; Wed, 25 Jan 2012 16:23:41 -0500
Received: from helix.usm.uni-muenchen.de ([129.187.204.86]:37504)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <hoffmann@usm.uni-muenchen.de>) id 1RqAJg-0003qL-9S
	for groff@gnu.org; Wed, 25 Jan 2012 16:23:40 -0500
Received: by helix.usm.uni-muenchen.de (Postfix, from userid 2097)
	id 576C01613051; Wed, 25 Jan 2012 22:23:37 +0100 (CET)
Date: Wed, 25 Jan 2012 22:23:37 +0100
From: Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
To: groff@gnu.org
Message-ID: <20120125212337.GC26388@usm.uni-muenchen.de>
References: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 129.187.204.86
Subject: Re: [Groff] Turn text upside down
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 21:23:43 -0000


> how can I turn text upside down, will say:
> rotate by 180 degrees?

As far as I know this can only be done with appropriate
device code.  And of course it depends on how much text you
want upside down.  Here is a little example in Postscript
that rotates a short text fragment within a line of text
(the fragment must fit on one line).  If you need larger
blocks I guess it would be better to have a start macro
(which translates and rotates the coordinate system) and an
end macro (which restores the original coordinate system)
instead of a single macro.


  .\"
  .\" --------------------------------------------------------------------
  .de UD
  .nr WD \w'\\$1'
  \Z'\h'\\n(WDu'\
  \X'ps: exec gsave currentpoint 2 copy \\n[.ps] u -.45 mul add \
  translate 180 rotate neg exch neg exch translate'\
  \\$1\
  \X'ps: exec grestore''\h'\\n(WDu'\\$2
  ..
  .\" --------------------------------------------------------------------
  .ll 15c
  .po 3c
  .sp 3c
  .ps 12
  .vs 14
  Hello,
  .UD world !


This particular example saves the old coordinate system and
then rotates the coordinate system around the current point:

  gsave
  currentpoint 2 copy
  translate
  180 rotate
  neg exch neg exch translate

and later restores the saved coordinate system:

  grestore

the rest is just trickery to keep the upside-down word in line.

If you want a whole page upside down, it would of course be
easier to rotate 180 degrees around one corner and then move
the coordinate origin to the opposite corner.




From MAILER-DAEMON Wed Jan 25 17:04:54 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RqAxa-0000H1-2q
	for mharc-groff@gnu.org; Wed, 25 Jan 2012 17:04:54 -0500
Received: from eggs.gnu.org ([140.186.70.92]:59734)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.demon.co.uk>) id 1RqAxX-0000Gr-Fb
	for groff@gnu.org; Wed, 25 Jan 2012 17:04:52 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <deri@chuzzlewit.demon.co.uk>) id 1RqAxV-0001Mh-Hu
	for groff@gnu.org; Wed, 25 Jan 2012 17:04:51 -0500
Received: from chuzzlewit.demon.co.uk ([80.177.169.146]:56599
	helo=dombey.localdomain) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.demon.co.uk>) id 1RqAxV-0001MQ-8L
	for groff@gnu.org; Wed, 25 Jan 2012 17:04:49 -0500
Received: by dombey.localdomain (Postfix, from userid 500)
	id E81D022AE5; Wed, 25 Jan 2012 22:04:46 +0000 (GMT)
From: Deri James <deri@chuzzlewit.demon.co.uk>
To: groff@gnu.org
Date: Wed, 25 Jan 2012 22:04:46 +0000
User-Agent: KMail/1.13.7 (Linux/2.6.38.8-desktop-9.mga; KDE/4.6.5; x86_64; ; )
References: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
	<20120125184111.A8CF820073@orac.inputplus.co.uk>
	<4f206ba8.JelMHjjzqwvN8yxT%volker@volker-wolfram.de>
In-Reply-To: <4f206ba8.JelMHjjzqwvN8yxT%volker@volker-wolfram.de>
MIME-Version: 1.0
Content-Type: Text/Plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <201201252204.46860.deri@chuzzlewit.demon.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 80.177.169.146
Cc: Volker Wolfram <volker@volker-wolfram.de>
Subject: Re: [Groff] Turn text upside down
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Jan 2012 22:04:53 -0000

On Wednesday 25 Jan 2012 20:52:56 Volker Wolfram wrote:
> Ralph Corderoy <ralph@inputplus.co.uk> wrote:
> > Hi Volker,
> > 
> > > how can I turn text upside down, will say: rotate by 180 degrees?
> > 
> > Do you only need this for a particular output, e.g. Postscript?
> > 
> > Cheers, Ralph.
> 
> Hi all,
> 
> yes, my output is written in Postscript for printing pocketmods.
> 
> Can you give my any help?
> 
> Regards,
> 
> echo "HUE\a"

There is a way using pic and the Greetings Card example from Ted in the list 
archives for 29th December 2009 gives an example. Basically draw an invisible 
line and align your text with it:-

.sp 2i
.PS
line invis from (2,2) to (1,2) "Hello" aligned
.PE

(use "groff -p" to run it).

Cheers 

Deri


From MAILER-DAEMON Thu Jan 26 14:53:52 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RqVOK-0002Fh-0h
	for mharc-groff@gnu.org; Thu, 26 Jan 2012 14:53:52 -0500
Received: from [140.186.70.92] (port=37295 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RqVOH-0002EP-Ai
	for groff@gnu.org; Thu, 26 Jan 2012 14:53:50 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RqVOB-0007Jz-Iz
	for groff@gnu.org; Thu, 26 Jan 2012 14:53:44 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:36712)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RqVOB-0007Jk-Dw
	for groff@gnu.org; Thu, 26 Jan 2012 14:53:43 -0500
Received: by bkbzx1 with SMTP id zx1so931891bkb.0
	for <groff@gnu.org>; Thu, 26 Jan 2012 11:53:40 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type;
	bh=hz2dOLTMTGH3raaNil4c30JHdaZDO6ZPUmvzoM65SEM=;
	b=elM9yDhvj/QLVIXl1PiLyFS8AVcikxxQP1y/mQHbJqYiwOi7ZlsvLVOVlnBIfbK/6A
	NUeNYbRSs+6QN1NAUfWbWWFHct43fja2762gTIEg2bfK7UshsomNfhL32RWHeenQk3sK
	6SRXWS+NbryYuLAny8vQgTn0wXihjJ3VxyUIM=
Received: by 10.204.200.197 with SMTP id ex5mr1624241bkb.128.1327607620822;
	Thu, 26 Jan 2012 11:53:40 -0800 (PST)
Received: from ANT ([95.73.239.57])
	by mx.google.com with ESMTPS id d2sm11029186bky.11.2012.01.26.11.53.34
	(version=TLSv1/SSLv3 cipher=OTHER);
	Thu, 26 Jan 2012 11:53:40 -0800 (PST)
Date: Thu, 26 Jan 2012 23:53:26 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Ken Mandelberg <km@mathcs.emory.edu>
Message-Id: <20120126235326.6f3131f20d92bfd631f7130f@gmail.com>
In-Reply-To: <4F1A00F7.9080009@mathcs.emory.edu>
References: <4F1A00F7.9080009@mathcs.emory.edu>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: multipart/mixed;
	boundary="Multipart=_Thu__26_Jan_2012_23_53_26_+0400_GUZLHvNxTgyMDii_"
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 26 Jan 2012 19:53:50 -0000

This is a multi-part message in MIME format.

--Multipart=_Thu__26_Jan_2012_23_53_26_+0400_GUZLHvNxTgyMDii_
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

Hello, John

I  don't  have access to any other implementation of
troff than groff, but I have  consulted  "The  Docu-
menter's  Workbench",  and  it seems that groff's mm
signature macros have incompatibilities more serious
than the omission of the title, and some errors too.
For example, it prints the AU attributes only before
the  last author's name, repeating (due to a typo in
the macro) his initials as many times as  there  are
authors, instead of listing those of each author...

Would you please send me the -Tascii and -Tps output
generated from the attached source file  so  that  I
could see what the result should look like?

Anton

--Multipart=_Thu__26_Jan_2012_23_53_26_+0400_GUZLHvNxTgyMDii_
Content-Type: application/x-freemind;
 name="sign.mm"
Content-Disposition: attachment;
 filename="sign.mm"
Content-Transfer-Encoding: base64

Lndhcm4NCi5UTCAiQW50b24ncyB0aXRsZSINCi5NVCA1DQouQVUgIkkuIFNtaXRoIiBJUyBZVyBE
MQ0KLkFUIENFTw0KLkFVICJKLiBCdXJrZSIgSkIgQVIgRDINCi5BVCBDRU8xICJhbHNvIE9FQzEi
DQouQVUgIksuIFdpbGxpcyIgS1cgTU8gRDMNCi5BVCBDRU8yDQouUA0KdGVzdGluZw0KLkZDDQou
U0c=

--Multipart=_Thu__26_Jan_2012_23_53_26_+0400_GUZLHvNxTgyMDii_--


From MAILER-DAEMON Thu Jan 26 15:43:30 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RqWAM-0002bX-1m
	for mharc-groff@gnu.org; Thu, 26 Jan 2012 15:43:30 -0500
Received: from [140.186.70.92] (port=37381 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1RqWAK-0002ad-2E
	for groff@gnu.org; Thu, 26 Jan 2012 15:43:28 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1RqWAD-0005Kg-54
	for groff@gnu.org; Thu, 26 Jan 2012 15:43:22 -0500
Received: from srv052.fs-itsolutions.de ([83.151.25.206]:58326)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <volker@volker-wolfram.de>) id 1RqWAD-0005JA-0R
	for groff@gnu.org; Thu, 26 Jan 2012 15:43:21 -0500
Received: from localhost (localhost [127.0.0.1])
	by srv052.fs-itsolutions.de (Postfix) with ESMTP id 474C114A0C41;
	Thu, 26 Jan 2012 21:42:58 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at srv052.fs-itsolutions.de
Received: from srv052.fs-itsolutions.de ([127.0.0.1])
	by localhost (srv052.fs-itsolutions.de [127.0.0.1]) (amavisd-new,
	port 10024)
	with ESMTP id xddPD2hd-pzD; Thu, 26 Jan 2012 21:42:58 +0100 (CET)
Received: from november.winter.de (p5B2BDC2C.dip.t-dialin.net [91.43.220.44])
	by srv052.fs-itsolutions.de (Postfix) with ESMTPA id E416914A0C3E;
	Thu, 26 Jan 2012 21:42:57 +0100 (CET)
Date: Thu, 26 Jan 2012 21:43:49 +0100
From: volker@volker-wolfram.de (Volker Wolfram)
To: groff@gnu.org, deri@chuzzlewit.demon.co.uk
Message-ID: <4f21bb05.XIsR4/ZK9a7iaXmC%volker@volker-wolfram.de>
References: <4f1fed4c.6R7BURQZnMR01Q4a%volker@volker-wolfram.de>
	<20120125184111.A8CF820073@orac.inputplus.co.uk>
	<4f206ba8.JelMHjjzqwvN8yxT%volker@volker-wolfram.de>
	<201201252204.46860.deri@chuzzlewit.demon.co.uk>
In-Reply-To: <201201252204.46860.deri@chuzzlewit.demon.co.uk>
User-Agent: Heirloom mailx 12.4 7/29/08
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 83.151.25.206
Subject: Re: [Groff] Turn text upside down
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 26 Jan 2012 20:43:28 -0000

Deri James <deri@chuzzlewit.demon.co.uk> wrote:

> On Wednesday 25 Jan 2012 20:52:56 Volker Wolfram wrote:
> > Ralph Corderoy <ralph@inputplus.co.uk> wrote:
> > > Hi Volker,
> > > 
> > > > how can I turn text upside down, will say: rotate by 180 degrees?
> > > 
> > > Do you only need this for a particular output, e.g. Postscript?
> > > 
> > > Cheers, Ralph.
> > 
> > Hi all,
> > 
> > yes, my output is written in Postscript for printing pocketmods.
> > 
> > Can you give my any help?
> > 
> > Regards,
> > 
> > echo "HUE\a"
>
> There is a way using pic and the Greetings Card example from Ted in the list 
> archives for 29th December 2009 gives an example. Basically draw an invisible 
> line and align your text with it:-
>
> .sp 2i
> .PS
> line invis from (2,2) to (1,2) "Hello" aligned
> .PE
>
> (use "groff -p" to run it).
>
> Cheers 
>
> Deri
Hi all,

I can't fix my pocketmod with Deri's hint. It won't do a absolute positioning.

Can anyone help me.

See you,

echo "HUE\a"
-- 
Volker Wolfram
good old europe

We have joy we have fun
there's no LINUX in the SUN.


From MAILER-DAEMON Sat Jan 28 09:27:41 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Rr9Fl-0008V4-BB
	for mharc-groff@gnu.org; Sat, 28 Jan 2012 09:27:41 -0500
Received: from eggs.gnu.org ([140.186.70.92]:40588)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rinkworks@gmail.com>) id 1Rr9Ff-0008Up-0i
	for groff@gnu.org; Sat, 28 Jan 2012 09:27:39 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <rinkworks@gmail.com>) id 1Rr9Fb-0003SB-0M
	for groff@gnu.org; Sat, 28 Jan 2012 09:27:34 -0500
Received: from mail-vx0-f169.google.com ([209.85.220.169]:49455)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rinkworks@gmail.com>) id 1Rr9Fa-0003S5-S0
	for groff@gnu.org; Sat, 28 Jan 2012 09:27:30 -0500
Received: by vcbfl11 with SMTP id fl11so2181617vcb.0
	for <groff@gnu.org>; Sat, 28 Jan 2012 06:27:29 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:date:message-id:subject:from:to:content-type;
	bh=cE2jLqCGYyX+kc4X96gVzHwF+hxuZ2eHpDb9DjuhfxA=;
	b=cw5CBEZulqfHBmmujWKDs2rIFZe1vR+ySraGCzvu7Rm0q2snhNJTitjwbO8lk4JJ/N
	6TvOJparKlRwv55kw9tuHoeNBThjdjYt6tKVOLWucpK3X11XZf/Vez7N7n67OKArvGT8
	4NuPwzzSwwa3aIZuCCCTJjp/biPYvLRFj44vE=
MIME-Version: 1.0
Received: by 10.220.226.138 with SMTP id iw10mr5711048vcb.64.1327760849056;
	Sat, 28 Jan 2012 06:27:29 -0800 (PST)
Received: by 10.52.38.233 with HTTP; Sat, 28 Jan 2012 06:27:29 -0800 (PST)
Date: Sat, 28 Jan 2012 09:27:29 -0500
Message-ID: <CAOKAThAPu2hKxmmF9Kbx-j2PHk-1TDA97DrH6qj_0yaRq4k=0Q@mail.gmail.com>
From: Samuel Stoddard <rinkworks@gmail.com>
To: groff@gnu.org
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.220.169
Content-Type: text/plain; charset=ISO-8859-1
X-Content-Filtered-By: Mailman/MimeDel 2.1.14
Subject: [Groff] mom headers not showing up
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 28 Jan 2012 14:27:39 -0000

Hi!  I've been struggling for quite some time trying to get mom headers to
display.  What kills me is that I'm pretty sure this used to work, and only
stopped working once I upgraded my machine, so I'm suspecting a change to
the way mom works.  But whether it's that or not, this isn't working.
(groff, grops, and troff are all version 1.20.1.)

What happens is that I generate a postscript file, then convert that to a
PDF, and I see the HEADER_RULE and the space reserved for a header, but no
actual text in the header itself.  You can see the results at
http://www.rinkworks.com/bad_headers.ps and
http://www.rinkworks.com/bad_headers.pdf.  If you look at pages 2-4, you'll
see the header rules, with the recto/verso margins correctly observed.  But
no actual text.

Here is the groff source:

.TITLE "My Title"
.AUTHOR "Me"
.PRINTSTYLE TYPESET
.COPYSTYLE FINAL
\#
\# Margins.
\#
.T_MARGIN .75i
.B_MARGIN .75i
.L_MARGIN 1.0i
.R_MARGIN .75i
\#
\# Don't use mom cover pages.
\#
.DOC_COVERS OFF
.COVERS OFF
.DOCHEADER OFF
\#
\# Don't use page numbers.
\#
.PAGENUM_HYPHENS OFF
.PAGINATE OFF
\#
\# Alternate pages.
\#
.L_MARGIN 1.0i
.R_MARGIN .75i
.RECTO_VERSO
.HEADER_RECTO LEFT "RECTO HEADER"
.HEADER_VERSO LEFT "VERSO HEADER"
.HEADER_SIZE -2
\#
\# Margins for body.
\#
.HEADER_MARGIN .75i-12p
.T_MARGIN .75i-12p+3P
.FOOTER_MARGIN 0
\#
\# Let's roll.
\#
.HEADERS
.START

blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
.NEWPAGE
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
.NEWPAGE
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
.NEWPAGE
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah
blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah


Does anybody have any idea what's going on here?  If it helps, here are my
commands for generating the postscript and PDF files:

groff -U -Ww -p -mwww -mom < bad_headers.t > bad_headers.ps
/usr/bin/ps2pdf13 -dPDFSETTINGS=/prepress -dAutoFilterColorImages=false
-dColorImageFilter=/FlateEncode -dMaxInlineImageSize=50000000 - - <
bad_headers.ps > bad_headers.pdf

Thanks in advance for any assistance you can offer!  In particular, my
forehead will appreciate not being banged into walls any more.

-- Sam.

From MAILER-DAEMON Sat Jan 28 15:13:36 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RrEeW-0008EO-7B
	for mharc-groff@gnu.org; Sat, 28 Jan 2012 15:13:36 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33724)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=PDtS27=AH=schaffter.ca=peter@eigbox.net>)
	id 1RrEeT-0008EI-Lc
	for groff@gnu.org; Sat, 28 Jan 2012 15:13:34 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <SRS0=PDtS27=AH=schaffter.ca=peter@eigbox.net>)
	id 1RrEeR-0002gN-D2
	for groff@gnu.org; Sat, 28 Jan 2012 15:13:33 -0500
Received: from bosmailout15.eigbox.net ([66.96.190.15]:52916)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <SRS0=PDtS27=AH=schaffter.ca=peter@eigbox.net>)
	id 1RrEeR-0002g9-AO
	for groff@gnu.org; Sat, 28 Jan 2012 15:13:31 -0500
Received: from bosmailscan16.eigbox.net ([10.20.15.16])
	by bosmailout15.eigbox.net with esmtp (Exim) id 1RrEAC-0004s2-Ei
	for groff@gnu.org; Sat, 28 Jan 2012 14:42:16 -0500
Received: from bosimpout01.eigbox.net ([10.20.55.1])
	by bosmailscan16.eigbox.net with esmtp (Exim) id 1RrEAB-0003Ps-AR
	for groff@gnu.org; Sat, 28 Jan 2012 14:42:15 -0500
Received: from bosauthsmtp13.eigbox.net ([10.20.18.13])
	by bosimpout01.eigbox.net with NO UCE
	id T7iF1i0070GvDVm017iFKU; Sat, 28 Jan 2012 14:42:15 -0500
X-EN-OrigOutIP: 10.20.18.13
X-EN-IMPSID: T7iF1i0070GvDVm017iFKU
Received: from bas1-ottawa09-2925287095.dsl.bell.ca ([174.92.86.183]
	helo=augustus)
	by bosauthsmtp13.eigbox.net with esmtpsa (TLSv1:AES256-SHA:256)
	(Exim) id 1RrEAC-0004iA-07
	for groff@gnu.org; Sat, 28 Jan 2012 14:42:16 -0500
Received: from peter by augustus with local (Exim 4.76)
	(envelope-from <peter@schaffter.ca>) id 1RrEA9-0001dG-Jm
	for groff@gnu.org; Sat, 28 Jan 2012 14:42:13 -0500
Date: Sat, 28 Jan 2012 14:42:12 -0500
From: Peter Schaffter <peter@schaffter.ca>
To: groff@gnu.org
Message-ID: <20120128194212.GA6033@augustus>
Mail-Followup-To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
References: <CAOKAThAPu2hKxmmF9Kbx-j2PHk-1TDA97DrH6qj_0yaRq4k=0Q@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <CAOKAThAPu2hKxmmF9Kbx-j2PHk-1TDA97DrH6qj_0yaRq4k=0Q@mail.gmail.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-EN-UserInfo: de950a90bfbefba2fd690f5ecdd2f718:712911bb6d01017077352c3c8e2e335d
X-EN-AuthUser: peter@schaffter.ca
Sender: Peter Schaffter <peter@schaffter.ca>
X-EN-OrigIP: 174.92.86.183
X-EN-OrigHost: bas1-ottawa09-2925287095.dsl.bell.ca
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2)
X-Received-From: 66.96.190.15
Subject: Re: [Groff] mom headers not showing up
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 28 Jan 2012 20:13:34 -0000

Sam --

On Sat, Jan 28, 2012, Samuel Stoddard wrote:
> Hi!  I've been struggling for quite some time trying to get mom headers to
> display.  What kills me is that I'm pretty sure this used to work, and only
> stopped working once I upgraded my machine, so I'm suspecting a change to
> the way mom works.  But whether it's that or not, this isn't working.
> (groff, grops, and troff are all version 1.20.1.)

Which version of mom are you using?  When I process your source with the
latest version (1.6-a), the headers are fine.

You can find out which mom version you're using with

  grep "Version *[-0-9.a-z]*" om.tmac

om.tmac lives in /usr/share/groff/1.21/tmac/

If you're not using 1.6-a, you can download it from

  http://www.schaffter.ca/mom/mom-1.6-a.tar.gz

Alternatively, you can download and build the latest groff sources
from the repository, which always include the most recent version of
mom.

-- 
Peter Schaffter

Author of The Binbrook Caucus
http://www.schaffter.ca


From MAILER-DAEMON Sat Jan 28 16:58:37 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RrGI9-0002G9-8r
	for mharc-groff@gnu.org; Sat, 28 Jan 2012 16:58:37 -0500
Received: from eggs.gnu.org ([140.186.70.92]:48387)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RrGI7-0002G2-44
	for groff@gnu.org; Sat, 28 Jan 2012 16:58:36 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RrGI6-0007EA-4x
	for groff@gnu.org; Sat, 28 Jan 2012 16:58:35 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:35216)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RrGI5-0007E5-Q0
	for groff@gnu.org; Sat, 28 Jan 2012 16:58:34 -0500
Received: by bkbzs2 with SMTP id zs2so1608567bkb.0
	for <groff@gnu.org>; Sat, 28 Jan 2012 13:58:32 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type;
	bh=drNCVQ2TZ2O1o0EEDZESLa9gyF2gBNpQLTkC+n2yBAg=;
	b=xm8KP7nseIig02nr9HsUhuC2QG+cKHp9QDtoeysoQk3oLoCEOZycV53w9RgkL/5sc/
	wlsXZMl5g6vgjSnUV4QyfwBhqlP199B9beS6dhdpZE/3+bBgwAUsh/W7B9aY8Jr4kxgS
	uQaDgsfUaNLwmorHomyLrPUsmtNIyhPFcQWz4=
Received: by 10.204.148.73 with SMTP id o9mr5892733bkv.46.1327787912144;
	Sat, 28 Jan 2012 13:58:32 -0800 (PST)
Received: from ANT ([95.72.112.190])
	by mx.google.com with ESMTPS id ek9sm25825353bkb.10.2012.01.28.13.58.26
	(version=TLSv1/SSLv3 cipher=OTHER);
	Sat, 28 Jan 2012 13:58:30 -0800 (PST)
Date: Sun, 29 Jan 2012 01:58:31 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Ken Mandelberg <km@mathcs.emory.edu>
Message-Id: <20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
In-Reply-To: <4F1A00F7.9080009@mathcs.emory.edu>
References: <4F1A00F7.9080009@mathcs.emory.edu>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: multipart/mixed;
	boundary="Multipart=_Sun__29_Jan_2012_01_58_31_+0400_sM8RgvkOKysElyUi"
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 28 Jan 2012 21:58:36 -0000

This is a multi-part message in MIME format.

--Multipart=_Sun__29_Jan_2012_01_58_31_+0400_sM8RgvkOKysElyUi
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

Ken Mandelberg:

> It  seems  like  AU/AT  with  the MM macros is not
> working properly.
>
> Here is a simple test
>
>    .AU "John Smith"
>    .AT "CEO"
>    .MT 5
>    .P
>    testing
>    .FC
>    .SG
>    .br
>
> [...]
>
> So the AT title string never comes out, and  there
> is an extraneous "--"

Please,  check  if the attached patch has fixed your
problem.  Bear in mind, that I only did  symptomatic
treatment, and it still does not work correctly with
more than one author.

Anton

--Multipart=_Sun__29_Jan_2012_01_58_31_+0400_sM8RgvkOKysElyUi
Content-Type: text/plain;
 name="m.tmac.diff"
Content-Disposition: attachment;
 filename="m.tmac.diff"
Content-Transfer-Encoding: 7bit

--- m.tmac	2012-01-29 01:40:29.781250000 +0400
+++ m1.tmac	2012-01-29 01:47:40.406250000 +0400
@@ -3288,31 +3288,54 @@
 .\}
 ..
 .\"------------------------
+.\" Helper macro: assign string $2 to string $1 with separator $3
+.de ASS
+.   if !d \\$1 \{\
+.      ds sep-\\$1
+.      ds \\$1
+.   \}
+.   if d \\$2 .as \\$1 \\*[sep-\\$1]\\*[\\$2]
+.   ds sep-\\$1 \\$3
+..
 .\" Memorandum signature
 .de let*mt-sign
 .df@print-float 3
-.ne \\n[cov*au]u*4v
+.di di-sgn
 .ie \\n[.$]>1 .nr let*k 1
 .el .nr let*k \\n[cov*au]
-.ds let*tmp \\*[cov*au!\\n[let*k]!3]-\\*[cov*au!\\n[let*k]!4]-
+.\" Concatenate attributes of the last author:
+.ASS let*tmp cov*au!\\n[let*k]!3 -
+.ASS let*tmp cov*au!\\n[let*k]!4 -
 .nr let*i 0 1
-.while \\n+[let*i]<=\\n[cov*au] \{\
-.	if \\n[let*i]>1 .as let*tmp /
-.	as let*tmp \\*[cov*au!\\n[let*k]!2]
-.\}
+.\" Collect authors' initials:
+.while \\n+[let*i]<=\\n[cov*au] .ASS let*tmp cov*au!\\n[let*i]!2 "/"
 .if !''\\$1' .as let*tmp -\\$1
+.nr i-old \\n[.i]u
 .in (u;\\n[.l]/2)
 .nf
 .nr let*i 0 1
+.\" Loop through authors:
 .while \\n+[let*i]<=\\n[cov*au] \{\
-.	SP 3v
-.	if \\n[let*i]=\\n[let*k] \{\
+.  SP 3v
+.  if \\n[let*i]=\\n[let*k] \{\
 \Z'\h'-(u;\\n[.l]/2)'\\*[let*tmp]'\c
-.	\}
+.  \}
 \\*[cov*au!\\n[let*i]!1]
+.\" Print author's titles, one per line:
+.  nr cov*j 0 1
+.  while \\n+[cov*j]<=9 \{\
+.     br
+.     if d cov*at!\\n[let*i]!\\n[cov*j] \\*[cov*at!\\n[let*i]!\\n[cov*j]]
+.  \}
 .\}
+.di
+.ne \\n[dn]u
+.in 0
+.di-sgn
+.ch di-sgn
 .fi
-.in
+.in \\n[i-old]u
+.rr i-old
 ..
 .\"------------------------
 .\" Approval signature

--Multipart=_Sun__29_Jan_2012_01_58_31_+0400_sM8RgvkOKysElyUi--


From MAILER-DAEMON Sun Jan 29 10:24:24 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RrWcB-00024h-SN
	for mharc-groff@gnu.org; Sun, 29 Jan 2012 10:24:23 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33152)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rinkworks@gmail.com>) id 1RrWc9-00024b-5t
	for groff@gnu.org; Sun, 29 Jan 2012 10:24:22 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <rinkworks@gmail.com>) id 1RrWc6-0005V9-8f
	for groff@gnu.org; Sun, 29 Jan 2012 10:24:21 -0500
Received: from mail-vx0-f169.google.com ([209.85.220.169]:39454)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rinkworks@gmail.com>) id 1RrWc6-0005V4-6H
	for groff@gnu.org; Sun, 29 Jan 2012 10:24:18 -0500
Received: by vcbfl11 with SMTP id fl11so2576523vcb.0
	for <groff@gnu.org>; Sun, 29 Jan 2012 07:24:17 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:content-type; bh=km8m4nZaDFyXYfWJHSzTbftGXFU1rTvakqhJQqDbM8U=;
	b=YWO+/Xj0b3w1a1galCk5LXyfv4lcANufEof1xd1Ccwr7GsqPmrNP43Vh3qH7Q3mJuV
	vTK5ygTgfypu6PuzXNBseZLNiOcv39lbPX3/FnNcbSHTh9brs3j9gyI7ewTQ/wGSxYBt
	tU3+3gIgRC6sQg5kXAVsDazeHHMy36XooKehw=
MIME-Version: 1.0
Received: by 10.220.153.144 with SMTP id k16mr1298233vcw.59.1327850657415;
	Sun, 29 Jan 2012 07:24:17 -0800 (PST)
Received: by 10.52.38.233 with HTTP; Sun, 29 Jan 2012 07:24:17 -0800 (PST)
In-Reply-To: <20120128194212.GA6033@augustus>
References: <CAOKAThAPu2hKxmmF9Kbx-j2PHk-1TDA97DrH6qj_0yaRq4k=0Q@mail.gmail.com>
	<20120128194212.GA6033@augustus>
Date: Sun, 29 Jan 2012 10:24:17 -0500
Message-ID: <CAOKAThDeWL2x5QW=R64f-8VRWd=U13iz2iChUF0r=hX6_-9QgQ@mail.gmail.com>
From: Samuel Stoddard <rinkworks@gmail.com>
To: Peter Schaffter <peter@schaffter.ca>, groff@gnu.org
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.220.169
Content-Type: text/plain; charset=ISO-8859-1
X-Content-Filtered-By: Mailman/MimeDel 2.1.14
Subject: Re: [Groff] mom headers not showing up
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 29 Jan 2012 15:24:22 -0000

>
> > Hi!  I've been struggling for quite some time trying to get mom headers
> to
> > display.  What kills me is that I'm pretty sure this used to work, and
> only
> > stopped working once I upgraded my machine, so I'm suspecting a change to
> > the way mom works.  But whether it's that or not, this isn't working.
> > (groff, grops, and troff are all version 1.20.1.)
>
> Which version of mom are you using?  When I process your source with the
> latest version (1.6-a), the headers are fine.
>

Thank you so much!  Such a simple problem, in retrospect, but I wouldn't
have figured this out.  I'd been using 1.5-c.  Swapping it out for 1.6-a,
which itself was an easier task than I'd thought, did the trick.  Thank you!

From MAILER-DAEMON Tue Jan 31 09:42:27 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RsEuh-00041Q-TJ
	for mharc-groff@gnu.org; Tue, 31 Jan 2012 09:42:27 -0500
Received: from eggs.gnu.org ([140.186.70.92]:33692)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RsEuf-00040x-Kq
	for groff@gnu.org; Tue, 31 Jan 2012 09:42:26 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RsEub-000399-E8
	for groff@gnu.org; Tue, 31 Jan 2012 09:42:25 -0500
Received: from ndb-mr2.cc.emory.edu ([170.140.52.250]:59111)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RsEub-00038X-4J
	for groff@gnu.org; Tue, 31 Jan 2012 09:42:21 -0500
Received: from [192.168.10.22] (emoryfloatdmz.cc.emory.edu [170.140.52.254])
	(authenticated bits=0)
	by ndb-mr2.cc.emory.edu (8.13.8/8.13.1) with ESMTP id q0VEgEfa000426
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Tue, 31 Jan 2012 09:42:14 -0500
Message-ID: <4F27FDC6.400@mathcs.emory.edu>
Date: Tue, 31 Jan 2012 09:42:14 -0500
From: Ken Mandelberg <km@mathcs.emory.edu>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.25) Gecko/20111214 Lightning/1.0b2 Thunderbird/3.1.17
MIME-Version: 1.0
To: Anton Shepelev <anton.txt@gmail.com>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120126235326.6f3131f20d92bfd631f7130f@gmail.com>
In-Reply-To: <20120126235326.6f3131f20d92bfd631f7130f@gmail.com>
Content-Type: multipart/mixed; boundary="------------040800050802040001090103"
X-Emory-MailScanner-Information: Please contact the ISP for more information
X-Emory-MailScanner-ID: q0VEgEfa000426
X-Emory-MailScanner: Found to be clean
X-Emory-MailScanner-SpamCheck: not spam, SpamAssassin (not cached,
	score=1.99, required 8, autolearn=disabled, SMTP_AUTH 2.00,
	T_RP_MATCHES_RCVD -0.01)
X-Emory-MailScanner-SpamScore: s
X-Emory-MailScanner-From: km@mathcs.emory.edu
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 170.140.52.250
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Jan 2012 14:42:26 -0000

This is a multi-part message in MIME format.
--------------040800050802040001090103
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

Anton Shepelev wrote, On 01/26/2012 02:53 PM:
>
> I  don't  have access to any other implementation of
> troff than groff, but I have  consulted  "The  Docu-
> menter's  Workbench",  and  it seems that groff's mm
> signature macros have incompatibilities more serious
> than the omission of the title, and some errors too.
> For example, it prints the AU attributes only before
> the  last author's name, repeating (due to a typo in
> the macro) his initials as many times as  there  are
> authors, instead of listing those of each author...
>
> Would you please send me the -Tascii and -Tps output
> generated from the attached source file  so  that  I
> could see what the result should look like?
>
> Anton

Anton

To run this test I needed to modify sign.mm to place the ".MT 5" after 
the other directives. I haven't checked the original DWB documentation, 
but in the Gehani book "Document Formatting and Typesetting on the Unix 
system" this order is documented. With the MT earlier troff gets into an 
infinite "brk" loop trying to allocate memory.

I've attached the ascii and postscript output. It gets the multiple 
authors and author titles right, but makes a mess of the document title. 
I suspect the latter is too Bell Labs specific.

Ken


--------------040800050802040001090103
Content-Type: text/plain;
 name="sign.ascii"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="sign.ascii"





       s title')&(0) .ie'Anton's title'' .br
       Charge and Filing Case Anton's title
       s title'=0):(0=0) .ie120s title' - Case Anton's title





                                                    January 31, 2012


       testing

                                     Yours very truly,



                                     I. Smith
                                     CEO



                                     J. Burke
                                     CEO1
                                     also OEC1



                                     K. Willis
                                     CEO2

































--------------040800050802040001090103
Content-Type: application/postscript;
 name="sign.ps"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="sign.ps"

%!PS
%%Version: 3.3.1
%%DocumentFonts: (atend)
%%Pages: (atend)
%%EndComments
%
% Version 3.3.1 prologue for troff files.
%

/#copies 1 store
/aspectratio 1 def
/formsperpage 1 def
/landscape false def
/linewidth .3 def
/magnification 1 def
/margin 0 def
/orientation 0 def
/resolution 720 def
/rotation 1 def
/xoffset 0 def
/yoffset 0 def

/roundpage true def
/useclippath true def
/pagebbox [0 0 612 792] def

/R  /Times-Roman def
/I  /Times-Italic def
/B  /Times-Bold def
/BI /Times-BoldItalic def
/H  /Helvetica def
/HI /Helvetica-Oblique def
/HB /Helvetica-Bold def
/HX /Helvetica-BoldOblique def
/CW /Courier def
/CO /Courier def
/CI /Courier-Oblique def
/CB /Courier-Bold def
/CX /Courier-BoldOblique def
/PA /Palatino-Roman def
/PI /Palatino-Italic def
/PB /Palatino-Bold def
/PX /Palatino-BoldItalic def
/Hr /Helvetica-Narrow def
/Hi /Helvetica-Narrow-Oblique def
/Hb /Helvetica-Narrow-Bold def
/Hx /Helvetica-Narrow-BoldOblique def
/KR /Bookman-Light def
/KI /Bookman-LightItalic def
/KB /Bookman-Demi def
/KX /Bookman-DemiItalic def
/AR /AvantGarde-Book def
/AI /AvantGarde-BookOblique def
/AB /AvantGarde-Demi def
/AX /AvantGarde-DemiOblique def
/NR /NewCenturySchlbk-Roman def
/NI /NewCenturySchlbk-Italic def
/NB /NewCenturySchlbk-Bold def
/NX /NewCenturySchlbk-BoldItalic def
/ZD /ZapfDingbats def
/ZI /ZapfChancery-MediumItalic def
/S  /S def
/S1 /S1 def
/GR /Symbol def

/inch {72 mul} bind def
/min {2 copy gt {exch} if pop} bind def

/setup {
	counttomark 2 idiv {def} repeat pop

	landscape {/orientation 90 orientation add def} if
	/scaling 72 resolution div def
	linewidth setlinewidth
	1 setlinecap

	pagedimensions
	xcenter ycenter translate
	orientation rotation mul rotate
	width 2 div neg height 2 div translate
	xoffset inch yoffset inch neg translate
	margin 2 div dup neg translate
	magnification dup aspectratio mul scale
	scaling scaling scale

	addmetrics
	0 0 moveto
} def

/pagedimensions {
	useclippath userdict /gotpagebbox known not and {
		/pagebbox [clippath pathbbox newpath] def
		roundpage currentdict /roundpagebbox known and {roundpagebbox} if
	} if
	pagebbox aload pop
	4 -1 roll exch 4 1 roll 4 copy
	landscape {4 2 roll} if
	sub /width exch def
	sub /height exch def
	add 2 div /xcenter exch def
	add 2 div /ycenter exch def
	userdict /gotpagebbox true put
} def

/addmetrics {
	/Symbol /S null Sdefs cf
	/Times-Roman /S1 StandardEncoding dup length array copy S1defs cf
} def

/pagesetup {
	/page exch def
	currentdict /pagedict known currentdict page known and {
		page load pagedict exch get cvx exec
	} if
} def

/decodingdefs [
	{counttomark 2 idiv {y moveto show} repeat}
	{neg /y exch def counttomark 2 idiv {y moveto show} repeat}
	{neg moveto {2 index stringwidth pop sub exch div 0 32 4 -1 roll widthshow} repeat}
	{neg moveto {spacewidth sub 0.0 32 4 -1 roll widthshow} repeat}
	{counttomark 2 idiv {y moveto show} repeat}
	{neg setfunnytext}
] def

/setdecoding {/t decodingdefs 3 -1 roll get bind def} bind def

/w {neg moveto show} bind def
/m {neg dup /y exch def moveto} bind def
/done {/lastpage where {pop lastpage} if} def

/f {
	dup /font exch def findfont exch
	dup /ptsize exch def scaling div dup /size exch def scalefont setfont
	linewidth ptsize mul scaling 10 mul div setlinewidth
	/spacewidth ( ) stringwidth pop def
} bind def

/changefont {
	/fontheight exch def
	/fontslant exch def
	currentfont [
		1 0
		fontheight ptsize div fontslant sin mul fontslant cos div
		fontheight ptsize div
		0 0
	] makefont setfont
} bind def

/sf {f} bind def

/cf {
	dup length 2 idiv
	/entries exch def
	/chtab exch def
	/newencoding exch def
	/newfont exch def

	findfont dup length 1 add dict
	/newdict exch def
	{1 index /FID ne {newdict 3 1 roll put}{pop pop} ifelse} forall

	newencoding type /arraytype eq {newdict /Encoding newencoding put} if

	newdict /Metrics entries dict put
	newdict /Metrics get
	begin
		chtab aload pop
		1 1 entries {pop def} for
		newfont newdict definefont pop
	end
} bind def

%
% A few arrays used to adjust reference points and character widths in some
% of the printer resident fonts. If square roots are too high try changing
% the lines describing /radical and /radicalex to,
%
%	/radical	[0 -75 550 0]
%	/radicalex	[-50 -75 500 0]
%
% Move braceleftbt a bit - default PostScript character is off a bit.
%

/Sdefs [
	/bracketlefttp		[201 500]
	/bracketleftbt		[201 500]
	/bracketrighttp		[-81 380]
	/bracketrightbt		[-83 380]
	/braceleftbt		[203 490]
	/bracketrightex		[220 -125 500 0]
	/radical		[0 0 550 0]
	/radicalex		[-50 0 500 0]
	/parenleftex		[-20 -170 0 0]
	/integral		[100 -50 500 0]
	/infinity		[10 -75 730 0]
] def

/S1defs [
	/underscore		[0 80 500 0]
	/endash			[7 90 650 0]
] def
%%EndProlog
%%BeginSetup
mark
/resolution 720 def
setup
2 setdecoding
%%EndSetup
%%Page: 1 1
/saveobj save def
mark
1 pagesetup
10 B f
(s title'\)&\(0\) .ie'Anton's title'' .br Work Project No. and)8 2364 1 720 600 t
(Filing Case Anton's title)3 1036 1 720 720 t
(s title'=0\):\(0=0\) .ie267s title' - Work Project No. Anton's title)9 2588 1 720 840 t
(January 31, 2012)2 731 1 4032 1560 t
10 R f
(testing)720 1920 w
(Yours very truly,)2 685 1 2880 2160 t
10 B f
(I. Smith)1 345 1 2880 2640 t
(CEO)2880 2760 w
(J. Burke)1 367 1 2880 3240 t
(CEO1)2880 3360 w
(also OEC1)1 459 1 2880 3480 t
(K. Willis)1 379 1 2880 3960 t
(CEO2)2880 4080 w
cleartomark
showpage
saveobj restore
%%EndPage: 1 1
%%Trailer
done
%%Pages: 1
%%DocumentFonts: Times-Bold Times-Roman

--------------040800050802040001090103
Content-Type: text/x-troff-mm;
 name="sign.mm"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="sign.mm"

.warn
.TL "Anton's title"
.AU "I. Smith" IS YW D1
.AT CEO
.AU "J. Burke" JB AR D2
.AT CEO1 "also OEC1"
.AU "K. Willis" KW MO D3
.AT CEO2
.MT 5
.P
testing
.FC
.SG

--------------040800050802040001090103--


From MAILER-DAEMON Tue Jan 31 09:49:30 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RsF1W-0007kl-H1
	for mharc-groff@gnu.org; Tue, 31 Jan 2012 09:49:30 -0500
Received: from eggs.gnu.org ([140.186.70.92]:59828)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RsF1U-0007ka-D2
	for groff@gnu.org; Tue, 31 Jan 2012 09:49:29 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RsF1N-0005JL-OA
	for groff@gnu.org; Tue, 31 Jan 2012 09:49:28 -0500
Received: from ws-mr2.cc.emory.edu ([170.140.50.232]:53961)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <km@mathcs.emory.edu>) id 1RsF1N-0005J0-Ks
	for groff@gnu.org; Tue, 31 Jan 2012 09:49:21 -0500
Received: from [192.168.10.22] (emoryfloatdmz.cc.emory.edu [170.140.52.254])
	(authenticated bits=0)
	by ws-mr2.cc.emory.edu (8.13.8/8.13.1) with ESMTP id q0VEnF3A032471
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Tue, 31 Jan 2012 09:49:15 -0500
Message-ID: <4F27FF6B.1010905@mathcs.emory.edu>
Date: Tue, 31 Jan 2012 09:49:15 -0500
From: Ken Mandelberg <km@mathcs.emory.edu>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.9.2.25) Gecko/20111214 Lightning/1.0b2 Thunderbird/3.1.17
MIME-Version: 1.0
To: Anton Shepelev <anton.txt@gmail.com>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
In-Reply-To: <20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Emory-MailScanner-Information: Please contact the ISP for more information
X-Emory-MailScanner-ID: q0VEnF3A032471
X-Emory-MailScanner: Found to be clean
X-Emory-MailScanner-SpamCheck: not spam, SpamAssassin (not cached,
	score=1.99, required 8, autolearn=disabled, SMTP_AUTH 2.00,
	T_RP_MATCHES_RCVD -0.01)
X-Emory-MailScanner-SpamScore: s
X-Emory-MailScanner-From: km@mathcs.emory.edu
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 170.140.50.232
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Jan 2012 14:49:29 -0000

Anton Shepelev wrote, On 01/28/2012 04:58 PM:
> Ken Mandelberg:
>
>> It  seems  like  AU/AT  with  the MM macros is not
>> working properly.
>>
>> Here is a simple test
>>
>>     .AU "John Smith"
>>     .AT "CEO"
>>     .MT 5
>>     .P
>>     testing
>>     .FC
>>     .SG
>>     .br
>>
>> [...]
>>
>> So the AT title string never comes out, and  there
>> is an extraneous "--"
>
> Please,  check  if the attached patch has fixed your
> problem.  Bear in mind, that I only did  symptomatic
> treatment, and it still does not work correctly with
> more than one author.
>
> Anton

Anton

I tested the patch. It does indeed fix the single author with title case.

However, there still is one difference between groff and troff. In troff 
the signature comes out bold and in groff it doesn't. Any thoughts on that?


Ken


From MAILER-DAEMON Tue Jan 31 11:25:33 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RsGWT-0003So-DN
	for mharc-groff@gnu.org; Tue, 31 Jan 2012 11:25:33 -0500
Received: from eggs.gnu.org ([140.186.70.92]:47634)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsGWM-0003RJ-9u
	for groff@gnu.org; Tue, 31 Jan 2012 11:25:32 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsGWA-0004MQ-VK
	for groff@gnu.org; Tue, 31 Jan 2012 11:25:26 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:32785)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsGWA-0004M8-QJ
	for groff@gnu.org; Tue, 31 Jan 2012 11:25:14 -0500
Received: by bkbzs2 with SMTP id zs2so154845bkb.0
	for <groff@gnu.org>; Tue, 31 Jan 2012 08:25:13 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type;
	bh=TUw2tmCP/dxqp1iDdq/93stHwR3NHFH4mvbvko3NFT8=;
	b=CNat1bI0otpGkQnqrCO5AJuNxBvt+3I3j0Du/WT1iNvlQvpNDgrqu2fAPAdd5JLCdq
	uauExveUfls/l2fp1gkfqK2MzVMlKt7EwmcJXUiR+TlliEIIaqvAh2V2fXL5avoMuxn+
	e2I/IeUhUgtnbC7+BG0YAxXxQFMi+TmYziXOs=
Received: by 10.204.130.28 with SMTP id q28mr10961571bks.10.1328027110855;
	Tue, 31 Jan 2012 08:25:10 -0800 (PST)
Received: from erp07.git.ru ([94.79.3.82])
	by mx.google.com with ESMTPS id ek9sm46060038bkb.10.2012.01.31.08.25.09
	(version=SSLv3 cipher=OTHER); Tue, 31 Jan 2012 08:25:10 -0800 (PST)
Date: Tue, 31 Jan 2012 20:25:08 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Ken Mandelberg <km@mathcs.emory.edu>
Message-Id: <20120131202508.372d0fe7bc75f89e0b2673f1@gmail.com>
In-Reply-To: <4F27FF6B.1010905@mathcs.emory.edu>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
	<4F27FF6B.1010905@mathcs.emory.edu>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: multipart/mixed;
	boundary="Multipart=_Tue__31_Jan_2012_20_25_08_+0400_0WI1SH9b00mEcYj/"
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Jan 2012 16:25:32 -0000

This is a multi-part message in MIME format.

--Multipart=_Tue__31_Jan_2012_20_25_08_+0400_0WI1SH9b00mEcYj/
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

Ken Mandelberg:

> I  tested the patch. It does indeed fix the single
> author with title case.
>
> However, there still  is  one  difference  between
> groff  and troff. In troff the signature comes out
> bold and in groff  it  doesn't.  Any  thoughts  on
> that?

OK, I have modified the patch (attached).

But  I am not sure how mm is supposed to handle long
signatures if they spread across the page  boundary:
should  it treat the .FC + .SG combination as an in-
divisible keep or not, e.t.c.; so I did it the  sim-
plest way and with the least changes possible.

Anton

--Multipart=_Tue__31_Jan_2012_20_25_08_+0400_0WI1SH9b00mEcYj/
Content-Type: text/plain;
 name="m.tmac.diff"
Content-Disposition: attachment;
 filename="m.tmac.diff"
Content-Transfer-Encoding: 7bit

--- m.tmac-old.tmac	2012-01-31 20:11:31.244325100 +0400
+++ m.tmac	2012-01-31 20:10:42.917128000 +0400
@@ -3288,31 +3288,56 @@
 .\}
 ..
 .\"------------------------
+.\" Helper macro: assign string $2 to string $1 with separator $3
+.de ASS
+.   if !d \\$1 \{\
+.      ds sep-\\$1
+.      ds \\$1
+.   \}
+.   if d \\$2 .as \\$1 \\*[sep-\\$1]\\*[\\$2]
+.   ds sep-\\$1 \\$3
+..
 .\" Memorandum signature
 .de let*mt-sign
 .df@print-float 3
-.ne \\n[cov*au]u*4v
+.di di-sgn
+.ft B
 .ie \\n[.$]>1 .nr let*k 1
 .el .nr let*k \\n[cov*au]
-.ds let*tmp \\*[cov*au!\\n[let*k]!3]-\\*[cov*au!\\n[let*k]!4]-
+.\" Concatenate attributes of the last author:
+.ASS let*tmp cov*au!\\n[let*k]!3 -
+.ASS let*tmp cov*au!\\n[let*k]!4 -
 .nr let*i 0 1
-.while \\n+[let*i]<=\\n[cov*au] \{\
-.	if \\n[let*i]>1 .as let*tmp /
-.	as let*tmp \\*[cov*au!\\n[let*k]!2]
-.\}
+.\" Collect authors' initials:
+.while \\n+[let*i]<=\\n[cov*au] .ASS let*tmp cov*au!\\n[let*i]!2 "/"
 .if !''\\$1' .as let*tmp -\\$1
+.nr i-old \\n[.i]u
 .in (u;\\n[.l]/2)
 .nf
 .nr let*i 0 1
+.\" Loop through authors:
 .while \\n+[let*i]<=\\n[cov*au] \{\
-.	SP 3v
-.	if \\n[let*i]=\\n[let*k] \{\
+.  SP 3v
+.  if \\n[let*i]=\\n[let*k] \{\
 \Z'\h'-(u;\\n[.l]/2)'\\*[let*tmp]'\c
-.	\}
+.  \}
 \\*[cov*au!\\n[let*i]!1]
+.\" Print author's titles, one per line:
+.  nr cov*j 0 1
+.  while \\n+[cov*j]<=9 \{\
+.     br
+.     if d cov*at!\\n[let*i]!\\n[cov*j] \\*[cov*at!\\n[let*i]!\\n[cov*j]]
+.  \}
 .\}
+.di
+.ne \\n[dn]u
+.in 0
+.di-sgn
+.ch di-sgn
 .fi
-.in
+.in \\n[i-old]u
+.rr i-old
+.ft R
 ..
 .\"------------------------
 .\" Approval signature

--Multipart=_Tue__31_Jan_2012_20_25_08_+0400_0WI1SH9b00mEcYj/--


From MAILER-DAEMON Tue Jan 31 11:25:34 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RsGWU-0003WW-Fc
	for mharc-groff@gnu.org; Tue, 31 Jan 2012 11:25:34 -0500
Received: from eggs.gnu.org ([140.186.70.92]:47655)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsGWN-0003RP-Px
	for groff@gnu.org; Tue, 31 Jan 2012 11:25:33 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsGWJ-0004Ni-MQ
	for groff@gnu.org; Tue, 31 Jan 2012 11:25:27 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:32785)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsGWJ-0004M8-HT
	for groff@gnu.org; Tue, 31 Jan 2012 11:25:23 -0500
Received: by mail-bk0-f41.google.com with SMTP id zs2so154845bkb.0
	for <groff@gnu.org>; Tue, 31 Jan 2012 08:25:23 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type:content-transfer-encoding;
	bh=j5QmqZm4lkh+NG0vVGjTE6yVCtGiPj+sajaL4C8CiFE=;
	b=tcWuRv/EaDUqFxYhZZv3Ix7H/OQTM3YcN4c3NUONZwHECTumnnzpB+uGhPZ8Jqd0wL
	lskshgrd31e8TM2JI17VMYIaM+6GUYeiM+fBGnDh9dUgLNi8+Ks78JktMU6hXxpX7JyI
	Fxij9Ydw/uMZ1meudJAhHJBS/aNWpMmdeEdV8=
Received: by 10.204.130.129 with SMTP id t1mr11264161bks.33.1328027118710;
	Tue, 31 Jan 2012 08:25:18 -0800 (PST)
Received: from erp07.git.ru ([94.79.3.82])
	by mx.google.com with ESMTPS id z15sm43195230bkd.7.2012.01.31.08.25.17
	(version=SSLv3 cipher=OTHER); Tue, 31 Jan 2012 08:25:18 -0800 (PST)
Date: Tue, 31 Jan 2012 20:19:03 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Ken Mandelberg <km@mathcs.emory.edu>
Message-Id: <20120131201903.ffb1ffc238a68d9a4161091d@gmail.com>
In-Reply-To: <4F27FDC6.400@mathcs.emory.edu>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120126235326.6f3131f20d92bfd631f7130f@gmail.com>
	<4F27FDC6.400@mathcs.emory.edu>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Jan 2012 16:25:33 -0000

Ken Mandelberg:

> I've  attached the ascii and postscript output. It
> gets the multiple authors and author titles right

Looks like your version of  mm  completerly  ignored
the  last three arguments to AU: location, deparment
and initials.  I am not sure it is correct either.

Anton


From MAILER-DAEMON Tue Jan 31 14:35:39 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RsJUR-0000m7-OE
	for mharc-groff@gnu.org; Tue, 31 Jan 2012 14:35:39 -0500
Received: from eggs.gnu.org ([140.186.70.92]:49126)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RsJUL-0000gi-Nh
	for groff@gnu.org; Tue, 31 Jan 2012 14:35:37 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RsJUH-0001HY-AQ
	for groff@gnu.org; Tue, 31 Jan 2012 14:35:33 -0500
Received: from mailout-de.gmx.net ([213.165.64.23]:59212)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <werner.lemberg@gmx.de>) id 1RsJUG-0001HP-PA
	for groff@gnu.org; Tue, 31 Jan 2012 14:35:29 -0500
Received: (qmail invoked by alias); 31 Jan 2012 19:35:26 -0000
Received: from 77.117.77.74.wireless.dyn.drei.com (EHLO localhost)
	[77.117.77.74]
	by mail.gmx.net (mp041) with SMTP; 31 Jan 2012 20:35:26 +0100
X-Authenticated: #54312696
X-Provags-ID: V01U2FsdGVkX1/Vbqw99bLVpjUJB06fCGLzO55xwBhAYZuBIfIc7c
	bIWfCeHKwURK6g
Date: Tue, 31 Jan 2012 20:35:17 +0100 (CET)
Message-Id: <20120131.203517.345887628.wl@gnu.org>
To: anton.txt@gmail.com
From: Werner LEMBERG <wl@gnu.org>
In-Reply-To: <20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
X-Mailer: Mew version 6.4rc1 on Emacs 24.0.92.1 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 213.165.64.23
Cc: km@mathcs.emory.edu, groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Jan 2012 19:35:37 -0000


> Please, check if the attached patch has fixed your problem.

BTW, thanks for working on this :-)

Please tell me if you have found a patch which I can apply to the
repository.


    Werner


From MAILER-DAEMON Tue Jan 31 15:01:55 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RsJtr-0007gJ-KQ
	for mharc-groff@gnu.org; Tue, 31 Jan 2012 15:01:55 -0500
Received: from eggs.gnu.org ([140.186.70.92]:55053)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsJtk-0007J1-W8
	for groff@gnu.org; Tue, 31 Jan 2012 15:01:54 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>) id 1RsJtj-0004ic-Ui
	for groff@gnu.org; Tue, 31 Jan 2012 15:01:48 -0500
Received: from mail-bk0-f41.google.com ([209.85.214.41]:47721)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anton.txt@gmail.com>)
	id 1RsJtd-0004hY-B4; Tue, 31 Jan 2012 15:01:41 -0500
Received: by bkbzs2 with SMTP id zs2so387128bkb.0
	for <multiple recipients>; Tue, 31 Jan 2012 12:01:39 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=date:from:to:cc:subject:message-id:in-reply-to:references:x-mailer
	:mime-version:content-type:content-transfer-encoding;
	bh=Y2zoU6cfO1mxVnncA63VtimPxhn+k8zAks/AOgmWdC8=;
	b=TOu+5nm7GLkpS0piNoXmjFOWxkQ/bS01E0iyTdiWzZDTv8wtwpAYt/G5smuHeDw7cv
	TBzH1NJ9Cnfcw7rIlXcZ+COCH/wNl+Y+tvhBAjzS8cBov/shs/l50vTS/r4l/zwIxqlB
	cj67tf8fhGuWJ+nhYnh1gB6OnJrgbXgU9lp3E=
Received: by 10.205.132.138 with SMTP id hu10mr11042734bkc.117.1328040099895; 
	Tue, 31 Jan 2012 12:01:39 -0800 (PST)
Received: from ANT ([77.51.110.231])
	by mx.google.com with ESMTPS id bw9sm47294809bkb.8.2012.01.31.12.01.32
	(version=TLSv1/SSLv3 cipher=OTHER);
	Tue, 31 Jan 2012 12:01:39 -0800 (PST)
Date: Wed, 1 Feb 2012 00:01:38 +0400
From: Anton Shepelev <anton.txt@gmail.com>
To: Werner LEMBERG <wl@gnu.org>
Message-Id: <20120201000138.0166e22f2de69357a589ff8b@gmail.com>
In-Reply-To: <20120131.203517.345887628.wl@gnu.org>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
	<20120131.203517.345887628.wl@gnu.org>
X-Mailer: Sylpheed 3.2.0beta5 (GTK+ 2.10.14; i686-pc-mingw32)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.85.214.41
Cc: groff@gnu.org
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Jan 2012 20:01:54 -0000

Werner LEMBERG:

> Please  tell  me if you have found a patch which I
> can apply to the repository.

This is bound to be difficult because I  don't  have
an  exact  specification  of how mm _should_ typeset
the signature, and have to try to imitate  it  based
on tests -- the black box method...

On  the other hand, even what little I have done can
be considered an improvement:

  1.  Memorandum signature no longer  requires  that
      optional .AU parameters be specified.

  2.  The title (.AT) is now output.

  3.  A  typo  was  fixed  that  caused  the list of
      authors' initials contain multiple  copies  of
      those of the last author.

  4.  The  memorandum-style  signature  block is now
      typeset in bold, but still can  have  problems
      if  it  happens to cross the inter-page bound-
      aty, which case needs to be tested with a ref-
      erence implementation of mm.

Anton


From MAILER-DAEMON Tue Jan 31 19:13:27 2012
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1RsNpH-0005FE-Gr
	for mharc-groff@gnu.org; Tue, 31 Jan 2012 19:13:27 -0500
Received: from eggs.gnu.org ([140.186.70.92]:42175)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RsNpC-0005Ep-21
	for groff@gnu.org; Tue, 31 Jan 2012 19:13:26 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RsNp7-0005ER-KS
	for groff@gnu.org; Tue, 31 Jan 2012 19:13:21 -0500
Received: from relay02.pair.com ([209.68.5.16]:3507)
	by eggs.gnu.org with smtp (Exim 4.71)
	(envelope-from <ralph@inputplus.co.uk>) id 1RsNp7-0005E1-GT
	for groff@gnu.org; Tue, 31 Jan 2012 19:13:17 -0500
Received: (qmail 62182 invoked from network); 1 Feb 2012 00:13:15 -0000
Received: from 31.185.160.119 (HELO orac.inputplus.co.uk) (31.185.160.119)
	by relay02.pair.com with SMTP; 1 Feb 2012 00:13:15 -0000
X-pair-Authenticated: 31.185.160.119
Received: by orac.inputplus.co.uk (Postfix, from userid 1000)
	id BA2881FB40; Wed,  1 Feb 2012 00:13:14 +0000 (GMT)
Received: from orac.inputplus.co.uk (localhost [127.0.0.1])
	by orac.inputplus.co.uk (Postfix) with ESMTP id 8FCFA1FB1E
	for <groff@gnu.org>; Wed,  1 Feb 2012 00:13:14 +0000 (GMT)
To: groff@gnu.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-reply-to: <20120201000138.0166e22f2de69357a589ff8b@gmail.com>
References: <4F1A00F7.9080009@mathcs.emory.edu>
	<20120129015831.6c8c520eccb9b9eee0405e70@gmail.com>
	<20120131.203517.345887628.wl@gnu.org>
	<20120201000138.0166e22f2de69357a589ff8b@gmail.com>
Comments: In-reply-to Anton Shepelev <anton.txt@gmail.com> message dated "Wed,
	01 Feb 2012 00:01:38 +0400."
Date: Wed, 01 Feb 2012 00:13:14 +0000
From: Ralph Corderoy <ralph@inputplus.co.uk>
Message-Id: <20120201001314.BA2881FB40@orac.inputplus.co.uk>
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
	recognized.
X-Received-From: 209.68.5.16
Subject: Re: [Groff] groff MM problem with AU/AT
X-BeenThere: groff@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff>,
	<mailto:groff-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff>
List-Post: <mailto:groff@gnu.org>
List-Help: <mailto:groff-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff>,
	<mailto:groff-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 01 Feb 2012 00:13:26 -0000

Hi Anton,

> This is bound to be difficult because I don't have an exact
> specification of how mm _should_ typeset the signature, and have to
> try to imitate it based on tests

Is
http://books.google.co.uk/books?id=Wz1C5JhTzlYC&lpg=PR12&ots=e8Ftu5WzMi&dq=documenters%20workbench%20mm%20macros&pg=PA38#v=onepage&q=documenters%20workbench%20mm%20macros&f=false
of any use?  Section 7 might be going through the macros you're
discussing.  Obviously, not a spec. but a book in print.

Cheers, Ralph.


