Author: ken
Date: Thu Aug 18 20:09:04 2016
New Revision: 17646

Log:
Noto-fonts: fix up the instructions for people who use the tarball.

Modified:
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/kde/kf5/noto-fonts.xml

Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml       Wed Aug 17 22:47:58 
2016        (r17645)
+++ trunk/BOOK/introduction/welcome/changelog.xml       Thu Aug 18 20:09:04 
2016        (r17646)
@@ -47,6 +47,11 @@
     <listitem>
       <para>August 18th, 2016</para>
       <itemizedlist>
+        <listitem>
+          <para>[ken] - alter the instructions for the smaller version
+          of noto-fonts to prefer hinted (without this, both hinted and
+          unhinted forms of the main fonts were installed).</para>
+        </listitem>
         <listitem revision="systemd">
           <para>[renodr] - Update to evolution-3.20.5. Fixes
           <ulink url="&blfs-ticket-root;8166">#8166</ulink>.</para>

Modified: trunk/BOOK/kde/kf5/noto-fonts.xml
==============================================================================
--- trunk/BOOK/kde/kf5/noto-fonts.xml   Wed Aug 17 22:47:58 2016        (r17645)
+++ trunk/BOOK/kde/kf5/noto-fonts.xml   Thu Aug 18 20:09:04 2016        (r17646)
@@ -31,10 +31,24 @@
     <title>Introduction to Noto Fonts</title>
 
     <para>
-      The <application>noto-fonts</application> package is a set of fonts
-      used by KF5.
+      The <application>noto-fonts</application> package ('No Tofu' i.e. 
avoiding
+      boxes with dots [ hex digits ] when a glyph cannot be found) is a set of
+      fonts which aim to cover <emphasis>every glyph in unicode, no matter how
+      obscure</emphasis>. These fonts, or at least the Sans Serif fonts, are
+      used by KF5 (initially only for gtk applications).
     </para>
 
+    <para>
+      Some of these fonts began life as the libre Source Sans Pro fonts from
+      adobe.
+    </para>
+
+    <note><para>As well as the full set, there is a slightly smaller and
+    older set of fonts, with some extra fonts, at
+    <ulink url="&noto-alternate;">&noto-alternate;</ulink> (19 MB). The
+    installation procedures for those are listed separately. Unfortunately,
+    the tarball does not provide the CJK fonts.</para></note>
+
     &lfs79_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
@@ -71,18 +85,15 @@
       </listitem>
     </itemizedlist>
 
-    <note><para>There is a smaller file that contains some of the most common
-    Noto fonts at <ulink url="&noto-alternate;">&noto-alternate;</ulink> 
-    (19 MB).  The installation procedures are similar to the instructions 
-    below.  Just copy the .ttf files in the tarball to a directory
-    in the /usr/share/fonts/ hierarchy.</para></note>
-
+    <note><para>Almost nobody will ever encounter text for which some of these
+    fonts can be used. Consult the wiki to see which fonts you might wish to
+    delete.</para></note>
 
     <bridgehead renderas="sect3">Noto Fonts Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-      <xref linkend="unzip"/>
+      <xref linkend="unzip"/> (for Noto-hinted.zip)
     </para>
 
     <para condition="html" role="usernotes">
@@ -94,17 +105,58 @@
     <title>Installation of Noto Fonts</title>
 
     <note><para>Unlike most other packages there is no need to unpack the 
compressed
-    noto package before installation.</para></note>
+    Noto-hinted.zip package before installation.</para></note>
+
+    <para>
+      To install <application>Noto Fonts</application> from the full 
Noto-hinted
+      zip file, run the following commands as the
+       <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen><userinput>install -d -m755         /usr/share/fonts/noto   &amp;&amp;
+unzip Noto-hinted.zip -d /usr/share/fonts/noto   &amp;&amp;
+chmod 0644               /usr/share/fonts/noto/* &amp;&amp;
+fc-cache</userinput></screen>
+
+    <para>
+      Alternatively, to install a smaller set from the tarball, untar it
+      as normal.  You will note that there are both
+      <filename class="directory">hinted/</filename> and
+      <filename class="directory">unhinted/</filename> directories, and
+      the documentation suggests that linux users should install the
+      hinted files.
+    </para>
+
+    <para>
+      In fact, there are many other fonts in the <filename
+      class="directory">unhinted</filename> directory, but all except one are
+      historic. The exception is the Noto Sans Symbols font - if Noto Sans is
+      your main font, you will probably want this because of the currency
+      symbols it provides.
+    </para>
 
+    <para>
+      In the <filename class="directory">hinted/</filename> directory there are
+      also some duplicate TTC (TrueType Collection) files for NotoSans which do
+      not provide anything useful and similarly some UI variants which were
+      again a dead end.
+    </para>
 
     <para>
-      Install the <application>Noto Fonts</application> by running the 
following
-      commands as the <systemitem class="username">root</systemitem> user:
+      To install from the tarball, run the following commands as the
+       <systemitem class="username">root</systemitem> user:
     </para>
 
-<screen><userinput>install -d -m755         /usr/share/fonts/truetype/noto 
&amp;&amp;
-unzip Noto-hinted.zip -d /usr/share/fonts/truetype/noto &amp;&amp;
-chmod 0644               /usr/share/fonts/truetype/noto/*</userinput></screen>
+<screen><userinput>install -d -m755         /usr/share/fonts/noto              
                   &amp;&amp;
+cp -v LICENSE hinted/*.ttf unhinted/NotoSansSymbols*.ttf /usr/share/fonts/noto 
&amp;&amp;
+rm -v /usr/share/fonts/noto/Noto*UI*                                           
&amp;&amp;
+chmod 0644               /usr/share/fonts/noto/*                               
&amp;&amp;
+fc-cache</userinput></screen>
+
+    <para>
+      If you remove any of the fonts, remember to run 'fc-cache' (as root) to
+      update fontconfig.
+    </para>
 
     <para>
       This package does not come with a test suite.
@@ -128,7 +180,7 @@
           None
         </seg>
         <seg>
-          /usr/share/fonts/truetype/noto 
+          /usr/share/fonts/noto
         </seg>
       </seglistitem>
     </segmentedlist>
-- 
http://lists.linuxfromscratch.org/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to