[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