Presentation markup on Emacs manual page

[Eric S. Raymond]

This bug report will be sent to the Free Software Foundation,
 not to your local site managers!!
Please write in English, because the Emacs maintainers do not have
translators to read other languages for them.

In GNU Emacs 20.7.1 (i386-redhat-linux-gnu, X toolkit)
 of Fri Mar 16 2001 on porky.devel.redhat.com
configured using `configure  --mandir=/usr/share/man --infodir=/usr/share/info 
--prefix=/usr --libexecdir=/usr/lib --sharedstatedir=/var --with-gcc --with-pop 
--with-x-toolkit i386-redhat-linux-gnu'

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:

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>

The Bible is not my book, and Christianity is not my religion.  I could never
give assent to the long, complicated statements of Christian dogma.
        -- Abraham Lincoln