bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Reference to GETTING.GNU.SOFTWARE


From: Eric S. Raymond
Subject: Re: Reference to GETTING.GNU.SOFTWARE
Date: Wed, 31 Oct 2001 10:32:36 -0500
User-agent: Mutt/1.2.5i

Eli Zaretskii <eliz@is.elta.co.il>:
> > I submitted a fix patch to it that seems to have been ignored.
> 
> IIRC, I asked a question about that (whether the alternative macros you 
> used in your patch are supported by versions of troff other than Groff), 
> but that question seems to have been ignored. ;-)
> 
> I cannot make up my mind about this change without knowing its effect on 
> portability.

Ah.  That explains it.  I never saw that question.  Yes, the TBL markup
I patched in should be fully portable to Bell Labs and other troffs.  You'll
note that it only uses "l" format specifiers, not the more problematic "n"
or "d" ones, and it doesn't use any global options at all.  That's about
as simple as TBL tables get.

Here it is again in case you don't have a copy handy:

The Emacs manual page has nasty presentation-level troff macros on it
that simulate tables.  These make structural translation of the page
impossible (see http://www.tuxedo.org/~esr/doclifter).  Since groff
with tbl supports table markup, there is no good reason for this.

The following diff fixes the problem.  The visual appearance of the
patched page is indistinguishable from the original, but this 
markup is much cleaner.

--- emacs.1     2001/10/15 22:20:32     1.1
+++ emacs.1     2001/10/15 22:30:53
@@ -1,3 +1,4 @@
+'\" t
 .TH EMACS 1 "1995 December 7"
 .UC 4
 .SH NAME
@@ -330,49 +331,34 @@
 .I Emacs
 window under X11.
 
-.in +\w'CTRL-SHIFT-middle'u+4n
-.ta \w'CTRL-SHIFT-middle'u+4n
-.ti -\w'CTRL-SHIFT-middle'u+4n
+.TS
+l l.
 MOUSE BUTTON   FUNCTION
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
 left   Set point.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
 middle Paste text.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
 right  Cut text into X cut buffer.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
 SHIFT-middle   Cut text into X cut buffer.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
 SHIFT-right    Paste text.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
 CTRL-middle    Cut text into X cut buffer and kill it.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-right     Select this window, then split it into 
+CTRL-right     T{
+Select this window, then split it into 
 two windows.  Same as typing CTRL-x 2.
+T}
 .\" START DELETING HERE IF YOU'RE NOT USING X MENUS
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-SHIFT-left        X buffer menu--hold the buttons and keys
+CTRL-SHIFT-left        T{
+X buffer menu--hold the buttons and keys
 down, wait for menu to appear, select 
 buffer, and release.  Move mouse out of
 menu and release to cancel.
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-SHIFT-middle      X help menu--pop up index card menu for
-Emacs help.
+T}
+CTRL-SHIFT-middle      X help menu--pop up index card menu for Emacs help.
 .\" STOP DELETING HERE IF YOU'RE NOT USING X MENUS
-.br
-.ti -\w'CTRL-SHIFT-middle'u+4n
-CTRL-SHIFT-right       Select window with mouse, and delete all
+CTRL-SHIFT-right       T{
+Select window with mouse, and delete all
 other windows.  Same as typing CTRL-x 1.
+T}
 .\" STOP DELETING HERE IF YOU'RE NOT USING X
+.TE
 .PP
 .SH MANUALS
 You can order printed copies of the GNU Emacs Manual from the Free

-- 
                <a href="http://www.tuxedo.org/~esr/";>Eric S. Raymond</a>

"This country, with its institutions, belongs to the people who inhabit it. 
Whenever they shall grow weary of the existing government, they can exercise
their constitutional right of amending it or their revolutionary right to 
dismember it or overthrow it."  -- Abraham Lincoln, 4 April 1861



reply via email to

[Prev in Thread] Current Thread [Next in Thread]