Bug 55223 - "groff" reports a "\T" in the manual of "bitmap.man"
Summary: "groff" reports a "\T" in the manual of "bitmap.man"
Status: RESOLVED FIXED
Alias: None
Product: xorg
Classification: Unclassified
Component: App/other (show other bugs)
Version: 7.7 (2012.06)
Hardware: All Linux (All)
: medium minor
Assignee: Xorg Project Team
QA Contact: Xorg Project Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-09-22 16:20 UTC by bjarniig
Modified: 2012-09-22 23:51 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:


Attachments

Description bjarniig 2012-09-22 16:20:36 UTC
Software: bitmap
Version: 1.0.6
File: man/bitmap.man
Patch: Yes

  Warning from "groff ...":

<groff: bitmap.man>:428: warning: escape character ignored before `T'

  Some space corrected.

#
  Output from "nroff" should (usually) have only the left margin adjusted
(".ad l").  Otherwise the space between words can be too long.

  Output for a manual should (usually) have the right margin ragged
(".ad l"), as it is not (usually) intended for a book or other professional
printing medium.
#
#
  Each sentence should begin in a new line.

a) The space between sentences is different between formatters.

b) Changes in one line do then not affect others, and do therefore not
appear as changed in the output of "diff".
#
  Sometimes a small change in space between a roman and an italic
character is needed (use ".RI" or ".IR" macros; "\," or "\/" escape
sequence).

  Patch:

--- bitmap.man	2012-03-09 05:40:16.000000000 +0000
+++ bitmap.man.new	2012-09-22 15:41:50.000000000 +0000
@@ -174,13 +174,13 @@ may be used in creating cursors, icons,
 .SH EDITING
 To edit a bitmap image simply click on one of the buttons with drawing
 commands (\fBPoint, Curve, Line, Rectangle,\fP etc.) and move the
-pointer into the bitmap grid  window.  Press one of the buttons on your
+pointer into the bitmap grid window.  Press one of the buttons on your
 mouse and the appropriate action will take place.  You can either set,
 clear or invert the gird squares.  Setting a grid square corresponds
 to setting a bit in the bitmap image to 1.  Clearing a grid square
 corresponds to setting a bit in the bitmap image to 0.  Inverting a
 grid square corresponds to changing a bit in the bitmap image from 0 to
-1 or 1 to 0, depending what its previous state was. The
+1 or 1 to 0, depending what its previous state was.  The
 default behavior of mouse buttons is as specified below.
 .sp
 .nf
@@ -406,7 +406,7 @@ filename.  It should be used if you want
 This command is used to resize the editing area to the new number of
 pixels.  The size should be entered in the WIDTHxHEIGHT format.  The
 information in the image being edited will not be lost unless the new
-size is smaller that the current image size. The editor was not
+size is smaller that the current image size.  The editor was not
 designed to edit huge files.
 .TP 4
 .B Rescale
@@ -425,7 +425,7 @@ This command is used to change the basen
 the specified filename is desired.
 .TP 4
 .B Quit
-\This command will terminate the bitmap application.  If the file was
+This command will terminate the bitmap application.  If the file was
 not saved, user will be prompted and asked whether to save the image
 or not.  This command is preferred over killing the process.
 .SH EDIT MENU
Comment 1 James Cloos 2012-09-22 23:44:04 UTC
The \This goes back to before git — and before cvs for that matter.
Ours or XFree86’s.

X11R3 was the first to have a man page for bitmap(1).  The backslash is
not in R3 or R4.  It is in X11R5.  Therefore lThe backslash was added
sometime between 1989-12-22 and 1991-08-01.

∴ 21+ years old.

I’ll push the proposed patch.
Comment 2 James Cloos 2012-09-22 23:51:04 UTC
Pushed as 0d42abaefc427f7c354f4cff3d098775df5c9cb4.


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.