From owner-svn-doc-all@FreeBSD.ORG Mon Oct 7 14:15:15 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id BEFA9592; Mon, 7 Oct 2013 14:15:15 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id AB9B526CC; Mon, 7 Oct 2013 14:15:15 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r97EFFL7046716; Mon, 7 Oct 2013 14:15:15 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r97EFFTc046715; Mon, 7 Oct 2013 14:15:15 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310071415.r97EFFTc046715@svn.freebsd.org> From: Dru Lavigne Date: Mon, 7 Oct 2013 14:15:15 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42872 - head/en_US.ISO8859-1/books/handbook/desktop X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 07 Oct 2013 14:15:15 -0000 Author: dru Date: Mon Oct 7 14:15:15 2013 New Revision: 42872 URL: http://svnweb.freebsd.org/changeset/doc/42872 Log: This patch does the following: - comments authors - spells out or rewords hyperlinks - adds note about PC-BSD - minor wordsmithing The next patch for this chapter will make igor happy. Approved by: bcr (mentor) Modified: head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml Mon Oct 7 10:29:38 2013 (r42871) +++ head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml Mon Oct 7 14:15:15 2013 (r42872) @@ -6,13 +6,13 @@ - + Desktop Applications @@ -22,14 +22,20 @@ While &os; is popular as a server for its performance and stability, it is also suited for day-to-day use as a desktop. - With over &os.numports; applications available as packages or ports, it is easy to build a + With over &os.numports; applications available as &os; packages or + ports, it is easy to build a customized desktop that runs a wide variety of desktop applications. This chapter demonstrates how to install some - popular desktop applications effortlessly using packages or the + popular desktop applications using packages or the &os; Ports Collection. + + Users who prefer to install a pre-built desktop + version of FreeBSD rather than configuring one from scratch + should refer to the pcbsd.org + website. + + As &os; features &linux; binary compatibility, many applications developed for &linux; can be installed on a &os; desktop. Many of the ports using @@ -115,7 +121,7 @@ OpenOffice openoffice editors/openoffice-3 + role="package">editors/openoffice-4 @@ -191,18 +197,20 @@ Install additional software using packages or - ports. + ports as described in . + + + + Install X and a window manager as described in . - Enable &linux; binary compatibility. + Enable &linux; binary compatibility as described in . For information on how to configure a multimedia - environment, refer to . For - information on how to set up and use electronic mail, refer to - . + environment, refer to . @@ -252,7 +260,7 @@ Firefox medium heavy - &os; and &linux; versions are available + &os;, &linux;, and localized versions are available @@ -287,15 +295,15 @@ Firefox - Firefox is a modern, free, + Firefox is an open source browser that is fully ported to &os;. It features a standards-compliant HTML display engine, tabbed browsing, popup blocking, extensions, improved security, and more. Firefox is based on the Mozilla codebase. - Install the package of the latest release version of - Firefox by typing: + To install the package of the latest release version of + Firefox, type: &prompt.root; pkg_add -r firefox @@ -309,7 +317,7 @@ role="package">www/firefox-esr-i18n. The Ports Collection can instead be used to compile - the desired version of firefox from + the desired version of Firefox from source code. This example builds www/firefox, where firefox can be replaced with the ESR or @@ -321,13 +329,9 @@ Firefox and &java; Plugin - - The following sections assume that - Firefox is already - installed. - - - java/icedtea-web + The installation of + Firefox does not include &java; + support. However, java/icedtea-web provides a free software web browser plugin for running Java applets. It can be installed as a package. To alternately compile the port: @@ -362,11 +366,11 @@ A native &adobe; &flash; plugin is not available for &os;. - However, a software layer (wrapper) for running the &linux; - version of the plugin exists. This wrapper also provides + However, a software wrapper for running the &linux; + version of the plugin is available. This wrapper also provides support for other browser plugins such as &realplayer;. - To install and enable this plugin: + To install and enable this plugin, perform these steps: @@ -415,11 +419,10 @@ Firefox and Swfdec &flash; Plugin - Swfdec is the library for decoding and rendering &flash; - animations. Swfdec-Mozilla is a plugin for + Swfdec is a decoder and renderer for &flash; + animations. Swfdec-Mozilla is a plugin for Firefox browsers that uses the - Swfdec library for playing SWF files. It is still in heavy - development. + Swfdec library for playing SWF files. To install the package: @@ -431,8 +434,7 @@ &prompt.root; cd /usr/ports/www/swfdec-plugin &prompt.root; make install clean - Restart the browser for this plugin to take - effect. + Restart the browser to activate this plugin. @@ -473,7 +475,7 @@ as a package is not available due to licensing restrictions. Then install either the www/opera-linuxplugins port - or package. This example compiles both from ports: + or package. This example compiles both applications from ports: &prompt.root; cd /usr/ports/www/linux-f10-flashplugin11 &prompt.root; make install clean @@ -487,8 +489,7 @@ all the currently available plugins. To add the &java; plugin, - follow the instructions for - Firefox. + follow the instructions in . @@ -498,11 +499,10 @@ Konqueror - Konqueror is part of x11/kde4-baseapps. - Konqueror is more than a web + Konqueror is more than a web browser as it is also a file manager and a multimedia - viewer. + viewer. It is included in the x11/kde4-baseapps package or port. Konqueror supports WebKit as well as its own KHTML. WebKit is a rendering engine used by @@ -565,23 +565,19 @@ Chromium and &java; Plugin - - The following sections assume that - Chromium is already - installed. - - - To install &java; plugin support, follow the instructions + The installation of + Chromium does not include &java; + support. To install &java; plugin support, follow the instructions in . Once &java; support is installed, start - Chromium, and enter + Chromium and enter about:plugins in the address bar. IcedTea-Web should be listed as one of the installed plugins. If Chromium does not display - the IcedTea-Web plugin, run the following commands, and + the IcedTea-Web plugin, run the following commands and restart the web browser: &prompt.root; mkdir -p /usr/local/share/chromium/plugins @@ -594,8 +590,7 @@ Configuring Chromium and &adobe; &flash; is similar to the - instructions for - Firefox. No additional configuration should be + the instructions in . No additional configuration should be necessary, since Chromium is able to use some plugins from other browsers. @@ -605,13 +600,13 @@ Productivity - When it comes to productivity, new users often look for a - good office suite or a friendly word processor. While some + When it comes to productivity, new users often look for an + office suite or an easy-to-use word processor. While some desktop environments like - KDE already provide an office suite, + KDE provide an office suite, there is no default productivity package. Several office - suites and word processors are available for &os;, regardless - of the installed desktop environment. + suites and graphical word processors are available for &os;, regardless + of the installed window manager. This section demonstrates how to install the following popular productivity software and indicates if the application @@ -685,8 +680,8 @@ Calligra - The KDE community provides its desktop environment with - an office suite which can be used outside of + The KDE desktop environment includes + an office suite which can be installed separately from KDE. Calligra includes standard components that can be found in other office suites. @@ -696,7 +691,7 @@ and Karbon is used to draw graphical documents. - In &os;, editors/calligra can be installed as a package or a port. To install the package: @@ -718,13 +713,12 @@ AbiWord is a free word processing program similar in look and feel to - µsoft; Word. It is suitable - for typing papers, letters, reports, memos, and so forth. It + µsoft; Word. It is fast, contains many features, and is user-friendly. AbiWord can import or export many file formats, including some proprietary ones like - µsoft; .doc. + µsoft; .rtf. To install the AbiWord package: @@ -763,9 +757,9 @@ &prompt.root; cd /usr/ports/graphics/gimp &prompt.root; make install clean - The graphics - category of the Ports Collection contains several + The graphics category (freebsd.org/ports/graphics.html) + of the Ports Collection contains several GIMP-related plugins, help files, and user manuals. @@ -786,19 +780,14 @@ - On 1 June 2011, &oracle; donated the - OpenOffice.org code base to the - Apache Software Foundation. - OpenOffice.org is now known as - Apache OpenOffice and is developed + Apache OpenOffice is an open + source office suite which is developed under the wing of the Apache Software Foundation's - Incubator. - - Apache OpenOffice includes all - of the mandatory applications in a complete office + Incubator. It includes all + of the applications found in a complete office productivity suite: a word processor, spreadsheet, presentation manager, and drawing program. Its user - interface is very similar to other office suites, and it can + interface is 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 and internationalization has been extended to interfaces, spell @@ -812,29 +801,16 @@ Apache OpenOffice is stable and runs natively on &windows;, &solaris;, &linux;, &os;, and &macos; X. More information about Apache - OpenOffice can be found on the Apache - OpenOffice web site. For &os; specific - information, and to directly download packages, refer to the - web site of the &os; Apache - OpenOffice Porting Team. + OpenOffice can be found at openoffice.org. For &os; specific + information refer to porting.openoffice.org/freebsd/. To install the Apache OpenOffice package: &prompt.root; pkg_add -r apache-openoffice - - When running a -RELEASE version of &os;, this should - work. Otherwise, download the latest package from the - website of the &os; - Apache OpenOffice Porting Team - and install it using &man.pkg.add.1;. Both the current - release and development versions are available for download - at this web site. - - Once the package is installed, type the following command to launch Apache OpenOffice: @@ -842,20 +818,17 @@ where X.Y.Z is the version number of the installed version of - Apache OpenOffice. - - - During the first launch, some questions will be asked - and a .openoffice.org folder + Apache OpenOffice. The first time + Apache OpenOffice launches, some questions will be asked + and a .openoffice.org folder will be created in the user's home directory. - If the desired Apache OpenOffice package is not available, compiling - the port is still an opton. However, this requires a lot of + the port is still an option. However, this requires a lot of disk space and a fairly long time to compile: - &prompt.root; cd /usr/ports/editors/openoffice-3 + &prompt.root; cd /usr/ports/editors/openoffice-4 &prompt.root; make install clean @@ -886,15 +859,14 @@ LibreOffice is a free software office suite developed by The Document - Foundation. It is compatible with other major + url="http://www.documentfoundation.org/">documentfoundation.org. It is compatible with other major office suites and available on a variety of platforms. It is a rebranded fork of OpenOffice.org - which includes all of the mandatory applications in a complete + and includes applications found in a complete office productivity suite: a word processor, spreadsheet, presentation manager, drawing program, database management program, and a tool for creating and editing mathematical - formula. It is available in a number of different languages + formulæ. It is available in a number of different languages and internationalization has been extended to interfaces, spell checkers, and dictionaries. @@ -906,18 +878,17 @@ LibreOffice is stable and runs natively on &windows;, &linux;, &os;, and &macos; X. More information about - LibreOffice can be found on the - LibreOffice web - site. + LibreOffice can be found at + libreoffice.org. To install the English version of the LibreOffice package: &prompt.root; pkg_add -r libreoffice - The editors - category of the Ports Collection contains several + The editors category (freebsd.org/ports/editors.html) + of the Ports Collection contains several localizations for LibreOffice. When installing a localized package, replace libreoffice with the name of the @@ -928,11 +899,9 @@ &prompt.user; libreoffice - During the first launch, some questions will be asked and a .libreoffice folder will be created in the user's home directory. - If the desired LibreOffice package is not available, compiling the port is still an @@ -947,9 +916,9 @@ To build a localized version, cd into the port directory of the desired language. Supported languages can be found - in the editors - category of the Ports Collection. + in the editors category (freebsd.org/ports/editors.html) + of the Ports Collection. @@ -960,7 +929,7 @@ Some new document formats have gained popularity since the advent of &unix; and the viewers they require may not be available in the base system. This section demonstrates how to - install the following viewers: + install the following document viewers: @@ -1018,15 +987,15 @@ Many documents are now distributed as Portable Document - Format (PDF) files. One popular viewer for PDFs is + Format (PDF) files. One popular PDF viewer is &acrobat.reader;, released by &adobe; for &linux;. As &os; can run &linux; binaries, it is also available for &os;. Due to - licensing restrictions, a package is not available so it must + licensing restrictions, a package is not available, meaning that this application must be compiled from ports. Several localizations are - available from the print - category of the Ports Collection. + available from the print category (freebsd.org/ports/print.html) + of the Ports Collection. This command installs the English version of &acrobat.reader; 9 from the Ports @@ -1054,12 +1023,11 @@ viewing - gv is a + gv is a &postscript; and PDF viewer. It is based on ghostview, but has a nicer look - due to the Xaw3d library. It is - fast with a clean interface. gv + as it is based on the Xaw3d widget toolkit. + gv has many configurable features, such as orientation, paper size, scale, and anti-aliasing. Almost any operation can be performed with either the keyboard or the mouse. @@ -1088,12 +1056,11 @@ For users that prefer a small &os; PDF viewer, - xpdf provides a + Xpdf provides a light-weight and efficient viewer which requires few resources. It uses the standard X fonts and does not require - &motif; or any other X - toolkit. + any additional + toolkits. To install the Xpdf package: @@ -1118,8 +1085,7 @@ GQview - GQview is + GQview is an image manager which supports viewing a file with a single click, launching an external editor, and thumbnail previews. It also features a slideshow mode and some basic file @@ -1195,8 +1161,7 @@ GnuCash - GnuCash is part of the + GnuCash is part of the GNOME effort to provide user-friendly, yet powerful, applications to end-users. GnuCash can be used to keep track @@ -1235,11 +1200,10 @@ Gnumeric - Gnumeric + Gnumeric is a spreadsheet program developed by the GNOME community. It features - convenient automatic guessing of user input + convenient automatic guessing of user input according to the cell format with an autofill system for many sequences. It can import files in a number of popular formats, including Excel, @@ -1270,16 +1234,15 @@ KMyMoney - KMyMoney + KMyMoney is a personal finance application created by the KDE community. - KMyMoney intends to provide and - incorporate all the important features found in commercial + KMyMoney aims to provide + the important features found in commercial personal finance manager applications. It also highlights ease-of-use and proper double-entry accounting among its features. KMyMoney imports from - standard Quicken Interchange Format (QIF) files, tracks + standard Quicken QIF files, tracks investments, handles multiple currencies, and provides a wealth of reports.