From owner-freebsd-doc@FreeBSD.ORG Fri Jul 6 18:40:04 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 0E07416A46E for ; Fri, 6 Jul 2007 18:40:04 +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 DD39113C4AD for ; Fri, 6 Jul 2007 18:40:03 +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 l66Ie37x021758 for ; Fri, 6 Jul 2007 18:40:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id l66Ie3s4021757; Fri, 6 Jul 2007 18:40:03 GMT (envelope-from gnats) Resent-Date: Fri, 6 Jul 2007 18:40:03 GMT Resent-Message-Id: <200707061840.l66Ie3s4021757@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 70E0716A468 for ; Fri, 6 Jul 2007 18:30:23 +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 6082213C489 for ; Fri, 6 Jul 2007 18:30:23 +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 l66IUNLP026666 for ; Fri, 6 Jul 2007 18:30:23 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id l66IUNe0026665; Fri, 6 Jul 2007 18:30:23 GMT (envelope-from nobody) Message-Id: <200707061830.l66IUNe0026665@www.freebsd.org> Date: Fri, 6 Jul 2007 18:30:23 GMT From: Ben Kaduk To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.0 Cc: Subject: docs/114363: minor grammar nits in handbook/desktop 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: Fri, 06 Jul 2007 18:40:04 -0000 >Number: 114363 >Category: docs >Synopsis: minor grammar nits in handbook/desktop 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: Fri Jul 06 18:40:03 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'm getting on more shaky ground with some of the proposed changes in this chapter. Please exercise editorial judgement. There's a list of changes in the patch; I'll try to take them in order: o [style in describing Mozilla's features]: I got tired of the big list of declarative sentences ``It features ...'', so I changed it up a bit. I'm pretty sure that it's okay to use a colon in this context o Communicator Suite-->the Communicator Suite: I think that a definite article is appropriate here o resource-consuming-->resource-demanding: I think the latter is more commonly used o for any reason-->for whatever reason: the former implies (in my reading) that the reader is partisan agains compiling Mozilla; the latter is more considering (nicer to the reader?) o you already installed-->you have already installed: perhaps not necessary, but probably enhances readibility o [plugins]: they are listed, and ``not the case'' feels awkward (to me) o [FTP/packages]: ``the same result can be obtained'' is awkward in this context o appear to be-->should be: the latter makes it sound more like we know what we're doing o [Konqueror plugins]: they aren't installed by default, so Konqueror doesn't come with them (but they are, nonetheless, available) o [Konqueror Howto]: I think my version makes it more clear what the howto does for the user o default application-->default productivity package [and more]: specify what there is no default of, and do not imply that all options are available without user effort to get them o [MS .doc]: I think that the possessive on .doc is valid, and we might as well use the entity while we're here o [internationalization]: make more clear how the different languages have been incorporated o packages-->packages,: avoid run-on o [new document formats]: pdf's have been quite popular for many years now. Are there document viewers in base other than *roff? I don't know anyone that composes in roff for anything other than man pages. o [gv]: readility and style (?) o [finances]: more hyphenation (I'm starting to think I might be going overboard on this. . .), prefer ``such as'' to ``like'' (optional), and do not imply that an application can support at most one external file format o applications-->programs: remove ambiguity (action vs. software) o yet powerful-->,yet powerful,: while it's tempting to say ``user-friendly-but-powerful'', that's just silly. Adding these commas may make this sentence more readable. o or your stocks-->and your stocks: do not imply that only one thing can be done at once o many-->and many: ``many keyboard accelerators and auto-completion methods'' seems to be one element in the list (if not, some modifier should be added to ``auto-completion methods'', such as ``several'', to make this clear) o spreadsheet-->spreadsheet program: I am very uncertain about this one, but I always thought that the spreadsheet was the document that the spreadsheet program modifies. Excel's webpage claims it is a spreadsheet program, wikipedia claims gnumeric is a spreadsheet program, but gnumeric's webpage lists it as just a ``spreadsheet'' (in at least one place). What gives? o and-->with: it seems that the autofill system is a subclass of the ``guessing'' and should be included as such o type in-->do: ``do'' seems to be the preferred way to indicate a command to be typed in, in this handbook (so far) o spreadsheet-->spreadsheet program: see above; I didn't check websites about Abacus, but the two instances should probably be consistent on the same page o from its-->as a: the latter seems more consistent with our use of package. >How-To-Repeat: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/desktop.html and the rest of the chapter >Fix: patch attached. Patch attached with submission follows: --- chapter.sgml.orig 2007-07-05 13:56:31.000000000 -0500 +++ chapter.sgml 2007-07-06 12:54:55.000000000 -0500 @@ -178,22 +178,22 @@ Mozilla is a modern, - stable browser that is fully ported to FreeBSD. It features a very - standards-compliant HTML display engine. It provides a mail + stable browser that is fully ported to FreeBSD: it features a very + standards-compliant HTML display engine; it provides a mail and news reader. It even has a HTML composer if you plan to write some web pages yourself. Users of &netscape; will recognize the - similarities with Communicator - suite, as both browsers shared the same basis. + similarities with the Communicator + suite, as both browsers share some development history. On slow machines, with a CPU speed less than 233MHz or with less than 64MB of RAM, Mozilla - can be too resource-consuming to be fully usable. You may + can be too resource-demanding to be fully usable. You may want to look at the Opera browser instead, described a little later in this chapter. If you cannot or do not want to compile - Mozilla for any reason, the FreeBSD + Mozilla, for whatever reason, the FreeBSD GNOME team has already done this for you. Just install the package from the network by: @@ -256,7 +256,7 @@ Firefox, Mozilla and &java; plugin - In this section and in the next one, we assume you + In this section and in the next one, we assume you have already installed Firefox or Mozilla. @@ -270,8 +270,8 @@ To add &java; support to Firefox or - Mozilla, you have to install, at - first, the Mozilla, you first have to install + the java/javavmwrapper port. Then, download the Diablo &jre; package from Start your browser, enter about:plugins in the location bar and press - Enter. A page regarding installed plugins - will be displayed, the &java; - plugin should be listed there now. If it is not the case, as + Enter. A page listing the installed plugins + will be displayed; the &java; + plugin should be listed there now. If it is not, as root, run the following command: &prompt.root; ln -s /usr/local/diablo-jre1.5.0/plugin/i386/ns7/libjavaplugin_oji.so \ @@ -356,9 +356,9 @@ &prompt.root; pkg_add -r opera - Some FTP sites do not have all the packages, but the same - result can be obtained with the Ports Collection by - typing: + Some FTP sites do not have all the packages, but + Opera can still be obtained + through the Ports Collection by typing: &prompt.root; cd /usr/ports/www/opera &prompt.root; make install clean @@ -370,7 +370,7 @@ version is useful in situations requiring the use of plug-ins that are only available for Linux, such as Adobe &acrobat.reader;. In all other respects, the - FreeBSD and Linux versions appear to be functionally + FreeBSD and Linux versions should be functionally identical. @@ -388,10 +388,14 @@ Konqueror is much more than a browser, it is also a file manager and a multimedia viewer. - Konqueror also comes with a set of plugins, + There is also a set of plugins available for + Konqueror, available in misc/konq-plugins. - Konqueror also supports &flash; and a How To + Konqueror also supports + &flash;; a How To guide + for getting &flash; support on + Konqueror is available at . @@ -403,7 +407,8 @@ good office suite or a friendly word processor. While some desktop environments like KDE already provide an office suite, - there is no default application. FreeBSD provides all that is + there is no default productivity package. + FreeBSD can provide all that is needed, regardless of your desktop environment. This section covers these applications: @@ -503,7 +508,7 @@ AbiWord can import or export many file formats, including some proprietary ones like - Microsoft .doc. + µsoft;'s .doc. AbiWord is available as a package. You can install it by: @@ -578,7 +583,8 @@ and a drawing program. Its user interface is very similar to other office suites, and it can import and export in various popular file formats. It is available in a number of - different languages including interfaces, spell checkers, and + different languages &emdash; internationalization has been + extended to interfaces, spell checkers, and dictionaries. The word processor of @@ -593,7 +599,7 @@ can be found on the OpenOffice.org web site. For FreeBSD specific information, and to directly - download packages use the FreeBSD OpenOffice.org Porting Team's web site. @@ -656,9 +662,10 @@ Document Viewers - Some new document formats have recently gained popularity. - The standard viewers they require may not be available in the - base system. We will see how to install them in this + Some new document formats have gained popularity since + the advent of &unix;; + the standard viewers they require may not be available in the + base system. We will see how to install such viewers in this section. This section covers these applications: @@ -751,9 +758,9 @@ viewer. It is originally based on ghostview but it has a nicer look thanks to the Xaw3d library. It is fast and its interface is - clean. gv has many features like - orientation, paper size, scale, or antialias. Almost any - operation can be done either from the keyboard or the + clean. gv has many features, such as + orientation, paper size, scale, and anti-aliasing. Almost any + operation can be done with either the keyboard or the mouse. To install gv as a package, @@ -832,11 +839,11 @@ If, for any reason, you would like to manage your personal finances on your FreeBSD Desktop, there are some powerful and - easy to use applications ready to be installed. Some of them - are compatible with widespread file formats like those of - Quicken or Excel documents. + easy-to-use applications ready to be installed. Some of them + are compatible with widespread file formats, such as the formats used by + Quicken and Excel to store documents. - This section covers these applications: + This section covers these programs: @@ -882,14 +889,14 @@ GnuCash is part of the GNOME effort to provide - user-friendly yet powerful applications to end-users. With + user-friendly, yet powerful, applications to end-users. With GnuCash, you can keep track of your - income and expenses, your bank accounts, or your stocks. It + income and expenses, your bank accounts, and your stocks. It features an intuitive interface while remaining very professional. GnuCash provides a smart - register, a hierarchical system of accounts, many keyboard + register, a hierarchical system of accounts, and many keyboard accelerators and auto-completion methods. It can split a single transaction into several more detailed pieces. GnuCash can import and merge @@ -918,10 +925,10 @@ Gnumeric - Gnumeric is a spreadsheet, part + Gnumeric is a spreadsheet program, part of the GNOME desktop environment. It features convenient automatic guessing of user - input according to the cell format and an autofill system for + input according to the cell format with an autofill system for many sequences. It can import files in a number of popular formats like those of Excel, Lotus 1-2-3, or Quattro Pro. Gnumeric supports graphs through @@ -931,7 +938,7 @@ date, time, and much more. To install Gnumeric as a - package, type in: + package, do: &prompt.root; pkg_add -r gnumeric @@ -953,13 +960,13 @@ Abacus is a small and easy to - use spreadsheet. It includes many built-in functions useful + use spreadsheet program. It includes many built-in functions useful in several domains such as statistics, finances, and mathematics. It can import and export the Excel file format. Abacus can produce &postscript; output. - To install Abacus from its + To install Abacus as a package, do: &prompt.root; pkg_add -r abacus >Release-Note: >Audit-Trail: >Unformatted: