[blfs-book] r10406 - in trunk/BOOK: . archive introduction/important introduction/welcome multimedia/audioutils multimedia/libdriv postlfs/security x/wm

ken at linuxfromscratch.org ken at linuxfromscratch.org
Mon Jul 9 11:31:36 PDT 2012


Author: ken
Date: 2012-07-09 12:31:25 -0600 (Mon, 09 Jul 2012)
New Revision: 10406

Added:
   trunk/BOOK/archive/gnome-media.xml
   trunk/BOOK/introduction/important/libraries.xml
   trunk/BOOK/multimedia/audioutils/gvolwheel.xml
   trunk/BOOK/postlfs/security/vulnerabilities.xml
   trunk/BOOK/x/wm/icewm.xml
Removed:
   trunk/BOOK/multimedia/audioutils/gnome-media.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/important/beyond.xml
   trunk/BOOK/introduction/important/important.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/multimedia/audioutils/audioutils.xml
   trunk/BOOK/multimedia/libdriv/alsa-lib.xml
   trunk/BOOK/postlfs/security/security.xml
   trunk/BOOK/x/wm/wm.xml
Log:
Add pages on libraries and vulnerabilities, icewm-1.3.7, gvolwheel-1.0.0 and retire gnome-media.

Copied: trunk/BOOK/archive/gnome-media.xml (from rev 10405, trunk/BOOK/multimedia/audioutils/gnome-media.xml)
===================================================================
--- trunk/BOOK/archive/gnome-media.xml	                        (rev 0)
+++ trunk/BOOK/archive/gnome-media.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -0,0 +1,211 @@
+<?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 gnome-media-download-http "&gnome-download-http;/gnome-media/2.32/gnome-media-&gnome-media-version;.tar.bz2">
+  <!ENTITY gnome-media-download-ftp  "&gnome-download-ftp;/gnome-media/2.32/gnome-media-&gnome-media-version;.tar.bz2">
+  <!ENTITY gnome-media-md5sum        "06fc8c67add34c98bc484e0dbc404d41">
+  <!ENTITY gnome-media-size          "2.7 MB">
+  <!ENTITY gnome-media-buildsize     "38 MB">
+  <!ENTITY gnome-media-time          "0.5 SBU">
+]>
+
+<sect1 id="gnome-media" xreflabel="gnome-media-&gnome-media-version;">
+  <?dbhtml filename="gnome-media.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>gnome-media-&gnome-media-version;</title>
+
+  <indexterm zone="gnome-media">
+    <primary sortas="a-GNOME Media">GNOME Media</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to GNOME Media</title>
+
+    <para>The <application>GNOME Media</application> package contains
+    <application>GNOME</application>'s media applications.</para>
+
+    &lfs70_checked;
+
+    <para>This is a legacy GNOME-2 package which has been deprecated by the
+    GNOME developers and will be removed from the book in due course. If you
+    are not building a GNOME desktop, this can provide a volume control / mixer
+    application, but you may wish to consider simpler alternatives:</para>
+
+    <para><ulink url="http://volumecontrol.sourceforge.net/">volumecontrol</ulink>,
+    is a simple volume control and mixer which requires
+    <xref linkend="gtk2"/>, and
+    <xref linkend="alsa-utils"/>. Use ./autogen.sh to configure it.</para>
+
+    <para><ulink url="http://gvolwheel.sourceforge.net/">gvolwheel</ulink>
+    provides a volume control in a tray icon, for minimalist desktops. It uses
+    <xref linkend="intltool"/>, <xref linkend="perl-xml-parser"/>, and there are
+    different versions for <xref linkend="gtk2"/> (0.7) or
+    <xref linkend="gtk3"/> (0.9).</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&gnome-media-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&gnome-media-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &gnome-media-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &gnome-media-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &gnome-media-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &gnome-media-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">GNOME Media Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="libcanberra"/>,
+      <xref linkend="GConf"/>,
+      <xref linkend="gnome-doc-utils"/>
+      <xref linkend="gstreamer"/>,
+      <xref linkend="gtk2"/>, and
+      <xref linkend="which"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="gst-plugins-base"/> (required to build the sound mixer and
+         recorder),
+      <xref linkend="libglade"/>,
+      <!-- libunique in the book will be updated to 3.0 during the gnome-3 changes,
+      that version is too new -->
+      <xref linkend="pulseaudio"/> (with
+      <ulink url="&gnome-download-http;/libunique/1.1/libunique-1.1.6.tar.bz2">libunique-1</ulink>),
+      and <xref linkend="rarian"/>
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/gnome-media"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of GNOME Media</title>
+
+    <para>Install <application>GNOME Media</application> by
+    running the following commands:</para>
+
+<screen><userinput>./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
+            --sysconfdir=&gnome-old-etc-dir; \
+            --localstatedir=/var/lib \
+            --libexecdir=$(pkg-config \
+                --variable=prefix ORBit-2.0)/lib/gnome-media &&
+make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+    href="../../xincludes/gnome-old-prefix.xml"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+    href="../../xincludes/gnome-old-sysconfdir.xml"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+    href="../../xincludes/scrollkeeper-dir.xml"/>
+
+    <para><parameter>--libexecdir=$(pkg-config --variable=prefix
+    ORBit-2.0)/lib/gnome-media</parameter>: This parameter causes the libexec
+    files to be installed in the preferred location of
+    <filename class="directory">$GNOME_PREFIX/lib/gnome-media</filename> instead
+    of <filename class="directory">$GNOME_PREFIX/libexec</filename>.</para>
+
+    <para><option>--disable-scrollkeeper</option>: Use this parameter if you
+    wish to disable the updates to the scrollkeeper database.</para>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>gnome-audio-profiles-properties, gnome-sound-recorder,
+        gnome-volume-control, and gstreamer-properties</seg>
+        <seg>libgnome-media-profiles.{so,a}</seg>
+        <seg><envar>$GNOME_PREFIX</envar>/{include/gnome-media/profiles,
+        share/{gnome-media/{pixmaps,sounds},gnome-sound-recorder/ui,
+        gnome/help/{gnome-audio-profiles/*,gnome-sound-recorder/*,
+        gnome-volume-control/*,gstreamer-properties/*},
+        gstreamer-properties/icons,omf/{gnome-audio-profiles,
+        gnome-sound-recorder,gnome-volume-control,gstreamer-properties},
+        sounds/gnome/default/alerts}}</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="gnome-sound-recorder">
+        <term><command>gnome-sound-recorder</command></term>
+        <listitem>
+          <para>is <application>GNOME</application>'s recorder.</para>
+          <indexterm zone="gnome-media gnome-sound-recorder">
+            <primary sortas="b-gnome-sound-recorder">gnome-sound-recorder</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="gnome-volume-control">
+        <term><command>gnome-volume-control</command></term>
+        <listitem>
+          <para>is <application>GNOME</application>'s mixer with volume
+          applet.</para>
+          <indexterm zone="gnome-media gnome-volume-control">
+            <primary sortas="b-gnome-volume-control">gnome-volume-control</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="gstreamer-properties">
+        <term><command>gstreamer-properties</command></term>
+        <listitem>
+          <para>is a GUI front-end to <application>GStreamer</application>'s
+          audio/video input/output parameters.</para>
+          <indexterm zone="gnome-media gstreamer-properties">
+            <primary sortas="b-gstreamer-properties">gstreamer-properties</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/general.ent	2012-07-09 18:31:25 UTC (rev 10406)
@@ -3,13 +3,13 @@
 $Date$
 -->
 
-<!ENTITY day          "07">                   <!-- Always 2 digits -->
+<!ENTITY day          "09">                   <!-- Always 2 digits -->
 <!ENTITY month        "07">                   <!-- Always 2 digits -->
 <!ENTITY year         "2012">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
 <!ENTITY version      "&year;-&month;-&day;">
-<!ENTITY releasedate  "July 7th, &year;">
+<!ENTITY releasedate  "July 9th, &year;">
 <!-- <!ENTITY releasedate  "November &day;st, &year;"> -->
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
@@ -688,6 +688,7 @@
 
 <!-- Chapter 26 -->
 <!ENTITY fluxbox-version              "1.3.2">
+<!ENTITY icewm-version                "1.3.7">
 <!ENTITY openbox-version              "3.5.0">
 <!ENTITY sawfish-version              "1.6.1">
 
@@ -1057,7 +1058,10 @@
 <!ENTITY audacious-version            "3.2.2">
 <!ENTITY audacious-plugins-version    "3.2.2">
 <!ENTITY amarok-version               "2.5.0">
+<!ENTITY gvolwheel-version            "1.0.0">
+<!-- Obsolete
 <!ENTITY gnome-media-version          "2.32.0">
+-->
 
 <!-- Chapter 40 -->
 <!ENTITY dvb-apps-version             "2012-06-10">

Modified: trunk/BOOK/introduction/important/beyond.xml
===================================================================
--- trunk/BOOK/introduction/important/beyond.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/introduction/important/beyond.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -82,8 +82,8 @@
 
   <itemizedlist>
     <listitem>
-      <para>If you know the name of the package, then search FreshMeat for
-      it at <ulink url="http://freshmeat.net/"/>. Also search Google at
+      <para>If you know the name of the package, then search Freecode for
+      it at <ulink url="http://freecode.com/"/>. Also search Google at
       <ulink url="http://google.com/"/>. Sometimes a search for the
       <filename class='extension'>rpm</filename> at
       <ulink url="http://rpmfind.net/"/> or the
@@ -119,8 +119,76 @@
       <para>If you are having a problem compiling the package, try
       searching the LFS archives at
       <ulink url="http://www.&lfs-domainname;/search.html"/> for the error or if
-      that fails, try searching Google. If everything else fails,
-      try the blfs-support mailing-list.</para>
+      that fails, try searching Google. Often, a distribution will have already
+      solved the problem (many of them use development versions of packages, so
+      they see the changes sooner than those of us who normally use stable released
+      versions).  But be cautious - all builders tend to carry patches which are no
+      longer necessary, and to have fixes which are only required because of their
+      particular choices in how they build a package. You may have to search
+      deeply to find a fix for the package version you are trying to use, or even
+      to find the package (names are sometimes not what you might expect, e.g.
+      <application>ghostscript</application> often has a prefix or a suffix in its
+      name), but the following notes might help:</para>
+      <itemizedlist>
+        <listitem>
+          <para>Arch
+          <ulink url="http://www.archlinux.org/packages/"/> - enter the package name
+          in the 'Keywords' box, select the package name, select one of the 'SVN
+          Entries' fields, then select the <filename>PKGBUILD</filename> to see how
+          they build this package, or look at any patches.</para>
+        </listitem>
+        <listitem>
+          <para>Debian
+	  <ulink url="ftp://ftp.uk.debian.org/debian/pool"/> (use your country's
+          version if there is one) - the source will be in .tar.gz tarballs (either
+          the original upstream <filename class='extension'>.orig</filename> source,
+          or else a <filename>dfsg</filename> containing those parts which comply
+          with debian's free software guidelines) accompanied by versioned .diff.gz
+          or .tar.gz additions. These additions often show how the package is built,
+          and may contain patches. In the .diff.gz versions, any patches create files
+          in <filename class="directory">debian/patches</filename>.</para>
+        </listitem>
+        <listitem>
+          <para>Fedora
+	  <ulink url="http://pkgs.fedoraproject.org/gitweb/"/> - this site
+          is often overloaded since they moved to git-web, but when available it is
+          an easy way of looking at .spec files and patches. If unavailable, try
+          looking for a local mirror of ftp.fedora.com (the primary site is usually
+          unavailable when fedora gitweb is not responding) and download a source
+	  rpm to see what they do.</para>
+        </listitem>
+        <listitem>
+          <para>Gentoo - the mirrors for ebuilds and patches seem to be well-hidden,
+          and they change frequently.  Also, if you have found a mirror, you need to
+          know which directory the application has been assigned to.  The ebuilds
+          themselves can be found at <ulink url="http://packages.gentoo.org/"/> -
+          use the search field.  If there are any patches, a mirror will have them
+          in the <filename class="directory">files/</filename> directory. Depending
+          on your browser, or the mirror, you might need to download the ebuild to
+          be able to read it.  Treat the ebuild as a sort of pseudo-code / shell
+          combination - look in particular for <command>sed</command> commands and
+          patches, or hazard a guess at the meanings of the functions such as
+          <command>dodoc</command>.</para>
+        </listitem>
+        <listitem>
+          <para>PLD
+          <ulink url="http://cvs.pld-linux.org/cgi-bin/cvsweb/packages/"/> -
+          another distro which uses rpms, cvsweb provides access to patches and the
+          spec files.</para>
+        </listitem>
+        <listitem>
+          <para>Slackware - the official package browser is currently broken.  The
+          site at <ulink url="http://slackbuilds.org/"/> has current and previous
+          versions in their unofficial repository with links to homepages, downloads,
+          and some individual files, particularly the <filename>.SlackBuild</filename>
+          files.</para>
+        </listitem>
+        <listitem>
+          <para>Ubuntu <ulink url="ftp://ftp.ubuntu.com/ubuntu/pool/"/> - see the
+          debian notes above.</para>
+        </listitem>
+      </itemizedlist>
+      <para>If everything else fails, try the blfs-support mailing-list.</para>
     </listitem>
   </itemizedlist>
 
@@ -133,6 +201,13 @@
     <ulink url="&downloads-project;/deb2targz.tar.bz2"/> and
     <ulink url="&downloads-project;/rpm2targz.tar.bz2"/> to convert the archives
     into a simple <filename>tar.gz</filename> format.</para>
+    <para>You may also find an rpm2cpio script useful.  The perl version in the
+    linux kernel archives at <ulink
+    url="http://lkml.indiana.edu/hypermail/linux/kernel/0210.2/att-0093/01-rpm2cpio"/>
+    works for most source rpms.  The rpm2targz script will use an rpm2cpio script
+    or binary if one is on your path.  Note that rpm2cpio will unpack a source
+    rpm in the current directory, giving a tarball, a spec file, and perhaps patches
+    or other files.</para>
   </tip>
 
 </sect1>

Modified: trunk/BOOK/introduction/important/important.xml
===================================================================
--- trunk/BOOK/introduction/important/important.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/introduction/important/important.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -26,6 +26,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="position.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="patches.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bootscripts.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libraries.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="locale-issues.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="beyond.xml"/>
 

Added: trunk/BOOK/introduction/important/libraries.xml
===================================================================
--- trunk/BOOK/introduction/important/libraries.xml	                        (rev 0)
+++ trunk/BOOK/introduction/important/libraries.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter 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;
+]>
+
+<sect1 id="libraries" xreflabel="libraries">
+  <?dbhtml filename="libraries.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Libraries: static or shared</title>
+
+  <!-- section g : 'Others' in longindex.html -->
+  <indexterm zone="libraries">
+    <primary sortas="g-libraries">libraries: static or shared</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Libraries: static or shared</title>
+
+    <para>The original libraries were simply an archive of routines, from which
+    the required routines were extracted and linked into the executable program.
+    These are described as static libraries (libfoo.a).  On some old operating
+    systems they are the only type available.</para>
+
+    <para>On almost all Linux platforms we also have shared libraries (libfoo.so)
+    - one copy of the library is loaded into vitual memory, and shared by all the
+    programs which call any of its functions. This is space efficient.</para>
+
+    <para>In the past, essential programs such as a shell were often linked
+    statically so that some form of minimal recovery system would exist even if
+    shared libraries, such as libc.so, became damaged (e,g, moved to
+    <filename class="directory">lost+found</filename> after fsck following an
+    unclean shutdown). Nowadays, most people use an alternative system install,
+    or a Live CD, if they have to recover. Journalling filesystems also reduce
+    the likelihood of this sort of problem.</para>
+
+    <para>Developers, at least while they are developing, often prefer to use
+    static versions of the libraries which their code links to.</para>
+
+    <para>Within the book, there are various places where configure switches
+    such as <command>--disable-static</command> are employed, and other places
+    where the possibility of using system versions of libraries instead of the
+    versions included within another package is discussed. The main reason for
+    this is to simplify updates of libraries.</para>
+
+    <para>If a package is linked to a dynamic library, updating to a newer
+    library version is automatic once the newer library is installed and the
+    program is (re)started (provided the library major version is unchanged,
+    e.g. going from from libfoo.so.2.0 to libfoo.so.2.1 : going to libfoo.so.3
+    will require recompilation - use <command>ldd</command> to find what uses
+    the old version). If a program is linked to a static library, the program
+    always has to be recompiled. If you know which programs linked to a
+    particular static library, this is merely an annoyance. But usually you will
+    <emphasis>not</emphasis> know which programs to recompile.</para>
+
+    <para>Most libraries are shared, but if you do something unusual such as
+    moving a shared library to <filename class="directory">/lib</filename> and
+    accidentally break the <literal>.so</literal> symlink in
+    <filename class="directory">/usr/lib</filename> but keep the static library
+    there, the static library will be silently linked into the programs which
+    need it.</para>
+
+    <para>One way to identify when a static library is used is to deal with it
+    at the end of the installation of every package.  Write a script to find all
+    the static libraries in /usr/lib or wherever you are installing to, and
+    either move them to another directory so that they are no longer found by
+    the linker, or rename them so that libfoo.a becomes e.g. libfoo.a.hidden.
+    You can then temporarily restore a static library if it is ever needed, and
+    make a note which package needs it.  You may choose to exclude some of the
+    static libraries from glibc if you do this (<filename>libc_nonshared.a,
+    libg.a, libieee.a, libm.a, libpthread_nonshared.a, librpcsvc.a,
+    libsupc++.a</filename> to simplify compilation.</para>
+
+<!-- versions hardcoded in this para, it's a comment on those versions  -->
+    <para>If you do that, you may discover that more packages than you were
+    expecting use a static library. That was the case with
+    <application>nettle-2.4</application> in its default static-only configuration:
+    required by <application>GnuTLS-3.0.19</application> but also linked into
+    package(s) which used that, such as
+    <application>glib-networking-2.32.3</application>.</para>
+
+    <para>Many packages put some of their common functions into a static
+    library which is only used by the programs within the package and
+    crucially is <emphasis>not</emphasis> installed as a standalone library.
+    These internal libraries are not a problem - if the package has to be
+    rebuilt to fix a bug or vulnerability, nothing else is linked to them.
+    </para>
+
+    <para>When we speak of System libraries, we mean the shared versions. Some
+    packages such as <xref linkend="firefox"/> and <xref linkend="gs"/> include
+    many other libraries. When they link to them, they link statically so this
+    also makes the programs bigger. The version they ship is often older than
+    the version used in the system, so it may contain bugs - sometimes
+    developers go to the trouble of fixing bugs in their included libraries,
+    other times they do not.</para>
+
+    <para>Sometimes, deciding to use system libraries is an easy decision. Other
+    times it may require you to alter the system version (e.g. for
+    <xref linkend="libpng"/> if used for <xref linkend="firefox"/>).
+    Occasionally a package has an old shipped library, can no longer link to the
+    current version, but can link to a less-old version : the book will usually
+    just use the shipped version. Sometimes the included library is no longer
+    developed separately, or its upstream is now the same as the package's
+    upstream and you have no other packages which will use it. In those cases,
+    you might decide to use the included static library even if you usually
+    prefer to use system libraries.</para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/libraries"/></para>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/introduction/important/libraries.xml
___________________________________________________________________
Added: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -42,6 +42,26 @@
 
 -->
     <listitem>
+      <para>July 9th, 2012</para>
+      <itemizedlist>
+        <listitem>
+          <para>[ken] - Added pages for 'Libraries: static or shared'
+           and 'Vulnerabilities', extended 'Going Beyond BLFS'.
+          </para>
+        </listitem>
+        <listitem>
+          <para>[ken] - Added IceWM-1.3.7.</para>
+        </listitem>
+        <listitem>
+          <para>[ken] - Added Gvolwheel-1.0.</para>
+        </listitem>
+        <listitem>
+          <para>[ken] - Removed gnome-media-2.32.0.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>July 7th, 2012</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/multimedia/audioutils/audioutils.xml
===================================================================
--- trunk/BOOK/multimedia/audioutils/audioutils.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/multimedia/audioutils/audioutils.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -29,6 +29,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="freetts.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="audacious.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="amarok.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gnome-media.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gvolwheel.xml"/>
 
 </chapter>

Deleted: trunk/BOOK/multimedia/audioutils/gnome-media.xml
===================================================================
--- trunk/BOOK/multimedia/audioutils/gnome-media.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/multimedia/audioutils/gnome-media.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -1,211 +0,0 @@
-<?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 gnome-media-download-http "&gnome-download-http;/gnome-media/2.32/gnome-media-&gnome-media-version;.tar.bz2">
-  <!ENTITY gnome-media-download-ftp  "&gnome-download-ftp;/gnome-media/2.32/gnome-media-&gnome-media-version;.tar.bz2">
-  <!ENTITY gnome-media-md5sum        "06fc8c67add34c98bc484e0dbc404d41">
-  <!ENTITY gnome-media-size          "2.7 MB">
-  <!ENTITY gnome-media-buildsize     "38 MB">
-  <!ENTITY gnome-media-time          "0.5 SBU">
-]>
-
-<sect1 id="gnome-media" xreflabel="gnome-media-&gnome-media-version;">
-  <?dbhtml filename="gnome-media.html"?>
-
-  <sect1info>
-    <othername>$LastChangedBy$</othername>
-    <date>$Date$</date>
-  </sect1info>
-
-  <title>gnome-media-&gnome-media-version;</title>
-
-  <indexterm zone="gnome-media">
-    <primary sortas="a-GNOME Media">GNOME Media</primary>
-  </indexterm>
-
-  <sect2 role="package">
-    <title>Introduction to GNOME Media</title>
-
-    <para>The <application>GNOME Media</application> package contains
-    <application>GNOME</application>'s media applications.</para>
-
-    &lfs70_checked;
-
-    <para>This is a legacy GNOME-2 package which has been deprecated by the
-    GNOME developers and will be removed from the book in due course. If you
-    are not building a GNOME desktop, this can provide a volume control / mixer
-    application, but you may wish to consider simpler alternatives:</para>
-
-    <para><ulink url="http://volumecontrol.sourceforge.net/">volumecontrol</ulink>,
-    is a simple volume control and mixer which requires
-    <xref linkend="gtk2"/>, and
-    <xref linkend="alsa-utils"/>. Use ./autogen.sh to configure it.</para>
-
-    <para><ulink url="http://gvolwheel.sourceforge.net/">gvolwheel</ulink>
-    provides a volume control in a tray icon, for minimalist desktops. It uses
-    <xref linkend="intltool"/>, <xref linkend="perl-xml-parser"/>, and there are
-    different versions for <xref linkend="gtk2"/> (0.7) or
-    <xref linkend="gtk3"/> (0.9).</para>
-
-    <bridgehead renderas="sect3">Package Information</bridgehead>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>Download (HTTP): <ulink url="&gnome-media-download-http;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download (FTP): <ulink url="&gnome-media-download-ftp;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download MD5 sum: &gnome-media-md5sum;</para>
-      </listitem>
-      <listitem>
-        <para>Download size: &gnome-media-size;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated disk space required: &gnome-media-buildsize;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated build time: &gnome-media-time;</para>
-      </listitem>
-    </itemizedlist>
-
-    <bridgehead renderas="sect3">GNOME Media Dependencies</bridgehead>
-
-    <bridgehead renderas="sect4">Required</bridgehead>
-    <para role="required">
-      <xref linkend="libcanberra"/>,
-      <xref linkend="GConf"/>,
-      <xref linkend="gnome-doc-utils"/>
-      <xref linkend="gstreamer"/>,
-      <xref linkend="gtk2"/>, and
-      <xref linkend="which"/>
-    </para>
-
-    <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional">
-      <xref linkend="gst-plugins-base"/> (required to build the sound mixer and
-         recorder),
-      <xref linkend="libglade"/>,
-      <!-- libunique in the book will be updated to 3.0 during the gnome-3 changes,
-      that version is too new -->
-      <xref linkend="pulseaudio"/> (with
-      <ulink url="&gnome-download-http;/libunique/1.1/libunique-1.1.6.tar.bz2">libunique-1</ulink>),
-      and <xref linkend="rarian"/>
-    </para>
-
-    <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gnome-media"/></para>
-
-  </sect2>
-
-  <sect2 role="installation">
-    <title>Installation of GNOME Media</title>
-
-    <para>Install <application>GNOME Media</application> by
-    running the following commands:</para>
-
-<screen><userinput>./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
-            --sysconfdir=&gnome-old-etc-dir; \
-            --localstatedir=/var/lib \
-            --libexecdir=$(pkg-config \
-                --variable=prefix ORBit-2.0)/lib/gnome-media &&
-make</userinput></screen>
-
-    <para>This package does not come with a test suite.</para>
-
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
-
-<screen role="root"><userinput>make install</userinput></screen>
-
-  </sect2>
-
-  <sect2 role="commands">
-    <title>Command Explanations</title>
-
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="../../xincludes/gnome-old-prefix.xml"/>
-
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="../../xincludes/gnome-old-sysconfdir.xml"/>
-
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="../../xincludes/scrollkeeper-dir.xml"/>
-
-    <para><parameter>--libexecdir=$(pkg-config --variable=prefix
-    ORBit-2.0)/lib/gnome-media</parameter>: This parameter causes the libexec
-    files to be installed in the preferred location of
-    <filename class="directory">$GNOME_PREFIX/lib/gnome-media</filename> instead
-    of <filename class="directory">$GNOME_PREFIX/libexec</filename>.</para>
-
-    <para><option>--disable-scrollkeeper</option>: Use this parameter if you
-    wish to disable the updates to the scrollkeeper database.</para>
-
-  </sect2>
-
-  <sect2 role="content">
-    <title>Contents</title>
-
-    <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Libraries</segtitle>
-      <segtitle>Installed Directories</segtitle>
-
-      <seglistitem>
-        <seg>gnome-audio-profiles-properties, gnome-sound-recorder,
-        gnome-volume-control, and gstreamer-properties</seg>
-        <seg>libgnome-media-profiles.{so,a}</seg>
-        <seg><envar>$GNOME_PREFIX</envar>/{include/gnome-media/profiles,
-        share/{gnome-media/{pixmaps,sounds},gnome-sound-recorder/ui,
-        gnome/help/{gnome-audio-profiles/*,gnome-sound-recorder/*,
-        gnome-volume-control/*,gstreamer-properties/*},
-        gstreamer-properties/icons,omf/{gnome-audio-profiles,
-        gnome-sound-recorder,gnome-volume-control,gstreamer-properties},
-        sounds/gnome/default/alerts}}</seg>
-      </seglistitem>
-    </segmentedlist>
-
-    <variablelist>
-      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
-      <?dbfo list-presentation="list"?>
-      <?dbhtml list-presentation="table"?>
-
-      <varlistentry id="gnome-sound-recorder">
-        <term><command>gnome-sound-recorder</command></term>
-        <listitem>
-          <para>is <application>GNOME</application>'s recorder.</para>
-          <indexterm zone="gnome-media gnome-sound-recorder">
-            <primary sortas="b-gnome-sound-recorder">gnome-sound-recorder</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="gnome-volume-control">
-        <term><command>gnome-volume-control</command></term>
-        <listitem>
-          <para>is <application>GNOME</application>'s mixer with volume
-          applet.</para>
-          <indexterm zone="gnome-media gnome-volume-control">
-            <primary sortas="b-gnome-volume-control">gnome-volume-control</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="gstreamer-properties">
-        <term><command>gstreamer-properties</command></term>
-        <listitem>
-          <para>is a GUI front-end to <application>GStreamer</application>'s
-          audio/video input/output parameters.</para>
-          <indexterm zone="gnome-media gstreamer-properties">
-            <primary sortas="b-gstreamer-properties">gstreamer-properties</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-    </variablelist>
-
-  </sect2>
-
-</sect1>

Added: trunk/BOOK/multimedia/audioutils/gvolwheel.xml
===================================================================
--- trunk/BOOK/multimedia/audioutils/gvolwheel.xml	                        (rev 0)
+++ trunk/BOOK/multimedia/audioutils/gvolwheel.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -0,0 +1,169 @@
+<?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 gvolwheel-download-http "&sourceforge-repo;/gvolwheel/gvolwheel-&gvolwheel-version;.tar.gz">
+  <!ENTITY gvolwheel-download-ftp  "">
+  <!ENTITY gvolwheel-md5sum        "4f04f00cdb875894c96b8a3ff8a9edb9">
+  <!ENTITY gvolwheel-size          "340 KB">
+  <!ENTITY gvolwheel-buildsize     "2.8 MB">
+  <!ENTITY gvolwheel-time          "less than 0.1 SBU">
+]>
+
+<sect1 id="gvolwheel" xreflabel="gvolwheel-&gvolwheel-version;">
+  <?dbhtml filename="gvolwheel.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>gvolwheel-&gvolwheel-version;</title>
+
+  <indexterm zone="gvolwheel">
+    <primary sortas="a-gvolwheel">gvolwheel</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Gvolwheel</title>
+
+    <para>The <application>gvolwheel</application> package provides a lightweight
+    volume control with a tray icon.</para>
+
+    &lfs71_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&gvolwheel-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&gvolwheel-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &gvolwheel-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &gvolwheel-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &gvolwheel-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &gvolwheel-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Gvolwheel Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="alsa-utils"/>,
+      <xref linkend="gtk3"/>,
+      <xref linkend="intltool"/>, and
+      <xref linkend="perl-xml-parser"/>
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/gvolwheel"/></para>
+
+  </sect2>
+
+  <sect2 role="kernel"  id="gvolwheel-kernel">
+    <title>Kernel Configuration</title>
+
+    <para>In the Device Drivers ⇒ Sound card support ⇒ Advanced Linux
+    Sound Architecture section of the kernel configuration, ensure that OSS Mixer
+    API (CONFIG_SND_MIXER_OSS) is selected.  If necessary, recompile and install
+    your new kernel.</para>
+
+    <indexterm zone="gvolwheel gvolwheel-kernel">
+      <primary sortas="d-gvolwheel">gvolwheel</primary>
+    </indexterm>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Gvolwheel</title>
+
+    <para>Install <application>gvolwheel</application> by
+    running the following commands:</para>
+
+<screen><userinput>sed -i 's%doc/gvolwheel%share/doc/gvolwheel-&gvolwheel-version;%' Makefile.in &&
+./configure --prefix=/usr --enable-oss &&
+make</userinput></screen>
+
+    <para>This package does not come with a working test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><parameter>sed -i 's%doc/gvolwheel%share/doc/gvolwheel-&gvolwheel-version;%' ...</parameter>:
+    this puts the documentation into a versioned directory.</para>
+
+    <para><parameter>--enable-oss</parameter>: without this, the program will not
+    run unless <command>alsamixer</command> has been run.</para>
+
+  </sect2>
+
+  <sect2 role="configuring gvolwheel">
+    <title>Configuring gvolwheel</title>
+
+    <para>Before using this application, use <command>alsamixer</command> to
+    ensure the channels are not muted, and are set to suitable levels so that the
+    master volume control will provide suitable levels. Once
+    <command>gvolwheel</command> is running you can, if you wish. right-click on
+    its icon in the tray to change it to control the PCM volume instead of the
+    master volume. Depending on your theme settings, you may also wish to tick
+    "Use Gnome Icons".</para>
+
+    <para>If you middle-click on the icon, it will mute the volume, that is, it
+    will set it to zero : do not confuse this with the mute/unmute controls in
+    e.g. <command>alsamixer</command>.</para>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>gvolwheel</seg>
+        <seg>none</seg>
+        <seg>/usr/share/doc/gvolwheel-&gvolwheel-version;
+        /usr/share/pixmaps/gvolwheel</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="gvolwheel-prog">
+        <term><command>gvolwheel</command></term>
+        <listitem>
+          <para>is a lightweight volume control that sits in a tray.</para>
+          <indexterm zone="gvolwheel gvolwheel">
+            <primary sortas="b-gvolwheel">gvolwheel</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/multimedia/audioutils/gvolwheel.xml
___________________________________________________________________
Added: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/multimedia/libdriv/alsa-lib.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/alsa-lib.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/multimedia/libdriv/alsa-lib.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -71,11 +71,12 @@
   <sect2 role="kernel"  id="alsa-lib-kernel">
     <title>Kernel Configuration</title>
 
-    <para>In the Device Drivers ⇒ Sound ⇒ Advanced Linux Sound
-    Architecture section of the kernel configuration, select the settings and
-    drivers appropriate for your hardware.  Ensure that the deprecated Device
-    Drivers ⇒ Sound ⇒ Open Sound System is <emphasis>not</emphasis>
-    selected.  If necessary, recompile and install your new kernel.</para>
+    <para>In the Device Drivers ⇒ Sound card support ⇒ Advanced Linux
+    Sound Architecture section of the kernel configuration, select the settings
+    and drivers appropriate for your hardware.  Ensure that the deprecated Device
+    Drivers ⇒ Sound card support ⇒ Open Sound System is
+    <emphasis>not</emphasis> selected.  If necessary, recompile and install your
+    new kernel.</para>
 
     <indexterm zone="alsa-lib alsa-lib-kernel">
       <primary sortas="d-ALSA">ALSA</primary>

Modified: trunk/BOOK/postlfs/security/security.xml
===================================================================
--- trunk/BOOK/postlfs/security/security.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/postlfs/security/security.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -15,7 +15,8 @@
 
   <title>Security</title>
 
-  <para>Security takes many forms in a computing environment. This chapter
+  <para>Security takes many forms in a computing environment. After some
+  initial discussion, this chapter
   gives examples of three different types of security: access, prevention
   and detection.</para>
 
@@ -39,6 +40,7 @@
   of critical files (defined by the administrator) and then regenerates those
   "signatures" and compares for files that have been changed.</para>
 
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="vulnerabilities.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="accountsservice.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acl.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="attr.xml"/>

Added: trunk/BOOK/postlfs/security/vulnerabilities.xml
===================================================================
--- trunk/BOOK/postlfs/security/vulnerabilities.xml	                        (rev 0)
+++ trunk/BOOK/postlfs/security/vulnerabilities.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter 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;
+]>
+
+<sect1 id="vulnerabilities" xreflabel="vulnerabilities">
+  <?dbhtml filename="vulnerabilities.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Vulnerabilities</title>
+
+  <!-- section g : 'Others' in longindex.html -->
+  <indexterm zone="vulnerabilities">
+    <primary sortas="g-vulnerabilities">vulnerability links</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>About vulnerabilities</title>
+
+    <para>All software has bugs. Sometimes, a bug can be exploited, for example
+    to allow users to gain enhanced privileges (perhaps gaining a root shell, or
+    simply accessing or deleting other users' files), or to allow a remote
+    site to crash an application (denial of service), or for theft of data. These
+    bugs are labelled as vulnerabilities.</para>
+
+    <para>The main place where vulnerabilities get logged is
+    <ulink url="http://cve.mitre.org">cve.mitre.org</ulink>.
+    Unfortunately, many vulnerabily numbers (CVE-yyyy-nnnn) are initially only
+    labelled as "reserved" when distributions start issuing fixes.  Also, some
+    vulnerabilities apply to particular combinations of
+    <command>configure</command> options, or only apply to old versions of
+    packages which have long since been updated in BLFS.</para>
+
+    <para>BLFS differs from distributions - there is no BLFS security team and
+    the editors only become aware of vulnerabilities after they are public
+    knowledge. Sometimes, a package with a vulnerability will not be updated in
+    the book for a long time.  Issues can be logged in the trac system, which
+    might speed up resolution.</para>
+
+    <para>The normal way for BLFS to fix a vulnerability is, ideally, to update
+    the book to a new fixed releasse of the package.  Sometimes that happens even
+    before the vulnerability is public knowledge, so there is no guarantee that
+    it will be shown as a vulnerability fix in the Changelog. Alternatively, a
+    <command>sed</command> command, or a patch taken from a distribution, may be
+    appropriate.</para>
+
+    <para>The bottom line is that you are responsible for your own security, and
+    for assessing the potential impact of any problems.</para>
+
+    <para>To keep track of what is being discovered, you may wish to follow the
+    security announcements of one or more distributions.  For example, debian have
+    <ulink url="http://www.debian.org/security">debian security</ulink>.
+    fedora links on security are at
+    <ulink url="http://fedoraproject.org/wiki/Security">the fedora wiki</ulink>.
+    details of gentoo linux security announcements are discussed at
+    <ulink url="http://www.gentoo.org/security">gentoo security</ulink>.
+    and the Slackware archives of security announcements are at
+    <ulink url="http://slackware.com/security">slackware security</ulink>.
+    </para>
+
+    <para>The most general English source is perhaps
+    <ulink url="http://seclists.org/fulldisclosure">the Full Disclosure Mailing
+    List</ulink>, but please read the comment on that page. If you use other
+    languages you may prefer other sites such as http://www.heise.de/security
+    <ulink url="http://www.heise.de/security">heise.de</ulink> (German) or
+    <ulink url="http://www.cert.hr">cert.hr</ulink> (Croatian). These are not
+    linux-specific. There is also a daily update at lwn.net for subscribers
+    (free access to the data after 2 weeks), but their vulnerabilities database at
+    <ulink url="http://lwn.net/Vulnerabilities/">lwn.net/Vulnerabilities</ulink>
+    is unrestricted).</para>
+
+    <para>For some packages, subscribing to their 'announce' lists
+    will provide prompt news of newer versions.</para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/vulnerabilities"/></para>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/postlfs/security/vulnerabilities.xml
___________________________________________________________________
Added: svn:keywords
   + LastChangedBy Date

Added: trunk/BOOK/x/wm/icewm.xml
===================================================================
--- trunk/BOOK/x/wm/icewm.xml	                        (rev 0)
+++ trunk/BOOK/x/wm/icewm.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -0,0 +1,393 @@
+<?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 icewm-download-http "&sourceforge-repo;/icewm/icewm-&icewm-version;.tar.gz">
+  <!ENTITY icewm-download-ftp  "&gentoo-ftp-repo;/icewm-&icewm-version;.tar.gz">
+  <!ENTITY icewm-md5sum        "224695231aedb2b91db3254a13e1c8dd">
+  <!ENTITY icewm-size          "878 KB">
+  <!ENTITY icewm-buildsize     "39 MB">
+  <!ENTITY icewm-time          "0.3 SBU">
+]>
+
+<sect1 id="icewm" xreflabel="IceWM-&icewm-version;">
+  <?dbhtml filename="icewm.html" ?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>IceWM-&icewm-version;</title>
+
+  <indexterm zone="icewm">
+    <primary sortas="a-icewm">icewm</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to IceWM</title>
+
+    <para><application>IceWM</application> is a window manager with the goals of
+    speed, simplicity, and not getting in the user's way.</para>
+
+    &lfs71_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&icewm-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&icewm-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &icewm-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &icewm-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &icewm-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &icewm-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">IceWM Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required"><xref linkend="x-window-system"/> and
+    <xref linkend="gdk-pixbuf"/></para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional"><xref linkend="esound"/></para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/icewm"/></para>
+
+   </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of IceWM</title>
+
+    <note>
+      <para>This version of <application>IceWM</application> is nominally a
+      development release, but it provides a stable working environment and can
+      be built without using obsolete libraries.</para>
+    </note>
+
+    <para>Install <application>IceWM</application> by running the following
+    commands:</para>
+
+<screen><userinput>sed -i '/^LIBS/s/\(.*\)/\1 -lfontconfig/' src/Makefile.in &&
+sed -i 's/define deprecated/define ICEWM_deprecated/' src/base.h &&
+./configure --prefix=/usr &&
+make</userinput></screen>
+
+    <para>This package does not have a working testsuite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+make install-docs &&
+make install-man &&
+make install-desktop</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><parameter>sed -i '/^LIBS/s/\(.*\)/\1 -lfontconfig/' src/Makefile.in</parameter>:
+    this fixes the build with recent versions of <application>binutils</application>.
+    </para>
+
+    <para><parameter>sed -i 's/define deprecated/define ICEWM_deprecated/' src/base.h</parameter>:
+    this fixes the build with current <application>libX11</application>.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring IceWM</title>
+
+    <sect3 id="icewm-config">
+      <title>Config Files</title>
+
+      <para><filename>~/.icewm/keys</filename>,
+      <filename>~/.icewm/menu</filename>, and
+      <filename>~/.icewm/preferences</filename>, and
+      <filename>~/.icewm/toolbar</filename>, and
+      <filename>~/.icewm/winoptions</filename>. The default versions are installed
+      in <filename class="directory">/usr/share/icewm/</filename> and will be used
+      if you have not copied them to <filename class="directory">~/.icewm</filename>.
+      </para>
+
+      <indexterm zone="icewm icewm-config">
+        <primary sortas="e-AA.icewm-keys">~/.icewm/keys</primary>
+      </indexterm>
+
+      <indexterm zone="icewm icewm-config">
+        <primary sortas="e-AA.icewm-menu">~/.icewm/menu</primary>
+      </indexterm>
+
+      <indexterm zone="icewm icewm-config">
+        <primary sortas="e-AA.icewm-preferences">~/.icewm/preferences</primary>
+      </indexterm>
+
+      <indexterm zone="icewm icewm-config">
+        <primary sortas="e-AA.icewm-toolbar">~/.icewm/toolbar</primary>
+      </indexterm>
+
+      <indexterm zone="icewm icewm-config">
+        <primary sortas="e-AA.icewm-winoptions">~/.icewm/winoptions</primary>
+      </indexterm>
+
+    </sect3>
+
+    <sect3>
+      <title>Configuration Information</title>
+
+      <para>If <application>IceWM</application> is the only Window Manager
+      you want to use, you can start it with an <filename>.xinitrc</filename>
+      file in your home folder. Be sure to backup your
+      current <filename>.xinitrc</filename> before proceeding.</para>
+
+      <indexterm zone="icewm icewm-config">
+        <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
+      </indexterm>
+
+<screen><userinput>echo icewm-session > ~/.xinitrc</userinput></screen>
+
+      <para>Now create the <application>IceWM</application> configuration
+      files:</para>
+
+<screen><userinput>mkdir -v ~/.icewm &&
+cp -v /usr/share/icewm/keys ~/.icewm/keys &&
+cp -v /usr/share/icewm/menu ~/.icewm/menu &&
+cp -v /usr/share/icewm/preferences ~/.icewm/preferences &
+cp -v /usr/share/icewm/toolbar ~/.icewm/toolbar &
+cp -v /usr/share/icewm/winoptions ~/.icewm/winoptions</userinput></screen>
+
+      <para>You can now edit these files to meet your requirements. In particular,
+      review the <filename>preferences</filename> file. You can use
+      <command>Logout -> Restart-IceWM</command> on the main menu to load your
+      changed preferences, but changes to the background only take effect when
+      <application>IceWM</application> is started.</para>
+
+      <para>The syntax of the menus is explained in the help files, which you
+      can access by running <command>help</command> from the menu, but some of
+      the detail is out of date and the default selections in the menus (a few
+      old applications on the main menu, everything else on the
+      <command>Programs</command> menu) will benefit from being updated to meet
+      your needs. The following examples are  provided to encourage you to think
+      about how you wish to organise your menus. Please note the following:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>If a program listed in the menu has not been installed, it will
+          not appear when the menu is displayed. Similarly, if the program
+          exists but the specified icon does not, no icon will be displayed in the
+          menu.</para>
+        </listitem>
+        <listitem>
+          <para>The icons can be either <filename>.xpm</filename> or
+          <filename>.png</filename> files, and there is no need to specify the
+          extension. If the icon is located in the "library"
+          (<filename class="directory">/usr/share/icewm/icons</filename>) there is
+          no need to specifiy the path.</para>
+        </listitem>
+        <listitem>
+          <para>Most programs are in sub-menus, and the main menu will always append
+          entries for <literal>windows, help, settings, logout</literal> at the
+          bottom.</para>
+        </listitem>
+        <listitem>
+          <para>An icon for <application>firefox</application> was copied to the
+          library directory and given a meaningful name. The icon for
+          <application>xine</application> is <filename>xine.xpm</filename> which
+          was installed to a pixmap directory.</para>
+        </listitem>
+        <listitem>
+          <para>The default toolbar is not altered.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>It is unlikely that these examples meet your desires, but if you wish
+      to use them run the following commands:</para>
+
+<screen role="nodump"><userinput>cat > ~/.icewm/menu << "EOF"
+<literal>prog Urxvt xterm urxvt
+prog GVolWheel /usr/share/pixmaps/gvolwheel/audio-volume-medium gvolwheel
+separator
+menufile General folder general
+menufile Multimedia folder multimedia
+menufile Tool_bar folder toolbar</literal>
+EOF &&
+>cat > ~/.icewm/general << "EOF"
+<literal>prog Firefox firefox firefox
+prog Epiphany /usr/share/icons/gnome/16x16/apps/web-browser epiphany
+prog Midori /usr/share/icons/hicolor/24x24/apps/midori midori
+separator
+prog Gimp /usr/share/icons/hicolor/16x16/apps/gimp gimp
+separator
+prog Evince /usr/share/icons/hicolor/16x16/apps/evince evince
+prog Epdfview /usr/share/epdfview/pixmaps/icon_epdfview-48 epdfview</literal>
+EOF &&
+>cat > ~/.icewm/multimedia << "EOF"
+<literal>prog Audacious /usr/share/icons/hicolor/48x48/apps/audacious audacious
+separator
+prog Parole /usr/share/icons/hicolor/16x16/apps/parole parole
+prog Totem /usr/share/icons/hicolor/16x16/apps/totem totem
+prog Vlc /usr/share/icons/hicolor/16x16/apps/vlc vlc
+prog Xine /usr/share/pixmaps/xine xine</literal>
+EOF &&</userinput></screen>
+
+      <para>If you wish to put icons on your desktop, you will need to install a
+      program such as <xref linkend="rox-filer"/> which provides a pinboard. If you
+      do that you will no longer be able to access the menu by right-clicking on the
+      desktop, you will have to use the <application>IceWM</application> button. To
+      ensure that the <application>rox</application> pinboard is running, the
+      following commands will put it in the startup file:</para>
+
+<screen role="nodump"><userinput>cat > ~/.icewm/startup << "EOF"
+<literal>rox -p Default &
+EOF &&
+chmod +x ~/.icewm/startup</literal></userinput></screen>
+
+     <tip>
+      <para>There are a number of keyboard shortcuts in
+      <application>IceWM</application>:</para>
+      <itemizedlist>
+        <listitem>
+          <para>Ctrl + Alt + F<replaceable>N</replaceable> : go to
+          <filename>tty<replaceable>N</replaceable></filename>.</para>
+        </listitem>
+        <listitem>
+          <para>Ctrl + Alt + <replaceable>N</replaceable> : go to desktop
+          number <replaceable>N</replaceable></para>
+        </listitem>
+        <listitem>
+          <para>Ctrl + Alt + Space : open a box on the taskbar where you can
+          key in the name of an application and run it.</para>
+        </listitem>
+      </itemizedlist>
+     </tip>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>icehelp, icesh, icewm, icewm-session, icewm-set-gnomewm, icewmbg,
+        icewmhint, icewmtray</seg>
+        <seg>None</seg>
+        <seg>/usr/share/doc/icewm-&icewm-version;, /usr/share/icewm and ~/.icewm</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="icehelp">
+        <term><command>icehelp</command></term>
+        <listitem>
+          <para>is used to display the html manual.</para>
+          <indexterm zone="icewm icehelp">
+            <primary sortas="b-icehelp">icehelp</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="icesh">
+        <term><command>icesh</command></term>
+        <listitem>
+          <para>is a command-line window manager which can be used in
+          <filename>~/.icewm/startup</filename>.</para>
+          <indexterm zone="icewm icesh">
+            <primary sortas="b-icesh">icesh</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="icewm-prog">
+        <term><command>icewm</command></term>
+        <listitem>
+          <para>is the window manager.</para>
+          <indexterm zone="icewm icewm-prog">
+            <primary sortas="b-icewm">icewm</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="icewm-session">
+        <term><command>icewm-session</command></term>
+        <listitem>
+          <para>runs icewmbg, icewm, icewmtray, startup, shutdown (i.e. startup
+          and shutdown scripts are run if installed).</para>
+          <indexterm zone="icewm icewm-session">
+            <primary sortas="b-icewm-session">icewm-session</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="icewm-set-gnomewm">
+        <term><command>icewm-set-gnomewm</command></term>
+        <listitem>
+          <para>is a script to set the <application>GNOME</application> to
+          <application>icewm</application> using <application>gconftool</application>.
+          </para>
+          <indexterm zone="icewm icewm-set-gnomewm">
+            <primary sortas="b-icewm-set-gnomewm">icewm-set-gnomewm</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="icewmbg">
+        <term><command>icewmbg</command></term>
+        <listitem>
+          <para>is used to set the background, according to the various
+          <literal>DesktopBackground</literal> settings in the preferences.</para>
+          <indexterm zone="icewm icewmbg">
+            <primary sortas="b-icewmbg">icewmbg</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="icewmhint">
+        <term><command>icewmhint</command></term>
+        <listitem>
+          <para>is used internally.</para>
+          <indexterm zone="icewm icewmhint">
+            <primary sortas="b-icewmhint">icewmhint</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="icewmtray">
+        <term><command>icewmtray</command></term>
+        <listitem>
+          <para>provides the tray.</para>
+          <indexterm zone="icewm icewmtray">
+            <primary sortas="b-icewmtray">icewmtray</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/x/wm/icewm.xml
___________________________________________________________________
Added: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/x/wm/wm.xml
===================================================================
--- trunk/BOOK/x/wm/wm.xml	2012-07-08 21:14:40 UTC (rev 10405)
+++ trunk/BOOK/x/wm/wm.xml	2012-07-09 18:31:25 UTC (rev 10406)
@@ -54,6 +54,7 @@
   </sect1>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="fluxbox.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="icewm.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="openbox.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sawfish.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="other-wms.xml"/>




More information about the blfs-book mailing list