Professionalize the descriptions of the pieces of the GNOME

system. Monkey-bubble's description still makes no sense ::)


git-svn-id: svn://creme-brulee.marcuscom.com/ports/trunk@2203 df743ca5-7f9a-e211-a948-0013205c9059

97 files changed, 263 insertions, 371 deletions

diff --git a/accessibility/at-spi/pkg-descr b/accessibility/at-spi/pkg-descr
index 9a558afb5..c832f3ba9 100644
--- a/accessibility/at-spi/pkg-descr
+++ b/accessibility/at-spi/pkg-descr
@@ -1,4 +1,6 @@
-This is the Early Access Release of the Gnome Accessibility Project's
-Assistive Technology Service Provider Interface.
+This is the Gnome Accessibility Project's Assistive Technology
+Service Provider Interface.  It allows accessibility applications
+and assistive technologies to announce their respective existence
+to each other.
 
-WWW: http://www.gnome.org/
+WWW: http://developer.gnome.org/projects/gap/
diff --git a/accessibility/atk/pkg-descr b/accessibility/atk/pkg-descr
index b28d3e537..ac3b71815 100644
--- a/accessibility/atk/pkg-descr
+++ b/accessibility/atk/pkg-descr
@@ -1,12 +1,5 @@
-Accessibility means helping people with disabilities to participate in
-substantial life activities. That includes work, and the use of services,
-products, and information. GNOME includes libraries and a support framework
-that allow people with disabilities to utilize all of the functionality of the
-GNOME user environment.
-
-The GNOME Accessibility Toolkit (ATK) describes a set of interfaces that need
-to be implemented by GUI components to make them accessible. The interfaces are
-toolkit-independent-- implementations could be written for any widget set, such
-as GTK, Motif or Qt.
+The GNOME Accessibility Toolkit (ATK) contains accessibility widgets,
+just like GTK contains GUI element widgets.  However, ATK's widgets
+are platform-independent, so they can be used with Qt, Motif, etc.
 
 WWW: http://developer.gnome.org/projects/gap/
diff --git a/accessibility/dasher/pkg-descr b/accessibility/dasher/pkg-descr
index 70df2911e..7ef3255f0 100644
--- a/accessibility/dasher/pkg-descr
+++ b/accessibility/dasher/pkg-descr
@@ -9,6 +9,6 @@ system wherever a full-size keyboard cannot be used - for example,
     * when operating a computer with zero hands (i.e., by head-mouse or
     * by eyetracker).
 
-Dasher is fast, efficient, easy to learn, and fun to use.
+Dasher is fast, efficient, and easy to learn.
 
 WWW: http://www.inference.phy.cam.ac.uk/dasher/
diff --git a/accessibility/gail/pkg-descr b/accessibility/gail/pkg-descr
index e32431209..50541e527 100644
--- a/accessibility/gail/pkg-descr
+++ b/accessibility/gail/pkg-descr
@@ -1,4 +1,5 @@
-Gail, the Gnome Accessibility Implementation library, is implementation of the
-ATK interfaces for GTK+ widgets.
+Gail, the Gnome Accessibility Implementation library, contains
+the bindings to integrate the platform-independent ATK accessibility
+widgets into the Gtk structure.
 
-WWW: http://www.gnome.org/
+WWW: http://developer.gnome.org/projects/gap/
diff --git a/accessibility/gnopernicus/pkg-descr b/accessibility/gnopernicus/pkg-descr
index d522adfa7..1719c6588 100644
--- a/accessibility/gnopernicus/pkg-descr
+++ b/accessibility/gnopernicus/pkg-descr
@@ -1,4 +1,4 @@
-Gnopernicus  provides Assistive Technologies (AT) for blind and visually 
+Gnopernicus provides Assistive Technologies (AT) for blind and visually 
 impaired persons through modules for text-to-speech, braille, etc.
 
 WWW: http://www.baum.ro/gnopernicus.html
diff --git a/accessibility/gok/pkg-descr b/accessibility/gok/pkg-descr
index 1eb987453..1ef635d80 100644
--- a/accessibility/gok/pkg-descr
+++ b/accessibility/gok/pkg-descr
@@ -1,4 +1,4 @@
-The GNOME On-Screen Keyboard (GOK) is an accessability interface
+The GNOME On-Screen Keyboard (GOK) is an accessibility interface
 that gives you control of your system without needing a keyboard.
 The GOK makes available a hierarchical button system that enables
 keyboardless entry of common accelerators, and contains a
diff --git a/archivers/file-roller/pkg-descr b/archivers/file-roller/pkg-descr
index 66b4bc9dd..703a89829 100644
--- a/archivers/file-roller/pkg-descr
+++ b/archivers/file-roller/pkg-descr
@@ -1,13 +1,10 @@
-File Roller is an archive manager for the GNOME environment. Archive manager
-means that you can create and modify archives, view the content of an archive,
-view a file contained in the archive, and extract files from the archive.
-
-File Roller is only a front-end (a graphical interface) to archiving programs
-like tar and zip. The supported file types are :
+File Roller is an archive manager for the GNOME environment.  It is only a
+front-end (a graphical interface) to archiving programs like tar and zip.
+The supported file types are:
 
 * Tar archives uncompressed (.tar) or compressed with gzip (.tar.gz , .tgz),
-bzip (.tar.bz , .tbz), bzip2 (.tar.bz2 , .tbz2), compress (.tar.Z , .taz),
-lzop (.tar.lzo , .tzo)
+  bzip (.tar.bz , .tbz), bzip2 (.tar.bz2 , .tbz2), compress (.tar.Z , .taz),
+  lzop (.tar.lzo , .tzo)
 * Zip archives (.zip)
 * Jar archives (.jar , .ear , .war)
 * Lha archives (.lzh)
@@ -15,9 +12,9 @@ lzop (.tar.lzo , .tzo)
 * Single files compressed with gzip, bzip, bzip2, compress, lzop
  
 File Roller also has a document viewer based on bonobo that lets you view files
-of any type you have a viewer for.
+of any type for which you have a viewer.
 
-Former WinZip users may find this program useful. It serves the same purpose.
+Former WinZip users may find this program useful.  It serves the same purpose.
 
 WWW: http://fileroller.sourceforge.net/
 
diff --git a/archivers/fileroller/pkg-descr b/archivers/fileroller/pkg-descr
index 66b4bc9dd..703a89829 100644
--- a/archivers/fileroller/pkg-descr
+++ b/archivers/fileroller/pkg-descr
@@ -1,13 +1,10 @@
-File Roller is an archive manager for the GNOME environment. Archive manager
-means that you can create and modify archives, view the content of an archive,
-view a file contained in the archive, and extract files from the archive.
-
-File Roller is only a front-end (a graphical interface) to archiving programs
-like tar and zip. The supported file types are :
+File Roller is an archive manager for the GNOME environment.  It is only a
+front-end (a graphical interface) to archiving programs like tar and zip.
+The supported file types are:
 
 * Tar archives uncompressed (.tar) or compressed with gzip (.tar.gz , .tgz),
-bzip (.tar.bz , .tbz), bzip2 (.tar.bz2 , .tbz2), compress (.tar.Z , .taz),
-lzop (.tar.lzo , .tzo)
+  bzip (.tar.bz , .tbz), bzip2 (.tar.bz2 , .tbz2), compress (.tar.Z , .taz),
+  lzop (.tar.lzo , .tzo)
 * Zip archives (.zip)
 * Jar archives (.jar , .ear , .war)
 * Lha archives (.lzh)
@@ -15,9 +12,9 @@ lzop (.tar.lzo , .tzo)
 * Single files compressed with gzip, bzip, bzip2, compress, lzop
  
 File Roller also has a document viewer based on bonobo that lets you view files
-of any type you have a viewer for.
+of any type for which you have a viewer.
 
-Former WinZip users may find this program useful. It serves the same purpose.
+Former WinZip users may find this program useful.  It serves the same purpose.
 
 WWW: http://fileroller.sourceforge.net/
 
diff --git a/audio/marlin/pkg-descr b/audio/marlin/pkg-descr
index d56d2c79a..a9542529e 100644
--- a/audio/marlin/pkg-descr
+++ b/audio/marlin/pkg-descr
@@ -1,5 +1,5 @@
-Marlin is a audio sample editor for GNOME 2. It uses Gstreamer as a backend,
-resulting in support of numerous file formats. Marlin can also record
+Marlin is a audio sample editor for GNOME 2. It uses Gstreamer as a backend
+to provide support for numerous file formats. Marlin can also record
 from microphone or rip audio from CD.
 
 WWW: http://marlin.sourceforge.net/
