[gthumb] start of the docbook to mallard conversion
- From: Michael J. Chudobiak <mjc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gthumb] start of the docbook to mallard conversion
- Date: Thu, 24 Jun 2010 20:43:30 +0000 (UTC)
commit b604331f748f5c5b368773b4cecca9752f7fec28
Author: Michael J. Chudobiak <mjc avtechpulse com>
Date: Thu Jun 24 16:42:36 2010 -0400
start of the docbook to mallard conversion
extensions/change_date/dlg-change-date.c | 2 +-
extensions/convert_format/dlg-convert-format.c | 2 +-
extensions/resize_images/dlg-resize-images.c | 2 +-
help/C/Makefile.am | 9 -
help/C/attributes.page | 108 +
help/C/batch-change-date.page | 13 +
help/C/batch-convert-format.page | 12 +
help/C/batch-resize.page | 12 +
help/C/batch-rotate.page | 13 +
help/C/batch-scripts.page | 11 +
help/C/browser.page | 83 +
help/C/gthumb-C.omf | 31 -
help/C/gthumb.xml | 3846 ------------------------
help/C/index.page | 60 +
help/C/introduction.page | 31 +
help/C/legal.xml | 85 +-
help/C/strftime.page | 388 +++
help/C/thumbnails.page | 42 +
help/C/topic.dat | 3 -
help/Makefile.am | 28 +-
20 files changed, 806 insertions(+), 3975 deletions(-)
---
diff --git a/extensions/change_date/dlg-change-date.c b/extensions/change_date/dlg-change-date.c
index 92d0614..6312de0 100644
--- a/extensions/change_date/dlg-change-date.c
+++ b/extensions/change_date/dlg-change-date.c
@@ -104,7 +104,7 @@ static void
help_button_cb (GtkWidget *widget,
DialogData *data)
{
- show_help_dialog (GTK_WINDOW (data->dialog), "gthumb-change-date");
+ show_help_dialog (GTK_WINDOW (data->dialog), "gthumb-batch-change-date");
}
diff --git a/extensions/convert_format/dlg-convert-format.c b/extensions/convert_format/dlg-convert-format.c
index 81f11da..0ca5c68 100644
--- a/extensions/convert_format/dlg-convert-format.c
+++ b/extensions/convert_format/dlg-convert-format.c
@@ -63,7 +63,7 @@ static void
help_button_clicked_cb (GtkWidget *widget,
DialogData *data)
{
- show_help_dialog (GTK_WINDOW (data->dialog), "convert-format");
+ show_help_dialog (GTK_WINDOW (data->dialog), "gthumb-batch-convert-format");
}
diff --git a/extensions/resize_images/dlg-resize-images.c b/extensions/resize_images/dlg-resize-images.c
index cd761e1..22d7ada 100644
--- a/extensions/resize_images/dlg-resize-images.c
+++ b/extensions/resize_images/dlg-resize-images.c
@@ -116,7 +116,7 @@ static void
help_clicked_cb (GtkWidget *widget,
DialogData *data)
{
- show_help_dialog (GTK_WINDOW (data->dialog), NULL);
+ show_help_dialog (GTK_WINDOW (data->dialog), "gthumb-batch-resize");
}
diff --git a/help/C/attributes.page b/help/C/attributes.page
new file mode 100644
index 0000000..e9674f1
--- /dev/null
+++ b/help/C/attributes.page
@@ -0,0 +1,108 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-attributes">
+ <info>
+ <link type="guide" xref="index#reference" />
+ </info>
+ <title>Attribute Codes</title>
+ <p>gThumb stores many different attributes for each file.
+ Extensions may add more. The list below is a summary of some of
+ the more common attributes:</p>
+ <list>
+ <item>
+ <p>gth::file::display-size</p>
+ </item>
+ <item>
+ <p>standard::fast-content-type</p>
+ </item>
+ <item>
+ <p>general::dimensions</p>
+ </item>
+ <item>
+ <p>general::format</p>
+ </item>
+ <item>
+ <p>general::location</p>
+ </item>
+ <item>
+ <p>general::datetime</p>
+ </item>
+ <item>
+ <p>general::rating</p>
+ </item>
+ <item>
+ <p>Exif::Image::Make</p>
+ </item>
+ <item>
+ <p>Exif::Image::Model</p>
+ </item>
+ <item>
+ <p>Exif::Image::Software</p>
+ </item>
+ <item>
+ <p>Exif::Image::Artist</p>
+ </item>
+ <item>
+ <p>Exif::Image::Copyright</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ISOSpeedRatings</p>
+ </item>
+ <item>
+ <p>Exif::Photo::BrightnessValue</p>
+ </item>
+ <item>
+ <p>Exif::Photo::FNumber</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ApertureValue</p>
+ </item>
+ <item>
+ <p>Exif::Photo::MaxApertureValue</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ExposureTime</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ExposureProgram</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ExposureIndex</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ExposureBiasValue</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ExposureMode</p>
+ </item>
+ <item>
+ <p>Exif::Photo::ShutterSpeedValue</p>
+ </item>
+ <item>
+ <p>Exif::Photo::MeteringMode</p>
+ </item>
+ <item>
+ <p>Exif::Photo::LightSource</p>
+ </item>
+ <item>
+ <p>Exif::Photo::WhiteBalance</p>
+ </item>
+ <item>
+ <p>Exif::Photo::Flash</p>
+ </item>
+ <item>
+ <p>Exif::Photo::FocalLength</p>
+ </item>
+ <item>
+ <p>Exif::Photo::SubjectArea</p>
+ </item>
+ <item>
+ <p>Exif::Photo::Contrast</p>
+ </item>
+ <item>
+ <p>Exif::Photo::Saturation</p>
+ </item>
+ <item>
+ <p>Exif::Photo::Sharpness</p>
+ </item>
+ </list>
+</page>
diff --git a/help/C/batch-change-date.page b/help/C/batch-change-date.page
new file mode 100644
index 0000000..a181ff2
--- /dev/null
+++ b/help/C/batch-change-date.page
@@ -0,0 +1,13 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-batch-change-date">
+ <info>
+ <link type="guide" xref="index#batch" />
+ </info>
+ <title>Changing Dates</title>
+ <p>To change the the file modification times, the comment dates, or the
+ Exif DateTimeOriginal tags of multiple files, select the files in the
+ browser view. Then click the <gui>Tools</gui> button on the main toolbar,
+ and select <guiseq><gui>Tools</gui><gui>Change Date</gui></guiseq>.</p>
+ <p>Select the desired date options, and click <gui>Execute</gui>
+ to complete the process.</p>
+</page>
diff --git a/help/C/batch-convert-format.page b/help/C/batch-convert-format.page
new file mode 100644
index 0000000..e449159
--- /dev/null
+++ b/help/C/batch-convert-format.page
@@ -0,0 +1,12 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-batch-convert-format">
+ <info>
+ <link type="guide" xref="index#batch" />
+ </info>
+ <title>Converting File Formats</title>
+ <p>To convert one or more images into a new file format, select
+ the images in the browser view. Then click the <gui>Tools</gui> button
+ on the main toolbar, and select <guiseq><gui>Tools</gui><gui>Convert Format</gui></guiseq>.</p>
+ <p>Select the desired output format and destination folder. Click <gui>Execute</gui>
+ to complete the process.</p>
+</page>
diff --git a/help/C/batch-resize.page b/help/C/batch-resize.page
new file mode 100644
index 0000000..9ef1668
--- /dev/null
+++ b/help/C/batch-resize.page
@@ -0,0 +1,12 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-batch-resize">
+ <info>
+ <link type="guide" xref="index#batch" />
+ </info>
+ <title>Resizing Images</title>
+ <p>To resize one or more images using the same dimensions or scaling
+ factors, select the images in the browser view. Then click the <gui>Tools</gui> button
+ on the main toolbar, and select <guiseq><gui>Tools</gui><gui>Resize Images</gui></guiseq>.</p>
+ <p>Then select the desired maximum output dimensions, or the desired percentage scaling,
+ and the destination folder. Click <gui>Execute</gui> to complete the process.</p>
+</page>
diff --git a/help/C/batch-rotate.page b/help/C/batch-rotate.page
new file mode 100644
index 0000000..4ee1577
--- /dev/null
+++ b/help/C/batch-rotate.page
@@ -0,0 +1,13 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-batch-rotate">
+ <info>
+ <link type="guide" xref="index#batch" />
+ </info>
+ <title>Rotating Images</title>
+ <p>To rotate one or more images, select the images in the browser
+ view. Then click the <gui>Tools</gui> button on the main toolbar,
+ and select either <guiseq><gui>Tools</gui><gui>Rotate Right</gui></guiseq>
+ or <guiseq><gui>Tools</gui><gui>Rotate Left</gui></guiseq>. The
+ images will be rotated.</p>
+ <p>Lossless rotation is used, when possible.</p>
+</page>
diff --git a/help/C/batch-scripts.page b/help/C/batch-scripts.page
new file mode 100644
index 0000000..216c428
--- /dev/null
+++ b/help/C/batch-scripts.page
@@ -0,0 +1,11 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-batch-scripts">
+ <info>
+ <link type="guide" xref="index#batch" />
+ </info>
+ <title>User-Defined Scripts</title>
+ <p>To define a script (a command-line sequence that gThumb will
+ execute on your files), click the <gui>Tools</gui> button on the main toolbar,
+ and select <guiseq><gui>Tools</gui><gui>Personalize</gui></guiseq>.</p>
+ <p>TODO: further documentation is need here.</p>
+</page>
diff --git a/help/C/browser.page b/help/C/browser.page
new file mode 100644
index 0000000..800f4e0
--- /dev/null
+++ b/help/C/browser.page
@@ -0,0 +1,83 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-browser-view">
+ <info>
+ <link type="guide" xref="index#files" />
+ </info>
+ <title>Browsing Your Files</title>
+ <p>When you start gThumb the following window is displayed:</p>
+ <figure>
+ <title>The main window</title>
+ <media type="image" mime="image/png"
+ src="figures/main-win.png" />
+ </figure>
+ <p>The gThumb browser contains the following elements:</p>
+ <terms>
+ <item>
+ <title>Menubar</title>
+ <p>The menus on the menubar contain all of the commands that
+ you can use in gThumb</p>
+ </item>
+ <item>
+ <title>Toolbar</title>
+ <p>The toolbar contains a subset of the commands that you can
+ access from the menubar. In particular, the Tools button
+ contains functions for batch processing multiple images.</p>
+ </item>
+ <item>
+ <title>Locationbar</title>
+ <p>The locationbar contains the current folder or catalog
+ name.</p>
+ </item>
+ <item>
+ <title>Folder Tree</title>
+ <p>The folder tree allows you to navigate the filesystem.
+ Single-clicking on a folder will load its images in the
+ browser view. Double-clicking a folder, or clicking the
+ expander arrow, will also list folder's subfolders in the
+ tree.</p>
+ </item>
+ <item>
+ <title>Browser View</title>
+ <p>The browser view shows the images in the current folder or
+ catalog. Single-clicking an image will enable the Information
+ Sidebar for that image. Double-clicking an image will open it
+ in the viewer mode. Double-clicking with the middle mouse
+ button will load the image in fullscreen viewer mode.</p>
+ </item>
+ <item>
+ <title>Organize Button</title>
+ <p>The Organize button, just above the browser view, allows
+ you to group images into catalogs.</p>
+ </item>
+ <item>
+ <title>Statusbar</title>
+ <p>On the statusbar you can read:</p>
+ <list>
+ <item>
+ <p>the total number of images contained in the current
+ folder or catalog and their total size.</p>
+ </item>
+ <item>
+ <p>the number of the selected images and their size.</p>
+ </item>
+ <item>
+ <p>some properties of the currently focused image.</p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <title>Information Sidebar</title>
+ <p>If a single image is selected, the information sidebar
+ (below the folder tree) will display detailed information
+ (such as EXIF or XMP tags) about the selected image.</p>
+ </item>
+ <item>
+ <title>Filter Bar</title>
+ <p>An image filtering tool is provided just below the browser
+ view. This can be used to filter the displayed images. For
+ example, the browser view can be limited to files of a
+ certain size, date, or name pattern, or other
+ characteristics.</p>
+ </item>
+ </terms>
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..6ea2a68
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="guide"
+ id="index">
+
+ <info>
+ <credit type="author">
+ <name>Paolo Bacchilega</name>
+ <email>paobac src gnome org</email>
+ </credit>
+ <credit type="author">
+ <name>Michael J. Chudobiak</name>
+ <email>mjc avtechpulse com</email>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
+ </info>
+
+ <title>gThumb Help</title>
+
+ <section id="welcome" style="2column">
+ <title>Welcome</title>
+ </section>
+
+ <section id="files" style="2column">
+ <title>File Management</title>
+ </section>
+
+ <section id="editing" style="2column">
+ <title>Editing Mode</title>
+ <p>Numerous editing tools are provided for touching-up individual photos.
+ Undo and redo functions are provided, up until the photo is saved.</p>
+ </section>
+
+ <section id="batch" style="2column">
+ <title>Batch Tools</title>
+ <p>Batch tools are provided to modify multiple images simultaneously.
+ Changes are written immediately, and are not undoable.</p>
+ </section>
+
+ <section id="importing" style="2column">
+ <title>Importing</title>
+ </section>
+
+ <section id="sharing" style="2column">
+ <title>Sharing</title>
+ </section>
+
+ <section id="organizing" style="2column">
+ <title>Organizing</title>
+ </section>
+
+ <section id="other" style="2column">
+ <title>Other Tools</title>
+ </section>
+
+ <section id="reference" style="2column">
+ <title>Reference</title>
+ </section>
+
+</page>
diff --git a/help/C/introduction.page b/help/C/introduction.page
new file mode 100644
index 0000000..913500c
--- /dev/null
+++ b/help/C/introduction.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-introduction">
+ <info>
+ <link type="guide" xref="index#welcome" />
+ </info>
+ <title>Introduction</title>
+ <p>gThumb is an image viewer and browser written for the GNOME
+ environment. It lets you browse your hard disk, showing you
+ thumbnails of image files and view single images of many
+ different formats.</p>
+ <p>gThumb supports the most common graphics formats, including
+ JPEG, GIF, TIF, and PNG. gThumb will also display other less
+ common image types if the supporting libraries are installed,
+ including TGA, ICO, BMP, XPM, and others.</p>
+ <p>Some support for RAW image types is included, especially if
+ the dcraw program is installed on your system.</p>
+ <p>gThumb not only lets you view image files but has many other
+ features such as adding comments to images, organizing images
+ into catalogs, printing images, slideshows, setting your desktop
+ background, and more.</p>
+ <p>gThumb includes a tool to import photos from attached cameras
+ and memory card readers.</p>
+ <p>gThumb can read EXIF, XMP, and IPTC metadata that is commonly
+ embedded in files.</p>
+ <p>gThumb provides a systems of extensions (or plug-ins), to
+ allow users to extend the functionality of gThumb.</p>
+ <p>More information about these extensions, and about gThumb
+ generally, is available at
+ <link href="http://live.gnome.org/gthumb";>
+ http://live.gnome.org/gthumb</link>.</p>
+</page>
diff --git a/help/C/legal.xml b/help/C/legal.xml
index d6906f9..86d6173 100644
--- a/help/C/legal.xml
+++ b/help/C/legal.xml
@@ -1,76 +1,9 @@
- <legalnotice id="legalnotice">
- <para>
- Permission is granted to copy, distribute and/or modify this
- document under the terms of the GNU Free Documentation
- License (GFDL), Version 1.1 or any later version published
- by the Free Software Foundation with no Invariant Sections,
- no Front-Cover Texts, and no Back-Cover Texts. You can find
- a copy of the GFDL at this <ulink type="help"
- url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
- distributed with this manual.
- </para>
- <para> This manual is part of a collection of GNOME manuals
- distributed under the GFDL. If you want to distribute this
- manual separately from the collection, you can do so by
- adding a copy of the license to the manual, as described in
- section 6 of the license.
- </para>
-
- <para>
- Many of the names used by companies to distinguish their
- products and services are claimed as trademarks. Where those
- names appear in any GNOME documentation, and the members of
- the GNOME Documentation Project are made aware of those
- trademarks, then the names are in capital letters or initial
- capital letters.
- </para>
-
- <para>
- DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
- UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
- WITH THE FURTHER UNDERSTANDING THAT:
-
- <orderedlist>
- <listitem>
- <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
- WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
- IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
- THAT THE DOCUMENT OR MODIFIED VERSION OF THE
- DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
- A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
- RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
- OF THE DOCUMENT OR MODIFIED VERSION OF THE
- DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
- MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
- YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
- CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
- SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
- OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
- LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
- VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
- EXCEPT UNDER THIS DISCLAIMER; AND
- </para>
- </listitem>
- <listitem>
- <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
- THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
- CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
- INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
- DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
- OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
- PARTIES, BE LIABLE TO ANY PERSON FOR ANY
- DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
- CONSEQUENTIAL DAMAGES OF ANY CHARACTER
- INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
- OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
- MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
- LOSSES ARISING OUT OF OR RELATING TO USE OF THE
- DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
- EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
- THE POSSIBILITY OF SUCH DAMAGES.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </legalnotice>
-
\ No newline at end of file
+<license xmlns="http://projectmallard.org/1.0/";
+ href="http://creativecommons.org/licenses/by-sa/3.0/";>
+<p>This work is licensed under a
+<link href="http://creativecommons.org/licenses/by-sa/3.0/";>Creative Commons
+Attribution-Share Alike 3.0 Unported License</link>.</p>
+<p>As a special exception, the copyright holders give you permission to copy,
+modify, and distribute the example code contained in this document under the
+terms of your choosing, without restriction.</p>
+</license>
diff --git a/help/C/strftime.page b/help/C/strftime.page
new file mode 100644
index 0000000..9aa1c0a
--- /dev/null
+++ b/help/C/strftime.page
@@ -0,0 +1,388 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-date-formats">
+ <info>
+ <link type="guide" xref="index#reference" />
+ </info>
+ <title>Date/Time Format Codes</title>
+ <p>This is a summary of standard date/time codes that may be used
+ in format strings:</p>
+ <table id="gthumb-TBL-strftime">
+ <title>Valid format codes for custom subfolders</title>
+ <tr>
+ <td>
+ <p>%a</p>
+ </td>
+ <td>
+ <p>The abbreviated weekday name according to the current
+ locale.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%A</p>
+ </td>
+ <td>
+ <p>The full weekday name according to the current
+ locale.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%b</p>
+ </td>
+ <td>
+ <p>The abbreviated month name according to the current
+ locale.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%B</p>
+ </td>
+ <td>
+ <p>The full month name according to the current locale.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%c</p>
+ </td>
+ <td>
+ <p>The preferred date and time representation for the
+ current locale.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%C</p>
+ </td>
+ <td>
+ <p>The century number (year/100) as a 2-digit integer.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%d</p>
+ </td>
+ <td>
+ <p>The day of the month as a decimal number (range 01 to
+ 31).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%D</p>
+ </td>
+ <td>
+ <p>Equivalent to %m/%d/%y. (Yecch -- for Americans only.
+ Americans should note that in other countries %d/%m/%y is
+ rather common. This means that in international context
+ this format is ambiguous and should not be used.)</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%e</p>
+ </td>
+ <td>
+ <p>Like %d, the day of the month as a decimal number, but a
+ leading zero is replaced by a space.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%E</p>
+ </td>
+ <td>
+ <p>Modifier: use alternative format, see below.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%F</p>
+ </td>
+ <td>
+ <p>Equivalent to %Y-%m-%d (the ISO 8601 date format).
+ (C99)</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%G</p>
+ </td>
+ <td>
+ <p>The ISO 8601 year with century as a decimal number. The
+ 4-digit year corresponding to the ISO week number (see %V).
+ This has the same format and value as %y, except that if
+ the ISO week number belongs to the previous or next year,
+ that year is used instead.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%g</p>
+ </td>
+ <td>
+ <p>Like %G, but without century, i.e., with a 2-digit year
+ (00-99).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%h</p>
+ </td>
+ <td>
+ <p>Equivalent to %b.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%H</p>
+ </td>
+ <td>
+ <p>The hour as a decimal number using a 24-hour clock
+ (range 00 to 23).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%I</p>
+ </td>
+ <td>
+ <p>The hour as a decimal number using a 12-hour clock
+ (range 01 to 12).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%j</p>
+ </td>
+ <td>
+ <p>The day of the year as a decimal number (range 001 to
+ 366).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%k</p>
+ </td>
+ <td>
+ <p>The hour (24-hour clock) as a decimal number (range 0 to
+ 23); single digits are preceded by a blank. (See also
+ %H.)</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%l</p>
+ </td>
+ <td>
+ <p>The hour (12-hour clock) as a decimal number (range 1 to
+ 12); single digits are preceded by a blank. (See also
+ %I.)</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%m</p>
+ </td>
+ <td>
+ <p>The month as a decimal number (range 01 to 12).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%M</p>
+ </td>
+ <td>
+ <p>The minute as a decimal number (range 00 to 59).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%O</p>
+ </td>
+ <td>
+ <p>Modifier: use alternative format, see below.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%p</p>
+ </td>
+ <td>
+ <p>Either 'AM' or 'PM' according to the given time value,
+ or the corresponding strings for the current locale. Noon
+ is treated as 'pm' and midnight as 'am'.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%P</p>
+ </td>
+ <td>
+ <p>Like %p but in lowercase: 'am' or 'pm' or a
+ corresponding string for the current locale.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%r</p>
+ </td>
+ <td>
+ <p>The time in a.m. or p.m. notation. In the POSIX locale
+ this is equivalent to '%I:%M:%S %p'.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%R</p>
+ </td>
+ <td>
+ <p>The time in 24-hour notation (%H:%M). For a version
+ including the seconds, see %T below.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%s</p>
+ </td>
+ <td>
+ <p>The number of seconds since the Epoch, i.e., since
+ 1970-01-01 00:00:00 UTC.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%S</p>
+ </td>
+ <td>
+ <p>The second as a decimal number (range 00 to 60). (The
+ range is up to 60 to allow for occasional leap
+ seconds.)</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%T</p>
+ </td>
+ <td>
+ <p>The time in 24-hour notation (%H:%M:%S).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%u</p>
+ </td>
+ <td>
+ <p>The day of the week as a decimal number, range 1 to 7,
+ Monday being 1. See also %w.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%U</p>
+ </td>
+ <td>
+ <p>The week number of the current year as a decimal number,
+ range 00 to 53, starting with the first Sunday as the first
+ day of week 01. See also %V and %W.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%V</p>
+ </td>
+ <td>
+ <p>The ISO 8601:1988 week number of the current year as a
+ decimal number, range 01 to 53, where week 1 is the first
+ week that has at least 4 days in the current year, and with
+ Monday as the first day of the week. See also %U and
+ %W.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%w</p>
+ </td>
+ <td>
+ <p>The day of the week as a decimal, range 0 to 6, Sunday
+ being 0. See also %u.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%W</p>
+ </td>
+ <td>
+ <p>The week number of the current year as a decimal number,
+ range 00 to 53, starting with the first Monday as the first
+ day of week 01.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%x</p>
+ </td>
+ <td>
+ <p>The preferred date representation for the current locale
+ without the time.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%X</p>
+ </td>
+ <td>
+ <p>The preferred time representation for the current locale
+ without the date.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%y</p>
+ </td>
+ <td>
+ <p>The year as a decimal number without a century (range 00
+ to 99).</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%Y</p>
+ </td>
+ <td>
+ <p>The year as a decimal number including the century.</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%z</p>
+ </td>
+ <td>
+ <p>The time-zone as hour offset from GMT. Required to emit
+ RFC 822-conformant dates (using "%a, %d %b %Y %H:%M:%S
+ %z").</p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <p>%Z</p>
+ </td>
+ <td>
+ <p>The time zone or name or abbreviation.</p>
+ </td>
+ </tr>
+ </table>
+ <p>Some conversion specifications can be modified by preceding
+ the conversion specifier character by the E or O modifier to
+ indicate that an alternative format should be used. If the
+ alternative format or specification does not exist for the
+ current locale, the behaviour will be as if the unmodified
+ conversion specification were used. The Single Unix Specification
+ mentions %Ec, %EC, %Ex, %EX, %Ey, %EY, %Od, %Oe, %OH, %OI, %Om,
+ %OM, %OS, %Ou, %OU, %OV, %Ow, %OW, %Oy, where the effect of the O
+ modifier is to use alternative numeric symbols (say, roman
+ numerals), and that of the E modifier is to use a
+ locale-dependent alternative representation.</p>
+</page>
diff --git a/help/C/thumbnails.page b/help/C/thumbnails.page
new file mode 100644
index 0000000..0c2def0
--- /dev/null
+++ b/help/C/thumbnails.page
@@ -0,0 +1,42 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-thumbnails">
+ <info>
+ <link type="guide" xref="index#files" />
+ </info>
+ <title>Thumbnails</title>
+ <p>The browser window normally shows the thumbnails of the images
+ and movies in the selected folder. Generic icons for other files
+ (audio files, for instance) may also be shown.</p>
+ <p>You can select what types of files to show in the browser view
+ using the
+ <guiseq>
+ <gui>View</gui>
+ <gui>Filter</gui>
+ </guiseq> dialog. The default is to show all media files (images,
+ movies, audio), but this can be made more or less
+ restrictive.</p>
+ <p>The thumbnails may be generated by a number of different
+ methods. gThumb will first check for existing thumbnails in the
+ system cache.</p>
+ <p>If no cached thumbnail is found, and an image file contains an
+ embedded thumbnail (jpeg files generated by digital cameras
+ normally do), gThumb will attempt to use that. gThumb will
+ confirm that the aspect ratio of the thumbnail is similar to that
+ of the main image, and ignore thumbnails that do not appear to
+ match the main image.</p>
+ <p>If that doesn't work, gThumb will attempt to load the entire
+ file and generate a scaled-down thumbnail.</p>
+ <p>Lastly, gThumb will use any system-defined scripts for
+ thumbnailing particular media types. For example, some systems
+ may use mplayer or totem or other movie viewers to generate movie
+ thumbnails.</p>
+ <p>gThumb will save thumbnails to a system cache, to share them
+ with other applications. By default, Gnome systems prune cached
+ thumbnails when they are older than 180 days, or when the
+ thumbnail cache exceeds 512 MB. Technically-inclined users can
+ explore these settings with gconf-editor. See the
+ /desktop/gnome/thumbnail_cache/maximum_age and
+ /desktop/gnome/thumbnail_cache/maximum_size keys in particular.
+ Certain applications (like F-Spot) may automatically increase
+ these settings greatly.</p>
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 83de253..2f79103 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -1,14 +1,28 @@
include $(top_srcdir)/gnome-doc-utils.make
dist-hook: doc-dist-hook
-DOC_MODULE = gthumb
-DOC_ENTITIES = legal.xml
-DOC_INCLUDES =
-DOC_FIGURES = figures/comment.png \
- figures/main-win.png \
- figures/nav-button.png \
- figures/preferences.png
+DOC_ID = gthumb
+DOC_INCLUDES = legal.xml
+DOC_FIGURES = \
+ figures/comment.png \
+ figures/main-win.png \
+ figures/nav-button.png \
+ figures/preferences.png
+
+DOC_PAGES = \
+ index.page \
+ attributes.page \
+ strftime.page \
+ introduction.page \
+ browser.page \
+ batch-rotate.page \
+ batch-convert-format.page \
+ batch-resize.page \
+ batch-change-date.page \
+ batch-scripts.page \
+ thumbnails.page
+
DOC_LINGUAS = de el es fr oc sl sv zh_CN
EXTRA_DIST = album-theme-format.txt
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
