Improve descriptions in gsettings schema

Try and improve readability of the descriptions for format specifiers
and add missing composer format specifiers. Reword some other
descriptions as well.

https://bugzilla.gnome.org/show_bug.cgi?id=625897

1 files changed, 9 insertions, 10 deletions

diff --git a/data/org.gnome.SoundJuicer.gschema.xml b/data/org.gnome.SoundJuicer.gschema.xml
index 444f5cc..4426f1e 100644
--- a/data/org.gnome.SoundJuicer.gschema.xml
+++ b/data/org.gnome.SoundJuicer.gschema.xml
@@ -39,24 +39,24 @@
     <key name="path-pattern" type="s">
       <default>'%aa/%at'</default>
       <summary>The directory structure for the files</summary>
-      <description>%at -- album title %aT -- album title (lowercase) %aa -- album artist %aA -- album artist (lowercase) %as -- album artist (sortable) %aS -- album artist (sortable lowercase) %ay -- album year %tt -- track title %tT -- track title (lowercase) %ta -- track artist %tA -- track artist (lowercase) %ts -- track artist (sortable) %tS -- track artist (sortable lowercase)</description>
+      <description>Format specifiers: %at - album title; %aT - album title (lowercase); %aa - album artist; %aA - album artist (lowercase); %as - album artist (sortable); %aS - album artist (sortable lowercase); %ac - album composer; %aC - album composer (lowercase); %ap - album composer (sortable); %aP - album composer (sortable lowercase); %ay - album year; %tt - track title; %tT - track title (lowercase); %ta - track artist; %tA - track artist (lowercase); %ts - track artist (sortable); %tS - track artist (sortable lowercase); %tc - track composer; %tC - track composer (lowercase); %tp - track composer (sortable); %tP - track composer (sortable lowercase)</description>
     </key>
 
     <key name="file-pattern" type="s">
       <default>'%dn - %tt'</default>
       <summary>The name pattern for files</summary>
-      <description>Do not specify an extension. %at -- album title %aT -- album title (lowercase) %aa -- album artist %aA -- album artist (lowercase) %as -- album artist (sortable) %aS -- album artist (sortable lowercase) %tn -- track number (i.e 8) %tN -- track number, zero padded (i.e 08) %tt -- track title %tT -- track title (lowercase) %ta -- track artist %tA -- track artist (lowercase) %ts -- track artist (sortable) %tS -- track artist (sortable lowercase) %dn -- disc and track number (i.e Disk 2 - 6, or 6) %dN -- disc number, zero padded (i.e d02t06, or 06)</description>
+      <description>Do not specify an extension. Format specifiers: %at - album title; %aT - album title (lowercase); %aa - album artist; %aA - album artist (lowercase); %as - album artist (sortable); %aS - album artist (sortable lowercase); %ac - album composer; %aC - album composer (lowercase); %ap - album composer (sortable); %aP - album composer (sortable lowercase); %tn - track number (i.e 8); %tN - track number, zero padded (i.e 08); %tt - track title; %tT - track title (lowercase); %ta - track artist; %tA - track artist (lowercase); %ts - track artist (sortable); %tS - track artist (sortable lowercase); %tc - track composer; %tC - track composer (lowercase); %tp - track composer (sortable); %tP - track composer (sortable lowercase); %dn - disc and track number (i.e Disk 2 - 6, or 6); %dN - disc number, zero padded (i.e d02t06, or 06)</description>
     </key>
 
     <key name="paranoia" enum="org.gnome.SoundJuicer.paranoia">
       <default>'scratch'</default>
       <summary>The paranoia mode to use</summary>
-      <description>Paranoia mode: 0) disable 2) fragment 4) overlap 8) scratch 16) repair 255) full</description>
+      <description>Paranoia mode: 0) disable; 2) fragment; 4) overlap; 8) scratch; 16) repair; 255) full</description>
     </key>
 
     <key name="strip-special" type="b">
       <default>false</default>
-      <summary>If to strip special characters from filenames</summary>
+      <summary>Whether to strip special characters from filenames</summary>
       <description>If enabled, special characters such as space, wildcards and backslashes will be removed from the output filename.</description>
     </key>
 
@@ -76,33 +76,32 @@
       <default>false</default>
       <summary>Whether the window is maximized</summary>
       <description>
-        True if the window is maximized. Otherwise, the size and position are determined
-        by the size and position keys.
+        True if the window is maximized. Otherwise, the size and position are determined by the size and position keys.
       </description>
     </key>
 
     <key name="width" type="i">
       <default>790</default>
       <summary>The width of the main window</summary>
-      <description>The width of the main window.</description>
+      <description>The width of the main window, if it isn't maximized.</description>
     </key>
 
     <key name="height" type="i">
       <default>560</default>
       <summary>The height of the main window</summary>
-      <description>The height of the main window.</description>
+      <description>The height of the main window, if it isn't maximized.</description>
     </key>
 
     <key name="position-x" type="i">
       <default>-1</default>
       <summary>Main window horizontal position</summary>
-      <description>The horizontal position of the window, if not maximized.</description>
+      <description>The horizontal position of the window, if it isn't maximized.</description>
     </key>
 
     <key name="position-y" type="i">
       <default>-1</default>
       <summary>Main window vertical position</summary>
-      <description>The vertical position of the window, if not maximized.</description>
+      <description>The vertical position of the window, if it isn't maximized.</description>
     </key>
 
   </schema>