diff --git a/audio/sound-juicer/pkg-descr b/audio/sound-juicer/pkg-descr
index d2fe92826..ec4721433 100644
--- a/audio/sound-juicer/pkg-descr
+++ b/audio/sound-juicer/pkg-descr
@@ -1,5 +1,5 @@
 Sound Juicer is a clean, mean and lean CD ripper for GNOME2.
-It supports a clean interface and simple preferences, aiming
+It provides a clean interface and simple preferences, aiming
 to do The Right Thing and What You Mean all of the time.
 
 WWW: http://www.burtonini.com/blog/computers/sound-juicer/
diff --git a/databases/evolution-data-server/pkg-descr b/databases/evolution-data-server/pkg-descr
index 5a78b77ef..076bb0ef7 100644
--- a/databases/evolution-data-server/pkg-descr
+++ b/databases/evolution-data-server/pkg-descr
@@ -1,3 +1,3 @@
-Evolution-data-server makes up the various backend components for the 
-Evolution integrated mail/PIM suite.  This includes the backend Berkeley
-database as well as the libical calendar components.
+Evolution-data-server provides the various backend components for the 
+Evolution integrated mail/PIM suite, including the Berkeley database
+backend and the libical calendar components.
diff --git a/deskutils/gnome-utils/pkg-descr b/deskutils/gnome-utils/pkg-descr
index 3aaba4bf6..bfe154899 100644
--- a/deskutils/gnome-utils/pkg-descr
+++ b/deskutils/gnome-utils/pkg-descr
@@ -1,3 +1,2 @@
-GNOME 2.0 support utilities, including an on-the-fly dialog box tool
-(like Zenity), a dictionary, a frontend for find(1), a system log
-viewer, and more.
+GNOME 2.0 support utilities, including a dictionary looker-upper,
+a frontend for find(1), a system log viewer, and more.
diff --git a/deskutils/gnomeutils2/pkg-descr b/deskutils/gnomeutils2/pkg-descr
index 3aaba4bf6..bfe154899 100644
--- a/deskutils/gnomeutils2/pkg-descr
+++ b/deskutils/gnomeutils2/pkg-descr
@@ -1,3 +1,2 @@
-GNOME 2.0 support utilities, including an on-the-fly dialog box tool
-(like Zenity), a dictionary, a frontend for find(1), a system log
-viewer, and more.
+GNOME 2.0 support utilities, including a dictionary looker-upper,
+a frontend for find(1), a system log viewer, and more.
diff --git a/deskutils/gucharmap/pkg-descr b/deskutils/gucharmap/pkg-descr
index 20fe556a3..e69361663 100644
--- a/deskutils/gucharmap/pkg-descr
+++ b/deskutils/gucharmap/pkg-descr
@@ -1,4 +1,4 @@
-gucharmap is a Unicode/ISO10646 character map and font viewer. It uses GTK+ 
-2. It supports anti-aliased, scalable fonts.
+gucharmap is a Unicode/ISO10646 character map and font viewer.  It uses
+GTK+ 2, and supports anti-aliased, scalable fonts.
 
 WWW: http://gucharmap.sourceforge.net/
diff --git a/devel/ORBit2/pkg-descr b/devel/ORBit2/pkg-descr
index 8336574a1..57ee9653d 100644
--- a/devel/ORBit2/pkg-descr
+++ b/devel/ORBit2/pkg-descr
@@ -1,3 +1,3 @@
 ORBit is a high-performance CORBA ORB with support for the C language.
-It allows programs to send requests and receive replies from other
-programs, regardless of the locations of the two programs.
+It allows programs to comminucate with each other, regardless of their
+physical and logical locations.
diff --git a/devel/bugbuddy2/pkg-descr b/devel/bugbuddy2/pkg-descr
index 0a572e8cc..7268130ab 100644
--- a/devel/bugbuddy2/pkg-descr
+++ b/devel/bugbuddy2/pkg-descr
@@ -1,5 +1,6 @@
-This is a graphical bug reporting tool.  It can extract debugging
-information from a core file or crashed application (via gnome_segv).
+This is a bug reporting tool.  It pops up automatically when a GNOME
+app crashes under the GNOME desktop (via gnome_segv), and allows
+the crash information to be sent to the app's developers.
 
 Jacob Berkman  <jberkman@andrew.cmu.edu>
 
diff --git a/devel/gconf2/pkg-descr b/devel/gconf2/pkg-descr
index 0658ef70f..010cc810e 100644
--- a/devel/gconf2/pkg-descr
+++ b/devel/gconf2/pkg-descr
@@ -1,22 +1,18 @@
-GConf attempts to leapfrog the registry concept. It's a library which provides
-a simple configuration data storage interface to applications, and also an
-architecture that tries to make things easy for system administrators.
+GConf extends the concept of a configuration registry.  It provides
+a simple way for applications and administrators to store data;
+often GConf is used to store preferences for applications.
 
-Here are some of the features of GConf:
+Some of the features of GConf are:
+GConf provides:
 
-    * Replaceable backend architecture.
+    * Documentation for each configuration key, so that administrators
+      can better modify the value.
 
-    * Configuration key documentation. Applications can install documentation
-      along with their configuration data, explaining the possible settings and
-      the effect of each configuration key.
+    * Notifications to interested applications when configuration data
+      is changed.  The notification service works across networks,
+      affecting all login sessions for a single user.
 
-    * Data change notification service. If configuration data is changed, all
-      interested applications are notified. The notification service works
-      across the network, affecting all login sessions for a single user.
-
-    * The client API is very abstract.
-
-    * GConf does proper locking so that the configuration data doesn't get
-      corrupted when multiple applications try to use it.
+    * Proper locking so that configuration data doesn't get corrupted
+      when accessed by multiple applications at the same time.
 
 WWW: http://www.gnome.org/projects/gconf/
diff --git a/devel/glade2/pkg-descr b/devel/glade2/pkg-descr
index ba67d8da4..b74a7247c 100644
--- a/devel/glade2/pkg-descr
+++ b/devel/glade2/pkg-descr
@@ -1,5 +1,5 @@
 Glade is a RAD tool to enable quick & easy development of user interfaces
-for GTK+/GNOME. It also contains built-in support for generating the
-C source code needed to recreate the interfaces.
+for GTK+/GNOME.  It can generate the C source code needed to create
+the interfaces designed within Glade's interface editor.
 
 WWW: http://glade.gnome.org/
diff --git a/devel/glib20/pkg-descr b/devel/glib20/pkg-descr
index d762ed2f4..3b3059030 100644
--- a/devel/glib20/pkg-descr
+++ b/devel/glib20/pkg-descr
@@ -1,13 +1,5 @@
-This is GLib version 2.0.  GLib, is a library which includes support
-routines for C such as lists, trees, hashes, memory allocation, and
-many other things.
+GLib provides a simple, abstract, and highly portable set of C support
+routines such as lists, trees, hashes, memory allocation, and much, much
+more.  It is a foundation for writing portable applications.
 
 WWW: http://www.gtk.org/
-ftp://ftp.gtk.org/pub/gtk
-
-A mailing list is located at gtk-list@redhat.com for discussion.
-
-GLib-2.0 is a stable release that forms the basis of GTK+-2.0.
-
-- Vanilla
-vanilla@FreeBSD.ORG
diff --git a/devel/gnome-vfs/pkg-descr b/devel/gnome-vfs/pkg-descr
index 81cfcd5dd..03cbc07f6 100644
--- a/devel/gnome-vfs/pkg-descr
+++ b/devel/gnome-vfs/pkg-descr
@@ -1,14 +1,7 @@
-This is the GNOME Virtual File System.
-
-GnomeVFS is a filesystem abstraction library allowing applications
-plugable transparent access to a variety of "real" filesystems, from
-WebDAV to digital cameras, to the local filesystem. It also contains a
-number of other convenient file utilities such as a comphrehensive MIME
-database / Application registry, and a copy engine. Use of GnomeVFS
-ensures that an application or component will be usable by Nautilus or
-other GnomeVFS applications for handling the display of data from
-various URIs, as well.
-
-This is the GnomeVFS for the GNOME 2 architecture.
+The GNOME Virtual File System allows applications and users to treat
+any number of file system concepts as a part of the local filesystem.
+With GnomeVFS, filesystems across the internet, on connected devices,
+and in multiple formats are as simple to access (and write code for)
+as any directory on the local machine.
 
 WWW: http://www.gnome.org/
