Author: andy Date: 2012-04-12 07:29:17 -0600 (Thu, 12 Apr 2012) New Revision: 9905
Modified: trunk/BOOK/general/graphlib/poppler.xml trunk/BOOK/xsoft/office/libreoffice.xml Log: Poppler tweaks commented out some references to xpdf as it is no longer in the book. added --enable-xpdf-headers to the default options as it is required by 3 packages in the book added an optional patch to use lcms2 Modified: trunk/BOOK/general/graphlib/poppler.xml =================================================================== --- trunk/BOOK/general/graphlib/poppler.xml 2012-04-11 23:35:38 UTC (rev 9904) +++ trunk/BOOK/general/graphlib/poppler.xml 2012-04-12 13:29:17 UTC (rev 9905) @@ -4,15 +4,19 @@ <!ENTITY % general-entities SYSTEM "../../general.ent"> %general-entities; - <!ENTITY poppler-download-http "http://poppler.freedesktop.org/poppler-&poppler-version;.tar.gz";> + <!ENTITY poppler-download-http + "http://poppler.freedesktop.org/poppler-&poppler-version;.tar.gz";> <!ENTITY poppler-download-ftp " "> <!ENTITY poppler-md5sum "12658f3308597e57f3faff538cc73baf"> <!ENTITY poppler-size "1.9 MB"> - <!ENTITY poppler-buildsize "28 MB (excluding the encoding data) and 112 MB (including the encoding data)"> - <!ENTITY poppler-time "1.3 SBU (includes building with most dependencies)"> + <!ENTITY poppler-buildsize "28 MB (excluding the encoding data) and + 112 MB (including the encoding data)"> + <!ENTITY poppler-time "1.3 SBU (includes building with most + dependencies)"> <!ENTITY poppler-data-version "0.4.5"> - <!ENTITY poppler-data-download-http "http://poppler.freedesktop.org/poppler-data-&poppler-data-version;.tar.gz";> + <!ENTITY poppler-data-download-http + "http://poppler.freedesktop.org/poppler-data-&poppler-data-version;.tar.gz";> <!ENTITY poppler-data-md5sum "448dd7c5077570e340340706cef931aa"> <!ENTITY poppler-data-size "4.0 MB"> ]> @@ -34,32 +38,45 @@ <sect2 role="package"> <title>Introduction to Poppler</title> - <para>The <application>Poppler</application> package contains a PDF - rendering library and command line tools used to manipulate PDF files. - This is useful for providing PDF rendering functionality as a shared - library.</para> + <para> + The <application>Poppler</application> package contains a PDF rendering + library and command line tools used to manipulate PDF files. This is + useful for providing PDF rendering functionality as a shared library. + </para> &lfs71_checked; <bridgehead renderas="sect3">Package Information</bridgehead> <itemizedlist spacing="compact"> <listitem> - <para>Download (HTTP): <ulink url="&poppler-download-http;"/></para> + <para> + Download (HTTP): <ulink url="&poppler-download-http;"/> + </para> </listitem> <listitem> - <para>Download (FTP): <ulink url="&poppler-download-ftp;"/></para> + <para> + Download (FTP): <ulink url="&poppler-download-ftp;"/> + </para> </listitem> <listitem> - <para>Download MD5 sum: &poppler-md5sum;</para> + <para> + Download MD5 sum: &poppler-md5sum; + </para> </listitem> <listitem> - <para>Download size: &poppler-size;</para> + <para> + Download size: &poppler-size; + </para> </listitem> <listitem> - <para>Estimated disk space required: &poppler-buildsize;</para> + <para> + Estimated disk space required: &poppler-buildsize; + </para> </listitem> <listitem> - <para>Estimated build time: &poppler-time;</para> + <para> + Estimated build time: &poppler-time; + </para> </listitem> </itemizedlist> @@ -68,111 +85,150 @@ <itemizedlist spacing="compact"> <title>Poppler Encoding Data</title> <listitem> - <para>Download (HTTP): <ulink url="&poppler-data-download-http;"/></para> + <para> + Download (HTTP): <ulink url="&poppler-data-download-http;"/> + </para> </listitem> <listitem> - <para>Download MD5 sum: &poppler-data-md5sum;</para> + <para> + Download MD5 sum: &poppler-data-md5sum; + </para> </listitem> <listitem> - <para>Download size: &poppler-data-size;</para> + <para> + Download size: &poppler-data-size; + </para> </listitem> </itemizedlist> - <para>The additional package consists of encoding files for use with - <application>Poppler</application>. The encoding files are optional and - <application>Poppler</application> will automatically read them if they are - present. When installed, they enable <application>Poppler</application> to - render CJK and Cyrillic properly.</para> + <para> + The additional package consists of encoding files for use with + <application>Poppler</application>. The encoding files are optional and + <application>Poppler</application> will automatically read them if they + are present. When installed, they enable + <application>Poppler</application> to render CJK and Cyrillic properly. + </para> + <bridgehead renderas="sect3">Additional Downloads</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para> + Optional patch (if you want to use <application>Lcms 2</application>): + <ulink url="&patch-root;/poppler-&poppler-version;-lcms2-1.patch"/> + </para> + </listitem> + </itemizedlist> + <bridgehead renderas="sect3">Poppler Dependencies</bridgehead> <bridgehead renderas="sect4">Required</bridgehead> - <para role="required"><xref linkend="fontconfig"/> and - <xref linkend="pkgconfig"/></para> + <para role="required"> + <xref linkend="fontconfig"/> and + <xref linkend="pkgconfig"/> + </para> <bridgehead renderas="sect4">Recommended</bridgehead> - <para role="recommended"><xref linkend="libjpeg"/>, <xref linkend="cairo"/> - and <xref linkend="openjpeg"/> + <para role="recommended"> + <xref linkend="libjpeg"/>, + <xref linkend="cairo"/> and + <xref linkend="openjpeg"/>. </para> <bridgehead renderas="sect4">Optional</bridgehead> - <para role="optional"><xref linkend="gtk2"/>, - <xref linkend="qt4"/> (the <filename>libpoppler-qt4.so</filename> library is needed - for PDF support in <application>Okular</application>), - <xref linkend="curl"/>, - <xref linkend="libtiff"/>, - <xref linkend="libxml2"/> and - <xref linkend="lcms"/></para> + <para role="optional"> + <xref linkend="curl"/>, + <xref linkend="gtk2"/>, + <xref linkend="lcms"/> or <xref linkend="lcms2"/>, + <xref linkend="libtiff"/>, + <xref linkend="libxml2"/> and + <xref linkend="qt4"/> (the <filename>libpoppler-qt4.so</filename> library + is needed for PDF support in <application>Okular</application>). + </para> - <para condition="html" role="usernotes">User Notes: - <ulink url="&blfs-wiki;/poppler"/></para> - + <para condition="html" role="usernotes"> + User Notes: <ulink url="&blfs-wiki;/poppler"/> + </para> </sect2> <sect2 role="installation"> <title>Installation of Poppler</title> + <para> + If you have installed <xref linkend="lcms2"/> and would like + <application>Poppler</application> to use it, apply the + <application>Lcms 2</application> patch: + </para> + +<screen><userinput>patch -p1 < ../poppler-&poppler-version;-lcms2-1.patch</userinput></screen> + + <para> + Install <application>Poppler</application> by running the following + commands: + </para> + +<!-- Xpdf is no longer in the book <caution> - <para><application>Poppler</application> will overwrite command-line - utilities and man pages previously installed by the - <application>Xpdf</application> package. If you prefer to keep the - <application>Xpdf</application> versions of these files, pass the - <option>--disable-utils</option> parameter to the - <command>configure</command> command below.</para> + <para> + <application>Poppler</application> will overwrite command-line utilities + and man pages previously installed by the + <application>Xpdf</application> package. If you prefer to keep the + <application>Xpdf</application> versions of these files, pass the + <option>--disable-utils</option> parameter to the + <command>configure</command> command below. + </para> </caution> +--> -<screen><userinput>./configure --prefix=/usr \ - --sysconfdir=/etc \ - --disable-static && +<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \ + --disable-static --enable-xpdf-headers && make</userinput></screen> - <para>This package does not come with a test suite.</para> + <para> + This package does not come with a test suite. + </para> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para> + Now, as the <systemitem class="username">root</systemitem> user: + </para> <screen role="root"><userinput>make install && install -v -m755 -d /usr/share/doc/poppler-&poppler-version; && install -v -m644 README* /usr/share/doc/poppler-&poppler-version;</userinput></screen> - <para>If you downloaded the additional encoding data package, install - it by issuing the following commands:</para> + <para> + If you downloaded the additional encoding data package, install it by + issuing the following commands: + </para> <screen><userinput>tar -xf ../poppler-data-&poppler-data-version;.tar.gz && cd poppler-data-&poppler-data-version;</userinput></screen> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para> + Now, as the <systemitem class="username">root</systemitem> user: + </para> <screen role="root"><userinput>make prefix=/usr install</userinput></screen> - </sect2> <sect2 role="commands"> <title>Command Explanations</title> - <!-- This is discouraged by the authors. There is built-in decompression - and zlib is not needed - <para><parameter>-enable-zlib</parameter>: This parameter forces the build - to link with the system-installed - <filename class='libraryfile'>libz</filename> library to enable compressed - PDF functionality.</para> --> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; + href="../../xincludes/static-libraries.xml"/> - <para><option>--disable-static</option>: Prevent static libraries - being built and installed.</para> + <para> + <option>--enable-xpdf-headers</option>: Install some old + <application>Xpdf</application> headers required by certain programs (e.g. + <application>Okular</application>, <application>Libre Office</application> + and <application>Inkscape</application>). + </para> - <para><option>--disable-cairo-output</option>: This parameter - disables building the <application>cairo</application> graphics backend.</para> - - <para><option>--disable-poppler-glib</option>, - <option>--disable-poppler-qt4</option> and - <option>--disable-gtk-test</option>: These parameters disable - building the <application>GLib</application> and <application>Qt4</application> - wrappers and the <application>GTK+</application> test program.</para> - - <para><option>--enable-xpdf-headers</option>: Install old - <application>Xpdf</application> headers required by certain programs (e.g. by - <application>Okular</application> for PDF support). These are unsupported by - <application>Poppler</application>.</para> - + <para> + <parameter>-enable-zlib</parameter>: This parameter makes + <application>Poppler</application> link with the system-installed + <filename class='libraryfile'>libz</filename> library to enable compressed + PDF functionality. + </para> </sect2> <sect2 role="content"> @@ -184,12 +240,18 @@ <segtitle>Installed Directories</segtitle> <seglistitem> - <seg>pdffonts, pdfimages, pdfinfo, pdfseparate, pdftocairo, pdftohtml, - pdftoppm, pdftops, pdftotext, pdfunite and poppler-glib-demo</seg> - <seg>libpoppler.so, libpoppler-cpp.so, libpoppler-glib.so, - and libpoppler-qt4.so</seg> - <seg>/usr/include/poppler, /usr/share/doc/poppler-&poppler-version;, - /usr/share/gtk-doc/html/poppler and /usr/share/poppler</seg> + <seg> + pdffonts, pdfimages, pdfinfo, pdfseparate, pdftocairo, pdftohtml, + pdftoppm, pdftops, pdftotext, pdfunite and poppler-glib-demo + </seg> + <seg> + libpoppler.so, libpoppler-cpp.so, libpoppler-glib.so and + libpoppler-qt4.so + </seg> + <seg> + /usr/include/poppler, /usr/share/doc/poppler-&poppler-version;, + /usr/share/gtk-doc/html/poppler and /usr/share/poppler + </seg> </seglistitem> </segmentedlist> @@ -201,8 +263,10 @@ <varlistentry id="pdffonts"> <term><command>pdffonts</command></term> <listitem> - <para>lists the fonts used in a PDF file along - with various information for each font.</para> + <para> + lists the fonts used in a PDF file along with various information + for each font. + </para> <indexterm zone="poppler pdffonts"> <primary sortas="b-pdffonts">pdffonts</primary> </indexterm> @@ -212,7 +276,9 @@ <varlistentry id="pdfimages"> <term><command>pdfimages</command></term> <listitem> - <para>saves images from a PDF file as PPM, PBM, or JPEG files.</para> + <para> + saves images from a PDF file as PPM, PBM, or JPEG files. + </para> <indexterm zone="poppler pdfimages"> <primary sortas="b-pdfimages">pdfimages</primary> </indexterm> @@ -222,8 +288,10 @@ <varlistentry id="pdfinfo"> <term><command>pdfinfo</command></term> <listitem> - <para>prints the contents of the 'Info' dictionary (plus some - other useful information) from a PDF file.</para> + <para> + prints the contents of the 'Info' dictionary (plus some other useful + information) from a PDF file. + </para> <indexterm zone="poppler pdfinfo"> <primary sortas="b-pdfinfo">pdfinfo</primary> </indexterm> @@ -233,7 +301,9 @@ <varlistentry id="pdfseparate"> <term><command>pdfseparate</command></term> <listitem> - <para>extracts single pages from a PDF file.</para> + <para> + extracts single pages from a PDF file. + </para> <indexterm zone="poppler pdfseparate"> <primary sortas="b-pdseparate">pdfseparate</primary> </indexterm> @@ -243,8 +313,10 @@ <varlistentry id="pdftocairo"> <term><command>pdftocairo</command></term> <listitem> - <para>converts a PDF file to one of several formats (PNG, JPEG, PDF, PS, - EPS, SVG) using the cairo output device of the poppler library.</para> + <para> + converts a PDF file to one of several formats (PNG, JPEG, PDF, PS, + EPS, SVG) using the cairo output device of the poppler library. + </para> <indexterm zone="poppler pdftocairo"> <primary sortas="b-pdftocairo">pdftocairo</primary> </indexterm> @@ -254,7 +326,9 @@ <varlistentry id="pdftohtml"> <term><command>pdftohtml</command></term> <listitem> - <para>converts a PDF file to HTML.</para> + <para> + converts a PDF file to HTML. + </para> <indexterm zone="poppler pdftohtml"> <primary sortas="b-pdftohtml">pdftohtml</primary> </indexterm> @@ -264,7 +338,9 @@ <varlistentry id="pdftoppm"> <term><command>pdftoppm</command></term> <listitem> - <para>converts PDF files to PBM, PGM and PPM formats.</para> + <para> + converts PDF files to PBM, PGM and PPM formats. + </para> <indexterm zone="poppler pdftoppm"> <primary sortas="b-pdftoppm">pdftoppm</primary> </indexterm> @@ -274,7 +350,9 @@ <varlistentry id="pdftops"> <term><command>pdftops</command></term> <listitem> - <para> converts PDF files to Postscript format.</para> + <para> + converts PDF files to Postscript format. + </para> <indexterm zone="poppler pdftops"> <primary sortas="b-pdftops">pdftops</primary> </indexterm> @@ -284,7 +362,9 @@ <varlistentry id="pdftotext"> <term><command>pdftotext</command></term> <listitem> - <para>converts PDF files to plain text.</para> + <para> + converts PDF files to plain text. + </para> <indexterm zone="poppler pdftotext"> <primary sortas="b-pdftotext">pdftotext</primary> </indexterm> @@ -294,8 +374,10 @@ <varlistentry id="pdfunite"> <term><command>pdfunite</command></term> <listitem> - <para>merges several PDF files, in the order of their occurrence on the - command line, to one PDF output file.</para> + <para> + merges several PDF files, in the order of their occurrence on the + command line, to one PDF output file. + </para> <indexterm zone="poppler pdfunite"> <primary sortas="b-pdfunite">pdfunite</primary> </indexterm> @@ -305,8 +387,10 @@ <varlistentry id="poppler-glib-demo"> <term><command>poppler-glib-demo</command></term> <listitem> - <para>is a tool to demonstrate the API, and for use when debugging and - testing <application>poppler</application>.</para> + <para> + is a tool to demonstrate the API, and for use when debugging and + testing <application>poppler</application>. + </para> <indexterm zone="poppler poppler-glib-demo"> <primary sortas="b-poppler-glib-demo">poppler-glib-demo</primary> </indexterm> @@ -316,7 +400,9 @@ <varlistentry id="libpoppler"> <term><filename class='libraryfile'>libpoppler.so</filename></term> <listitem> - <para>contains the API functions to render PDF files.</para> + <para> + contains the API functions to render PDF files. + </para> <indexterm zone="poppler libpoppler"> <primary sortas="c-libpoppler">libpoppler.so</primary> </indexterm> @@ -326,7 +412,9 @@ <varlistentry id="libpoppler-cpp"> <term><filename class='libraryfile'>libpoppler-cpp.so</filename></term> <listitem> - <para>is a C++ backend for rendering PDF files.</para> + <para> + is a C++ backend for rendering PDF files. + </para> <indexterm zone="poppler libpoppler-cpp"> <primary sortas="c-libpoppler-cpp">libpoppler-cpp.so</primary> </indexterm> @@ -336,8 +424,10 @@ <varlistentry id="libpoppler-glib"> <term><filename class='libraryfile'>libpoppler-glib.so</filename></term> <listitem> - <para>is a wrapper library used to interface the PDF rendering - functions with <application>GTK+</application>.</para> + <para> + is a wrapper library used to interface the PDF rendering functions + with <application>GTK+</application>. + </para> <indexterm zone="poppler libpoppler-glib"> <primary sortas="c-libpoppler-glib">libpoppler-glib.so</primary> </indexterm> @@ -347,16 +437,15 @@ <varlistentry id="libpoppler-qt4"> <term><filename class='libraryfile'>libpoppler-qt4.so</filename></term> <listitem> - <para>is a wrapper library used to interface the PDF rendering - functions with <application>Qt</application>-4.</para> + <para> + is a wrapper library used to interface the PDF rendering functions + with <application>Qt</application>-4. + </para> <indexterm zone="poppler libpoppler-qt4"> <primary sortas="c-libpoppler-qt4">libpoppler-qt4.so</primary> </indexterm> </listitem> </varlistentry> - </variablelist> - </sect2> - </sect1> Modified: trunk/BOOK/xsoft/office/libreoffice.xml =================================================================== --- trunk/BOOK/xsoft/office/libreoffice.xml 2012-04-11 23:35:38 UTC (rev 9904) +++ trunk/BOOK/xsoft/office/libreoffice.xml 2012-04-12 13:29:17 UTC (rev 9905) @@ -472,7 +472,7 @@ Comment=Libre Office Printer Administration Icon=printeradmin Exec=printeradmin -Categories=System;Printing;Application; +Categories=Office;Printing;Application; StartupNotify=true Terminal=false" > /usr/share/applications/printeradmin.desktop</userinput></screen> </sect2> @@ -486,7 +486,7 @@ <segtitle>Installed Directory</segtitle> <seglistitem> - <seg>base, calc, draw, impress, math and writer.</seg> + <seg>base, calc, draw, impress, math, printeradmin and writer.</seg> <seg> Hundreds of shared libraries in <filename class="directory">/usr/lib/libreoffice</filename>. @@ -560,6 +560,20 @@ </listitem> </varlistentry> + <varlistentry id="printeradmin"> + <term><command>printeradmin</command></term> + <listitem> + <para> + is a graphical interface to enable you to change your personal + printing preferences, which are saved in + <filename>~/.cups/lpoptions</filename>. + </para> + <indexterm zone="libreoffice printeradmin"> + <primary sortas="b-printeradmin">printeradmin</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="writer"> <term><command>writer</command></term> <listitem> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
