[gimp-web] unix - Updating the unix/fonts page.

[Alexandre Prokoudine <aprokoudine src gnome org>]

commit 07e63e85c332cdbe27013a078de866938ecd8384
Author: Jehan <jehan girinstud io>
Date:   Mon Aug 26 00:22:00 2013 +1200

    unix - Updating the unix/fonts page.
    
    Basically pushing technical blabla to the bottom with a not-for-everyone
    warning, and keeping main part (install fonts) simple.

 unix/fonts.htrw |  123 ++++++++++++++++++++++++++++++++++++-------------------
 1 files changed, 81 insertions(+), 42 deletions(-)
---
diff --git a/unix/fonts.htrw b/unix/fonts.htrw
index f1de626..d673b95 100644
--- a/unix/fonts.htrw
+++ b/unix/fonts.htrw
@@ -5,60 +5,99 @@
 
 <h1>Fonts in GIMP 2.x</h1>
 
-<p>Starting with GIMP version 2.0, font rendering is handled
-significantly different from the way it was done in GIMP 1.0 and
-1.2. GIMP no longer uses the X server to render the fonts. Instead it
-uses Pango and the FreeType library. Font configuration is handled by
-a small library called Fontconfig. As a result you get much better
-font rendering with real antialiasing, support for bidirectional text
-and various scripts.</p>
-
 <p>GIMP 2.x handles a variety of font formats, most notably TrueType,
-OpenType and Type1. It should be emphasized that it does not use the X
-server or any X font server, so don't be surprised if GIMP doesn't see
-the fonts you configured in your X11 setup.
-</p>
-
-<h2>Setting up Fonts for GIMP 2.x</h2>
-
-<p>GIMP uses Fontconfig to handle fonts, so setting up fonts for GIMP
-2.x is merely a job of setting up Fontconfig. But GIMP is not the only
-application that uses Fontconfig. Recent desktops such as GNOME use it
-as well, so there's a good chance that everything is properly setup
-already and fonts will just work for you. If they don't, you will have
-to create or edit your font configuration file as explained in
-the <a
-href="http://www.fontconfig.org/fontconfig-user.html";>Fontconfig User
-Manual</a>.</p>
+OpenType and Type1.</p>
+
+<h2>Adding Fonts for GIMP 2.x</h2>
 
-<h2>Adding Fonts (system-wide)</h2>
+<h3>System-Wide</h3>
 
-<p>As soon as Fontconfig is properly setup, adding fonts is just a
-matter of placing them into a directory that is searched by
-Fontconfig.  Have a look at <tt>/etc/fonts/fonts.conf</tt> (and
-perhaps <tt>/etc/fonts/local.conf</tt>) to find out what directories
-are searched. After copying the fonts there, you should run
-<b>fc-cache</b> to regenerate the fonts cache. Fonts added this
-way will be available to all applications using Fontconfig.</p>
+<p>Most distributions will propose a large choice of fonts in their
+package manager. The easier is usually to install them this way.</p>
 
-<h2>Adding Fonts (for GIMP only)</h2>
+<p>In case you want to manually add third-party fonts (commercial,
+downloaded...), adding fonts is usually just a matter of moving font
+files into a directory that is searched by the font system. Have a look
+at <tt>/etc/fonts/fonts.conf</tt> (and perhaps
+<tt>/etc/fonts/local.conf</tt>) to find out which directories are
+searched, or look for your operating system documentation. After
+copying the fonts there, you should run <b>fc-cache</b> to regenerate
+the fonts cache.</p>
+
+<p>Some distributions also propose a graphical tool allowing to install
+fonts from third-party without bothering about the specifics.</p>
+
+<p>Fonts added this way will be available to all applications using the
+Fontconfig system (such as GIMP).</p>
+
+<h3>For GIMP only</h3>
 
 <p>You might want to install fonts for use with GIMP only or you might
-not have permissions to install fonts system-wide. To make this
-possible, GIMP 2.x also looks for fonts in the GIMP specific font
-search path that can be configured in your <tt>gimprc</tt> or from the
-<i>Preferences Dialog</i>. So, in order to install fonts to be used
-with GIMP, you can just copy them to <tt>~/.gimp-2.8/fonts</tt>, press
-the <i>Refresh</i> button in the <i>Fonts</i> dialog and start using
-them.</p>
+not have permissions to install fonts system-wide. For such cases,
+GIMP 2.x also looks for fonts in a GIMP specific font search path.
+The default place where GIMP will look for user fonts is
+<tt>~/.gimp-2.8/fonts/</tt> but you can change it or add other
+directories by modifying your <tt>gimprc</tt> or in <i>Edit ->
+Preferences -> Folders -> Fonts</i>.
+Then press the <i>Refresh</i> button in the <i>Fonts</i> dialog and
+start using your new fonts.</p>
+
+<h2>Internal Mechanics</h2>
+
+<p><em class="warn">This section is mostly informational, for users or
+developers who want to know more about under-the-hood font handling in
+GIMP 2.x. In nearly no case would you have to understand and know any
+of this in order to have font support in GIMP 2.x.
+See above for adding fonts simply.</em></p>
+
+<p>Starting with GIMP version 2.0, font rendering is handled
+significantly differently from the way it was done in GIMP 1.0 and
+1.2. GIMP no longer uses the X server to render the fonts. Instead it
+uses <a href="http://www.pango.org/";>Pango</a> and the
+<a href="http://www.freetype.org/";>FreeType</a> library. Font
+configuration is handled by
+<a href="http://www.fontconfig.org/";>Fontconfig</a>.
+As a result you get much better font rendering with real antialiasing,
+support for bidirectional text and various scripts.</p>
+
+<p>Fontconfig can nowadays be considered a de-facto standard on Linux
+and other Unix operating systems as the simple way to list and share the
+same fonts accross all application. Most modern graphical programs with
+text support now uses this library. And desktop environments (GNOME or
+KDE for instance) use it too.
+Therefore it is likely already installed and properly set up out of the
+box in most Unix/Linux machines and you have probably nothing to do in
+particular to have fonts working in GIMP 2.x.</p>
+
+<p>If you use a very raw operating system though, or if you simply want
+to know more, you may want to have a look at the <a
+href="http://www.fontconfig.org/fontconfig-user.html";>Fontconfig User
+Manual</a> to create or edit your font configuration file.
+
+Note though that since it is such a widespread system, modern desktops
+environments such as GNOME or KDE, or other distribution software, may
+overwrite your font configuration file. They sometimes provide an easier
+interface to manage your fonts instead.
+For this reason, you are advised to search the specific documentation of
+your operating system distribution before updating your font
+configuration.</p>
 
 <h2>Known Problems</h2>
 
-<p>There have been reports of crashes at startup when GIMP scans your
+<dl>
+<dt>GIMP crashes when scanning fonts</dt>
+<dd>There have been reports of crashes at startup when GIMP scans your
 font directories. These crashes should go away as soon as you update
 to a newer version of fontconfig (>= 2.2.0). As a quick workaround you
 can start gimp with the <kbd>--no-fonts</kbd> command-line option but of
-course you will not be able to use the text tool then.</p>
+course you will not be able to use the text tool then.</dd>
+<dt>GIMP cannot see my X fonts</dt>
+<dd>
+GIMP does not use the X server or any X font server, so don't be
+surprised if GIMP doesn't see the fonts you configured in your X11
+setup. If you wish to add fonts, see the instructions above.
+</dl>
+
 
 <!--#include virtual="/includes/wgo-page-fini.xhtml" -->
 <!--#include virtual="/includes/wgo-xhtml-fini.xhtml" -->