Bug 76609 - Xserver.man: Warning from "groff" and some corrections to the manual
Summary: Xserver.man: Warning from "groff" and some corrections to the manual
Status: RESOLVED MOVED
Alias: None
Product: xorg
Classification: Unclassified
Component: Server/General (show other bugs)
Version: unspecified
Hardware: x86 (IA32) Linux (All)
: medium normal
Assignee: Xorg Project Team
QA Contact: Xorg Project Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-03-26 00:45 UTC by bjarniig
Modified: 2018-12-13 22:30 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments
Typographical corrections (5.44 KB, application/gzip)
2014-03-26 00:45 UTC, bjarniig
no flags Details

Description bjarniig 2014-03-26 00:45:37 UTC
Created attachment 96390 [details]
Typographical corrections

Source: xorg-server
Version: 1.15.99.901
Severity: minor
Tags: patch

  From

groff -b -ww -mandoc -z < Xserver.man

<standard input>:557: warning [p 8, 6.3i, div `an-div', 0.0i]: can't break line

  Input file is xorg-server-1.15.99.901/man/Xserver.man

  Changes:

  A full stop (.), that begins or ends a string, protected with \&

  An italic correction (\/) added before a roman character

  eg. changed to e.g.

  Space between sentences adjusted to two word spaces

  - changed to \- if it means an option

  - between two numbers changed to \(en if it means a range

  +- changed to \(+-

  - change to \- if it means a minus (sign)

  A comma (,) as an argument to the macro IR changed to ", " to enable
line breaking

  Patch is in the attachment.
Comment 1 Alan Coopersmith 2014-03-26 00:57:56 UTC
Attachment is completely garbled - did you post a valid text file?
Comment 2 bjarniig 2014-03-26 18:39:10 UTC
On Wed, Mar 26, 2014 at 12:57:56AM +0000, bugzilla-daemon@freedesktop.org wrote:
> https://bugs.freedesktop.org/show_bug.cgi?id=76609
> 
> Alan Coopersmith <alan.coopersmith@oracle.com> changed:
> 
>            What    |Removed                     |Added
> ----------------------------------------------------------------------------
>              Status|NEW                         |NEEDINFO
> 
> --- Comment #1 from Alan Coopersmith <alan.coopersmith@oracle.com> ---
> Attachment is completely garbled - did you post a valid text file?
> 
  No.  The name is "Xserver.man.diff.gz", also a gzipped file.  Either
I have overlooked a place to characterize the file, may only send pure
text files or the web-page does not classify the file correctly.
Comment 3 Alan Coopersmith 2014-03-26 18:57:27 UTC
Comment on attachment 96390 [details]
Typographical corrections

> No.  The name is "Xserver.man.diff.gz", also a gzipped file.  Either
> I have overlooked a place to characterize the file, may only send pure
> text files or the web-page does not classify the file correctly.

Bugzilla does not show filenames for attachments on the view screen (though
I see that now on the edit screen), and recorded the type of attachment as
"text/plain" (which should have been input you provided in the form).  I've
changed that now to application/gzip

Either way, bugzilla only really deals well with patches as plain text, and
gzipping them just increases the pain and decreases the odds anyone will do
anything with them.
Comment 4 GitLab Migration User 2018-12-13 22:30:04 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/xorg/xserver/issues/456.


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.