diff --git a/devel/gnomevfs2/pkg-descr b/devel/gnomevfs2/pkg-descr
index 81cfcd5dd..03cbc07f6 100644
--- a/devel/gnomevfs2/pkg-descr
+++ b/devel/gnomevfs2/pkg-descr
@@ -1,14 +1,7 @@
-This is the GNOME Virtual File System.
-
-GnomeVFS is a filesystem abstraction library allowing applications
-plugable transparent access to a variety of "real" filesystems, from
-WebDAV to digital cameras, to the local filesystem. It also contains a
-number of other convenient file utilities such as a comphrehensive MIME
-database / Application registry, and a copy engine. Use of GnomeVFS
-ensures that an application or component will be usable by Nautilus or
-other GnomeVFS applications for handling the display of data from
-various URIs, as well.
-
-This is the GnomeVFS for the GNOME 2 architecture.
+The GNOME Virtual File System allows applications and users to treat
+any number of file system concepts as a part of the local filesystem.
+With GnomeVFS, filesystems across the internet, on connected devices,
+and in multiple formats are as simple to access (and write code for)
+as any directory on the local machine.
 
 WWW: http://www.gnome.org/
diff --git a/devel/gtranslator/pkg-descr b/devel/gtranslator/pkg-descr
index 4a01aef41..e5988ceb9 100644
--- a/devel/gtranslator/pkg-descr
+++ b/devel/gtranslator/pkg-descr
@@ -1,5 +1,5 @@
-Gtranslator assists in the creation of GNU gettext translations. Its features include
-auto-learning of translation rules, fuzzy string manipulation, and self-contained
-msgfmt compilation/testing.
+Gtranslator is a Gtk+-2 GUI to assist in the creation of GNU gettext
+translations.  It features auto-learning of translation rules, fuzzy
+string manipulation, and self-contained msgfmt compilation/testing.
 
 WWW: http://www.gtranslator.org/
diff --git a/devel/libbonobo/pkg-descr b/devel/libbonobo/pkg-descr
index 19f9323f3..c555fab9a 100644
--- a/devel/libbonobo/pkg-descr
+++ b/devel/libbonobo/pkg-descr
@@ -1,5 +1,5 @@
-Bonobo is a set of language and system independant CORBA interfaces
-for creating reusable components, controls and creating compound
-documents.
+Bonobo is a set of language- and system-independant CORBA interfaces
+for creating reusable components and controls, and for creating
+compound documents.
 
 WWW: http://www.gnome.org/
diff --git a/devel/libglade2/pkg-descr b/devel/libglade2/pkg-descr
index dd6a386e9..7335dd1ea 100644
--- a/devel/libglade2/pkg-descr
+++ b/devel/libglade2/pkg-descr
@@ -1,5 +1,3 @@
-A library that allows you to load GLADE interfaces at runtime (you don't
-have to generate stubs with GLADE before hand). This way you can change
-the look of your application without recompiling. This way you can write
-the logic behind the interface separately from the code to build the
-interface, so changing the interface is not so much of a problem. 
+LibGlade allows GLADE interfaces to be handled at runtime, freeing
+GUI development from code development.  This allows an interface to
+be changed without requiring a re-compilation.
diff --git a/devel/libgtop2/pkg-descr b/devel/libgtop2/pkg-descr
index be81b3b48..f263f1127 100644
--- a/devel/libgtop2/pkg-descr
+++ b/devel/libgtop2/pkg-descr
@@ -1,3 +1,3 @@
-This is library for the gtop2, the GNOME 2.0 version of top command.
-The top command is a tool to display  and  update information about the
-top cpu processes.
+This library provides the backend for gtop2, a GNOME 2.0 version
+of top(1) that allows display and manipulation of running
+processes.
diff --git a/devel/libsoup/pkg-descr b/devel/libsoup/pkg-descr
index 423bf5cfc..1ec2bfea4 100644
--- a/devel/libsoup/pkg-descr
+++ b/devel/libsoup/pkg-descr
@@ -1,17 +1,16 @@
 Soup is a SOAP (Simple Object Access Protocol) implementation in C. 
 
-It provides an queued asynchronous callback-based mechanism for sending and
-servicing SOAP requests, and a WSDL (Web Service Definition Language) to C
-compiler which generates client stubs and server skeletons for easily calling
-and implementing SOAP methods.
-
-It uses the GLib main loop and is designed to work well with GTK applications.
+It provides a queued asynchronous callback-based mechanism for sending and
+servicing SOAP requests, and a WSDL (Web Service Definition Language) for C
+compilers which generates client stubs and server skeletons for easily
+calling and implementing SOAP methods.  It uses GLib and is designed to work
+well with GTK applications.
 
 Features:
   * Completely Asynchronous
   * Connection cache
   * HTTP chunked transfer and persistent connections
-  * authenticated HTTP, SOCKS4, and SOCKS5 proxy support
+  * Authenticated HTTP, SOCKS4, and SOCKS5 proxy support
   * SSL Support using OpenSSL
   * Apache module server support
   * Client digest authentication
diff --git a/devel/libsoup22/pkg-descr b/devel/libsoup22/pkg-descr
index 423bf5cfc..1ec2bfea4 100644
--- a/devel/libsoup22/pkg-descr
+++ b/devel/libsoup22/pkg-descr
@@ -1,17 +1,16 @@
 Soup is a SOAP (Simple Object Access Protocol) implementation in C. 
 
-It provides an queued asynchronous callback-based mechanism for sending and
-servicing SOAP requests, and a WSDL (Web Service Definition Language) to C
-compiler which generates client stubs and server skeletons for easily calling
-and implementing SOAP methods.
-
-It uses the GLib main loop and is designed to work well with GTK applications.
+It provides a queued asynchronous callback-based mechanism for sending and
+servicing SOAP requests, and a WSDL (Web Service Definition Language) for C
+compilers which generates client stubs and server skeletons for easily
+calling and implementing SOAP methods.  It uses GLib and is designed to work
+well with GTK applications.
 
 Features:
   * Completely Asynchronous
   * Connection cache
   * HTTP chunked transfer and persistent connections
-  * authenticated HTTP, SOCKS4, and SOCKS5 proxy support
+  * Authenticated HTTP, SOCKS4, and SOCKS5 proxy support
   * SSL Support using OpenSSL
   * Apache module server support
   * Client digest authentication
diff --git a/devel/scaffold/pkg-descr b/devel/scaffold/pkg-descr
index cb6157e27..bade29ab8 100644
--- a/devel/scaffold/pkg-descr
+++ b/devel/scaffold/pkg-descr
@@ -1,6 +1,3 @@
-Scaffold is meant to aid users with development work.  It provides an
-editor with syntax hilightlighting, a rudimentary project/build system
-and an interface to the gdb debugger.  The functionality can be
-extended with plugins that create various tools.
-
-Scaffold is based on the gIDE codebase.
+Scaffold aids software development.  It provides an editor with syntax
+hilightighting, a rudimentary project/build system, an interface to
+the gdb debugger, and a plugin system.
diff --git a/editors/AbiWord2/pkg-descr b/editors/AbiWord2/pkg-descr
index 7a56a9547..140b96c74 100644
--- a/editors/AbiWord2/pkg-descr
+++ b/editors/AbiWord2/pkg-descr
@@ -1,22 +1,8 @@
-AbiWord is an open-source, cross-platform WYSIWYG word processor.  It works
-on Windows and most Unix Systems.
+AbiWord is an open-source, cross-platform WYSIWYG word processor,
+available on Windows and most Unix Systems.
 
-Features include: 
+It provides many features of, and is compatible with, Microsoft Word.
 
- - Basic character formatting (bold, underline, italics, etc.) 
- - Paragraph alignment 
- - Spell-check 
- - Import of Word97 and RTF documents 
- - Export to RTF, Text, HTML, and LaTeX formats 
- - Interactive rulers and tabs 
- - Styles 
- - Unlimited undo/redo 
- - Multiple column control 
- - Widow/orphan control 
- - Find/Replace 
- - Anti-aliased fonts
- - Images 
-
-For more information, or to see screenshots, visit the AbiSource home page
-at
+For more information, or to see screenshots, visit the AbiSource
+home page, at
 WWW:  http://www.abisource.com/
diff --git a/editors/gedit2/pkg-descr b/editors/gedit2/pkg-descr
index 3ccfe39b0..85018482c 100644
--- a/editors/gedit2/pkg-descr
+++ b/editors/gedit2/pkg-descr
@@ -1,21 +1,11 @@
-gEdit is a text editor for X using the GTK+ and GNOME libraries.
-It is being developed by Alex Roberts, Evan Lawrence and Chris Lahey
-(among others).
+gEdit is a Gtk+-2 text editor. Its features include:
 
