> Date: Tue, 6 Dec 2016 13:35:55 +0000
> From: Ken Moffat <[email protected]>
> Subject: Re: [blfs-dev] Xorg bitmap fonts - deprecate them
>
        .
        .
> diff -Naur BOOK-r18030/x/installing/x7legacy.xml 
> BOOK-deprecate/x/installing/x7legacy.xml
> --- BOOK-r18030/x/installing/x7legacy.xml     1970-01-01 01:00:00.000000000 
> +0100
> +++ BOOK-deprecate/x/installing/x7legacy.xml  2016-12-06 11:37:04.231916269 
> +0000
> @@ -0,0 +1,229 @@
> +<?xml version="1.0" encoding="ISO-8859-1"?>
> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> +   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [
> +  <!ENTITY % general-entities SYSTEM "../../general.ent">
> +  %general-entities;
> +
> +  <!ENTITY x7legacy-download-http "&xorg-download-http;/">
> +  <!ENTITY x7legacy-download-ftp  "&xorg-download-ftp;/">
> +  <!ENTITY x7legacy-size          "1.7 MB">
> +  <!ENTITY x7legacy-buildsize     "70 MB">
> +  <!ENTITY x7legacy-time          "0.4 SBU">
> +
> +  <!ENTITY libXfont-version                "1.5.2">
> +  <!ENTITY libXfont-md5sum                 
> "254ee42bd178d18ebc7a73aacfde7f79">
> +
> +  <!ENTITY bdftopcf-version                "1.0.5">
> +  <!ENTITY bdftopcf-md5sum                 
> "53a48e1fdfec29ab2e89f86d4b7ca902">
> +
> +  <!ENTITY font-adobe-100dpi-version       "1.0.3">
> +  <!ENTITY font-adobe-100dpi-md5sum        
> "1347c3031b74c9e91dc4dfa53b12f143">
> +
> +]>


The legacy page should at this time include all of the fonts/&c that
you've removed from elsewhere.

And only after a few more book releases, then remove some/all of the
items from the book.

That's a standard way of 'putting out to pasture' - phasing out - such
materials: don't just - for such a case - do the reorganise and remove
in same step.

It's ok though to prioritise at this time the focus on the
libXfont/bdftopcf/font-adobe-100dpi  .


> +
> +<sect1 id="xorg7-legacy" xreflabel="Xorg Legacy">
> +  <?dbhtml filename="x7legacy.html"?>
> +
> +  <sect1info>
> +    <othername>$LastChangedBy: dibbler $</othername>
> +    <date>$Date: 2038-01-19 03:14:07 +0000 (Tue, 19 Jan 2038) $</date>
> +  </sect1info>
> +
> +  <title>Xorg Legacy</title>
> +
> +  <indexterm zone="xorg7-legacy">
> +    <primary sortas="a-xorg7-legacy">Xorg Legacy</primary>
> +  </indexterm>
> +
> +  <sect2 role="package">
> +    <title>Introduction to Xorg Legacy</title>
> +
> +    <para><application>Xorg</application> originally provided bitmap fonts,


'originally' implies that it now doesn't: does it still; if so then
reword.


> +    and a tool (<command>bdftopcf</command>) to assist in their installation.
> +    With the introduction of <application>xorg-server-1.19.0</application>
> +    and <application>libXfont2</application>, many people will not need them.
> +    There are still a few old packages which might require, or benefit from,
> +    these deprecated fonts and so the following packages are shown 
> here.</para>


Those last two sentences - and in partic the last - are a bit too vague
and ~hand-waving; and leave readers a bit too much in the dark.

At least, for those packages (if any) that are in BLFS and that
are _known_ or _thought_ to still require the now-legacy materials,
they should be listed and linked-to explicitly: if there are only a
few such packages (e.g. tigervnc &c) then it's not a hassle to list;
if the list were not short, then it'd call into question doing the
'legacy' stuff yet.


> +
> +    <note>
> +      <para>
> +        The font-adobe-100dpi package installs 100 dots per inch versions of
> +        Courier, Helvetica, New Century Schoolbook and Times fonts. In 
> previous
> +        versions of BLFS a lot more fonts were installed, and also 75 dots 
> per


s/and also/including/

or maybe even (less good)

s/and also/plus/

 - but _NOT_ 'and also'; red pen.


> +        inch versions.
> +      </para>
> +
> +      <para revision="sysv">
> +       Please consult the BLFS-7.10 book at <ulink
> +       url="http://www.linuxfromscratch.org/blfs/view/7.10/x/x7font.html"/>
> +       if you wish to install any of those other fonts.


Still too vague: you're leaving readers to hunt'n'peck, while you
know what they're likely to be looking for. Again: for packages in
BLFS that are known/thought to still require the legacy materials,
state the details explicitly. As noted, such materials should anyhow
be listed in legacy page.


> +      </para>
> +
> +      <para revision="systemd">
> +       Please consult the BLFS-7.10 systemd book at <ulink
> +       
> url="http://www.linuxfromscratch.org/blfs/view/7.10-systemd/x/x7font.html"/>
> +       if you wish to install any of those other fonts.
> +      </para>
> +    </note>
> +


Ditto.


>
        .
        .
> +    <title>Downloading Xorg Legacy</title>
> +
> +    <para>First, create a list of files to be downloaded. This file will also
> +    be used to verify the integrity of the downloads when complete:</para>
> +
> +<screen><userinput>cat &gt; legacy.dat &lt;&lt; "EOF"
> +<literal>&libXfont-md5sum; lib/ libXfont-&libXfont-version;.tar.bz2
> +&bdftopcf-md5sum; app/ bdftopcf-&bdftopcf-version;.tar.bz2
> +&font-adobe-100dpi-md5sum; font/ 
> font-adobe-100dpi-&font-adobe-100dpi-version;.tar.bz2</literal>
> +EOF</userinput></screen>
> +
> +    <para>To download the needed files using <application>wget</application>,
> +    use the following commands:</para>
> +
> +<screen><userinput>mkdir legacy &amp;&amp;
> +cd legacy &amp;&amp;
> +grep -v '^#' ../legacy.dat | awk '{print $2$3}' | wget -i- -c \
> +    -B &xorg-download-http;/ &amp;&amp;
> +grep -v '^#' ../legacy.dat | awk '{print $1 " " $3}' >../legacy.md5 
> &amp;&amp;
> +md5sum -c ../legacy.md5</userinput></screen>
> +<!--  is there any way to use lib/ app/ font/ directory in the above ? -->   
>         


Not sure exactly what that comment means. D'you mean, how to pass it
through to wget? If so, then use a '<<<' construct:

$
while read x y z spng; do
  some_cmds;
done <<< "$(
{
  grep -vE '^[[:blank:]]*(#|$)' ../legacy.dat ;
}
)" ;
$


>
        .
        .
>



hth,
akh





--
-- 
http://lists.linuxfromscratch.org/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to