Author: ken Date: Sun Aug 13 19:11:50 2017 New Revision: 19014 Log: Forgot to add and propset the new pages.
Added: trunk/BOOK/general/graphlib/potrace.xml (contents, props changed) trunk/BOOK/general/prog/scour.xml (contents, props changed) Added: trunk/BOOK/general/graphlib/potrace.xml ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ trunk/BOOK/general/graphlib/potrace.xml Sun Aug 13 19:11:50 2017 (r19014) @@ -0,0 +1,203 @@ +<?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 potrace-download-http "https://sourceforge.net/projects/potrace/files/&potrace-version;/potrace-&potrace-version;.tar.gz"> + <!ENTITY potrace-download-ftp " "> + <!ENTITY potrace-md5sum "60cecdaa9d14e0008f96b68dce77d246"> + <!ENTITY potrace-size "636 KB"> + <!ENTITY potrace-buildsize "7.5 MB (including tests)"> + <!ENTITY potrace-time "less than 0.1 SBU (including tests)"> +]> + +<sect1 id="potrace" xreflabel="Potrace-&potrace-version;"> + <?dbhtml filename="potrace.html"?> + + <sect1info> + <othername>$LastChangedBy: bdubbs $</othername> + <date>$Date: 2017-08-06 20:49:36 +0100 (Sun, 06 Aug 2017) $</date> + </sect1info> + + <title>Potrace-&potrace-version;</title> + + <indexterm zone="potrace"> + <primary sortas="a-Potrace">Potrace</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to Potrace</title> + + <para> + <!-- summarized from the home page, where Potrace(TM) is used --> + <application>Potrace™</application> is a tool for transforming a bitmap + (PBM, PGM, PPM, or BMP format) into one of several vector file formats. + </para> + + &lfs80_checked; + &gcc7_checked; + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para> + Download (HTTP): <ulink url="&potrace-download-http;"/> + </para> + </listitem> + <listitem> + <para> + Download (FTP): <ulink url="&potrace-download-ftp;"/> + </para> + </listitem> + <listitem> + <para> + Download MD5 sum: &potrace-md5sum; + </para> + </listitem> + <listitem> + <para> + Download size: &potrace-size; + </para> + </listitem> + <listitem> + <para> + Estimated disk space required: &potrace-buildsize; + </para> + </listitem> + <listitem> + <para> + Estimated build time: &potrace-time; + </para> + </listitem> + </itemizedlist> + + <bridgehead renderas="sect3">Potrace Dependencies</bridgehead> + + <bridgehead renderas="sect4">Recommended</bridgehead> + <para role="recommended"> + <xref linkend="llvm"/> (including <command>clang</command>). + </para> + + <para condition="html" role="usernotes"> + User Notes: <ulink url="&blfs-wiki;/potrace"/> + </para> + </sect2> + + <sect2 role="installation"> + <title>Installation of Potrace</title> + + <para> + Install <application>Potrace</application> by running the following + commands: + </para> + +<screen><userinput>./configure --prefix=/usr \ + --disable-static \ + --docdir=/usr/share/doc/potrace-&potrace-version; \ + --enable-a4 \ + --enable-metric \ + --with-libpotrace && +make</userinput></screen> + + <para> + To run the test suite, issue: <command>make check</command>. + </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>--enable-a4</parameter>: Use A4 as the default paper size. + </para> + + <para> + <!-- american spelling as in the configure script --> + <parameter>--enable-metric</parameter>: Use metric units (centimeters) + as default + </para> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="../../xincludes/static-libraries.xml"/> + + <para> + <parameter>--with-libpotrace</parameter>: Install the library and headers. + </para> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg> + mkbitmap, potrace + </seg> + <seg> + libpotrace.so, + </seg> + <seg> + /usr/share/doc/potrace-&potrace-version; + </seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="mkbitmap"> + <term><command>mkbitmap</command></term> + <listitem> + <para> + transforms images into bitmaps with scaling and filtering. + </para> + <indexterm zone="potrace mkbitmap"> + <primary sortas="b-mkbitmap">mkbitmap</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="potrace-prog"> + <term><command>potrace</command></term> + <listitem> + <para> + transforms bitmaps into vector graphics. + </para> + <indexterm zone="potrace potrace-prog"> + <primary sortas="b-potrace-prog">potrace</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libpotrace"> + <term><filename class="libraryfile">libpotrace.so</filename></term> + <listitem> + <para> + is a library for transforming bitmaps into vector graphics + </para> + <indexterm zone="potrace libpotrace"> + <primary sortas="c-libpotrace">libpotrace.so</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Added: trunk/BOOK/general/prog/scour.xml ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ trunk/BOOK/general/prog/scour.xml Sun Aug 13 19:11:50 2017 (r19014) @@ -0,0 +1,188 @@ +<?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 scour-download-http "https://github.com/scour-project/scour/archive/v&scour-version;.tar.gz"> + <!ENTITY scour-download-ftp " "> + <!ENTITY scour-md5sum "f7d03395a9ce51f822e5741034783e04"> + <!ENTITY scour-size "90 KB"> + <!ENTITY scour-buildsize "1.6 MB"> + <!ENTITY scour-time "less than 0.1 SBU"> +]> + + <!-- Begin scour --> + <sect2 id="scour" xreflabel="Scour-&scour-version;"> + + <title>Scour-&scour-version;</title> + + <indexterm zone="scour"> + <primary sortas="a-scour">scour</primary> + </indexterm> + + <sect3 role="package"> + <title>Introduction to Scour</title> + + <para> + <application>Scour</application> is an SVG (Scalable Vector Graphics) + optimizer/cleaner that reduces their size by optimizing structure and + removing unnecessary data. + </para> + + &lfs80_checked; + + <bridgehead renderas="sect4">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para> + Download (HTTP): <ulink url="&scour-download-http;"/> + </para> + </listitem> + <listitem> + <para> + Download (FTP): <ulink url="&scour-download-ftp;"/> + </para> + </listitem> + <listitem> + <para> + Download MD5 sum: &scour-md5sum; + </para> + </listitem> + <listitem> + <para> + Download size: &scour-size; + </para> + </listitem> + <listitem> + <para> + Estimated disk space required: &scour-buildsize; + </para> + </listitem> + <listitem> + <para> + Estimated build time: &scour-time; + </para> + </listitem> + </itemizedlist> + + <note> + <para> + The <application>Scour</application> source tarball shown above + downloads with the correct name, scour-&scour-version;.tar.gz, if + using a browser such as Firefox. If you prefer to use a command line + program such as wget, you normally would obtain v&scour-version;.tar.gz. + To obtain this package with the proper filename, run: + +<screen><userinput>wget -c https://github.com/scour-project/scour/releases/scour-&scour-version;.tar.gz -O scour-&scour-version;.tar.gz</userinput></screen> + </para> + </note> + + <bridgehead renderas="sect4">Scour Dependencies</bridgehead> + + <!-- Required: only setuptools, which is available from our Python and + Python3 installs via pypi (it has a recursive dependency) --> + + <bridgehead renderas="sect5">Optional (for the main test)</bridgehead> + <para role="optional"> + <ulink url="https://pypi.python.org/pypi/six">Six</ulink> + </para> + + <para condition="html" role="usernotes"> + User Notes: <ulink url="&blfs-wiki;/scour"/> + </para> + </sect3> + + <sect3 role="installation"> + <title>Installation of scour</title> + + <note> + <para> + Although this package installs modules for <application>Python + 2</application> <emphasis>or</emphasis> <application>Python + 3</application> they are usually invoked by <command>scour</command> + which is a script using the version of + <application>Python</application> for which it was compiled. + </para> + + <para> + For the moment, use of <application>Python 2</application> will + normally be adequate. + </para> + </note> + +<!-- Editors note: Use \-\-root= instead of DESTDIR= when updating. --> + + <para> + To build the <application>Python 2</application> module, issue: + </para> + +<screen><userinput>python setup.py build</userinput></screen> + + <para> + To partially test the results, issue: <command>python testcss.py</command>. + If you have installed <application>Six</application> you can run the main + tests by issuing: <command>python testscour.py</command>. + </para> + + <para> + To install the <application>Python 2</application> module + run the following command as the + <systemitem class="username">root</systemitem> user: + </para> + +<screen><userinput>python setup.py install --optimize=1</userinput></screen> + + <note> + <para> + If you wish to install the <application>Python 3</application> + modules, change 'python' to 'python3' in each of the above steps. + </para> + </note> + + </sect3> + + <sect3 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg> + scour + </seg> + <seg> + None + </seg> + <seg> + None + </seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="scour-prog"> + <term><command>scour</command></term> + <listitem> + <para> + is a program to optimize and clean SVG files. + </para> + <indexterm zone="inkscape inkscape-prog"> + <primary sortas="b-inkscape">inkscape</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect3> + + </sect2> + <!--End scour --> -- http://lists.linuxfromscratch.org/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page