-gEdit is quite a neat text editor. It contains the following
-features:
-	* Opening/Saving/Creating files
-	* File Revert
-	* Cut/Copy/Paste and Select All text
 	* Complete integration with the GNOME Environment, including GnomeMDI
-	* Search and Replace
-	* Global search
-	* A complete preferences interface
-	* Dynamically loading fonts
+	* Global Search and Replace
+	* Dynamically loaded fonts
 	* Splitscreen Mode
 	* Printing support 
 	* Configurable Plugins system
-	* Configurable window sizing
 	* Unlimited Undo/Redo
 
 WWW: http://gedit.sourceforge.net/
diff --git a/editors/ghex2/pkg-descr b/editors/ghex2/pkg-descr
index 355aa25e0..5e1d9e9fb 100644
--- a/editors/ghex2/pkg-descr
+++ b/editors/ghex2/pkg-descr
@@ -1,9 +1,6 @@
-GHEX is a simple binary editor, allowing the user to view
-and edit a binary file in both hex and ascii with multiple
-level undo/redo mechanism. It features find and replace
-functions and conversion between binary, octal, decimal
-and hexadecimal values, making use of an alternative,
-user-configurable MDI concept to allow the user to edit
-multiple documents with multiple views of each.
+GHEX is a simple binary editor, allowing binary files to be edited in
+both hex and ascii.  It features find and replace functions and conversion
+between binary, octal, decimal and hexadecimal values, making use of an
+alternative, user-configurable MDI concept.
 
 WWW: http://www.gnome.org/
diff --git a/editors/gnome2-office/pkg-descr b/editors/gnome2-office/pkg-descr
index a2e41bd46..8d27e0ef0 100644
--- a/editors/gnome2-office/pkg-descr
+++ b/editors/gnome2-office/pkg-descr
@@ -1,6 +1,6 @@
 GNOME 2 Office
 
-The Office is a collection of applications one would expect in an 
+The GNOME Office is a collection of applications one would expect in an 
 office/productivity suite for the GNOME 2 Desktop.  This includes a 
 spreadsheet application, a word processor, project management application, 
 database access application, groupware suite, and diagramming application.
diff --git a/games/gnome-games/pkg-descr b/games/gnome-games/pkg-descr
index 9d0fcb54b..547a44c3a 100644
--- a/games/gnome-games/pkg-descr
+++ b/games/gnome-games/pkg-descr
@@ -1,7 +1,7 @@
-The GNOME Desktop Environment's games application package, which includes
+The GNOME Desktop Environment's games application package includes
 card games (including a solitaire package which knows 69 distinct solitaire
-variations), knockoffs of Minesweeper, Tetris, mahjongg, Nibbles, action
-games, puzzle games, and more card games.
+variations); knockoffs of Minesweeper, Tetris, mahjongg, and Nibbles; action
+games; puzzle games; and even more card games.
 
 This package uses the GNOME 2 libraries.
 
diff --git a/games/gnomegames2/pkg-descr b/games/gnomegames2/pkg-descr
index 9d0fcb54b..547a44c3a 100644
--- a/games/gnomegames2/pkg-descr
+++ b/games/gnomegames2/pkg-descr
@@ -1,7 +1,7 @@
-The GNOME Desktop Environment's games application package, which includes
+The GNOME Desktop Environment's games application package includes
 card games (including a solitaire package which knows 69 distinct solitaire
-variations), knockoffs of Minesweeper, Tetris, mahjongg, Nibbles, action
-games, puzzle games, and more card games.
+variations); knockoffs of Minesweeper, Tetris, mahjongg, and Nibbles; action
+games; puzzle games; and even more card games.
 
 This package uses the GNOME 2 libraries.
 
diff --git a/games/monkeybubble/pkg-descr b/games/monkeybubble/pkg-descr
index b2bf4902d..cafb063d6 100644
--- a/games/monkeybubble/pkg-descr
+++ b/games/monkeybubble/pkg-descr
@@ -1,6 +1,6 @@
-Think Puzzle Bobble, but with monkeys. Monkeys that throw
-colourful things. It's a game, except SO MUCH MORE, because
-it has monkeys. It has sound and network play and a spiffy
+Think Puzzle Bobble, but with monkeys.  Monkeys that throw
+colourful things.  It's a game, except SO MUCH MORE, because
+it has monkeys.  It has sound and network play and a spiffy
 GTK+-2 interface, but that's all irrelevant because, come on...
 monkeys!
 
diff --git a/graphics/eog2/pkg-descr b/graphics/eog2/pkg-descr
index 958b6353b..fa7565d4c 100644
--- a/graphics/eog2/pkg-descr
+++ b/graphics/eog2/pkg-descr
@@ -1,7 +1,5 @@
-This is the Eye of Gnome, an image viewer program.  It is meant to be
-a fast and functional image viewer as well as an image cataloging
-program.
-
-This package requires the GNOME 2.0 development API.
+This is the Eye of Gnome, a GNOME 2 image viewer and cataloging
+application.  It provides inline image viewing support for
+nautilus.
 
 WWW: http://www.gnome.org/
diff --git a/graphics/gpdf/pkg-descr b/graphics/gpdf/pkg-descr
index 4d967a66f..d1735f2c2 100644
--- a/graphics/gpdf/pkg-descr
+++ b/graphics/gpdf/pkg-descr
@@ -1,6 +1,6 @@
 The GNOME PDF Viewer is an open source viewer for Portable Document
