GNOME.org
 

[release-notes/gnome-3-22] round of minor fixes - ready for proof reading now

commit a9c5ae9554f5752c02518abb636ad241d572d578
Author: Allan Day <allanpday gmail com>
Date:   Thu Sep 8 15:05:49 2016 +0100

    round of minor fixes - ready for proof reading now

 help/C/developers.page |   48 ++++++++++----------
 help/C/index.page      |  121 ++++++++++++++++++++++++------------------------
 2 files changed, 85 insertions(+), 84 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 45e9dfa..899177d 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -23,7 +23,7 @@
 
   <title>What’s New for Developers and System Administrators</title>
 
-  <p>GNOME &gnomeversion; includes many new features and improvements for those working with GNOME 
technologies. Read on for the details!</p>
+  <p>GNOME &gnomeversion; includes many new features and improvements for those working with GNOME 
technologies. Read on for more details!</p>
 
   <section id="gtk-long-term-support">
     <title>GTK+ Long Term Support</title>
@@ -35,13 +35,13 @@
     with new releases being limited to new widgets and bug and security
     fixes. These 3.22.x updates will be provided for at least three years.
     Major development work will continue in a separate release series, which
-    will also be consumable by application authors who are happy to deal with a
+    will be consumable by application authors who are happy to deal with a
     moderate amount of instability.</p>
-    <p>GTK+ 3.22 makes all the improvements introduced during the 3.x series,
-    such as CSS styling, GTK+ inspector, animations, new widgets and much more,
+    <p>GTK+ 3.22 makes all the improvements introduced in the 3.x series, such
+    as CSS styling, GTK+ inspector, animations, new widgets and much more,
     available in a stable form. This new way of organizing GTK+ releases
     promises to provide long-term stability for application authors who require
-    it while not impeding the overall speed of GTK+ development. It is being
+    it, while not impeding the overall speed of GTK+ development. It is being
     introduced after significant discussion and consultation with GTK+ users.
     More details can be found on <link
     href="https:blog.gtk.org/2016/09/01/versioningand-long-term-stability-in-gtk/">
@@ -53,19 +53,19 @@
     <media type="image" src="figures/placeholder.png"/>
     <p>Flatpak, previously known as xdg-app, is the next generation technology
     for application distribution on Linux. While it is an independent project
-    with its own release schedule, the GNOME project has major plans to make
-    Flatpak an integral part of its application developer experience.</p>
+    with its own release schedule, the GNOME project plans to make Flatpak an
+    integral part of its application developer experience.</p>
     <p>Since the &lastversion; release, Flatpak has made significant progress
-    and has continued to mature. An important milestone has also been reached
-    with the introduction of a new set of APIs, called “portals”. These allow
+    and has continued to mature. An important milestone has been reached with
+    the introduction of a new set of APIs, called “portals”. These allow
     sandboxed applications to access resources from the host system.</p>
     <p>GNOME 3.22's developer technologies come with complete portal support,
     through both GLib and GTK+. Supported portals include the file chooser,
     printing, URI opening, suspend/log out/idle inhibit, screenshots,
-    notifications and network status. Portal access is transparent, although
+    notifications and network status. This allows fully sandboxed applications to be
+    written for the first time. Portal access is transparent, although
     <code>GtkFileChooserNative</code> is recommended over the regular
-    <code>GtkFileChooser</code>. This allows fully sandboxed applications to be
-    written for the first time. More information can be found on
+    <code>GtkFileChooser</code>. More information can be found on
     <link href="https://blogs.gnome.org/mclasen/2016/07/08/portals-using-gtk-in-a-flatpak/";>
     Matthias Clasen's blog post</link>.</p>
     <p>More information about Flatpak, including developer documentation and a
@@ -79,16 +79,16 @@
     <p>GNOME 3.22 is another big release for Builder, with several key pieces
     of the new IDE falling into place. A new built-in profiler makes it
     possible to find performance issues in your project, and sees Builder start
-    to develop into a multi-function IDE for the first time.</p>
-    <!-- More details about the profiler here please -->
+    to develop into a multi-function IDE for the first time. The profiler
+    currently supports C and C++, with more language support expected in the
+    future.</p>
     <p>Builder's UI has received some significant polish since 3.20. A new
     perspective switcher provides a more elegant way to change between modes,
     and the search bar has been relocated. Most significantly, a new “project
     bar” provides information about the current project, branch and
-    build profile and also provides controls for building and running your
-    project. This makes it possible to build and run with a single click from
-    anywhere in the IDE.</p>
-    <p>Other changes in Builder 3.22 include:</p>
+    build profile, and also makes it possible to build and run your project
+    with a single click from anywhere in the IDE.</p>
+    <p>Other enhancements in Builder 3.22 include:</p>
     <list>
       <item><p>A new find and replace feature, which includes the usual options
       for case sensitive search, regular expressions, and word matching.
@@ -101,7 +101,7 @@
       </p></item>
       <item><p>A new quick highlight plugin highlights text that matches
       the current selection.</p></item>
-      <item><p>The C, XML, and HTML indenters have been expanded to support
+      <item><p>The C, XML, and HTML indenters have all been expanded to support
       more syntax styles.</p></item>
     </list>
   </section>
@@ -122,8 +122,8 @@
     href="https://blogs.gnome.org/carlosg/2016/08/24/wayland-%E2%99%A1-drawing-tablets/";>
     how to add support for this to applications</link>.</p></item>
     <item><p><link href="https://developer.gnome.org/gtk3/stable/GtkGLArea.html";>
-    GtkGLArea</link> can now use OpenGL for Embedded Systems (OpenGL ES or
-    GLES) instead of full OpenGL.</p></item>
+    GtkGLArea</link> can now use OpenGL for Embedded Systems (known as OpenGL
+    ES or GLES) instead of full OpenGL.</p></item>
     <item><p><link href="https://developer.gnome.org/gdk3/stable/GdkMonitor.html";>
     GdkMonitor</link> is a new more convenient way to get monitor
     information, and provides richer information than was previously
@@ -142,13 +142,13 @@
     <media type="image" src="figures/placeholder.png"/>
     <p>GLib’s logging API has been reworked to support structured key–value log
     fields. This makes it easier to add logging and makes it possible to write
-    more powerful logging schemes. It also makes it easier to include more
+    more powerful logging schemes. It also makes it possible to include more
     metadata in log messages, such as <link
     href="https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html";>
     message IDs</link>.</p>
     <p>As a part of this work, GLib's logging infrastructure has been
-    reorganised around a ‘writer’ function, where an application specifies its
-    logging policy; log handlers are deprecated in favour of this, which
+    reorganized around a “writer” function, where an application specifies its
+    logging policy. Log handlers are deprecated in favour of this, which
     reduces ambiguity about how and where logs should be handled, and
     eliminates conflicts between log handlers.</p>
     <p>GLib will now automatically pass logging data to systemd-journald,
diff --git a/help/C/index.page b/help/C/index.page
index 0c63fad..20803b7 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -34,24 +34,24 @@
 
   <p>3.20 has been named “Karlsruhe” in recognition of this year’s GUADEC
   organizing team. <link href="http://guadec.org/";>GUADEC</link> is GNOME’s
-  main conference, which is held in Europe each year, and is only possible due
-  to local volunteers.</p>
+  primary conference, which is held in Europe each year, and is only possible
+  due to local volunteers.</p>
 
   <section id="flatpak-integration">
     <title>Flatpak Integration</title>
     <media type="image" src="figures/placeholder.png"/>
     <p><link href="http://flatpak.org/";>Flatpak</link> is the next generation
     application distribution framework for Linux. It aims to make it easier to
-    distribute applications for Linux, in the hope of increasing the number of
-    applications that are available. Flatpak also has advantages for users.
-    Flatpak applications are more secure, and can be safely updated without
+    distribute applications for Linux, and thereby inclrease the number of
+    applications that are available. Flatpak applications have other
+    advantages, too: they are more secure, and can be safely updated without
     having to reboot.</p>
     <p>GNOME &gnomeversion; comes with comprehsive Flatpak support. The
-    Software application is now able to install repository files, which means
-    that it is possible to install Flatpak repositories and applications
+    Software application is now able to install Flatpak repository files, which
+    means  that it is possible to install Flatpak repositories and applications
     without ever having to use the command line. Numerous other smaller
     changes makes it easy to install and update Flatpak applications, such as
-    the display of source information for each application as well as details
+    the display of source information for each application, as well as details
     about whether applications are sandboxed.</p>
     <p>GNOME &gnomeversion; also introduces developer tools which allow
     applications to take full advantage of Flatpak's security features. This
@@ -62,16 +62,16 @@
   <section id="bulk-renaming">
     <title>Bulk Renaming</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>Bulk renaming is a new feature in the Files application for
+    <p>Bulk renaming is a new feature in the Files application for GNOME
     &gnomeversion;. As the name suggests, bulk renaming allows multiple files
     to be renamed at the same time. This is extremely useful when dealing with
     collections of files that have similar names, such as videos, music or
     photos.</p>
     <p>Files can be renamed using either a template that is applied to each
-    file, or using a function that allows specific parts of all the file names
-    to be replaced. The template mode allows using details from your files to
-    be included as part of the file name, such as the creation date, or the
-    track number, artist name or album name for music files.</p>
+    file, or by searching for and replacing parts of all the file names. The
+    template mode allows using details from your files to be included as part
+    of the file name, such as the creation date, or the track number, artist
+    name or album name for music files.</p>
     <p>To access the bulk rename feature, simply select multiple files and then
     rename using the context menu or <key>F2</key> shortcut.</p>
   </section>
@@ -81,11 +81,10 @@
     <media type="image" src="figures/placeholder.png"/>
     <p>Last release, Photos gained a new set of photo editing features. For
     &gnomeversion;, another critical feature is being introduced: the ability
-    to share photos with other people.</p>
-    <p>The new sharing feature allows sharing photos by uploading them to
-    Google, or by sending them as an email attachment. Further sharing
-    destinations are planned for the future, including a range of social
-    networks.</p>
+    to easily share photos with other people. The new sharing feature allows
+    photos to be shared by uploading them to Google, or by sending them as an
+    email attachment. Further sharing destinations are planned for the future,
+    including a range of social networks.</p>
     <p>Photo sharing is fully integrated with Online Accounts, so to upload to
     Google it is first necessary to add a Google account from the main Settings
     application</p>
@@ -94,14 +93,14 @@
   <section id="improved-software">
     <title>Improved Software</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>The Software application has a new look for GNOME &gnomeversion;. The
-    landing page has been revamped and now shows more application tiles. A new,
-    colorful category section makes browsing a more integral part of the
-    experience. Star ratings are also being displayed more prominently, in
-    order to make it easier to find the best applications to install.</p>
-    <p>Software has other smaller improvements, too. Color coded badges now
-    clearly indicate whether an application is Free Software. The layout of
-    many of the lists and pages has also been refined.</p>
+    <p>The Software application has an updated look for GNOME &gnomeversion;. The
+    landing page has been revamped and now shows more application tiles, and
+    the category section makes browsing a more integral part of the experience.
+    Star ratings are also displayed more prominently, in order to make it
+    easier to find the best applications to install.</p>
+    <p>Software has other improvements, too. Color coded badges now clearly
+    indicate whether an application is Free Software. The layout of many of the
+    lists and pages has also been refined.</p>
   </section>
 
   <section id="wayland">
@@ -115,29 +114,31 @@
     In GNOME &lastversion;, it became usable for the majority of users. Since
     then, support has continued to improve with the majority of missing
     features being filled in. This includes support for Wacom graphics
-    tablets, the ability to rotate displays, and the ability to use GNOME's
-    on-screen keyboard. Numerous smaller issues have also been resolved, making
-    the Wayland experience even more polished.</p>
+    tablets, the ability to rotate displays, and support for GNOME's on-screen
+    keyboard. Numerous smaller issues have also been resolved, making the
+    Wayland experience even more polished.</p>
   </section>
 
   <section id="files">
     <title>Improved Files Application</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>In addition to bulk renaming, the Files application has a number of
-    other improvements for GNOME &gnomeversion;. Archive functionality has been
-    directly integrated, so that extracting an archive (such as a .zip or
+    <p>In addition to bulk renaming, the Files application has a large number
+    of other improvements for GNOME &gnomeversion;. Archive functionality has
+    been directly integrated, so that extracting an archive (such as a .zip or
     .tar.gz file) just requires a double click, rather than using a separate
     application. New archives can also be created, using a variety of achive
     formats.</p>
-    <p>View and zoom controls have also been improved. It is now possible to
-    switch between the grid and list view with a single click, and the zoom
-    controls are now a more straightforward set of buttons. These changes were
-    informed by usability testing performed by Gina Dobrescu as a part of an
+    <p>Also in Files, the view and content sorting controls have been
+    overhauled for &gnomeversion;. This makes it possible to switch between the
+    grid and list view with a single click and makes the zoom and sorting
+    options much more straightforward. These changes were informed by usability
+    testing performed by Gina Dobrescu as a part of an
     <link href="https://www.gnome.org/outreachy/";>Outreachy</link> internship.
     </p>
     <p>Other UI enhancements include automatic hiding of the floating status
-    bar, so it doesn't get in the way, and more information in the connect to
-    server bar, including details of which file protocols are supported.
+    bar, so it doesn't get in the way, and the display of more information in
+    the connect to server bar, including details about which file protocols are
+    supported.
     </p>
     <p>Finally, you can now work with files with admin privileges over
     <code>admin:///</code>.</p>
@@ -148,19 +149,19 @@
     <title>Redesigned Keyboard Settings</title>
     <media type="image" src="figures/placeholder.png"/>
     <p>GNOME's keyboard settings have been overhauled for &gnomeversion;. The
-    list of shortcuts is easier to browse and eliminates a number of issues
+    list of shortcuts is now easier to browse and eliminates a number of issues
     with the previous version. A search feature makes it really quick to search
-    for keyboard shortcuts you want to change, and the process for setting a
-    shortcut provides much clearer feedback.</p>
+    for keyboard shortcuts, and the process for setting a shortcut provides
+    much clearer feedback.</p>
   </section>
 
   <section id="dconf-editor">
     <title>Redesigned dconf Editor</title>
     <media type="image" src="figures/placeholder.png"/>
     <p>dconf Editor, the application for browsing and changing settings, has
-    had a design refresh for &gnomeversion;. The new version has a new,
-    simplified interface, based around a single path bar. A new “delay mode”
-    allows multiple changes to be made at once. Several reset options allow
+    had a design refresh for &gnomeversion;. The new version has a simplified
+    interface, based around a path bar. A new “delay mode” allows multiple
+    changes to be made at once. Additionally, several reset options allow
     either resetting visible settings, or recursively resetting them (for the
     current folder and any subfolders).</p>
   </section>
@@ -168,15 +169,15 @@
   <section id="thats-not-all">
     <title>And That's Not All…</title>
     <p>As usual, there are many other smaller improvements in this GNOME
-    release. Here are some of them:</p>
+    release. Here are some of them!</p>
     <list>
-      <item><p>The new version of Calendar lets you to set alarms for events.
-      It also lets you change the calendar for events, and event editing has
-      restyled date pickers. In the calendar grid, events can now be moved
-      using drag and drop, and the layout of the year view has been refined and
-      is now more responsive.</p></item>
+      <item><p>The new version of Calendar now lets you set alarms for events.
+      It also lets you change which calendar an event belongs to, and event
+      editing has restyled date pickers. In the calendar grid, events can now
+      be moved using drag and drop, and the layout of the year view has been
+      refined and its layout now adjusts to the size of the window.</p></item>
       <item><p>Automatic NickServ authentication has been added to Polari,
-      GNOME's IRC client. This means that, instead of manually messaging
+      GNOME's IRC client. This means that instead of manually messaging
       NickServ each time you log in, all you have to do is enter your password
       into the server settings.</p></item>
       <item><p>Maps now uses <link href="https://www.mapbox.com/";>Mapbox</link>
@@ -185,20 +186,20 @@
       This is expected to provide a more reliable service in the
       future.</p></item>
       <item><p>Performance has been dramatically improved in Music. The
-      application now loads faster and the albums grid is more responsive.
-      </p></item>
+      application now loads faster and the albums grid automatically adjusts to
+      make the best use of the space available.</p></item>
       <item><p>Videos now allows playback at different rates. This is useful
       for various things, such as when listening to talks or taking notes.
       </p></item>
-      <item><p>In Boxes, the GNOME application for virtual and remote machines,
-      a clone function has been added, which makes it easy to create copies of
+      <item><p>Boxes, the GNOME application for virtual and remote machines,
+      has gained a clone function. This makes it easy to create copies of
       your boxes.</p></item>
       <item><p>Web, the GNOME browser, now has a shortcut window, which makes
-      it easy to discover all the available shortcuts. A new context menu in
-      the address bar also allows you to “Paste &amp; Go”, and a number of
-      error pages have been redesigned.</p></item>
-      <item><p>Books, GNOME's eBook application, has been steadily progressing,
-      and now has initial support for viewing ePub books. This feature is
+      it easy to discover which keyboard shortcuts are available. A new context
+      menu in the address bar also allows you to “Paste &amp; Go”, and a number
+      of error pages have been redesigned.</p></item>
+      <item><p>Progress has continued on Books, GNOME's eBook application,
+      which now has initial support for viewing ePub books. This feature is
       expected to mature in future releases.</p></item>
     </list>
   </section>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]