Bug 76609

Summary: Xserver.man: Warning from "groff" and some corrections to the manual
Product: xorg Reporter: bjarniig
Component: Server/GeneralAssignee: Xorg Project Team <xorg-team>
Status: RESOLVED MOVED QA Contact: Xorg Project Team <xorg-team>
Severity: normal    
Priority: medium    
Version: unspecified   
Hardware: x86 (IA32)   
OS: Linux (All)   
Whiteboard:
i915 platform: i915 features:
Attachments:
Description Flags
Typographical corrections none

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.