From owner-freebsd-doc@FreeBSD.ORG Thu Jul 5 18:50:02 2007 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A270C16A46C for ; Thu, 5 Jul 2007 18:50:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [69.147.83.40]) by mx1.freebsd.org (Postfix) with ESMTP id 82BAA13C46E for ; Thu, 5 Jul 2007 18:50:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id l65Io23U008318 for ; Thu, 5 Jul 2007 18:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id l65Io2m0008317; Thu, 5 Jul 2007 18:50:02 GMT (envelope-from gnats) Resent-Date: Thu, 5 Jul 2007 18:50:02 GMT Resent-Message-Id: <200707051850.l65Io2m0008317@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Ben Kaduk Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 1BE2216A400 for ; Thu, 5 Jul 2007 18:45:43 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [69.147.83.33]) by mx1.freebsd.org (Postfix) with ESMTP id 0BC4F13C459 for ; Thu, 5 Jul 2007 18:45:43 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.13.1/8.13.1) with ESMTP id l65IjgTs073048 for ; Thu, 5 Jul 2007 18:45:42 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id l65IjgTk073047; Thu, 5 Jul 2007 18:45:42 GMT (envelope-from nobody) Message-Id: <200707051845.l65IjgTk073047@www.freebsd.org> Date: Thu, 5 Jul 2007 18:45:42 GMT From: Ben Kaduk To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.0 Cc: Subject: docs/114337: minor grammar nits to handbook/x11 chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 05 Jul 2007 18:50:02 -0000 >Number: 114337 >Category: docs >Synopsis: minor grammar nits to handbook/x11 chapter >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Jul 05 18:50:01 GMT 2007 >Closed-Date: >Last-Modified: >Originator: Ben Kaduk >Release: 7-CURRENT >Organization: >Environment: System: FreeBSD prolepsis.scs.uiuc.edu 7.0-CURRENT FreeBSD 7.0-CURRENT #1: Sun Apr 1 16:59:00 UTC 2007 kaduk@prolepsis.scs.uiuc.edu:/usr/obj/usr/src/sys/GENERIC i386 >Description: I attach a patch with a number of small changes, which I detail here o the first change is an attempt to make the sentence relating X11, XOrg and XFree86 more parse-able. This is difficult for me, because I'm not entirely sure what the relationships are, myself. X.org claims (http://www.x.org/wiki/) that ``The X.Org Foundation provides an open source implementation of the X Window System''; presumably XFree86 does as well. This change reverses the inclusion so that the two softwares include the X11 protocol, not the other way around (which doesn't make much sense) o XDM controlled-->XDM-controlled: more hyphenation issues that I'm not 100% certain about; Marc Fonvieille is (hopefully) looking into this some more (controlled is a past participle here, right?) o the login-->login: either ``the chooser screen'' and ``the login screen'', or ``the chooser and login screens''. o edit-->you must edit: the text is telling the user what to do o [Xaccess]: a bit of style change (show the relation between two sentences), and close off the sentence with why users may wish to consult more documentation. o [add commas to list] o represents-->is: Konqueror is a browser, not a picture of one o FreeBSD-KDE-->FreeBSD KDE: style (?) I'm not sure what a hyphen adds here, and I couldn't find this term on the referenced webpage o etc. is an abbreviation o other things-->more: ``other things'' just feels like the wrong tone for this piece, to me >How-To-Repeat: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x11.html and the rest of the chapter >Fix: patch attached Patch attached with submission follows: --- chapter.sgml.orig 2007-07-03 18:27:06.000000000 -0500 +++ chapter.sgml 2007-07-05 12:59:42.000000000 -0500 @@ -26,9 +26,10 @@ FreeBSD uses X11 to provide users with a powerful graphical user interface. X11 - is an open-source implementation of the X Window System that - includes both &xorg; and - &xfree86;. &os; versions up to and + is a freely available version of the X Window System that + is implemented in both &xorg; and + &xfree86; (and other software + packages not discussed here). &os; versions up to and including &os; 5.2.1-RELEASE will find the default installation to be &xfree86;, the X11 server released by @@ -1144,7 +1145,7 @@ Xaccess The protocol for connecting to - XDM controlled displays is called + XDM-controlled displays is called the X Display Manager Connection Protocol (XDMCP). This file is a ruleset for controlling XDMCP connections from remote machines. It is ignored unless the xdm-config @@ -1155,7 +1156,7 @@ Xresources This is an application-defaults file for the display - chooser and the login screens. This is where the appearance + chooser and login screens. In it, the appearance of the login program can be modified. The format is identical to the app-defaults file described in the X11 documentation. @@ -1210,7 +1211,7 @@ Running a Network Display Server In order for other clients to connect to the display - server, edit the access control rules, and enable the connection + server, you must edit the access control rules and enable the connection listener. By default these are set to conservative values. To make XDM listen for connections, first comment out a line in the xdm-config @@ -1223,9 +1224,9 @@ and then restart XDM. Remember that comments in app-defaults files begin with a ! character, not the usual #. More strict - access controls may be desired. Look at the example + access controls may be desired — look at the example entries in Xaccess, and refer to the - &man.xdm.1; manual page. + &man.xdm.1; manual page for further information. @@ -1428,7 +1429,7 @@ - Centralized consisted dialog driven desktop + Centralized, consistent, dialog-driven desktop configuration @@ -1439,13 +1440,13 @@ KDE comes with a web browser called - Konqueror, which represents + Konqueror, which is a solid competitor to other existing web browsers on &unix; systems. More information on KDE can be found on the KDE website. For FreeBSD specific information and resources on KDE, consult - the FreeBSD-KDE + the FreeBSD KDE team's website. @@ -1554,7 +1555,7 @@ Fully configurable via mouse, with drag and - drop, etc + drop, etc. @@ -1564,8 +1565,7 @@ Integrated window manager, file manager, sound manager, - GNOME compliance module, and other - things + GNOME compliance module, and more >Release-Note: >Audit-Trail: >Unformatted: