GNOME.org
 

[release-notes/gnome-3-22] rework stuff

commit 783dd4e8ae485f0ca73f31e7d67e7bef1de99ce6
Author: Allan Day <allanpday gmail com>
Date:   Wed Sep 7 18:41:41 2016 +0100

    rework stuff

 help/C/developers.page |  188 ++++++++++++++++++++++-------------------------
 help/C/index.page      |   72 ++++++++++---------
 2 files changed, 126 insertions(+), 134 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 1f8518a..45e9dfa 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -25,29 +25,78 @@
 
   <p>GNOME &gnomeversion; includes many new features and improvements for those working with GNOME 
technologies. Read on for the details!</p>
 
+  <section id="gtk-long-term-support">
+    <title>GTK+ Long Term Support</title>
+    <media type="image" src="figures/gtk-long-term-support.svg"/>
+    <p>3.22 marks a significant moment in the history of GTK+. While
+    it does not have a .0 version number, 3.22 is the first in a major new stable
+    release series and is the first major GTK+ version since 3.0. Subsquent
+    releases in the 3.22.x series are guaranteed to be API and ABI stable,
+    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
+    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,
+    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
+    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/">
+    the GTK+ development blog</link>.</p>
+    </section>
+
+  <section id="flatpak">
+    <title>Flatpak</title>
+    <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>
+    <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
+    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
+    <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
+    <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
+    growing list of Flatpak applications you can try, can be found on
+    <link href="flatpak.org">flatpak.org</link>.</p>
+  </section>
+
   <section id="builder">
     <title>Builder</title>
     <media type="image" src="figures/placeholder.png"/>
     <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
+    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-functional IDE for the first time.</p>
-    <p>Builder's UI has had some significant polish since 3.20. A new
-    perspective switcher allows changing between different modes (including the
-    new profiler), and the search bar has been relocated. Most significantly,
-    a new omnibar provides information about the current project, branch and
+    to develop into a multi-function IDE for the first time.</p>
+    <!-- More details about the profiler here please -->
+    <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>
     <list>
       <item><p>A new find and replace feature, which includes the usual options
-      for case sensitive search, regular expressions, and word
-      matching.</p></item>
+      for case sensitive search, regular expressions, and word matching.
+      </p></item>
       <item><p>Builder's code editor now makes it really easy to work with
-      colors, thanks to a new color picker sidebar and color highlighting.
+      colors, thanks to color highlighting and a new color picker sidebar.
       </p></item>
-      <item><p>Startup pages for creating, cloning and opening projects have
+      <item><p>The pages for creating, cloning and opening projects have
       been improved, with better layouts and more project creation options.
       </p></item>
       <item><p>A new quick highlight plugin highlights text that matches
@@ -57,90 +106,39 @@
     </list>
   </section>
 
-  <section id="gtk-long-term-support">
-    <title>GTK+ Long Term Support</title>
-    <media type="image" src="figures/gtk-long-term-support.svg"/>
-    <p>3.22 marks a significant moment in the history of GTK+. While
-    it does not have a .0 version number, 3.22 is the first in a major new stable
-    release series and is the first major GTK+ version since 3.0. Subsquent
-    releases in the 3.22.x series will be guaranteed to be API and ABI stable,
-    with new releases being limited to new widgets and bug and security
-    fixes. These 3.22.x updates are guaranteed to be provided for at least
-    three years. Major development work will continue in a separate release
-    series, which will culminate in a new major stable release in approximately
-    2-3 years time.</p>
-    <p>GTK+ 3.22 makes all the major improvements introduced during 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 introduced after significant discussion
-    and consultation with GTK+ users, and more details can be found on <link
-    href="https:blog.gtk.org/2016/09/01/versioningand-long-term-stability-in-gtk/">
-    the GTK+ development blog</link>.</p>
-    </section>
-
   <section id="gtk+">
-    <title>GTK+ Improvements</title>
-    <media type="image" src="figures/placeholder.png"/>
-    <p>With 3.22, GTK+ is the first toolkit to support Flatpak “portals”. These
-    allow sandboxed applications to access system resources and interfaces in a
-    secure manner. Functionality covers the file chooser, printing, URI
-    opening, suspend/log out/idle inhibit, screenshots, notifications and
-    network status. Portal access is transparent, although
-    <code>GtkFileChooserNative</code> is recommended over the regular
-    <code>GtkFileChooser</code>. This allows fully sandboxed applications to be
-    written using GTK+ and Flatpak. 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>Other improvements in GTK+ 3.22 include:</p>
-    <list>
-      <item><p>CSS blends modes. This is a common CSS feature that allows
-      images to be programmatically transformed. Georges Stavracas,
-      who implemented the feature, has provided
-      <link href="https://feaneron.com/2016/07/03/css-blend-modes-in-gtk/";>more
-      details on his blog</link>.</p></item>
-      <item><p>GTK+ 3.22 allows graphics tablets to be used with Wayland.
-      Carlos Garnacho has written about <link
-      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>
-      <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
-      available with <link
-      href="https://developer.gnome.org/gdk3/unstable/GdkScreen.html";>GdkScreen
-      </link>.</p></item>
-    </list>
-    <p>Additionally, while it is not being introduced in 3.22, major progress
-    has been made on the GTK Scene Graph (GSK) over the past six months. With
-    the new release model described above, the way is clear for this to be
-    integrated into GTK+'s new unstable release series in the near future.</p>
-  </section>
-
-  <section id="flatpak">
-    <title>Flatpak</title>
-    <media type="image" src="figures/placeholder.png"/>
-    <p>Flatpak is the next generation technology for application distribution
-    on Linux. It allows applications to be installed on any distribution, and
-    provides a robust security framework which protects you from malicious
-    applications. While Flatpak is an independent project and does not follow
-    the GNOME release cycle, the GNOME project has plans to make it an integral
-    part of its application developer experience in the future.</p>
-    <p>Since the &lastversion; release, Flatpak has made significant progress.
-    In May it was renamed from xdg-app, and a new <link href="flatpak.org">
-    Flatpak</link> website was launched, containing a full set of developer
-    documentation as well as a growing list of Flatpak applications that you
-    can try.</p>
-    <p>A new set of APIs have been introduced, called “portals”, which allow
-    sandboxed applications to access resources from the host system, such as
-    opening files, printing, location services.</p>
+  <title>GTK+ Improvements</title>
+  <media type="image" src="figures/placeholder.png"/>
+  <p>In addition to portals integration, other improvements in GTK+ 3.22
+  include:</p>
+  <list>
+    <item><p>CSS blends modes. This is a common CSS feature that allows
+    images to be programmatically transformed. Georges Stavracas,
+    who implemented the feature, has provided
+    <link href="https://feaneron.com/2016/07/03/css-blend-modes-in-gtk/";>more
+    details on his blog</link>.</p></item>
+    <item><p>GTK+ 3.22 allows graphics tablets to be used with Wayland.
+    Carlos Garnacho has written about <link
+    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>
+    <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
+    available with <link
+    href="https://developer.gnome.org/gdk3/unstable/GdkScreen.html";>GdkScreen
+    </link>.</p></item>
+  </list>
+  <p>Additionally, while it is not being introduced in 3.22, major progress
+  has been made on the GTK Scene Graph (GSK) over the past six months. With
+  the new release model described above, the way is clear for this to be
+  integrated into GTK+'s new unstable release series in the near future.</p>
   </section>
 
   <section id="GLib">
-    <title>GLib</title>
+    <title>GLib Structured Logging</title>
     <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
@@ -158,14 +156,4 @@
     addition of color!</p>
   </section>
 
-  <section id="more">
-    <title>Other Improvements</title>
-    <p>Other improvements for developers in GNOME &gnomeversion; include:</p>
-    <list>
-      <item><p></p></item>
-      <item><p></p></item>
-      <item><p></p></item>
-    </list>
-  </section>
-
 </page>
diff --git a/help/C/index.page b/help/C/index.page
index 705ad26..74c0ede 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -126,26 +126,32 @@
     <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
-    .tar.gz) just requires a double click, rather than using a separate
-    application. New archives can also be created directly from within Files,
-    using a variety of formats.</p>
-    <p>The 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
+    .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
     <link href="https://www.gnome.org/outreachy/";>Outreachy</link> internship.
     </p>
-    <p></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.
+    </p>
+    <p>Finally, you can now work with files with admin privileges over
+    <code>admin:///</code>.</p>
+    <!-- Add here - what is this used for? -->
   </section>
 
   <section id="keyboard-settings">
     <title>Redesigned Keyboard Settings</title>
     <media type="image" src="figures/placeholder.png"/>
     <p>GNOME's keyboard settings have been overhauled for &gnomeversion;. The
-    new design is much clearer and eliminates known 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>
+    list of shortcuts is 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>
   </section>
 
   <section id="dconf-editor">
@@ -159,43 +165,41 @@
     current folder and any subfolders).</p>
   </section>
 
-  <section id="smaller-things">
-    <title>Smaller Things</title>
+  <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>
     <list>
-      <item><p>Calendar now allows you to set alarms for events. It is now
-      possible to 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>Polari, GNOME's IRC client, now has automatic NickServ
-      authentication. 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>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>Automatic NickServ authentication has been added to Polari,
+      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>
       as the supplier of its
       <link href="https://www.openstreetmap.org/";>OpenStreetMap</link> data.
-      This is expected to provide a more reliable service in the future.</p></item>
-      <item><p>Music's performance has been dramatically improved: the
-      application now loads faster and the albums grid is more
-      responsive.</p></item>
-      <item><p>The connect to server bar in Files now includes additional
-      information, including details of which file protocols are supported.
+      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>
       <item><p>Videos - variable rate playback
       <!-- More information needed about this - speak to hadess -->
       </p></item>
-      <item><p>Web, the GNOME browser, now has a shortcut window, to help find
-      out about shortcuts. A new context menu in the address bar allows you to
-      “Paste &amp; Go”, and a number of error pages have been
-      redesigned.</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
+      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
       expected to mature in future releases.</p></item>
-      <item><p>In Files, you can now work with files with admin privileges over
-      <code>admin:///</code>.
-      <!-- Add here - what is this used for? --> </p></item>
     </list>
   </section>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]