-Format (PDF) files.   (These are also sometimes called "Acrobat" files,
-from the name of Adobe's PDF software.)  The GNOME PDF viewer is based
-upon xpdf (ports/graphics/xpdf).
+Format (PDF) files, often called "Acrobat" files, from the name of
+Adobe's PDF software.  The GNOME PDF viewer is based upon xpdf, and
+integrates directly into the GNOME 2 desktop.
 
 WWW: http://www.gnome.org
diff --git a/graphics/libgnomecanvas/pkg-descr b/graphics/libgnomecanvas/pkg-descr
index 8900db783..a3d2ae327 100644
--- a/graphics/libgnomecanvas/pkg-descr
+++ b/graphics/libgnomecanvas/pkg-descr
@@ -1,6 +1,2 @@
-The GNOMECanvas library provides a number of features:
-
-	- Image loading facilities.
-	- Rendering of a GdkPixBuf into various formats:
-	  drawables (windows, pixmaps), GdkRGB buffers.
-	- A cache interface
+The GNOMECanvas library allows images to be used directly within
+GUIs.
diff --git a/graphics/librsvg2/pkg-descr b/graphics/librsvg2/pkg-descr
index b3f050b65..3f521eda2 100644
--- a/graphics/librsvg2/pkg-descr
+++ b/graphics/librsvg2/pkg-descr
@@ -1,7 +1,7 @@
 The librsvg library is a lightweight library for parsing and rendering
-vector-graphic files in SVG format (like the ones made by sodipodi). It also
+vector-graphic files in SVG format (like the ones made by sodipodi).  It also
 includes functions that render anti-aliased fonts using freetype, including
-caching of glyphs. It's used by Nautilus for drawing vector icons and
-anti-aliased type.
+caching of glyphs.  It is used by Nautilus for drawing vector icons and
+anti-aliased text.
 
 WWW: http://www.gnome.org/
diff --git a/mail/contact-lookup-applet/pkg-descr b/mail/contact-lookup-applet/pkg-descr
index d472e61f7..71e405abb 100644
--- a/mail/contact-lookup-applet/pkg-descr
+++ b/mail/contact-lookup-applet/pkg-descr
@@ -1,4 +1,4 @@
-Contract Lookup Applet is a gnome panel tool to lookup people using the
+Contact Lookup Applet is a gnome panel tool to look up people using the
 Evolution data server backend.
 
 WWW: http://www.burtonini.com/
diff --git a/mail/evolution/pkg-descr b/mail/evolution/pkg-descr
index 5e9708594..47965256d 100644
--- a/mail/evolution/pkg-descr
+++ b/mail/evolution/pkg-descr
@@ -1,11 +1,9 @@
 Ximian Evolution[tm] is the premier personal and workgroup information
-management solution for UNIX. The software seamlessly integrates email,
-calendaring, meeting scheduling, contact management and online task lists in
-one powerful, fast, and easy to use application. Ximian Evolution also
-delivers a comprehensive set of features that help you keep your work
-organized and your projects on track. Automatic email indexing keeps your
-information at your fingertips. The unique Ximian vFolders[tm] are virtual
-folders you use to create and save powerful contextual views of your email
-messages. 
+management solution for UNIX.  Evolution seamlessly integrates email,
+calendaring, meeting scheduling, contact management and online task lists
+in one powerful, fast, and easy to use application.  It also delivers a
+comprehensive set of features that help keep work organized and projects
+on track.  The unique Ximian vFolders[tm] are virtual folders used to
+create and save powerful contextual views of email messages. 
 
 WWW: http://www.ximian.com/products/ximian_evolution/
diff --git a/misc/gnome-icon-theme/pkg-descr b/misc/gnome-icon-theme/pkg-descr
index e22da77ba..426526f6d 100644
--- a/misc/gnome-icon-theme/pkg-descr
+++ b/misc/gnome-icon-theme/pkg-descr
@@ -1 +1,3 @@
-gnome-icon-theme is a collection of icons and emblems for the GNOME 2 desktop.
+gnome-icon-theme is a collection of icons and emblems for the
+GNOME 2 desktop.  Included are the images used in toolbars,
+dialog boxes, etc.
diff --git a/misc/gnome-user-docs/pkg-descr b/misc/gnome-user-docs/pkg-descr
index 0ba21f5fd..0ed2fb1bc 100644
--- a/misc/gnome-user-docs/pkg-descr
+++ b/misc/gnome-user-docs/pkg-descr
@@ -1 +1 @@
-GNOME 2 users guide.
+User documentation for the GNOME 2 desktop.
diff --git a/misc/gnomeuserdocs2/pkg-descr b/misc/gnomeuserdocs2/pkg-descr
index 0ba21f5fd..0ed2fb1bc 100644
--- a/misc/gnomeuserdocs2/pkg-descr
+++ b/misc/gnomeuserdocs2/pkg-descr
@@ -1 +1 @@
-GNOME 2 users guide.
+User documentation for the GNOME 2 desktop.
diff --git a/multimedia/gstreamer-ffmpeg/pkg-descr b/multimedia/gstreamer-ffmpeg/pkg-descr
index 7bacd1cf1..b8a091e35 100644
--- a/multimedia/gstreamer-ffmpeg/pkg-descr
+++ b/multimedia/gstreamer-ffmpeg/pkg-descr
@@ -1,5 +1,5 @@
-Gstreamer ffmpeg package provides:
- * codecs for most popular formats
- * optimized colorspace conversion
+The Gstreamer ffmpeg package provides mpeg support for Gstreamer.
+It includes codecs for most popular formats, and optimized
+colourspace conversion.
 
 WWW: http://gstreamer.freedesktop.org/
diff --git a/multimedia/gstreamer-player/pkg-descr b/multimedia/gstreamer-player/pkg-descr
index bc9dd3148..9b132c975 100644
--- a/multimedia/gstreamer-player/pkg-descr
+++ b/multimedia/gstreamer-player/pkg-descr
@@ -1,3 +1,3 @@
-Simple yet functional mediaplayer written with GStreamer
+Simple yet functional media player driven by GStreamer.
 
 WWW: http://gstreamer.sourceforge.net/
diff --git a/multimedia/nautilus-media/pkg-descr b/multimedia/nautilus-media/pkg-descr
index c751c5804..c8ad32667 100644
--- a/multimedia/nautilus-media/pkg-descr
+++ b/multimedia/nautilus-media/pkg-descr
@@ -1,2 +1,2 @@
-Nautilus-media is a GStreamer-based multimedia support for Nautilus, including 
-an awesome new music view and video thumbnailing.
+Nautilus-media provides GStreamer-based multimedia support within
+Nautilus, including music previewing and video thumbnailing.
diff --git a/net/gnome-netstatus/pkg-descr b/net/gnome-netstatus/pkg-descr
index 85e70885c..0848cf01f 100644
--- a/net/gnome-netstatus/pkg-descr
+++ b/net/gnome-netstatus/pkg-descr
@@ -1,2 +1,2 @@
-Gnome-netstatus is an applet which provides information about a network 
-interface on your panel.
+Gnome-netstatus is a panel applet which provides information about 
+network interfaces.
diff --git a/net/gnomenetstatus/pkg-descr b/net/gnomenetstatus/pkg-descr
index 85e70885c..0848cf01f 100644
--- a/net/gnomenetstatus/pkg-descr
+++ b/net/gnomenetstatus/pkg-descr
@@ -1,2 +1,2 @@
-Gnome-netstatus is an applet which provides information about a network 
-interface on your panel.
+Gnome-netstatus is a panel applet which provides information about 
+network interfaces.
diff --git a/print/libgnomeprint/pkg-descr b/print/libgnomeprint/pkg-descr
index f7ae47f42..ad9ac2ec1 100644
--- a/print/libgnomeprint/pkg-descr
+++ b/print/libgnomeprint/pkg-descr
@@ -1,4 +1,3 @@
-This is a prototype implementation of the Gnome Printing Architecture,
-as described in:
+The basis for the Gnome Printing Architecture as described in:
 
 WWW: http://www.gnome.org/projects/gnome-print/
diff --git a/sysutils/gconf-editor/pkg-descr b/sysutils/gconf-editor/pkg-descr
index f840cc1d2..0c8d23c9b 100644
--- a/sysutils/gconf-editor/pkg-descr
+++ b/sysutils/gconf-editor/pkg-descr
@@ -1,2 +1,2 @@
-gconf-editor is a gconf database editor for GNOME 2.0.  It is similar to 
+gconf-editor is a GNOME 2 GConf database editor.  It is analogous to
 regedit on Windows.
diff --git a/sysutils/gnome-control-center/pkg-descr b/sysutils/gnome-control-center/pkg-descr
index 017e3d76e..26d4dbe92 100644
--- a/sysutils/gnome-control-center/pkg-descr
+++ b/sysutils/gnome-control-center/pkg-descr
@@ -1 +1 @@
-control center for GNOME 2.0 project.
+Configuration tools tightly integrated within the GNOME 2 desktop.
diff --git a/sysutils/gnomecontrolcenter2/pkg-descr b/sysutils/gnomecontrolcenter2/pkg-descr
index 017e3d76e..26d4dbe92 100644
--- a/sysutils/gnomecontrolcenter2/pkg-descr
+++ b/sysutils/gnomecontrolcenter2/pkg-descr
@@ -1 +1 @@
-control center for GNOME 2.0 project.
+Configuration tools tightly integrated within the GNOME 2 desktop.
diff --git a/sysutils/nautilus-cd-burner/pkg-descr b/sysutils/nautilus-cd-burner/pkg-descr
index c3520e981..0bdde4f1a 100644
--- a/sysutils/nautilus-cd-burner/pkg-descr
+++ b/sysutils/nautilus-cd-burner/pkg-descr
@@ -1,6 +1,2 @@
-nautilus-cd-burner is an extension to Nautilus that makes it easy to
-write files to a CD burner.
-
-The user uses Nautilus or another gnome-vfs aware app to copy the
-files he wants to write to burn:///, and then nautilus-cd-burner is
-launched in some way to write the files to the CD.
+Nautilus-cd-burner allows CDs to be created and burned directly from
+within Nautilus (using the burn:/// URI).
diff --git a/textproc/gnome-spell/pkg-descr b/textproc/gnome-spell/pkg-descr
index a5004d360..10f0e6faa 100644
--- a/textproc/gnome-spell/pkg-descr
+++ b/textproc/gnome-spell/pkg-descr
@@ -1,6 +1,3 @@
-Gnome Spell is GNOME/Bonobo component for spell checking. In current version
-it contains GNOME::Spell::Dictionary object, which provides spell checking
-dictionary. It's based on pspell package, which is required to build
-gnome-spell.
+Gnome Spell is GNOME/Bonobo component for spell-checking.
 
 WWW: http://www.gnome.org/
diff --git a/textproc/gnomespell/pkg-descr b/textproc/gnomespell/pkg-descr
index a5004d360..10f0e6faa 100644
--- a/textproc/gnomespell/pkg-descr
+++ b/textproc/gnomespell/pkg-descr
@@ -1,6 +1,3 @@
-Gnome Spell is GNOME/Bonobo component for spell checking. In current version
-it contains GNOME::Spell::Dictionary object, which provides spell checking
-dictionary. It's based on pspell package, which is required to build
-gnome-spell.
+Gnome Spell is GNOME/Bonobo component for spell-checking.
 
 WWW: http://www.gnome.org/
diff --git a/www/epiphany-extensions/pkg-descr b/www/epiphany-extensions/pkg-descr
index 5617f207d..220193f34 100644
--- a/www/epiphany-extensions/pkg-descr
+++ b/www/epiphany-extensions/pkg-descr
@@ -1,4 +1,4 @@
-Epiphany-extensions is a set of plug-ins for the Epiphany web browser that
+Epiphany-extensions is a set of plugins for the Epiphany web browser that
 extend its base functionality.  Currently, the following extensions are
 supported:
 
diff --git a/www/epiphany/pkg-descr b/www/epiphany/pkg-descr
index f24cd9a2e..24a41f93d 100644
--- a/www/epiphany/pkg-descr
+++ b/www/epiphany/pkg-descr
@@ -1,7 +1,5 @@
-Epiphany, as it's manifesto states, is a web browser designed for the layman,
-by being consistent, lightweight and fast throughout all its operations.
-
-Originally forked from Galeon's (www/galeon2) source code, Epiphany looks to
-be a very promising browser indeed.
+Epiphany is a web browser designed to be as lightweight and fast as
+possible, at the expense of many of the features found in other
+browsers.
 
 WWW: http://epiphany.mozdev.org/
diff --git a/www/gtkhtml3/pkg-descr b/www/gtkhtml3/pkg-descr
index 618f9c253..38451dc01 100644
--- a/www/gtkhtml3/pkg-descr
+++ b/www/gtkhtml3/pkg-descr
@@ -1,5 +1,3 @@
-This is GtkHTML, a lightweight HTML rendering/printing/editing engine.
-It was originally based on KHTMLW, but is now being developed
-independently.
+GtkHTML is a lightweight HTML rendering, printing, and editing engine.
 
 WWW: http://www.ximian.com/
diff --git a/www/gtkhtml38/pkg-descr b/www/gtkhtml38/pkg-descr
index 618f9c253..38451dc01 100644
--- a/www/gtkhtml38/pkg-descr
+++ b/www/gtkhtml38/pkg-descr
@@ -1,5 +1,3 @@
-This is GtkHTML, a lightweight HTML rendering/printing/editing engine.
-It was originally based on KHTMLW, but is now being developed
-independently.
+GtkHTML is a lightweight HTML rendering, printing, and editing engine.
 
 WWW: http://www.ximian.com/
diff --git a/www/libgtkhtml/pkg-descr b/www/libgtkhtml/pkg-descr
index abb1b154d..173991abc 100644
--- a/www/libgtkhtml/pkg-descr
+++ b/www/libgtkhtml/pkg-descr
@@ -1,5 +1,3 @@
-This is GtkHTML, a lightweight HTML rendering/printing/editing engine.
-It was originally based on KHTMLW, but is now being developed
-independently.
+GtkHTML is a lightweight HTML rendering, printing, and editing engine.
 
 WWW: http://www.gnome.org/
diff --git a/x11-fm/nautilus/pkg-descr b/x11-fm/nautilus/pkg-descr
index 73801f0f0..b4f3fd678 100644
--- a/x11-fm/nautilus/pkg-descr
+++ b/x11-fm/nautilus/pkg-descr
@@ -1,5 +1,5 @@
-Nautilus is the official file manager for the GNOME desktop. It is designed
-to be primarly a file manager, but there are support for web and file viewing,
-too.  It is also responsible for desktop and icon management.
+Nautilus is a file manager tightly integrated into the GNOME destkop.
+It is also responsible for desktop and icon management, and provides
+an intuitive interface for accessing files and webpages.
 
 WWW: http://www.gnome.org/projects/nautilus/
diff --git a/x11-fm/nautilus2/pkg-descr b/x11-fm/nautilus2/pkg-descr
index 73801f0f0..b4f3fd678 100644
--- a/x11-fm/nautilus2/pkg-descr
+++ b/x11-fm/nautilus2/pkg-descr
@@ -1,5 +1,5 @@
-Nautilus is the official file manager for the GNOME desktop. It is designed
-to be primarly a file manager, but there are support for web and file viewing,
-too.  It is also responsible for desktop and icon management.
+Nautilus is a file manager tightly integrated into the GNOME destkop.
+It is also responsible for desktop and icon management, and provides
+an intuitive interface for accessing files and webpages.
 
 WWW: http://www.gnome.org/projects/nautilus/
diff --git a/x11-themes/gnome-themes/pkg-descr b/x11-themes/gnome-themes/pkg-descr
index f3fa6135c..333388e78 100644
--- a/x11-themes/gnome-themes/pkg-descr
+++ b/x11-themes/gnome-themes/pkg-descr
@@ -1,2 +1,2 @@
-New package of default themes for GNOME, which currently includes GTK+ and 
-icon themes designed for accessibility.
+A collection of themes for metacity and Gtk, and some basic icon
+sets.
diff --git a/x11-toolkits/eel2/pkg-descr b/x11-toolkits/eel2/pkg-descr
index 9f0aeb752..4b91eb9d0 100644
--- a/x11-toolkits/eel2/pkg-descr
+++ b/x11-toolkits/eel2/pkg-descr
@@ -1,10 +1,7 @@
-The eel library contains a number of generally useful classes and functions.
-Many of them are extensions to things in glib, gtk, gnome-libs, and other
-widely-used GNOME platform libraries. The long term plan is to move much of
-this into the platform libraries themselves.
+The eel library contains a number of useful classes and functions which
+extend glib, gtk, gnome-libs, and other widely-used GNOME platform libraries.
 
-Almost all of the eel library was previously part of Nautilus, in the
-"libnautilus-extensions" private library in Nautilus 1.0 - 1.0.2. It is now
-a separate package so it can be used by packages other than Nautilus.
+Almost all of the eel library was previously part of Nautilus, but is now
+a separate package so it can be used by other applications.
 
 WWW: http://www.gnome.org/
diff --git a/x11-toolkits/gal2/pkg-descr b/x11-toolkits/gal2/pkg-descr
index e2bbdf422..edb487657 100644
--- a/x11-toolkits/gal2/pkg-descr
+++ b/x11-toolkits/gal2/pkg-descr
@@ -1,8 +1,4 @@
 GAL is a collection of widgets and utility routines that were taken
 from Evolution and Gnumeric.
   
-The API is not frozen and might change at any time.  Larger class
-renaming might happen at any point without notice.  Use this library
-at your own risk.
-
 WWW: http://www.gnome.org/
diff --git a/x11-toolkits/gnome-themes-extras/pkg-descr b/x11-toolkits/gnome-themes-extras/pkg-descr
index c2f2a9463..f77d2b9e9 100644
--- a/x11-toolkits/gnome-themes-extras/pkg-descr
+++ b/x11-toolkits/gnome-themes-extras/pkg-descr
@@ -1,2 +1,2 @@
-Extra GNOME 2 themes, not contained within the x11-toolkits/gnome-themes
-package.
+Commonly used GNOME 2 themes that are not a part of the 
+x11-toolkits/gnome-themes package.
diff --git a/x11-toolkits/gnome-themes/pkg-descr b/x11-toolkits/gnome-themes/pkg-descr
index f3fa6135c..333388e78 100644
--- a/x11-toolkits/gnome-themes/pkg-descr
+++ b/x11-toolkits/gnome-themes/pkg-descr
@@ -1,2 +1,2 @@
-New package of default themes for GNOME, which currently includes GTK+ and 
-icon themes designed for accessibility.
+A collection of themes for metacity and Gtk, and some basic icon
+sets.
diff --git a/x11-toolkits/gtk20/pkg-descr b/x11-toolkits/gtk20/pkg-descr
index 7de6c9199..8cee4afc7 100644
--- a/x11-toolkits/gtk20/pkg-descr
+++ b/x11-toolkits/gtk20/pkg-descr
@@ -1,21 +1,10 @@
-   GTK is a library for creating graphical user interfaces similar to
-the Motif "look and feel". It is designed to be small and efficient, but
-still flexible enough to allow the programmer freedom in the interfaces
-created. GTK allows the programmer to use a variety of standard user
-interface widgets such as push, radio and check buttons, menus, lists
-and frames. It also provides several "container" widgets which can be
-used to control the layout of the user interface elements.
+The GIMP ToolKit (GTK+) is a collection of GUI widgets.  GTK+
+essentially provides the building blocks from which GUIs can be
+built.  It is highly themable, and its functionality is highly
+extensible.
 
-   GTK provides some unique features. (At least, I know of no other
-widget library which provides them). For example, a button does not
-contain a label, it contains a child widget, which in most instances
-will be a label. However, the child widget can also be a pixmap, image
-or any combination possible the programmer desires. This flexibility is
-adhered to throughout the library.
-
-GTK+-2.x is a stable release, but many applications still require
-GTK+-1.2, the previous stable version. You can have the runtime and
-development environments for both GTK+-2.x and GTK+-1.2 installed
-simultaneously on your computer.
+GTK+-2 is a very stable release, similar only in design to GTK+-1.
+GTK+-2 can coexist happily alongside GTK+-1, but applications are
+written for one version or the other.
 
 WWW: http://www.gtk.org/
diff --git a/x11-toolkits/gtksourceview/pkg-descr b/x11-toolkits/gtksourceview/pkg-descr
index d24afadff..729f71780 100644
--- a/x11-toolkits/gtksourceview/pkg-descr
+++ b/x11-toolkits/gtksourceview/pkg-descr
@@ -1,3 +1,2 @@
-Gtksourceview is a text widget that extends the standard Gtk+ 2.x GtkTextView.
-It improves it by implementing syntax highlighting and other features typical 
-of a source editor.
+GtkSourceView is a text widget for Gtk+-2 that provides syntax highlighting
+and other features typically expected in a source code editor.
diff --git a/x11-toolkits/gtksourceview2/pkg-descr b/x11-toolkits/gtksourceview2/pkg-descr
index d24afadff..729f71780 100644
--- a/x11-toolkits/gtksourceview2/pkg-descr
+++ b/x11-toolkits/gtksourceview2/pkg-descr
@@ -1,3 +1,2 @@
-Gtksourceview is a text widget that extends the standard Gtk+ 2.x GtkTextView.
-It improves it by implementing syntax highlighting and other features typical 
-of a source editor.
+GtkSourceView is a text widget for Gtk+-2 that provides syntax highlighting
+and other features typically expected in a source code editor.
diff --git a/x11-toolkits/libbonoboui/pkg-descr b/x11-toolkits/libbonoboui/pkg-descr
index 22194d3a1..8ca4e661c 100644
--- a/x11-toolkits/libbonoboui/pkg-descr
+++ b/x11-toolkits/libbonoboui/pkg-descr
@@ -1,9 +1,7 @@
-Bonobo is a set of language and system independant CORBA
-interfaces for creating reusable components and creating compound
-documents.
+Bonobo is a set of language- and system-independant CORBA
+interfaces for creating reusable components and compound documents.
 
-libbonoboui includes a Gtk+ based implementation of the Bonobo
-interfaces, enabling developers to create reusable components
-and applications that can be used to form more complex documents.
+libbonoboui includes a Gtk+-based implementation of the Bonobo
+interfaces.
 
 WWW: http://www.gnome.org/
diff --git a/x11-toolkits/libgnomeprintui/pkg-descr b/x11-toolkits/libgnomeprintui/pkg-descr
index f7ae47f42..cbc8ebcc6 100644
--- a/x11-toolkits/libgnomeprintui/pkg-descr
+++ b/x11-toolkits/libgnomeprintui/pkg-descr
@@ -1,4 +1,4 @@
-This is a prototype implementation of the Gnome Printing Architecture,
+The user interface for the Gnome Printing Architecture,
 as described in:
 
 WWW: http://www.gnome.org/projects/gnome-print/
diff --git a/x11-toolkits/libgnomeui/pkg-descr b/x11-toolkits/libgnomeui/pkg-descr
index 1dc68ad2b..706980bad 100644
--- a/x11-toolkits/libgnomeui/pkg-descr
+++ b/x11-toolkits/libgnomeui/pkg-descr
@@ -1,3 +1,4 @@
-Libraries for the GNOME GUI, a GNU desktop environment
+LibGnomeUI provides backend GUI components common to GNOME
+applications.
 
 WWW: http://www.gnome.org/
diff --git a/x11-toolkits/libwnck/pkg-descr b/x11-toolkits/libwnck/pkg-descr
index ada0fd869..685bf95e0 100644
--- a/x11-toolkits/libwnck/pkg-descr
+++ b/x11-toolkits/libwnck/pkg-descr
@@ -1,5 +1,5 @@
-libwnck is aWindow Navigator Construction Kit, i.e. a library to use
-for writing pagers and taskslists and stuff.  It is needed for the 
+libwnck is a Window Navigator Construction Kit, i.e. a library used
+for writing pagers and taskslists.  It is needed for the 
 GNOME 2.0 desktop.
 
 WWW: http://www.gnome.org/
diff --git a/x11-toolkits/pango/pkg-descr b/x11-toolkits/pango/pkg-descr
index 49eeb62d0..9ff793b51 100644
--- a/x11-toolkits/pango/pkg-descr
+++ b/x11-toolkits/pango/pkg-descr
@@ -1,8 +1,6 @@
-The goal of the Pango project is to provide an open-source framework for the
-layout and rendering of internationalized text. Pango is an offshoot of the
-GTK+ and GNOME projects, and the initial focus is operation in those
-environments, however there is nothing fundamentally GTK+ or GNOME specific
-about Pango. Pango uses Unicode for all of its encoding, and will eventually
-support output in all the world's major languages. 
+Pango provides a framework to render and control the layout of
+internationalized text, and is the backend for right-to-left text.
+Pango is an integral part of the GTK+ and GNOME projects, but its
+code is platform- and toolkit-independent.
 
 WWW: http://www.pango.org/
diff --git a/x11-toolkits/rep-gtk2/pkg-descr b/x11-toolkits/rep-gtk2/pkg-descr
index 4ceb045b3..597294953 100644
--- a/x11-toolkits/rep-gtk2/pkg-descr
+++ b/x11-toolkits/rep-gtk2/pkg-descr
@@ -1,3 +1,3 @@
-Rep-gtk offers GTK+-2 bindings for rep Lisp interpreter.
+Rep-gtk offers GTK+-2 bindings for the rep Lisp interpreter.
 
 WWW: http://rep-gtk.sourceforge.net/
diff --git a/x11-wm/metacity/pkg-descr b/x11-wm/metacity/pkg-descr
index 1323c5dcb..fb1cb52b9 100644
--- a/x11-wm/metacity/pkg-descr
+++ b/x11-wm/metacity/pkg-descr
@@ -1 +1,4 @@
-A window manager for the adult in you.
+Metacity is a low-frills Window Manager, and is the default
+Window Manager of the GNOME 2 desktop.  It provides most of
+the features expected of a Window Manager, but leaves everything
+it can up to other components of the GNOME environment.
diff --git a/x11/gdm2/pkg-descr b/x11/gdm2/pkg-descr
index 85c150c4c..2485dadfe 100644
--- a/x11/gdm2/pkg-descr
+++ b/x11/gdm2/pkg-descr
@@ -1,3 +1,2 @@
-The GNOME 2.0 version of the xdm display manager. It has support for
-face pixmaps, multiple sessions plus clean shutdowns from the login
-menu.
+The GNOME 2.0 version of the xdm display manager.  It supports user
+icons, multiple sessions, and clean system shutdowns.
diff --git a/x11/gnome-applets/pkg-descr b/x11/gnome-applets/pkg-descr
index c93d4bc89..5f715cf9a 100644
--- a/x11/gnome-applets/pkg-descr
+++ b/x11/gnome-applets/pkg-descr
@@ -1,3 +1,3 @@
-Applets components for the Gnome 2.0 Desktop Environment
+Panel applets for the Gnome 2.0 Desktop Environment.
 
 WWW: http://www.gnome.org/
diff --git a/x11/gnome-desktop/pkg-descr b/x11/gnome-desktop/pkg-descr
index 500857a54..bda4df791 100644
--- a/x11/gnome-desktop/pkg-descr
+++ b/x11/gnome-desktop/pkg-descr
@@ -1,4 +1,3 @@
-This is a collection of APIs not included in libgnomeui as they have
-not undergone sufficient testing.
+This is a collection of APIs not included in libgnomeui.
 
 WWW: http://www.gnome.org/
diff --git a/x11/gnome-panel/pkg-descr b/x11/gnome-panel/pkg-descr
index 5e7339891..263044b5e 100644
--- a/x11/gnome-panel/pkg-descr
+++ b/x11/gnome-panel/pkg-descr
@@ -1,3 +1,3 @@
-Panel component for the GNOME 2 Desktop.
+This drives the GNOME 2 panel.
 
 WWW: http://www.gnome.org/
diff --git a/x11/gnome-session/pkg-descr b/x11/gnome-session/pkg-descr
index e0a6dd027..50986ef91 100644
--- a/x11/gnome-session/pkg-descr
+++ b/x11/gnome-session/pkg-descr
@@ -1,2 +1,2 @@
-Session component for the GNOME 2.0 desktop.  This package contains the 
-commands needed to start GNOME 2.0.
+This provides session management for the GNOME 2 desktop, and
+provides the tools used to start the desktop.
diff --git a/x11/gnome-terminal/pkg-descr b/x11/gnome-terminal/pkg-descr
index eca945789..1193c30f7 100644
--- a/x11/gnome-terminal/pkg-descr
+++ b/x11/gnome-terminal/pkg-descr
@@ -1,3 +1,3 @@
-Terminal component for the GNOME 2.0 Desktop.
+Default terminal emulator for the GNOME 2.0 Desktop.
 
 WWW: http://www.gnome.org/
diff --git a/x11/gnome2-fifth-toe/pkg-descr b/x11/gnome2-fifth-toe/pkg-descr
index 0de444156..afa6e891d 100644
--- a/x11/gnome2-fifth-toe/pkg-descr
+++ b/x11/gnome2-fifth-toe/pkg-descr
@@ -1,7 +1,8 @@
 GNOME 2 "Fifth Toe"
 
 The Fifth Toe is a collection of stable GNOME 2 applications that 
-many users expect to be part of a usable desktop.  This includes image
-manipulation programs, chat applications, music and multimedia players, etc.
+many users expect to be part of a usable desktop.  Included are image
+manipulation programs, chat applications, music and multimedia players,
+much more.
 
 WWW: http://www.FreeBSD.org/gnome/
diff --git a/x11/gnome2-lite/pkg-descr b/x11/gnome2-lite/pkg-descr
index 4fd87114c..1c85098c1 100644
--- a/x11/gnome2-lite/pkg-descr
+++ b/x11/gnome2-lite/pkg-descr
@@ -1,8 +1,15 @@
 GNU Network Object Model Environment
 
-This package does not contain anything by itself -- it is a
-"meta-port" that depends on other GNOME packages.  Its sole purpose is
-to require dependencies so users can install the basic set of 
-components necessary to start a GNOME 2 desktop session.
+This metaport installs the pieces of the GNOME 2 desktop that
+are needed to provide a functional desktop.  x11/gnome2
+contains the full version of the GNOME 2 desktop environment.
+
+Other popular GNOME applications can be installed from the other
+GNOME 2 metaports:
+
+    * x11/gnome2-fifth-toe
+    * x11/gnome2-power-tools
+    * editors/gnome2-office
+    * devel/gnome2-hacker-tools
 
 WWW: http://www.FreeBSD.org/gnome/
diff --git a/x11/gnome2-power-tools/pkg-descr b/x11/gnome2-power-tools/pkg-descr
index a5e962aa0..041e159b9 100644
--- a/x11/gnome2-power-tools/pkg-descr
+++ b/x11/gnome2-power-tools/pkg-descr
@@ -1,11 +1,11 @@
 GNOME 2 Power Tools
 
 Power Tools is every GNOME geek's Batbelt.  It fills the gap between the
-core GNOME Desktop, which tries to be a relevant set of modules for all users;
-and the Fifth Toe, which is the collection of the coolest and most useful
-GNOME applications.
+core GNOME Desktop, which tries to be a relevant set of modules for all
+users; and the Fifth Toe, which is the collection of the coolest and most
+useful GNOME applications.
 
-This collection consists of utilities and applets for the technically minded
+This collection consists of utilities and applets for the technically-minded
 GNOME user.  It also contains many useful add-on utilities for some of the
 applications found in the Desktop and Fifth Toe.
 
diff --git a/x11/gnome2/pkg-descr b/x11/gnome2/pkg-descr
index 8632de997..a7051fc7b 100644
--- a/x11/gnome2/pkg-descr
+++ b/x11/gnome2/pkg-descr
@@ -1,9 +1,12 @@
 GNU Network Object Model Environment
 
-This package does not contain anything by itself -- it is a
-"meta-port" that depends on other GNOME packages.  Its sole purpose is
-to require dependencies so users can install this package only and
-have all the GNOME 2 stuff pulled in by the port/package dependency
-mechanism.
+This metaport installs the entire GNOME 2 desktop, including
+the the most common user applications.  Other popular GNOME
+applications can be installed from the other GNOME 2 metaports:
+
+    * x11/gnome2-fifth-toe
+    * x11/gnome2-power-tools
+    * editors/gnome2-office
+    * devel/gnome2-hacker-tools
 
 WWW: http://www.FreeBSD.org/gnome/
diff --git a/x11/gnomeapplets2/pkg-descr b/x11/gnomeapplets2/pkg-descr
index c93d4bc89..5f715cf9a 100644
--- a/x11/gnomeapplets2/pkg-descr
+++ b/x11/gnomeapplets2/pkg-descr
@@ -1,3 +1,3 @@
-Applets components for the Gnome 2.0 Desktop Environment
+Panel applets for the Gnome 2.0 Desktop Environment.
 
 WWW: http://www.gnome.org/
diff --git a/x11/gnomedesktop/pkg-descr b/x11/gnomedesktop/pkg-descr
index 500857a54..bda4df791 100644
--- a/x11/gnomedesktop/pkg-descr
+++ b/x11/gnomedesktop/pkg-descr
@@ -1,4 +1,3 @@
-This is a collection of APIs not included in libgnomeui as they have
-not undergone sufficient testing.
+This is a collection of APIs not included in libgnomeui.
 
 WWW: http://www.gnome.org/
diff --git a/x11/gnomepanel/pkg-descr b/x11/gnomepanel/pkg-descr
index 5e7339891..263044b5e 100644
--- a/x11/gnomepanel/pkg-descr
+++ b/x11/gnomepanel/pkg-descr
@@ -1,3 +1,3 @@
-Panel component for the GNOME 2 Desktop.
+This drives the GNOME 2 panel.
 
 WWW: http://www.gnome.org/
diff --git a/x11/gnomesession/pkg-descr b/x11/gnomesession/pkg-descr
index e0a6dd027..50986ef91 100644
--- a/x11/gnomesession/pkg-descr
+++ b/x11/gnomesession/pkg-descr
@@ -1,2 +1,2 @@
-Session component for the GNOME 2.0 desktop.  This package contains the 
-commands needed to start GNOME 2.0.
+This provides session management for the GNOME 2 desktop, and
+provides the tools used to start the desktop.
diff --git a/x11/gnometerminal/pkg-descr b/x11/gnometerminal/pkg-descr
index eca945789..1193c30f7 100644
--- a/x11/gnometerminal/pkg-descr
+++ b/x11/gnometerminal/pkg-descr
@@ -1,3 +1,3 @@
-Terminal component for the GNOME 2.0 Desktop.
+Default terminal emulator for the GNOME 2.0 Desktop.
 
 WWW: http://www.gnome.org/
diff --git a/x11/libgnome/pkg-descr b/x11/libgnome/pkg-descr
index f7f156423..b78aaf2cc 100644
--- a/x11/libgnome/pkg-descr
+++ b/x11/libgnome/pkg-descr
@@ -1,3 +1,3 @@
-Libraries for GNOME, a GNU desktop environment
+LibGnome provides the non-GUI backend for the GNOME environment.
 
 WWW: http://www.gnome.org/
diff --git a/x11/libxklavier/pkg-descr b/x11/libxklavier/pkg-descr
index 89144da3c..d5000e3ad 100644
--- a/x11/libxklavier/pkg-descr
+++ b/x11/libxklavier/pkg-descr
@@ -1,3 +1,4 @@
-Libxklavier is an utility to make XKB stuff easier.
+Libxklavier is a utility to simplify setting and changing
+keyboard layouts.
 
 WWW: http://gswitchit.sourceforge.net/
diff --git a/x11/yelp/pkg-descr b/x11/yelp/pkg-descr
index 5267ad53b..d38af5629 100644
--- a/x11/yelp/pkg-descr
+++ b/x11/yelp/pkg-descr
@@ -1,4 +1,4 @@
-Yelp is a help browser for GNOME 2.0. The name Yelp was suggested by Daniel
-Lundin. Yelp is pronounced the same as the swedish word for 'help'.
+Yelp is a help browser for GNOME 2.0 that displays GNOME
+help documents, info pages, manpages, and more.
 
 WWW: http://www.gnome.org/
diff --git a/x11/zenity/pkg-descr b/x11/zenity/pkg-descr
index 34a2188c0..384c19680 100644
--- a/x11/zenity/pkg-descr
+++ b/x11/zenity/pkg-descr
@@ -1,4 +1,3 @@
-This is zenity - a rewrite of gdialog, the GNOME port of dialog
-which allows you to display dialog boxes from the commandline
-and shell scripts. If you understand, things are just as they 
-are. If you don't understand, things are just as they are.
+Zenity allows dialog boxes to be created and displayed from the
+commandline.  This provides a simple way to create a GUI for
+a shell script.