- Timestamp:
- 03/25/2020 12:06:24 PM (4 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 81a73ed8
- Parents:
- 47274444
- Location:
- pst
- Files:
-
- 28 edited
Legend:
- Unmodified
- Added
- Removed
-
pst/printing/cups.xml
r47274444 rfa3edfef 307 307 <title>Config Files</title> 308 308 309 <para><filename>/etc/cups/*</filename></para> 309 <para> 310 <filename>/etc/cups/*</filename> 311 </para> 310 312 311 313 <indexterm zone="cups cups-config"> -
pst/printing/gs.xml
r47274444 rfa3edfef 43 43 <title>Introduction to Ghostscript</title> 44 44 45 <para><application>Ghostscript</application> is a versatile processor 46 for PostScript data with the ability to render PostScript to different 47 targets. It is a mandatory part of the cups printing stack.</para> 45 <para> 46 <application>Ghostscript</application> is a versatile processor 47 for PostScript data with the ability to render PostScript to different 48 targets. It is a mandatory part of the cups printing stack. 49 </para> 48 50 49 51 &lfs91_checked; … … 52 54 <itemizedlist spacing="compact"> 53 55 <listitem> 54 <para>Download (HTTP): <ulink url="&gs-download-http;"/></para> 55 </listitem> 56 <listitem> 57 <para>Download (FTP): <ulink url="&gs-download-ftp;"/></para> 58 </listitem> 59 <listitem> 60 <para>Download MD5 sum: &gs-md5sum;</para> 61 </listitem> 62 <listitem> 63 <para>Download size: &gs-size;</para> 64 </listitem> 65 <listitem> 66 <para>Estimated disk space required: &gs-buildsize;</para> 67 </listitem> 68 <listitem> 69 <para>Estimated build time: &gs-time;</para> 56 <para> 57 Download (HTTP): <ulink url="&gs-download-http;"/> 58 </para> 59 </listitem> 60 <listitem> 61 <para> 62 Download (FTP): <ulink url="&gs-download-ftp;"/> 63 </para> 64 </listitem> 65 <listitem> 66 <para> 67 Download MD5 sum: &gs-md5sum; 68 </para> 69 </listitem> 70 <listitem> 71 <para> 72 Download size: &gs-size; 73 </para> 74 </listitem> 75 <listitem> 76 <para> 77 Estimated disk space required: &gs-buildsize; 78 </para> 79 </listitem> 80 <listitem> 81 <para> 82 Estimated build time: &gs-time; 83 </para> 70 84 </listitem> 71 85 </itemizedlist> 72 86 73 87 <bridgehead renderas="sect3">Additional Downloads</bridgehead> 74 <para>If you wish, you can download additional fonts.</para> 88 <para> 89 If you wish, you can download additional fonts. 90 </para> 75 91 76 92 <itemizedlist spacing="compact"> 77 93 <title>Standard Fonts</title> 78 94 <listitem> 79 <para>Download (HTTP): <ulink url="&gs-standard-fonts-download;"/></para> 80 </listitem> 81 <listitem> 82 <para>Download MD5 sum: &gs-standard-fonts-md5sum;</para> 83 </listitem> 84 <listitem> 85 <para>Download size: &gs-standard-fonts-size;</para> 95 <para> 96 Download (HTTP): <ulink url="&gs-standard-fonts-download;"/> 97 </para> 98 </listitem> 99 <listitem> 100 <para> 101 Download MD5 sum: &gs-standard-fonts-md5sum; 102 </para> 103 </listitem> 104 <listitem> 105 <para> 106 Download size: &gs-standard-fonts-size; 107 </para> 86 108 </listitem> 87 109 </itemizedlist> … … 90 112 <title>Other Fonts</title> 91 113 <listitem> 92 <para>Download (HTTP): <ulink url="&gs-other-fonts-download;"/></para> 93 </listitem> 94 <listitem> 95 <para>Download MD5 sum: &gs-other-fonts-md5sum;</para> 96 </listitem> 97 <listitem> 98 <para>Download size: &gs-other-fonts-size;</para> 114 <para> 115 Download (HTTP): <ulink url="&gs-other-fonts-download;"/> 116 </para> 117 </listitem> 118 <listitem> 119 <para> 120 Download MD5 sum: &gs-other-fonts-md5sum; 121 </para> 122 </listitem> 123 <listitem> 124 <para> 125 Download size: &gs-other-fonts-size; 126 </para> 99 127 </listitem> 100 128 </itemizedlist> … … 161 189 <screen><userinput>rm -rf freetype lcms2mt jpeg libpng openjpeg</userinput></screen> 162 190 163 <para>Compile <application>Ghostscript</application>:</para> 191 <para> 192 Compile <application>Ghostscript</application>: 193 </para> 164 194 165 195 <screen><userinput>rm -rf zlib && … … 200 230 <screen role="root"><userinput>make install</userinput></screen> 201 231 202 <para>If you want the shared library too:</para> 232 <para> 233 If you want the shared library too: 234 </para> 203 235 204 236 <screen role="root"><userinput>make soinstall && … … 206 238 ln -sfvn ghostscript /usr/include/ps</userinput></screen> 207 239 208 <para>Now make the documentation accessible from the normal place:</para> 240 <para> 241 Now make the documentation accessible from the normal place: 242 </para> 209 243 <!-- Starting with 9.23, the install does not seem to copy the examples any more --> 210 244 -
pst/printing/gutenprint.xml
r47274444 rfa3edfef 31 31 <title>Introduction to Gutenprint</title> 32 32 33 <para>The <application>Gutenprint</application> (formerly 34 <application>Gimp-Print</application>) package contains high 35 quality drivers for many brands and models of printers for use with 36 <xref linkend="cups"/> 37 and the 38 <application>GIMP-2.0</application>. See a list of supported printers at 39 <ulink url="http://gutenprint.sourceforge.net/p_Supported_Printers.php"/>. 33 <para> 34 The <application>Gutenprint</application> (formerly 35 <application>Gimp-Print</application>) package contains high 36 quality drivers for many brands and models of printers for use with 37 <xref linkend="cups"/> 38 and the 39 <application>GIMP-2.0</application>. See a list of supported printers at 40 <ulink url="http://gutenprint.sourceforge.net/p_Supported_Printers.php"/>. 40 41 </para> 41 42 … … 45 46 <itemizedlist spacing="compact"> 46 47 <listitem> 47 <para>Download (HTTP): <ulink url="&gutenprint-download-http;"/></para> 48 </listitem> 49 <listitem> 50 <para>Download (FTP): <ulink url="&gutenprint-download-ftp;"/></para> 51 </listitem> 52 <listitem> 53 <para>Download MD5 sum: &gutenprint-md5sum;</para> 54 </listitem> 55 <listitem> 56 <para>Download size: &gutenprint-size;</para> 57 </listitem> 58 <listitem> 59 <para>Estimated disk space required: &gutenprint-buildsize;</para> 60 </listitem> 61 <listitem> 62 <para>Estimated build time: &gutenprint-time;</para> 48 <para> 49 Download (HTTP): <ulink url="&gutenprint-download-http;"/> 50 </para> 51 </listitem> 52 <listitem> 53 <para> 54 Download (FTP): <ulink url="&gutenprint-download-ftp;"/> 55 </para> 56 </listitem> 57 <listitem> 58 <para> 59 Download MD5 sum: &gutenprint-md5sum; 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Download size: &gutenprint-size; 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Estimated disk space required: &gutenprint-buildsize; 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 Estimated build time: &gutenprint-time; 75 </para> 63 76 </listitem> 64 77 </itemizedlist> … … 137 150 <title>Installation of Gutenprint</title> 138 151 139 <para>Install <application>Gutenprint</application> by running the 140 following commands:</para> 152 <para> 153 Install <application>Gutenprint</application> by running the 154 following commands: 155 </para> 141 156 142 157 <screen><userinput>sed -i 's|$(PACKAGE)/doc|doc/$(PACKAGE)-$(VERSION)|' \ … … 150 165 the package - but the tests in 5.2.12 have changed and I thought I read they 151 166 were more parallel --> 152 <para>To test the results, issue: <command>make check</command>. The tests 153 take a very long time and use a lot of disk space. When last tested 154 (version 5.2.15 in June 2019) this needed 75 SBU and 13.5 GB 155 to complete the tests (one test, rastertogutenprint failed because the CUPS 156 ppds are for a previous version. Maybe genppds should be run before the 157 tests). Note that the tests used only one CPU.</para> 158 159 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 167 <para> 168 To test the results, issue: <command>make check</command>. The tests 169 take a very long time and use a lot of disk space. When last tested 170 (version 5.2.15 in June 2019) this needed 75 SBU and 13.5 GB 171 to complete the tests (one test, rastertogutenprint failed because the 172 CUPS ppds are for a previous version. Maybe genppds should be run before 173 the tests). Note that the tests used only one CPU. 174 </para> 175 176 <para> 177 Now, as the <systemitem class="username">root</systemitem> user: 178 </para> 160 179 161 180 <screen role="root"><userinput>make install && … … 171 190 <title>Command Explanations</title> 172 191 173 <para><command>sed -i '...' ...Makefile.in</command>: This 174 command is used so that the package documentation is installed in the 175 conventional <filename class='directory'>/usr/share/doc</filename> 176 directory structure instead of 177 <filename class='directory'>/usr/share/gutenprint/doc</filename>.</para> 192 <para> 193 <command>sed -i '...' ...Makefile.in</command>: This 194 command is used so that the package documentation is installed in the 195 conventional <filename class='directory'>/usr/share/doc</filename> 196 directory structure instead of 197 <filename class='directory'>/usr/share/gutenprint/doc</filename>. 198 </para> 178 199 179 200 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" … … 188 209 <title>Configuration Information</title> 189 210 190 <para>For <application>CUPS</application> to see newly installed print 191 drivers, it has to be restarted (as the <systemitem 192 class="username">root</systemitem> user):</para> 211 <para> 212 For <application>CUPS</application> to see newly installed print 213 drivers, it has to be restarted (as the <systemitem 214 class="username">root</systemitem> user): 215 </para> 193 216 194 217 <screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/cups restart</userinput></screen> … … 196 219 <screen role="root" revision="systemd"><userinput>systemctl restart org.cups.cupsd</userinput></screen> 197 220 198 <!-- <para>This command may take a long time (up to 10 minutes) 199 to complete. Don't panic while <application>CUPS</application> 200 is rescanning the list of PPD files. The long delay will happen 201 only once.</para> --> 202 203 <para>Then point your web browser to <ulink url="http://localhost:631/"/> 204 to add a new printer to <application>CUPS</application>.</para> 221 <!-- <para> 222 This command may take a long time (up to 10 minutes) 223 to complete. Don't panic while <application>CUPS</application> 224 is rescanning the list of PPD files. The long delay will happen 225 only once. 226 </para> --> 227 228 <para> 229 Then point your web browser to <ulink url="http://localhost:631/"/> 230 to add a new printer to <application>CUPS</application>. 231 </para> 205 232 206 233 </sect3> … … 242 269 <term><command>cups-calibrate</command></term> 243 270 <listitem> 244 <para>calibrates the color output of printers using the 245 <application>Gutenprint</application>, 246 <application>CUPS</application> or 247 <application>ESP Print Pro</application> drivers.</para> 271 <para> 272 calibrates the color output of printers using the 273 <application>Gutenprint</application>, 274 <application>CUPS</application> or 275 <application>ESP Print Pro</application> drivers. 276 </para> 248 277 <indexterm zone="gutenprint cups-calibrate"> 249 278 <primary sortas="b-cups-calibrate">cups-calibrate</primary> … … 279 308 <term><command>escputil</command></term> 280 309 <listitem> 281 <para>is a command line utility to perform various maintenance 282 tasks on Epson Stylus inkjet printers.</para> 310 <para> 311 is a command line utility to perform various maintenance 312 tasks on Epson Stylus inkjet printers. 313 </para> 283 314 <indexterm zone="gutenprint escputil"> 284 315 <primary sortas="b-escputil">escputil</primary> … … 292 323 <term><command>ijsgutenprint.5.2</command></term> 293 324 <listitem> 294 <para>is a Ghostscript driver for HP InkJet and LaserJet printers.</para> 325 <para> 326 is a Ghostscript driver for HP InkJet and LaserJet printers. 327 </para> 295 328 <indexterm zone="gutenprint ijsgutenprint.5.2"> 296 329 <primary sortas="b-ijsgutenprint.5.2">ijsgutenprint.5.2</primary> -
pst/printing/printing.xml
r47274444 rfa3edfef 16 16 <title>Printing</title> 17 17 18 <para>This chapter contains spooling printer management systems and 19 ghostscript applications to render PostScript for display on terminals 20 or paper.</para> 18 <para> 19 This chapter contains spooling printer management systems and 20 ghostscript applications to render PostScript for display on terminals 21 or paper. 22 </para> 21 23 22 24 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cups.xml"/> -
pst/ps/a2ps.xml
r47274444 rfa3edfef 32 32 <title>Introduction to a2ps</title> 33 33 34 <para><application>a2ps</application> is a filter utilized mainly 35 in the background and primarily by printing scripts to convert almost 36 every input format into PostScript output. The application's name 37 expands appropriately to <quote>all to PostScript</quote>.</para> 34 <para> 35 <application>a2ps</application> is a filter utilized mainly 36 in the background and primarily by printing scripts to convert almost 37 every input format into PostScript output. The application's name 38 expands appropriately to <quote>all to PostScript</quote>. 39 </para> 38 40 39 41 &lfs91_checked; 40 42 41 43 <caution> 42 <para><application>a2ps</application> cannot convert UTF-8 encoded 43 text to PostScript. The issue is discussed in detail in the 44 <xref linkend="locale-not-valid-option"/> section of the 45 <xref linkend="locale-issues"/> page. 46 The solution is to use <xref linkend="paps"/> instead of 47 <application>a2ps</application> for converting 48 UTF-8 encoded text to PostScript.</para> 44 <para> 45 <application>a2ps</application> cannot convert UTF-8 encoded 46 text to PostScript. The issue is discussed in detail in the 47 <xref linkend="locale-not-valid-option"/> section of the 48 <xref linkend="locale-issues"/> page. 49 The solution is to use <xref linkend="paps"/> instead of 50 <application>a2ps</application> for converting 51 UTF-8 encoded text to PostScript. 52 </para> 49 53 </caution> 50 54 … … 52 56 <itemizedlist spacing="compact"> 53 57 <listitem> 54 <para>Download (HTTP): <ulink url="&a2ps-download-http;"/></para> 55 </listitem> 56 <listitem> 57 <para>Download (FTP): <ulink url="&a2ps-download-ftp;"/></para> 58 </listitem> 59 <listitem> 60 <para>Download MD5 sum: &a2ps-md5sum;</para> 61 </listitem> 62 <listitem> 63 <para>Download size: &a2ps-size;</para> 64 </listitem> 65 <listitem> 66 <para>Estimated disk space required: &a2ps-buildsize;</para> 67 </listitem> 68 <listitem> 69 <para>Estimated build time: &a2ps-time;</para> 58 <para> 59 Download (HTTP): <ulink url="&a2ps-download-http;"/> 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Download (FTP): <ulink url="&a2ps-download-ftp;"/> 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Download MD5 sum: &a2ps-md5sum; 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 Download size: &a2ps-size; 75 </para> 76 </listitem> 77 <listitem> 78 <para> 79 Estimated disk space required: &a2ps-buildsize; 80 </para> 81 </listitem> 82 <listitem> 83 <para> 84 Estimated build time: &a2ps-time; 85 </para> 70 86 </listitem> 71 87 </itemizedlist> … … 74 90 <itemizedlist spacing='compact'> 75 91 <listitem> 76 <para>International fonts: <ulink 77 url="&sources-anduin-http;/i18n-fonts/i18n-fonts-&i18n-fonts-version;.tar.bz2"/></para> 92 <para> 93 International fonts: <ulink url= 94 "&sources-anduin-http;/i18n-fonts/i18n-fonts-&i18n-fonts-version;.tar.bz2"/> 95 </para> 78 96 </listitem> 79 97 </itemizedlist> … … 108 126 <title>Installation of a2ps</title> 109 127 110 <para>Install <application>a2ps</application> by running the following 111 commands:</para> 128 <para> 129 Install <application>a2ps</application> by running the following 130 commands: 131 </para> 112 132 113 133 <screen><userinput>autoconf && … … 122 142 touch doc/*.info</userinput></screen> 123 143 124 <para>To test the results, issue: <command>make check</command>. 125 The <filename>printers.tst</filename> test will fail, as there is no default 126 test printer. The <filename>styles.tst</filename> may also fail, as the 127 tests report some inconsistencies between the generated postscript and the 128 reference sets. This is caused by version number differences between the 129 postscript test files and those generated by the tests — these do not 130 affect the operation of the program and can be ignored.</para> 131 132 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 144 <para> 145 To test the results, issue: <command>make check</command>. 146 The <filename>printers.tst</filename> test will fail, as there is no 147 default test printer. The <filename>styles.tst</filename> may also 148 fail, as the tests report some inconsistencies between the generated 149 postscript and the reference sets. This is caused by version number 150 differences between the postscript test files and those generated by 151 the tests — these do not affect the operation of the program 152 and can be ignored. 153 </para> 154 155 <para> 156 Now, as the <systemitem class="username">root</systemitem> user: 157 </para> 133 158 134 159 <screen role="root"><userinput>make install</userinput></screen> 135 160 136 <para>If desired, install the downloaded i18n-fonts by running the following 137 commands as the <systemitem class="username">root</systemitem> user:</para> 161 <para> 162 If desired, install the downloaded i18n-fonts by running the following 163 commands as the <systemitem class="username">root</systemitem> user: 164 </para> 138 165 139 166 <screen role="root"><userinput>tar -xf ../i18n-fonts-&i18n-fonts-version;.tar.bz2 && … … 150 177 <title>Command Explanations</title> 151 178 152 <para><command>autoconf</command>: This command is used to recreate the 153 <command>configure</command> script. This is required because there is 154 an issue in the mktime test which causes the 155 <command>configure</command> script to hang for 60 seconds and then report 156 that there is no working mktime function.</para> 157 158 <para><command>sed -i "s/GPERF --version |/& head -n 1 |/" configure</command>: 159 This fixes a bug in the handling of the version output of 160 <command>gperf</command>.</para> 161 162 <para><command>sed -i "s|/usr/local/share|/usr/share|" configure</command>: 163 This command modifies the <command>configure</command> script to search for 164 <application>Ghostscript</application> fonts at the location where they were 165 installed by the BLFS instructions.</para> 166 167 <para><parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data 168 is installed in <filename class="directory">/etc/a2ps</filename> instead of 169 <filename class="directory">/usr/etc</filename>.</para> 170 171 <para><parameter>--enable-shared</parameter>: This switch enables building 172 the dynamic <filename class='libraryfile'>liba2ps</filename> library.</para> 173 174 <para><parameter>--with-medium=letter</parameter>: This switch changes the 175 default paper format to US letter. It can either be given here or set 176 in <filename>/etc/a2ps/a2ps-site.cfg</filename> after installation. The 177 default is A4, but there are several other options, in particular: A4dj or 178 letterdj are good settings for HP Deskjet and other printers that need 179 wider paper-handling margins. See <filename>/etc/a2ps/a2ps.cfg</filename> 180 after installation.</para> 181 182 <para><command>touch doc/*.info</command>: This command avoids trying to 183 regenerate the info files. This is an older package and the current 184 .texi files will produce errors preventing <command>make install</command> 185 from working properly.</para> 179 <para> 180 <command>autoconf</command>: This command is used to recreate the 181 <command>configure</command> script. This is required because there is 182 an issue in the mktime test which causes the 183 <command>configure</command> script to hang for 60 seconds and then 184 report that there is no working mktime function. 185 </para> 186 187 <para> 188 <command>sed -i "s/GPERF --version |/& head -n 1 |/" configure</command>: 189 This fixes a bug in the handling of the version output of 190 <command>gperf</command>. 191 </para> 192 193 <para> 194 <command>sed -i "s|/usr/local/share|/usr/share|" configure</command>: 195 This command modifies the <command>configure</command> script to search 196 for <application>Ghostscript</application> fonts at the location where 197 they were installed by the BLFS instructions. 198 </para> 199 200 <para> 201 <parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data is 202 installed in <filename class="directory">/etc/a2ps</filename> instead of 203 <filename class="directory">/usr/etc</filename>. 204 </para> 205 206 <para> 207 <parameter>--enable-shared</parameter>: This switch enables building 208 the dynamic <filename class='libraryfile'>liba2ps</filename> library. 209 </para> 210 211 <para> 212 <parameter>--with-medium=letter</parameter>: This switch changes the 213 default paper format to US letter. It can either be given here or set 214 in <filename>/etc/a2ps/a2ps-site.cfg</filename> after installation. The 215 default is A4, but there are several other options, in particular: A4dj 216 or letterdj are good settings for HP Deskjet and other printers that need 217 wider paper-handling margins. See <filename>/etc/a2ps/a2ps.cfg</filename> 218 after installation. 219 </para> 220 221 <para> 222 <command>touch doc/*.info</command>: This command avoids trying to 223 regenerate the info files. This is an older package and the current 224 <filename class="extension">.texi</filename> files will produce errors 225 preventing <command>make install</command> from working properly. 226 </para> 186 227 187 228 </sect2> … … 193 234 <title>Config Files</title> 194 235 195 <para><filename>/etc/a2ps/a2ps.cfg</filename>, 196 <filename>/etc/a2ps/a2ps-site.cfg</filename></para> 236 <para> 237 <filename>/etc/a2ps/a2ps.cfg</filename> and 238 <filename>/etc/a2ps/a2ps-site.cfg</filename> 239 </para> 197 240 198 241 <indexterm zone="a2ps a2ps-config"> … … 209 252 <title>Configuration Information</title> 210 253 211 <para>Information about configuring <application>a2ps</application> 212 can be found in the comments contained in the above files, and also 213 by running <command>info a2ps</command>.</para> 254 <para> 255 Information about configuring <application>a2ps</application> 256 can be found in the comments contained in the above files, and also 257 by running <command>info a2ps</command>. 258 </para> 214 259 215 260 </sect3> … … 241 286 <term><command>a2ps</command></term> 242 287 <listitem> 243 <para>is a filter, utilized primarily by printing scripts, 244 that converts standard input or supported files to PostScript.</para> 288 <para> 289 is a filter, utilized primarily by printing scripts, 290 that converts standard input or supported files to PostScript. 291 </para> 245 292 <indexterm zone="a2ps a2ps-prog"> 246 293 <primary sortas="b-a2ps">a2ps</primary> … … 252 299 <term><command>card</command></term> 253 300 <listitem> 254 <para>prints a reference card of a given program's options.</para> 301 <para> 302 prints a reference card of a given program's options. 303 </para> 255 304 <indexterm zone="a2ps card"> 256 305 <primary sortas="b-card">card</primary> … … 262 311 <term><command>composeglyphs</command></term> 263 312 <listitem> 264 <para>creates a composite font program.</para> 313 <para> 314 creates a composite font program. 315 </para> 265 316 <indexterm zone="a2ps composeglyphs"> 266 317 <primary sortas="b-composeglyphs">composeglyphs</primary> … … 272 323 <term><command>fixnt</command></term> 273 324 <listitem> 274 <para>is supposed to fix the problems in the PostScript files 275 generated by the Microsoft PostScript driver under Windows NT 276 (3.5 and 4.0).</para> 325 <para> 326 is supposed to fix the problems in the PostScript files 327 generated by the Microsoft PostScript driver under Windows NT 328 (3.5 and 4.0). 329 </para> 277 330 <indexterm zone="a2ps fixnt"> 278 331 <primary sortas="b-fixnt">fixnt</primary> … … 284 337 <term><command>fixps</command></term> 285 338 <listitem> 286 <para>tries to fix common PostScript problems that break 287 postprocessing.</para> 339 <para> 340 tries to fix common PostScript problems that break 341 postprocessing. 342 </para> 288 343 <indexterm zone="a2ps fixps"> 289 344 <primary sortas="b-fixps">fixps</primary> … … 295 350 <term><command>ogonkify</command></term> 296 351 <listitem> 297 <para>provides international support for Postscript by performing 298 various munging of PostScript files related to printing in different 299 languages.</para> 352 <para> 353 provides international support for Postscript by performing various 354 munging of PostScript files related to printing in different 355 languages. 356 </para> 300 357 <indexterm zone="a2ps ogonkify"> 301 358 <primary sortas="b-ogonkify">ogonkify</primary> … … 307 364 <term><command>pdiff</command></term> 308 365 <listitem> 309 <para>produces a pretty comparison between files.</para> 366 <para> 367 produces a pretty comparison between files. 368 </para> 310 369 <indexterm zone="a2ps pdiff"> 311 370 <primary sortas="b-pdiff">pdiff</primary> … … 317 376 <term><command>psmandup</command></term> 318 377 <listitem> 319 <para>tries to produce a version of a given PostScript file to 320 print in manual duplex.</para> 378 <para> 379 tries to produce a version of a given PostScript file to 380 print in manual duplex. 381 </para> 321 382 <indexterm zone="a2ps psmandup"> 322 383 <primary sortas="b-psmandup">psmandup</primary> … … 328 389 <term><command>psset</command></term> 329 390 <listitem> 330 <para>produces a version of a given PostScript file with a 331 protected call to the PostScript operator 'setpagedevice'. 332 Typical use is making a file print duplex, or on the manual 333 tray, etc.</para> 391 <para> 392 produces a version of a given PostScript file with a 393 protected call to the PostScript operator 'setpagedevice'. 394 Typical use is making a file print duplex, or on the manual 395 tray, etc. 396 </para> 334 397 <indexterm zone="a2ps psset"> 335 398 <primary sortas="b-psset">psset</primary> … … 341 404 <term><command>texi2dvi4a2ps</command></term> 342 405 <listitem> 343 <para>compiles Texinfo and LaTeX files to DVI or PDF</para> 406 <para> 407 compiles Texinfo and LaTeX files to DVI or PDF. 408 </para> 344 409 <indexterm zone="a2ps texi2dvi4a2ps"> 345 410 <primary sortas="b-texi2dvi4a2ps">texi2dvi4a2ps</primary> -
pst/ps/enscript.xml
r47274444 rfa3edfef 34 34 <title>Introduction to Enscript</title> 35 35 36 <para><application>Enscript</application> converts ASCII text files 37 to PostScript, HTML, RTF, ANSI and overstrikes.</para> 36 <para> 37 <application>Enscript</application> converts ASCII text files 38 to PostScript, HTML, RTF, ANSI and overstrikes. 39 </para> 38 40 39 41 &lfs91_checked; 40 42 41 43 <caution> 42 <para><application>Enscript</application> cannot convert UTF-8 encoded 43 text to PostScript. The issue is discussed in detail in the 44 <xref linkend="locale-not-valid-option"/> section of the 45 <xref linkend="locale-issues"/> page. 46 The solution is to use <xref linkend="paps"/>, instead of 47 <application>Enscript</application>, for converting 48 UTF-8 encoded text to PostScript.</para> 44 <para> 45 <application>Enscript</application> cannot convert UTF-8 encoded 46 text to PostScript. The issue is discussed in detail in the 47 <xref linkend="locale-not-valid-option"/> section of the 48 <xref linkend="locale-issues"/> page. 49 The solution is to use <xref linkend="paps"/>, instead of 50 <application>Enscript</application>, for converting 51 UTF-8 encoded text to PostScript. 52 </para> 49 53 </caution> 50 54 … … 52 56 <itemizedlist spacing="compact"> 53 57 <listitem> 54 <para>Download (HTTP): <ulink url="&enscript-download-http;"/></para> 55 </listitem> 56 <listitem> 57 <para>Download (FTP): <ulink url="&enscript-download-ftp;"/></para> 58 </listitem> 59 <listitem> 60 <para>Download MD5 sum: &enscript-md5sum;</para> 61 </listitem> 62 <listitem> 63 <para>Download size: &enscript-size;</para> 64 </listitem> 65 <listitem> 66 <para>Estimated disk space required: &enscript-buildsize;</para> 67 </listitem> 68 <listitem> 69 <para>Estimated build time: &enscript-time;</para> 58 <para> 59 Download (HTTP): <ulink url="&enscript-download-http;"/> 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Download (FTP): <ulink url="&enscript-download-ftp;"/> 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Download MD5 sum: &enscript-md5sum; 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 Download size: &enscript-size; 75 </para> 76 </listitem> 77 <listitem> 78 <para> 79 Estimated disk space required: &enscript-buildsize; 80 </para> 81 </listitem> 82 <listitem> 83 <para> 84 Estimated build time: &enscript-time; 85 </para> 70 86 </listitem> 71 87 </itemizedlist> … … 74 90 <itemizedlist spacing="compact"> 75 91 <listitem> 76 <para>Required patch: <ulink 77 url="&patch-root;/enscript-&enscript-version;-security_fixes-1.patch"/></para> 92 <para> 93 Required patch: <ulink url= 94 "&patch-root;/enscript-&enscript-version;-security_fixes-1.patch"/> 95 </para> 78 96 </listitem> 79 97 </itemizedlist> --> … … 93 111 <title>Installation of Enscript</title> 94 112 95 <para>Install <application>Enscript</application> by running the 96 following commands:</para> 113 <para> 114 Install <application>Enscript</application> by running the 115 following commands: 116 </para> 97 117 98 118 <screen><userinput>./configure --prefix=/usr \ … … 106 126 popd</userinput></screen> 107 127 108 <para>If you have <xref linkend="texlive"/> installed, you can create 109 Postscript and PDF documentation by issuing (does not support parallel 110 make):</para> 128 <para> 129 If you have <xref linkend="texlive"/> installed, you can create 130 Postscript and PDF documentation by issuing (does not support parallel 131 make): 132 </para> 111 133 112 134 <screen remap="doc"><userinput>make -j1 -C docs ps pdf</userinput></screen> 113 135 114 <para>To test the results, issue: <command>make check</command>.</para> 115 116 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 136 <para> 137 To test the results, issue: <command>make check</command>. 138 </para> 139 140 <para> 141 Now, as the <systemitem class="username">root</systemitem> user: 142 </para> 117 143 118 144 <screen role="root"><userinput>make install && … … 122 148 /usr/share/doc/enscript-&enscript-version;</userinput></screen> 123 149 124 <para>If you built Postscript and PDF documentation, install it 125 using the following command as the 126 <systemitem class="username">root</systemitem> user:</para> 150 <para> 151 If you built Postscript and PDF documentation, install it 152 using the following command as the 153 <systemitem class="username">root</systemitem> user: 154 </para> 127 155 128 156 <screen role="root" … … 134 162 <title>Command Explanations</title> 135 163 136 <para><parameter>--sysconfdir=/etc/enscript</parameter>: This switch puts 137 configuration data in <filename class="directory">/etc/enscript</filename> 138 instead of <filename class="directory">/usr/etc</filename>.</para> 139 140 <para><parameter>--localstatedir=/var</parameter>: This switch sets the 141 directory for runtime data to <filename class="directory">/var</filename> 142 instead of <filename class="directory">/usr/var</filename>.</para> 143 144 <para><parameter>--with-media=Letter</parameter>: This switch sets the 145 medium format to letter size instead of the A4 default.</para> 164 <para> 165 <parameter>--sysconfdir=/etc/enscript</parameter>: This switch puts 166 configuration data in <filename class="directory">/etc/enscript</filename> 167 instead of <filename class="directory">/usr/etc</filename>. 168 </para> 169 170 <para> 171 <parameter>--localstatedir=/var</parameter>: This switch sets the 172 directory for runtime data to <filename class="directory">/var</filename> 173 instead of <filename class="directory">/usr/var</filename>. 174 </para> 175 176 <para> 177 <parameter>--with-media=Letter</parameter>: This switch sets the 178 medium format to letter size instead of the A4 default. 179 </para> 146 180 </sect2> 147 181 … … 171 205 <term><command>diffpp</command></term> 172 206 <listitem> 173 <para>converts <command>diff</command> output files to a format 174 suitable to be printed with <command>enscript</command>.</para> 207 <para> 208 converts <command>diff</command> output files to a format 209 suitable to be printed with <command>enscript</command>. 210 </para> 175 211 <indexterm zone="enscript diffpp"> 176 212 <primary sortas="b-diffpp">diffpp</primary> … … 182 218 <term><command>enscript</command></term> 183 219 <listitem> 184 <para>is a filter, used primarily by printing scripts, that 185 converts ASCII text files to PostScript, HTML, RTF, ANSI and 186 overstrikes.</para> 220 <para> 221 is a filter, used primarily by printing scripts, that 222 converts ASCII text files to PostScript, HTML, RTF, ANSI and 223 overstrikes. 224 </para> 187 225 <indexterm zone="enscript enscript-prog"> 188 226 <primary sortas="b-enscript">enscript</primary> … … 194 232 <term><command>mkafmmap</command></term> 195 233 <listitem> 196 <para>creates a font map from a given file.</para> 234 <para> 235 creates a font map from a given file. 236 </para> 197 237 <indexterm zone="enscript mkafmmap"> 198 238 <primary sortas="b-mkafmmap">mkafmmap</primary> … … 204 244 <term><command>over</command></term> 205 245 <listitem> 206 <para>is a script which calls <command>enscript</command> and 207 passes the correct parameters to create overstriked fonts.</para> 246 <para> 247 is a script which calls <command>enscript</command> and 248 passes the correct parameters to create overstriked fonts. 249 </para> 208 250 <indexterm zone="enscript over"> 209 251 <primary sortas="b-over">over</primary> … … 215 257 <term><command>sliceprint</command></term> 216 258 <listitem> 217 <para>slices documents with long lines.</para> 259 <para> 260 slices documents with long lines. 261 </para> 218 262 <indexterm zone="enscript sliceprint"> 219 263 <primary sortas="b-sliceprint">sliceprint</primary> … … 225 269 <term><command>states</command></term> 226 270 <listitem> 227 <para>is an <command>awk</command>-like text processing tool 228 with some state machine extensions. It is designed for program 229 source code highlighting and for similar tasks where state 230 information helps input processing.</para> 271 <para> 272 is an <command>awk</command>-like text processing tool 273 with some state machine extensions. It is designed for program 274 source code highlighting and for similar tasks where state 275 information helps input processing. 276 </para> 231 277 <indexterm zone="enscript states"> 232 278 <primary sortas="b-states">states</primary> -
pst/ps/epdfview.xml
r47274444 rfa3edfef 77 77 <itemizedlist spacing='compact'> 78 78 <listitem> 79 <para>Required patch: <ulink 80 url="&patch-root;/epdfview-&epdfview-version;-fixes-2.patch"/></para> 79 <para> 80 Required patch: <ulink url= 81 "&patch-root;/epdfview-&epdfview-version;-fixes-2.patch"/> 82 </para> 81 83 </listitem> 82 84 </itemizedlist> -
pst/ps/fop.xml
r47274444 rfa3edfef 58 58 <itemizedlist spacing="compact"> 59 59 <listitem> 60 <para>Download (HTTP): <ulink url="&fop-download-http;"/></para> 61 </listitem> 62 <listitem> 63 <para>Download (FTP): <ulink url="&fop-download-ftp;"/></para> 64 </listitem> 65 <listitem> 66 <para>Download MD5 sum: &fop-md5sum;</para> 67 </listitem> 68 <listitem> 69 <para>Download size: &fop-size;</para> 70 </listitem> 71 <listitem> 72 <para>Estimated disk space required: &fop-buildsize;</para> 73 </listitem> 74 <listitem> 75 <para>Estimated build time: &fop-time;</para> 60 <para> 61 Download (HTTP): <ulink url="&fop-download-http;"/> 62 </para> 63 </listitem> 64 <listitem> 65 <para> 66 Download (FTP): <ulink url="&fop-download-ftp;"/> 67 </para> 68 </listitem> 69 <listitem> 70 <para> 71 Download MD5 sum: &fop-md5sum; 72 </para> 73 </listitem> 74 <listitem> 75 <para> 76 Download size: &fop-size; 77 </para> 78 </listitem> 79 <listitem> 80 <para> 81 Estimated disk space required: &fop-buildsize; 82 </para> 83 </listitem> 84 <listitem> 85 <para> 86 Estimated build time: &fop-time; 87 </para> 76 88 </listitem> 77 89 </itemizedlist> … … 81 93 <title>Required Additional Downloads:</title> 82 94 <listitem> 83 <para>PDFBox: 95 <para> 96 PDFBox: 84 97 <simplelist> 85 98 <member><ulink url="&pdfbox-download;"/></member> … … 90 103 </listitem> 91 104 <listitem> 92 <para>PDFBox Fonts: 105 <para> 106 PDFBox Fonts: 93 107 <simplelist> 94 108 <member><ulink url="&fontbox-download;"/></member> … … 103 117 <title>Recommended packages</title> 104 118 <listitem> 105 <para>Objects for Formatting Objects (OFFO) hyphenation patterns: 119 <para> 120 Objects for Formatting Objects (OFFO) hyphenation patterns: 106 121 <simplelist> 107 122 <member><ulink url="&offo-download;"/></member> … … 394 409 <term><command>fop</command></term> 395 410 <listitem> 396 <para>is a wrapper script to the <command>java</command> command 411 <para> 412 is a wrapper script to the <command>java</command> command 397 413 which sets up the <application>fop</application> 398 environment and passes the required parameters.</para> 414 environment and passes the required parameters. 415 </para> 399 416 <indexterm zone="fop fop-prog"> 400 417 <primary sortas="b-fop">fop</primary> … … 406 423 <term><filename class='libraryfile'>fop.jar</filename></term> 407 424 <listitem> 408 <para>contains all the <application>fop</application> 409 <application>Java</application> classes.</para> 425 <para> 426 contains all the <application>fop</application> 427 <application>Java</application> classes. 428 </para> 410 429 <indexterm zone="fop fop.jar"> 411 430 <primary sortas="c-fop.jar">fop.jar</primary> -
pst/ps/ps.xml
r47274444 rfa3edfef 16 16 <title>PostScript</title> 17 17 18 <para>This chapter includes applications that create, manipulate or view 19 PostScript files and create or view Portable Document Format 20 PDF files.</para> 18 <para> 19 This chapter includes applications that create, manipulate or view 20 PostScript files and create or view Portable Document Format 21 PDF files. 22 </para> 21 23 22 24 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="a2ps.xml"/> -
pst/ps/psutils.xml
r47274444 rfa3edfef 31 31 <title>Introduction to PSUtils</title> 32 32 33 <para><application>PSUtils</application> is a set of utilities to manipulate 34 PostScript files.</para> 33 <para> 34 <application>PSUtils</application> is a set of utilities to manipulate 35 PostScript files. 36 </para> 35 37 36 38 &lfs91_checked; … … 39 41 <itemizedlist spacing="compact"> 40 42 <listitem> 41 <para>Download (HTTP): <ulink url="&psutils-download-http;"/></para> 42 </listitem> 43 <listitem> 44 <para>Download (FTP): <ulink url="&psutils-download-ftp;"/></para> 45 </listitem> 46 <listitem> 47 <para>Download MD5 sum: &psutils-md5sum;</para> 48 </listitem> 49 <listitem> 50 <para>Download size: &psutils-size;</para> 51 </listitem> 52 <listitem> 53 <para>Estimated disk space required: &psutils-buildsize;</para> 54 </listitem> 55 <listitem> 56 <para>Estimated build time: &psutils-time;</para> 43 <para> 44 Download (HTTP): <ulink url="&psutils-download-http;"/> 45 </para> 46 </listitem> 47 <listitem> 48 <para> 49 Download (FTP): <ulink url="&psutils-download-ftp;"/> 50 </para> 51 </listitem> 52 <listitem> 53 <para> 54 Download MD5 sum: &psutils-md5sum; 55 </para> 56 </listitem> 57 <listitem> 58 <para> 59 Download size: &psutils-size; 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Estimated disk space required: &psutils-buildsize; 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Estimated build time: &psutils-time; 70 </para> 57 71 </listitem> 58 72 </itemizedlist> … … 66 80 <title>Installation of PSUtils</title> 67 81 68 <para>Install <application>PSUtils</application> by running the 69 following commands:</para> 82 <para> 83 Install <application>PSUtils</application> by running the 84 following commands: 85 </para> 70 86 71 87 <screen><userinput>sed 's@/usr/local@/usr@g' Makefile.unix > Makefile && 72 88 make</userinput></screen> 73 89 74 <para>This package does not come with a test suite.</para> 75 76 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 90 <para> 91 This package does not come with a test suite. 92 </para> 93 94 <para> 95 Now, as the <systemitem class="username">root</systemitem> user: 96 </para> 77 97 78 98 <screen role="root"><userinput>make install</userinput></screen> … … 83 103 <title>Command Explanations</title> 84 104 85 <para><command>sed 's@/usr/local@/usr@g' Makefile.unix > Makefile</command>: 86 This command creates a <filename>Makefile</filename> that installs the 87 program to the <filename class="directory">/usr</filename> prefix instead 88 of the <filename class="directory">/usr/local</filename> prefix.</para> 105 <para> 106 <command>sed 's@/usr/local@/usr@g' Makefile.unix > Makefile</command>: 107 This command creates a <filename>Makefile</filename> that installs the 108 program to the <filename class="directory">/usr</filename> prefix instead 109 of the <filename class="directory">/usr/local</filename> prefix. 110 </para> 89 111 90 112 </sect2> … … 108 130 </segmentedlist> 109 131 110 <para>Sometimes <command>psnup</command> and other utilities from this 111 package produce PostScript files that don't conform to Adobe's DSC 112 standard. <application>CUPS</application> may print them incorrectly. 113 On the other hand, <application>CUPS</application> has builtin 114 replacements for most commands from this package. For example, to print 115 a document 2-up, you can issue this command:</para> 132 <para> 133 Sometimes <command>psnup</command> and other utilities from this 134 package produce PostScript files that don't conform to Adobe's DSC 135 standard. <application>CUPS</application> may print them incorrectly. 136 On the other hand, <application>CUPS</application> has builtin 137 replacements for most commands from this package. For example, to print 138 a document 2-up, you can issue this command: 139 </para> 116 140 117 141 <screen><userinput>lp -o number-up=2 <replaceable><filename></replaceable></userinput></screen> … … 125 149 <term><command>epsffit</command></term> 126 150 <listitem> 127 <para>fits an EPSF file to a given bounding box.</para> 151 <para> 152 fits an EPSF file to a given bounding box. 153 </para> 128 154 <indexterm zone="psutils epsffit"> 129 155 <primary sortas="b-epsffit">epsffit</primary> … … 183 209 <term><command>psbook</command></term> 184 210 <listitem> 185 <para>rearranges pages into signatures.</para> 211 <para> 212 rearranges pages into signatures. 213 </para> 186 214 <indexterm zone="psutils psbook"> 187 215 <primary sortas="b-psbook">psbook</primary> … … 205 233 <term><command>psnup</command></term> 206 234 <listitem> 207 <para>puts multiple pages per physical sheet of paper.</para> 235 <para> 236 puts multiple pages per physical sheet of paper. 237 </para> 208 238 <indexterm zone="psutils psnup"> 209 239 <primary sortas="b-psnup">psnup</primary> … … 215 245 <term><command>psresize</command></term> 216 246 <listitem> 217 <para>alters the document paper size.</para> 247 <para> 248 alters the document paper size. 249 </para> 218 250 <indexterm zone="psutils psresize"> 219 251 <primary sortas="b-psresize">psresize</primary> … … 225 257 <term><command>psselect</command></term> 226 258 <listitem> 227 <para>selects pages and page ranges.</para> 259 <para> 260 selects pages and page ranges. 261 </para> 228 262 <indexterm zone="psutils psselect"> 229 263 <primary sortas="b-psselect">psselect</primary> … … 235 269 <term><command>pstops</command></term> 236 270 <listitem> 237 <para>performs general page rearrangements and selection.</para> 271 <para> 272 performs general page rearrangements and selection. 273 </para> 238 274 <indexterm zone="psutils pstops"> 239 275 <primary sortas="b-pstops">pstops</primary> -
pst/scanning/sane.xml
r47274444 rfa3edfef 37 37 <title>Introduction to SANE</title> 38 38 39 <para><application>SANE</application> is short for Scanner Access Now Easy. 40 Scanner access, however, is far from easy, since every vendor has their own 41 protocols. The only known protocol that should bring some unity into this 42 chaos is the TWAIN interface, but this is too imprecise to allow a stable 43 scanning framework. Therefore, <application>SANE</application> comes with 44 its own protocol, and the vendor drivers can't be used.</para> 45 46 <para><application>SANE</application> is split into back ends and front 47 ends. The back ends are drivers for the supported scanners and cameras. The 48 front ends are user interfaces to access the backends.</para> 39 <para> 40 <application>SANE</application> is short for Scanner Access Now Easy. 41 Scanner access, however, is far from easy, since every vendor has their 42 own protocols. The only known protocol that should bring some unity into 43 this chaos is the TWAIN interface, but this is too imprecise to allow a 44 stable scanning framework. Therefore, <application>SANE</application> 45 comes with its own protocol, and the vendor drivers can't be used. 46 </para> 47 48 <para> 49 <application>SANE</application> is split into back ends and front ends. 50 The back ends are drivers for the supported scanners and cameras. The 51 front ends are user interfaces to access the backends. 52 </para> 49 53 50 54 &lfs91_checked; … … 53 57 <itemizedlist spacing='compact'> 54 58 <listitem> 55 <para>Download (HTTP): <ulink url="&sane-be-download-http;"/></para> 56 </listitem> 57 <listitem> 58 <para>Download (FTP): <ulink url="&sane-be-download-ftp;"/></para> 59 </listitem> 60 <listitem> 61 <para>Download MD5 sum: &sane-be-md5sum;</para> 62 </listitem> 63 <listitem> 64 <para>Download size: &sane-be-size;</para> 65 </listitem> 66 <listitem> 67 <para>Estimated disk space required: &sane-be-buildsize;</para> 68 </listitem> 69 <listitem> 70 <para>Estimated build time: &sane-be-time;</para> 59 <para> 60 Download (HTTP): <ulink url="&sane-be-download-http;"/> 61 </para> 62 </listitem> 63 <listitem> 64 <para> 65 Download (FTP): <ulink url="&sane-be-download-ftp;"/> 66 </para> 67 </listitem> 68 <listitem> 69 <para> 70 Download MD5 sum: &sane-be-md5sum; 71 </para> 72 </listitem> 73 <listitem> 74 <para> 75 Download size: &sane-be-size; 76 </para> 77 </listitem> 78 <listitem> 79 <para> 80 Estimated disk space required: &sane-be-buildsize; 81 </para> 82 </listitem> 83 <listitem> 84 <para> 85 Estimated build time: &sane-be-time; 86 </para> 71 87 </listitem> 72 88 </itemizedlist> … … 75 91 <itemizedlist spacing='compact'> 76 92 <listitem> 77 <para>Download (HTTP): <ulink url="&sane-fe-download-http;"/></para> 78 </listitem> 79 <listitem> 80 <para>Download (FTP): <ulink url="&sane-fe-download-ftp;"/></para> 81 </listitem> 82 <listitem> 83 <para>Downlaod MD5 sum: &sane-fe-md5sum;</para> 84 </listitem> 85 <listitem> 86 <para>Download size: &sane-fe-size;</para> 87 </listitem> 88 <listitem> 89 <para>Estimated disk space required: &sane-fe-buildsize;</para> 90 </listitem> 91 <listitem> 92 <para>Estimated build time: &sane-fe-time;</para> 93 <para> 94 Download (HTTP): <ulink url="&sane-fe-download-http;"/> 95 </para> 96 </listitem> 97 <listitem> 98 <para> 99 Download (FTP): <ulink url="&sane-fe-download-ftp;"/> 100 </para> 101 </listitem> 102 <listitem> 103 <para> 104 Downlaod MD5 sum: &sane-fe-md5sum; 105 </para> 106 </listitem> 107 <listitem> 108 <para> 109 Download size: &sane-fe-size; 110 </para> 111 </listitem> 112 <listitem> 113 <para> 114 Estimated disk space required: &sane-fe-buildsize; 115 </para> 116 </listitem> 117 <listitem> 118 <para> 119 Estimated build time: &sane-fe-time; 120 </para> 93 121 </listitem> 94 122 </itemizedlist> … … 129 157 </indexterm> 130 158 131 <para>To access your scanner, you will probably need the related kernel 132 drivers and/or additional support packages. A SCSI scanner will need SCSI 133 drivers, a parallel port scanner needs parallel port support (you should 134 use enhanced EPP modes) and perhaps <ulink 135 url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>, and a USB 136 scanner will need the <xref linkend="libusb"/> package. For HP devices, you 137 may need <ulink 138 url="http://sourceforge.net/projects/hplip/files/hplip/">hplip</ulink>. 139 Ensure you have the necessary drivers properly configured to access 140 the devices.</para> 159 <para> 160 To access your scanner, you will probably need the related kernel 161 drivers and/or additional support packages. A SCSI scanner will need SCSI 162 drivers, a parallel port scanner needs parallel port support (you should 163 use enhanced EPP modes) and perhaps <ulink 164 url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>, and a USB 165 scanner will need the <xref linkend="libusb"/> package. For HP devices, 166 you may need <ulink 167 url="http://sourceforge.net/projects/hplip/files/hplip/">hplip</ulink>. 168 Ensure you have the necessary drivers properly configured to access 169 the devices. 170 </para> 141 171 142 172 </sect2> … … 148 178 <title>Installation of SANE Back Ends</title> 149 179 150 <para>The <application>SANE</application> daemon should run with its own 151 group. Create this group by issuing the following commands as the 152 <systemitem class="username">root</systemitem> user:</para> 180 <para> 181 The <application>SANE</application> daemon should run with its own 182 group. Create this group by issuing the following commands as the 183 <systemitem class="username">root</systemitem> user: 184 </para> 153 185 154 186 <screen role="root"><userinput>groupadd -g 70 scanner</userinput></screen> … … 167 199 </note> 168 200 169 <para>For a USB scanner, if you are linking to <xref linkend="libusb"/>, 170 include the configure switch --enable-libusb_1_0. Install 171 <application>SANE</application>-backends by running the following 172 commands:</para> 201 <para> 202 For a USB scanner, if you are linking to <xref linkend="libusb"/>, 203 include the configure switch --enable-libusb_1_0. Install 204 <application>SANE</application>-backends by running the following 205 commands: 206 </para> 173 207 174 208 <screen><userinput>sg scanner -c " \ … … 180 214 make</userinput></screen> 181 215 182 <para>To test the results, issue: <command>make check</command>.</para> 183 184 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 216 <para> 217 To test the results, issue: <command>make check</command>. 218 </para> 219 220 <para> 221 Now, as the <systemitem class="username">root</systemitem> user: 222 </para> 185 223 186 224 <screen role="root"><userinput>make install && … … 189 227 chgrp -v scanner /var/lock/sane</userinput></screen> 190 228 191 <para>With the scanner on, run <command>scanimage -L</command> and the 192 name and location of the device should appear. Of course, you need the 193 device drivers configured, in order to run this test.</para> 229 <para> 230 With the scanner on, run <command>scanimage -L</command> and the 231 name and location of the device should appear. Of course, you need the 232 device drivers configured, in order to run this test. 233 </para> 194 234 195 235 </sect3> … … 198 238 <title>Installation of SANE Front Ends</title> 199 239 200 <para>The <application>SANE</application>-frontends package 201 includes the graphical frontends <command>xscanimage</command> and 202 <command>xcam</command>, and a command-line frontend 203 <command>scanadf</command>. You don't need this package if you intend 204 to use one of the more advanced graphical frontends like 205 <xref linkend="xsane"/>. For a list of frontend packages, see 206 <ulink url="http://www.sane-project.org/sane-frontends.html"/>.</para> 207 208 <para>To install <application>SANE</application>-frontends, 209 use the following commands:</para> 240 <para> 241 The <application>SANE</application>-frontends package 242 includes the graphical frontends <command>xscanimage</command> and 243 <command>xcam</command>, and a command-line frontend 244 <command>scanadf</command>. You don't need this package if you intend 245 to use one of the more advanced graphical frontends like 246 <xref linkend="xsane"/>. For a list of frontend packages, see 247 <ulink url="http://www.sane-project.org/sane-frontends.html"/>. 248 </para> 249 250 <para> 251 To install <application>SANE</application>-frontends, 252 use the following commands: 253 </para> 210 254 211 255 <screen><userinput>tar -xf ../sane-frontends-&sane-fe-version;.tar.gz && … … 216 260 make</userinput></screen> 217 261 218 <para>This package does not come with a test suite.</para> 219 220 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 262 <para> 263 This package does not come with a test suite. 264 </para> 265 266 <para> 267 Now, as the <systemitem class="username">root</systemitem> user: 268 </para> 221 269 222 270 <screen role="root"><userinput>make install && … … 224 272 /usr/share/sane</userinput></screen> 225 273 226 <para>If <application>GIMP</application> was linked into the build and 227 you wish <application>GIMP</application> to use 228 <command>xscanimage</command> as a scanning plugin, issue the following 229 command as the <systemitem class="username">root</systemitem> user:</para> 274 <para> 275 If <application>GIMP</application> was linked into the build and 276 you wish <application>GIMP</application> to use 277 <command>xscanimage</command> as a scanning plugin, issue the following 278 command as the <systemitem class="username">root</systemitem> user: 279 </para> 230 280 231 281 <screen role="root"><userinput>ln -v -s ../../../../bin/xscanimage /usr/lib/gimp/2.0/plug-ins</userinput></screen> … … 254 304 </para> 255 305 256 <para><parameter>--sysconfdir=/etc</parameter>: This switch installs the 257 configuration files in <filename class="directory">/etc/sane.d</filename> 258 instead of <filename class="directory">/usr/etc/sane.d</filename>.</para> 259 260 <para><parameter>--with-group=scanner</parameter>: This parameter causes 261 the directory created for the locking files to be group owned by the 262 <systemitem class="groupname">scanner</systemitem> group instead of the 263 default <systemitem class="groupname">uucp</systemitem> group.</para> 264 265 <para><command>exit</command>: This command is used to exit the shell 266 created by the <command>su</command> command.</para> 306 <para> 307 <parameter>--sysconfdir=/etc</parameter>: This switch installs the 308 configuration files in <filename class="directory">/etc/sane.d</filename> 309 instead of <filename class="directory">/usr/etc/sane.d</filename>. 310 </para> 311 312 <para> 313 <parameter>--with-group=scanner</parameter>: This parameter causes 314 the directory created for the locking files to be group owned by the 315 <systemitem class="groupname">scanner</systemitem> group instead of the 316 default <systemitem class="groupname">uucp</systemitem> group. 317 </para> 318 319 <para> 320 <command>exit</command>: This command is used to exit the shell 321 created by the <command>su</command> command. 322 </para> 267 323 </sect2> 268 324 … … 273 329 <title>Config Files</title> 274 330 275 <para><filename>/etc/sane.d/*.conf</filename></para> 331 <para> 332 <filename>/etc/sane.d/*.conf</filename> 333 </para> 276 334 277 335 <indexterm zone="sane sane-config"> … … 287 345 <title>Backend Configuration</title> 288 346 289 <para>The backend configuration files are located in 290 <filename class='directory'>/etc/sane.d</filename>. Information 291 for configuring the various backends can be found by using the man(5) 292 page for the desired backend. Run 293 <command>man sane-<replaceable><backend></replaceable></command>, 294 substituting the desired backend.</para> 295 296 <para>Add any desired users to the <systemitem 297 class="groupname">scanner</systemitem> group.</para> 298 299 <para>If you want to access a network scanner, include two lines in 300 <filename>net.conf</filename>, as <systemitem class="username">root</systemitem> user 301 (make sure to replace <server_ip> by the actual value, below):</para> 347 <para> 348 The backend configuration files are located in 349 <filename class='directory'>/etc/sane.d</filename>. Information 350 for configuring the various backends can be found by using the man(5) 351 page for the desired backend. Run 352 <command> 353 man sane-<replaceable><backend></replaceable></command>, 354 substituting the desired backend. 355 </para> 356 357 <para> 358 Add any desired users to the <systemitem 359 class="groupname">scanner</systemitem> group. 360 </para> 361 362 <para> 363 If you want to access a network scanner, include two lines in 364 <filename>net.conf</filename>, as <systemitem 365 class="username">root</systemitem> user (make sure to replace 366 <server_ip> by the actual value, below): 367 </para> 302 368 303 369 <screen role="root"><userinput>cat >> /etc/sane.d/net.conf << "EOF" … … 306 372 EOF</userinput></screen> 307 373 308 <para>On the server side, include the client ip in the access list of 309 <filename>/etc/sane.d/saned.conf</filename>, restart the 310 <command>saned</command> daemon, and make sure the firewall, if any, is 311 open to the client.</para> 374 <para> 375 On the server side, include the client ip in the access list of 376 <filename>/etc/sane.d/saned.conf</filename>, restart the 377 <command>saned</command> daemon, and make sure the firewall, if any, 378 is open to the client. 379 </para> 312 380 313 381 </sect4> … … 344 412 <title>General Information</title> 345 413 346 <para>For general information about configuring and using 347 <application>SANE</application>, see <command>man sane</command>. 348 Linux-2.6.x brings some special issues into the picture. See 349 <ulink url="http://www.sane-project.org/README.linux"/> for 350 information about using <application>SANE</application> with the 351 Linux-2.6.x kernel. For information about USB scanning devices, 352 run <command>man sane-usb</command>. For information about SCSI 353 devices, run <command>man sane-scsi</command>.</para> 414 <para> 415 For general information about configuring and using 416 <application>SANE</application>, see <command>man sane</command>. 417 For information about USB scanning devices, 418 run <command>man sane-usb</command>. For information about SCSI 419 devices, run <command>man sane-scsi</command>. 420 </para> 354 421 355 422 </sect4> … … 358 425 <title>Configuration and setup of the 'saned' daemon</title> 359 426 360 <para> The <command>saned</command> daemon is not meant to be used for361 untrusted clients. You should provide <xref linkend="fw-firewall"/>362 protection to ensure only trusted363 clients access the daemon. Due to the complex security requirementsto364 ensure only trusted clients access the daemon, BLFS does not provide365 instructions to configure the <command>saned</command> daemon. If you366 desire to make the daemon available, ensure you provide adequate367 security, configure your <filename>[x]inetd.conf</filename> file and368 send a <userinput>SIGHUP</userinput> to the [x]inetd daemon. Some good369 information for setting up and securing the <command>saned</command>370 daemon can be found at371 < ulink url="http://penguin-breeder.org/sane/saned/"/>.</para>427 <para> 428 The <command>saned</command> daemon is not meant to be used for 429 untrusted clients. You should provide <xref linkend="fw-firewall"/> 430 protection to ensure only trusted clients access the daemon. Due to 431 the complex security requirements to ensure only trusted clients 432 access the daemon, BLFS does not provide 433 instructions to configure the <command>saned</command> daemon. 434 Some good (but outdated) 435 information for setting up and securing the <command>saned</command> 436 daemon can be found at 437 <ulink url="http://penguin-breeder.org/sane/saned/"/>. 438 </para> 372 439 373 440 </sect4> … … 417 484 <term><command>gamma4scanimage</command></term> 418 485 <listitem> 419 <para>creates a gamma table in the format expected by 420 <command>scanimage</command>.</para> 486 <para> 487 creates a gamma table in the format expected by 488 <command>scanimage</command>. 489 </para> 421 490 <indexterm zone="sane gamma4scanimage"> 422 491 <primary sortas="b-gamma4scanimage">gamma4scanimage</primary> … … 428 497 <term><command>sane-config</command></term> 429 498 <listitem> 430 <para>is a tool used to determine the compiler and linker 431 flags that should be used to compile and link 432 <application>SANE</application>.</para> 499 <para> 500 is a tool used to determine the compiler and linker 501 flags that should be used to compile and link 502 <application>SANE</application>. 503 </para> 433 504 <indexterm zone="sane sane-config-prog"> 434 505 <primary sortas="b-sane-config">sane-config</primary> … … 440 511 <term><command>saned</command></term> 441 512 <listitem> 442 <para>is the <application>SANE</application> daemon that 443 allows remote clients to access image acquisition devices 444 available on the local host.</para> 513 <para> 514 is the <application>SANE</application> daemon that 515 allows remote clients to access image acquisition devices 516 available on the local host. 517 </para> 445 518 <indexterm zone="sane saned"> 446 519 <primary sortas="b-saned">saned</primary> … … 452 525 <term><command>sane-find-scanner</command></term> 453 526 <listitem> 454 <para>is a command-line tool to find SCSI and 455 USB scanners and determine their device files. Its primary 456 purpose is to make sure that scanners can be detected by 457 <application>SANE</application> backends.</para> 527 <para> 528 is a command-line tool to find SCSI and 529 USB scanners and determine their device files. Its primary 530 purpose is to make sure that scanners can be detected by 531 <application>SANE</application> backends. 532 </para> 458 533 <indexterm zone="sane sane-find-scanner"> 459 534 <primary sortas="b-sane-find-scanner">sane-find-scanner</primary> … … 465 540 <term><command>scanadf</command></term> 466 541 <listitem> 467 <para>is a command-line interface to control image acquisition 468 devices which are equipped with an automatic document feeder 469 (ADF).</para> 542 <para> 543 is a command-line interface to control image acquisition 544 devices which are equipped with an automatic document feeder (ADF). 545 </para> 470 546 <indexterm zone="sane scanadf"> 471 547 <primary sortas="b-scanadf">scanadf</primary> … … 477 553 <term><command>scanimage</command></term> 478 554 <listitem> 479 <para>is a command line interface for scanning from image acquisition 480 devices such as flatbed scanners or cameras. It is also used to list 481 the available backend devices.</para> 555 <para> 556 is a command line interface for scanning from image acquisition 557 devices such as flatbed scanners or cameras. It is also used to 558 list the available backend devices. 559 </para> 482 560 <indexterm zone="sane scanimage"> 483 561 <primary sortas="b-scanimage">scanimage</primary> … … 489 567 <term><command>xcam</command></term> 490 568 <listitem> 491 <para>is a graphical camera front end for 492 <application>SANE</application>.</para> 569 <para> 570 is a graphical camera front end for 571 <application>SANE</application>. 572 </para> 493 573 <indexterm zone="sane xcam"> 494 574 <primary sortas="b-xcam">xcam</primary> … … 500 580 <term><command>xscanimage</command></term> 501 581 <listitem> 502 <para>is a graphical user interface for scanning.</para> 582 <para> 583 is a graphical user interface for scanning. 584 </para> 503 585 <indexterm zone="sane xscanimage"> 504 586 <primary sortas="b-xscanimage">xscanimage</primary> … … 510 592 <term><filename class='libraryfile'>libsane.so</filename></term> 511 593 <listitem> 512 <para>is the application programming interface that is used to 513 communicate between frontends and backends.</para> 594 <para> 595 is the application programming interface that is used to 596 communicate between frontends and backends. 597 </para> 514 598 <indexterm zone="sane libsane"> 515 599 <primary sortas="c-libsane">libsane.so</primary> … … 521 605 <term><filename class='libraryfile'>libsane-*.so</filename></term> 522 606 <listitem> 523 <para>modules are backend scanning library plugins used to interface 524 with scanning devices. See 525 <ulink url="http://www.sane-project.org/sane-supported-devices.html"/> 526 for a list of supported backends.</para> 607 <para> 608 modules are backend scanning library plugins used to interface 609 with scanning devices. See <ulink 610 url="http://www.sane-project.org/sane-supported-devices.html"/> 611 for a list of supported backends. 612 </para> 527 613 <indexterm zone="sane libsane-module"> 528 614 <primary sortas="c-libsane-module">libsane-*.so</primary> -
pst/scanning/scanning.xml
r47274444 rfa3edfef 16 16 <title>Scanning</title> 17 17 18 <para>This chapter contains scanning applications which allow you to 19 convert printed documents into formatted documents readable by other 20 applications.</para> 18 <para> 19 This chapter contains scanning applications which allow you to 20 convert printed documents into formatted documents readable by other 21 applications. 22 </para> 21 23 22 24 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sane.xml"/> -
pst/scanning/xsane.xml
r47274444 rfa3edfef 30 30 <title>Introduction to XSane</title> 31 31 32 <para><application>XSane</application> is another front end for 33 <xref linkend="sane"/>. It has additional features to improve the image 34 quality and ease of use compared to <command>xscanimage</command>.</para> 32 <para> 33 <application>XSane</application> is another front end for 34 <xref linkend="sane"/>. It has additional features to improve the image 35 quality and ease of use compared to <command>xscanimage</command>. 36 </para> 35 37 36 38 &lfs91_checked; … … 39 41 <itemizedlist spacing="compact"> 40 42 <listitem> 41 <para>Download (HTTP): <ulink url="&xsane-download-http;"/></para> 42 </listitem> 43 <listitem> 44 <para>Download (FTP): <ulink url="&xsane-download-ftp;"/></para> 45 </listitem> 46 <listitem> 47 <para>Download MD5 sum: &xsane-md5sum;</para> 48 </listitem> 49 <listitem> 50 <para>Download size: &xsane-size;</para> 51 </listitem> 52 <listitem> 53 <para>Estimated disk space required: &xsane-buildsize;</para> 54 </listitem> 55 <listitem> 56 <para>Estimated build time: &xsane-time;</para> 43 <para> 44 Download (HTTP): <ulink url="&xsane-download-http;"/> 45 </para> 46 </listitem> 47 <listitem> 48 <para> 49 Download (FTP): <ulink url="&xsane-download-ftp;"/> 50 </para> 51 </listitem> 52 <listitem> 53 <para> 54 Download MD5 sum: &xsane-md5sum; 55 </para> 56 </listitem> 57 <listitem> 58 <para> 59 Download size: &xsane-size; 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Estimated disk space required: &xsane-buildsize; 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Estimated build time: &xsane-time; 70 </para> 57 71 </listitem> 58 72 </itemizedlist> … … 85 99 <title>Installation of XSane</title> 86 100 87 <para>Install <application>XSane</application> by running the following 88 commands:</para> 101 <para> 102 Install <application>XSane</application> by running the following 103 commands: 104 </para> 89 105 90 106 <!--sed -i -e 's/netscape/xdg-open/' src/xsane.h &&--> … … 93 109 make</userinput></screen> 94 110 95 <para>This package does not come with a test suite.</para> 96 97 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 111 <para> 112 This package does not come with a test suite. 113 </para> 114 115 <para> 116 Now, as the <systemitem class="username">root</systemitem> user: 117 </para> 98 118 99 119 <screen role="root"><userinput>make xsanedocdir=/usr/share/doc/xsane-&xsane-version; install && 100 120 ln -v -s ../../doc/xsane-&xsane-version; /usr/share/sane/xsane/doc</userinput></screen> 101 121 <!-- 102 <para>If you have not installed <xref linkend="xdg-utils"/> and have not 103 issued the first sed:</para>--> 104 <para>A browser of your choice can be used to get inline help, using the 105 following command, as the <systemitem class="username">root</systemitem> 106 user:</para> 122 <para> 123 If you have not installed <xref linkend="xdg-utils"/> and have not 124 issued the first sed: 125 </para>--> 126 <para> 127 A browser of your choice can be used to get inline help, using the 128 following command, as the <systemitem class="username">root</systemitem> 129 user: 130 </para> 107 131 108 132 <screen role="root"><userinput>ln -v -s <browser> /usr/bin/netscape</userinput></screen> 109 133 110 <note><para>Be sure to replace <browser> with the browser of your 111 choice on your system.</para></note> 112 113 <para>Alternatively, if the environment variable BROWSER is set to the 114 browser you want to use, eg, BROWSER="/usr/bin/firefox", the first time you 115 run <command>xsane</command>, it will be recorded in ~/.sane/xsane/xsane.rc. 116 If you wish to change it, edit this file, or remove it, and use the 117 instructions above, so that a new one is created.</para> 118 119 <para>If <application>GIMP</application> is installed, issue the following 120 command as the <systemitem class="username">root</systemitem> user:</para> 134 <note> 135 <para> 136 Be sure to replace <browser> with the browser of your 137 choice on your system. 138 </para> 139 </note> 140 141 <para> 142 Alternatively, if the environment variable BROWSER is set to the browser 143 you want to use, eg, BROWSER="/usr/bin/firefox", the first time you run 144 <command>xsane</command>, it will be recorded in <filename> 145 ~/.sane/xsane/xsane.rc</filename>. If you wish to change it, edit this 146 file, or remove it, and use the instructions above, so that a new one is 147 created. 148 </para> 149 150 <para> 151 If <application>GIMP</application> is installed, issue the following 152 command as the <systemitem class="username">root</systemitem> user: 153 </para> 121 154 122 155 <screen role="root"><userinput>ln -v -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</userinput></screen> … … 127 160 <title>Command Explanations</title> 128 161 <!-- 129 <para><command>sed -i -e 's/netscape/xdg-open/' src/xsane.h </command>: 130 This is to use <command>xdg-open</command> for the help documentation, 131 instead of the hardcoded browser.</para>--> 132 133 <para><command>ln -v -s ../../doc/xsane-&xsane-version; 134 /usr/share/sane/xsane/doc</command>: This symlink is created to ensure that 135 any program that looks for the <application>XSane</application> 136 documentation in the default location will find it, as the documentation 137 is installed in an alternate location specified in the 138 <command>make install</command> command.</para> 139 140 <para><command>ln -v -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</command>: 141 This creates a link in the system-wide <application>GIMP</application> 142 <filename class='directory'>plug-ins</filename> directory so that users can 143 access <application>XSane</application> directly from 144 <application>GIMP</application>. <application>GIMP</application> must be 145 available before building <application>XSane</application> for this to work. 146 Alternatively, create the link in <filename 147 class='directory'>~/.gimp-2.0/plug-ins/</filename> to provide individual 148 user access. <command>man xsane</command> for additional information.</para> 162 <para> 163 <command>sed -i -e 's/netscape/xdg-open/' src/xsane.h </command>: 164 This is to use <command>xdg-open</command> for the help documentation, 165 instead of the hardcoded browser. 166 </para>--> 167 168 <para> 169 <command>ln -v -s ../../doc/xsane-&xsane-version; 170 /usr/share/sane/xsane/doc</command>: This symlink is created to ensure 171 that any program that looks for the <application>XSane</application> 172 documentation in the default location will find it, as the documentation 173 is installed in an alternate location specified in the <command>make 174 install</command> command. 175 </para> 176 177 <para> 178 <command>ln -v -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</command>: 179 This creates a link in the system-wide <application>GIMP</application> 180 <filename class='directory'>plug-ins</filename> directory so that users 181 can access <application>XSane</application> directly from 182 <application>GIMP</application>. <application>GIMP</application> must 183 be available before building <application>XSane</application> for this 184 to work. Alternatively, create the link in <filename 185 class='directory'>~/.gimp-2.0/plug-ins/</filename> to provide individual 186 user access. <command>man xsane</command> for additional information. 187 </para> 149 188 150 189 </sect2> … … 174 213 <term><command>xsane</command></term> 175 214 <listitem> 176 <para>is a graphical user-interface to control an image acquisition 177 device such as a flatbed scanner.</para> 215 <para> 216 is a graphical user-interface to control an image acquisition 217 device such as a flatbed scanner. 218 </para> 178 219 <indexterm zone="xsane xsane-prog"> 179 220 <primary sortas="b-xsane">xsane</primary> -
pst/sgml/docbook-utils.xml
r47274444 rfa3edfef 30 30 <title>Introduction to DocBook-utils</title> 31 31 32 <para>The <application>DocBook-utils</application> package is a collection 33 of utility scripts used to convert and analyze SGML documents in general, 34 and DocBook files in particular. The scripts are used to convert from 35 DocBook or other SGML formats into <quote>classical</quote> file formats 36 like HTML, man, info, RTF and many more. There's also a utility to compare 37 two SGML files and only display the differences in markup. This is useful 38 for comparing documents prepared for different languages.</para> 32 <para> 33 The <application>DocBook-utils</application> package is a collection 34 of utility scripts used to convert and analyze SGML documents in general, 35 and DocBook files in particular. The scripts are used to convert from 36 DocBook or other SGML formats into <quote>classical</quote> file formats 37 like HTML, man, info, RTF and many more. There's also a utility to compare 38 two SGML files and only display the differences in markup. This is useful 39 for comparing documents prepared for different languages. 40 </para> 39 41 40 42 &lfs91_checked; … … 43 45 <itemizedlist spacing="compact"> 44 46 <listitem> 45 <para>Download (HTTP): <ulink url="&docbook-utils-download-http;"/></para> 46 </listitem> 47 <listitem> 48 <para>Download (FTP): <ulink url="&docbook-utils-download-ftp;"/></para> 49 </listitem> 50 <listitem> 51 <para>Download MD5 sum: &docbook-utils-md5sum;</para> 52 </listitem> 53 <listitem> 54 <para>Download size: &docbook-utils-size;</para> 55 </listitem> 56 <listitem> 57 <para>Estimated disk space required: &docbook-utils-buildsize;</para> 58 </listitem> 59 <listitem> 60 <para>Estimated build time: &docbook-utils-time;</para> 47 <para> 48 Download (HTTP): <ulink url="&docbook-utils-download-http;"/> 49 </para> 50 </listitem> 51 <listitem> 52 <para> 53 Download (FTP): <ulink url="&docbook-utils-download-ftp;"/> 54 </para> 55 </listitem> 56 <listitem> 57 <para> 58 Download MD5 sum: &docbook-utils-md5sum; 59 </para> 60 </listitem> 61 <listitem> 62 <para> 63 Download size: &docbook-utils-size; 64 </para> 65 </listitem> 66 <listitem> 67 <para> 68 Estimated disk space required: &docbook-utils-buildsize; 69 </para> 70 </listitem> 71 <listitem> 72 <para> 73 Estimated build time: &docbook-utils-time; 74 </para> 61 75 </listitem> 62 76 </itemizedlist> … … 65 79 <itemizedlist spacing='compact'> 66 80 <listitem> 67 <para>Required patch: <ulink 68 url="&patch-root;/docbook-utils-&docbook-utils-version;-grep_fix-1.patch"/></para> 81 <para> 82 Required patch: <ulink url= 83 "&patch-root;/docbook-utils-&docbook-utils-version;-grep_fix-1.patch"/> 84 </para> 69 85 </listitem> 70 86 </itemizedlist> … … 97 113 <title>Installation of DocBook-utils</title> 98 114 99 <para>Install <application>DocBook-utils</application> by running the 100 following commands:</para> 115 <para> 116 Install <application>DocBook-utils</application> by running the 117 following commands: 118 </para> 101 119 102 120 <screen><userinput>patch -Np1 -i ../docbook-utils-&docbook-utils-version;-grep_fix-1.patch && … … 106 124 make</userinput></screen> 107 125 108 <para>This package does not come with a test suite.</para> 109 110 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 126 <para> 127 This package does not come with a test suite. 128 </para> 129 130 <para> 131 Now, as the <systemitem class="username">root</systemitem> user: 132 </para> 111 133 112 134 <screen role="root"><userinput>make docdir=/usr/share/doc install</userinput></screen> 113 135 114 <para>Many packages use an alternate name for the 115 <application>DocBook-utils</application> scripts. If you wish to create 116 these alternate names, use the following command as 117 the <systemitem class="username">root</systemitem> user:</para> 136 <para> 137 Many packages use an alternate name for the 138 <application>DocBook-utils</application> scripts. If you wish to create 139 these alternate names, use the following command as 140 the <systemitem class="username">root</systemitem> user: 141 </para> 118 142 119 143 <screen role="root"><userinput>for doctype in html ps dvi man pdf rtf tex texi txt … … 123 147 124 148 <note> 125 <para>The <command>jw</command> script uses the <command>which</command> 126 command to locate required utilities. You must install 127 <xref linkend="which"/> before attempting to use any of the 128 <application>DocBook-utils</application> programs.</para> 149 <para> 150 The <command>jw</command> script uses the <command>which</command> 151 command to locate required utilities. You must install 152 <xref linkend="which"/> before attempting to use any of the 153 <application>DocBook-utils</application> programs. 154 </para> 129 155 </note> 130 156 … … 134 160 <title>Command Explanations</title> 135 161 136 <para><command>patch -Np1 -i ../docbook-utils-&docbook-utils-version;-grep_fix-1.patch</command>: 137 This patch corrects the syntax in the jw (Jade Wrapper) script which is at 138 the heart of much db2* processing, so that the current version of 139 <application>Grep</application> will not reject it.</para> 140 141 <para><command>sed -i 's:/html::' doc/HTML/Makefile.in</command>: 142 This command changes the installation directory of the HTML documents.</para> 143 144 <para><option>docdir=/usr/share/doc</option>: 145 This option is placed on the <command>make install</command> line because is is not 146 recognized by <command>configure</command>.</para> 162 <para> 163 <command>patch -Np1 -i ../docbook-utils-&docbook-utils-version;-grep_fix-1.patch</command>: 164 This patch corrects the syntax in the jw (Jade Wrapper) script which is 165 at the heart of much db2* processing, so that the current version of 166 <application>grep</application> will not reject it. 167 </para> 168 169 <para> 170 <command>sed -i 's:/html::' doc/HTML/Makefile.in</command>: 171 This command changes the installation directory of the HTML documents. 172 </para> 173 174 <para> 175 <option>docdir=/usr/share/doc</option>: This option is placed on the 176 <command>make install</command> line because is is not 177 recognized by <command>configure</command>. 178 </para> 147 179 148 180 </sect2> … … 177 209 <term><command>docbook2*</command></term> 178 210 <listitem> 179 <para>are simple one-line wrapper scripts to <command>jw</command>. 180 They are provided as easy-to-remember names used to convert DocBook or 181 other SGML files to the respective format.</para> 211 <para> 212 are simple one-line wrapper scripts to <command>jw</command>. 213 They are provided as easy-to-remember names used to convert 214 DocBook or other SGML files to the respective format. 215 </para> 182 216 <indexterm zone="docbook-utils docbook2"> 183 217 <primary sortas="b-docbook2-star">docbook2*</primary> … … 189 223 <term><command>db2*</command></term> 190 224 <listitem> 191 <para>are symlinks pointing at the respectively named 192 <command>docbook2*</command> commands, created to satisfy some 193 program's use of these names.</para> 225 <para> 226 are symlinks pointing at the respectively named 227 <command>docbook2*</command> commands, created to satisfy some 228 program's use of these names. 229 </para> 194 230 <indexterm zone="docbook-utils db2"> 195 231 <primary sortas="b-db2-star">db2*</primary> … … 201 237 <term><command>jw</command></term> 202 238 <listitem> 203 <para>is a script used to convert DocBook or other SGML files to various 204 output formats. It hides most of <application>OpenJade</application>'s 205 complexity and adds comfortable features.</para> 239 <para> 240 is a script used to convert DocBook or other SGML files to various 241 output formats. It hides most of 242 <application>OpenJade</application>'s complexity and adds 243 comfortable features. 244 </para> 206 245 <indexterm zone="docbook-utils jw"> 207 246 <primary sortas="b-jw">jw</primary> … … 213 252 <term><command>sgmldiff</command></term> 214 253 <listitem> 215 <para>is used to compare two SGML files and only return the differences 216 in the markup. This is especially useful to compare files that should be 217 identical except for language differences in the content.</para> 254 <para> 255 is used to compare two SGML files and only return the differences 256 in the markup. This is especially useful to compare files that 257 should be identical except for language differences in the content. 258 </para> 218 259 <indexterm zone="docbook-utils sgmldiff"> 219 260 <primary sortas="b-sgmldiff">sgmldiff</primary> -
pst/sgml/sgml-common.xml
r47274444 rfa3edfef 30 30 <title>Introduction to SGML Common</title> 31 31 32 <para>The <application>SGML Common</application> package contains 33 <command>install-catalog</command>. This is useful for creating and 34 maintaining centralized SGML catalogs.</para> 32 <para> 33 The <application>SGML Common</application> package contains 34 <command>install-catalog</command>. This is useful for creating and 35 maintaining centralized SGML catalogs. 36 </para> 35 37 36 38 &lfs91_checked; … … 39 41 <itemizedlist spacing="compact"> 40 42 <listitem> 41 <para>Download (HTTP): <ulink url="&sgml-common-download-http;"/></para> 42 </listitem> 43 <listitem> 44 <para>Download (FTP): <ulink url="&sgml-common-download-ftp;"/></para> 45 </listitem> 46 <listitem> 47 <para>Download MD5 sum: &sgml-common-md5sum;</para> 48 </listitem> 49 <listitem> 50 <para>Download size: &sgml-common-size;</para> 51 </listitem> 52 <listitem> 53 <para>Estimated disk space required: &sgml-common-buildsize;</para> 54 </listitem> 55 <listitem> 56 <para>Estimated build time: &sgml-common-time;</para> 43 <para> 44 Download (HTTP): <ulink url="&sgml-common-download-http;"/> 45 </para> 46 </listitem> 47 <listitem> 48 <para> 49 Download (FTP): <ulink url="&sgml-common-download-ftp;"/> 50 </para> 51 </listitem> 52 <listitem> 53 <para> 54 Download MD5 sum: &sgml-common-md5sum; 55 </para> 56 </listitem> 57 <listitem> 58 <para> 59 Download size: &sgml-common-size; 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Estimated disk space required: &sgml-common-buildsize; 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Estimated build time: &sgml-common-time; 70 </para> 57 71 </listitem> 58 72 </itemizedlist> … … 61 75 <itemizedlist spacing='compact'> 62 76 <listitem> 63 <para>Required patch: <ulink 64 url="&patch-root;/sgml-common-&sgml-common-version;-manpage-1.patch"/></para> 77 <para> 78 Required patch: <ulink url= 79 "&patch-root;/sgml-common-&sgml-common-version;-manpage-1.patch"/> 80 </para> 65 81 </listitem> 66 82 </itemizedlist> … … 74 90 <title>Installation of SGML Common</title> 75 91 76 <para>Instead of the normal convention of including the autotools files 92 <para> 93 Instead of the normal convention of including the autotools files 77 94 in the package, the maintainers included symlinks to the files in 78 95 <filename class="directory">/usr/share/automake</filename>. For previous … … 84 101 <filename>Makefile.am</filename> file uses a syntax not supported by 85 102 current versions of <application>Automake</application>, a patch is 86 required to fix the syntax.</para> 103 required to fix the syntax. 104 </para> 87 105 88 106 <screen><userinput>patch -Np1 -i ../sgml-common-0.6.3-manpage-1.patch && 89 107 autoreconf -f -i</userinput></screen> 90 108 91 <para>Install <application>SGML Common</application> by 92 running the following commands:</para> 109 <para> 110 Install <application>SGML Common</application> by 111 running the following commands: 112 </para> 93 113 94 114 <screen><userinput>./configure --prefix=/usr --sysconfdir=/etc && 95 115 make</userinput></screen> 96 116 97 <para>This package does not come with a test suite.</para> 98 99 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 117 <para> 118 This package does not come with a test suite. 119 </para> 120 121 <para> 122 Now, as the <systemitem class="username">root</systemitem> user: 123 </para> 100 124 101 125 <screen role="root"><userinput>make docdir=/usr/share/doc install && … … 110 134 <title>Update Hint</title> 111 135 112 <para>Remove the above catalog items prior to upgrading (as the 113 <systemitem class='username'>root</systemitem> user) with:</para> 136 <para> 137 Remove the above catalog items prior to upgrading (as the 138 <systemitem class='username'>root</systemitem> user) with: 139 </para> 114 140 115 141 <screen role="nodump"><userinput>install-catalog --remove /etc/sgml/sgml-ent.cat \ … … 129 155 <title>Config Files</title> 130 156 131 <para><filename>/etc/sgml/sgml.conf</filename></para> 157 <para> 158 <filename>/etc/sgml/sgml.conf</filename> 159 </para> 132 160 133 161 <indexterm zone="sgml-common sgml-common-config"> … … 140 168 <title>Configuration Information</title> 141 169 142 <para>No change in this file is necessary.</para> 170 <para> 171 No change in this file is necessary. 172 </para> 143 173 144 174 </sect3> … … 172 202 <term><command>install-catalog</command></term> 173 203 <listitem> 174 <para>creates a centralized catalog that maintains references to 175 catalogs scattered throughout the 176 <filename class="directory">/usr/share/sgml</filename> directory 177 tree.</para> 204 <para> 205 creates a centralized catalog that maintains references to 206 catalogs scattered throughout the 207 <filename class="directory">/usr/share/sgml</filename> directory 208 tree. 209 </para> 178 210 <indexterm zone="sgml-common install-catalog"> 179 211 <primary sortas="b-install-catalog">install-catalog</primary> … … 185 217 <term><command>sgmlwhich</command></term> 186 218 <listitem> 187 <para>will print to standard output the name of the main 188 configuration file.</para> 219 <para> 220 prints to standard output the name of the main configuration file. 221 </para> 189 222 <indexterm zone="sgml-common sgmlwhich"> 190 223 <primary sortas="b-sgmlwhich">sgmlwhich</primary> … … 196 229 <term><filename>SGML entities files</filename></term> 197 230 <listitem> 198 <para>contain the basic character entities defined with 199 SDATA entries.</para> 231 <para> 232 contains the basic character entities defined with SDATA entries. 233 </para> 200 234 <indexterm zone="sgml-common SGML-entities"> 201 235 <primary sortas="g-SGML-ENT-files">SGML entity files</primary> … … 207 241 <term><filename>XML entities files</filename></term> 208 242 <listitem> 209 <para> contain the basic character entities defined by a hexadecimal 210 representation of the Unicode character number.</para> 243 <para> 244 contains the basic character entities defined by a hexadecimal 245 representation of the Unicode character number. 246 </para> 211 247 <indexterm zone="sgml-common XML-entities"> 212 248 <primary sortas="g-XML-ENT-files">XML entity files</primary> -
pst/sgml/sgml.xml
r47274444 rfa3edfef 16 16 <title>Standard Generalized Markup Language (SGML)</title> 17 17 18 <para>This chapter contains DocBook SGML document type definitions (DTDs), 19 DocBook DSSSL Stylesheets and DocBook tools to validate, transform, format 20 and publish DocBook documents.</para> 18 <para> 19 This chapter contains DocBook SGML document type definitions (DTDs), 20 DocBook DSSSL Stylesheets and DocBook tools to validate, transform, format 21 and publish DocBook documents. 22 </para> 21 23 22 24 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sgml-common.xml"/> -
pst/typesetting/asymptote.xml
r47274444 rfa3edfef 159 159 href="../../xincludes/tex-prefix.xml"/> 160 160 161 <para><parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>: 162 This parameter ensures that the <filename class="directory">asymptote</filename> 163 directory will similarly overwrite any files installed by install-tl-unx.</para> 164 165 <para><parameter>--enable-gc=system</parameter>: this ensures that the system 166 version of <filename class="libraryfile">libgc.so</filename> will be used 167 instead of the version shipped with this package.</para> 168 169 <para><parameter>--with-latex= ... --with-context=</parameter>: These switches 170 ensure that style files and a tex file will be installed into the 171 <application>texlive</application> directories instead of creating a 172 <filename class="directory">texmf-local</filename> directory for them.</para> 161 <para> 162 <parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>: 163 This parameter ensures that the <filename 164 class="directory">asymptote</filename> directory will similarly 165 overwrite any files installed by install-tl-unx. 166 </para> 167 168 <para> 169 <parameter>--enable-gc=system</parameter>: this ensures that the system 170 version of <filename class="libraryfile">libgc.so</filename> will be used 171 instead of the version shipped with this package. 172 </para> 173 174 <para> 175 <parameter>--with-latex= ... --with-context=</parameter>: These switches 176 ensure that style files and a tex file will be installed into the 177 <application>texlive</application> directories instead of creating a 178 <filename class="directory">texmf-local</filename> directory for them. 179 </para> 173 180 174 181 <!-- commenting for now: 2.44 installs asymptote.info in both places -
pst/typesetting/biber.xml
r47274444 rfa3edfef 47 47 <title>Introduction to biber</title> 48 48 49 <para>Biber is a BibTeX replacement for users of biblatex, written in 50 <application>Perl</application>, with full Unicode support.</para> 49 <para> 50 Biber is a BibTeX replacement for users of biblatex, written in 51 <application>Perl</application>, with full Unicode support. 52 </para> 51 53 52 54 &lfs91_checked; … … 72 74 <itemizedlist spacing="compact"> 73 75 <listitem> 74 <para>Download (HTTP): <ulink url="&biber-download-http;"/></para> 75 </listitem> 76 <listitem> 77 <para>Download (FTP): <ulink url="&biber-download-ftp;"/></para> 78 </listitem> 79 <listitem> 80 <para>Download MD5 sum: &biber-md5sum;</para> 81 </listitem> 82 <listitem> 83 <para>Download size: &biber-size;</para> 84 </listitem> 85 <listitem> 86 <para>Estimated disk space required: &biber-buildsize;</para> 87 </listitem> 88 <listitem> 89 <para>Estimated build time: &biber-time;</para> 76 <para> 77 Download (HTTP): <ulink url="&biber-download-http;"/> 78 </para> 79 </listitem> 80 <listitem> 81 <para> 82 Download (FTP): <ulink url="&biber-download-ftp;"/> 83 </para> 84 </listitem> 85 <listitem> 86 <para> 87 Download MD5 sum: &biber-md5sum; 88 </para> 89 </listitem> 90 <listitem> 91 <para> 92 Download size: &biber-size; 93 </para> 94 </listitem> 95 <listitem> 96 <para> 97 Estimated disk space required: &biber-buildsize; 98 </para> 99 </listitem> 100 <listitem> 101 <para> 102 Estimated build time: &biber-time; 103 </para> 90 104 </listitem> 91 105 </itemizedlist> … … 106 120 --> 107 121 <para> 108 If you have updated to a new release of texlive-source, biber and its109 perl dependencies are still in present in <filename110 class="directory">/usr</filename> and do not need to be rebuilt. However,111 biblatex installs in <filename112 class="directory">/opt/texlive/&texlive-year;</filename> and does need to113 be reinstalled.122 If you have updated to a new release of texlive-source, biber and its 123 perl dependencies are still in present in <filename 124 class="directory">/usr</filename> and do not need to be rebuilt. 125 However, biblatex installs in <filename 126 class="directory">/opt/texlive/&texlive-year;</filename> and does 127 need to be reinstalled. 114 128 </para> 115 129 116 130 <para> 117 This version of biber requires <application>perl-5.30</application> or later.118 If you are still using the 8.4 version of BLFS you may wish to build the119 2.13 version: see the 8.4 book noting that biblatex-3.13 has been replaced by120 biblatex-3.13a upstream.131 This version of biber requires <application>perl-5.30</application> 132 or later. If you are still using the 8.4 version of BLFS you may 133 wish to build the 2.13 version: see the 8.4 book noting that 134 biblatex-3.13 has been replaced by biblatex-3.13a upstream. 121 135 </para> 122 136 </note> … … 126 140 <itemizedlist spacing="compact"> 127 141 <listitem> 128 <para>The corresponding version of <application>biblatex</application> is 129 a separate project - the tds tarball is pre-packaged for untarring into 130 the <filename class="directory">texmf-dist</filename> directory. 131 Download (HTTP): <ulink url="&biblatex-download-http;"/></para> 132 </listitem> 133 <listitem> 134 <para>Download MD5 sum: &biblatex-md5sum;</para> 135 </listitem> 136 <listitem> 137 <para>Download size: &biblatex-size;</para> 142 <para> 143 The corresponding version of <application>biblatex</application> is 144 a separate project - the tds tarball is pre-packaged for untarring 145 into the <filename class="directory">texmf-dist</filename> 146 directory. Download (HTTP): <ulink url="&biblatex-download-http;"/> 147 </para> 148 </listitem> 149 <listitem> 150 <para> 151 Download MD5 sum: &biblatex-md5sum; 152 </para> 153 </listitem> 154 <listitem> 155 <para> 156 Download size: &biblatex-size; 157 </para> 138 158 </listitem> 139 159 </itemizedlist> … … 195 215 <xref linkend="texlive"/> 196 216 (or <xref linkend="tl-installer"/>, but for that you can use 197 <command>tlmgr update 217 <command>tlmgr update</command>) 198 218 </para> 199 219 … … 208 228 It is possible to install all missing dependencies automatically. You 209 229 must first install <xref linkend="perl-module-build"/> using <xref 210 linkend="perl-auto-install"/>. then run <command>perl ./Build.PL</command>211 and when it prompts you, become the root user and run212 <command>./Build installdeps</command>230 linkend="perl-auto-install"/>. Then run <command>perl 231 ./Build.PL</command> and when it prompts you, become the root user 232 and run <command>./Build installdeps</command> 213 233 </para> 214 234 </note> … … 222 242 <title>Installation of Biber</title> 223 243 224 <para>Install <application>Biber</application> by running the following 225 commands:</para> 244 <para> 245 Install <application>Biber</application> by running the following 246 commands: 247 </para> 226 248 227 249 <screen><userinput>perl ./Build.PL && 228 250 ./Build</userinput></screen> 229 251 230 <para>To test the results, enter: <command>./Build test</command></para> 231 232 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 252 <para> 253 To test the results, enter: <command>./Build test</command> 254 </para> 255 256 <para> 257 Now, as the <systemitem class="username">root</systemitem> user: 258 </para> 233 259 234 260 <screen role="root"><userinput>tar -xf ../biblatex-&biblatex-version;.tds.tgz -C /opt/texlive/&texlive-year;/texmf-dist && … … 278 304 <term><command>biber</command></term> 279 305 <listitem> 280 <para>is used for producing bibliographies in LaTeX documents.</para> 306 <para> 307 is used for producing bibliographies in LaTeX documents. 308 </para> 281 309 <indexterm zone="biber biber-prog"> 282 310 <primary sortas="b-biber">biber</primary> -
pst/typesetting/tex-path.xml
r47274444 rfa3edfef 16 16 <title>Setting the PATH for TeX Live</title> 17 17 18 <para>Before starting to build TeX Live, set up your PATH so 18 <para> 19 Before starting to build TeX Live, set up your PATH so 19 20 that the system can properly find the files. If you set up your login 20 21 scripts as recommended in <xref linkend='postlfs-config-profile'/>, update … … 23 24 installed in an <ARCH>-linux subdirectory and on 32-bit x86 this is 24 25 always i386-linux. For x86_64 and i?86 we can generate this as $TEXARCH: 25 26 </para> 26 27 27 28 <!-- EOF should NOT be in double quotes, we want it to evaluate $TEXARCH --> … … 43 44 unset TEXARCH</userinput></screen> 44 45 45 <!-- commented, they have been removed46 <note><para>The standard MANPATH and INFOPATH path are specified above to47 ensure they are included. If they are already set in the boot script48 procedure, the pathappend function will ensure duplicates are49 removed, so including them here will do no harm.</para></note> -->50 46 51 <para>The new paths can be immediately activated by running <command>source 52 /etc/profile</command>.</para> 47 <note> 48 <para> 49 The standard MANPATH and INFOPATH path are specified above to 50 ensure they are included. If they are already set in the boot script 51 procedure, the pathappend function will ensure duplicates are 52 removed, so including them here will do no harm. 53 </para> 54 </note> 53 55 54 <para>You should now proceed either to <xref linkend="tl-installer"/> for 56 <para> 57 The new paths can be immediately activated by running <command>source 58 /etc/profile</command>. 59 </para> 60 61 <para> 62 You should now proceed either to <xref linkend="tl-installer"/> for 55 63 a binary installation of texlive, or to <xref linkend="texlive"/> to begin 56 installing from source.</para> 64 installing from source. 65 </para> 57 66 58 67 </sect1> -
pst/typesetting/texlive.xml
r47274444 rfa3edfef 38 38 <title>Introduction to TeX Live from source</title> 39 39 40 <para>Most of TeX Live can be built from source without a pre-existing 41 installation, but <application>xindy</application> (for indexing) needs 42 working versions of <command>latex</command> and <command>pdflatex</command> 43 when configure is run, and the testsuite and install for 44 <command>asy</command> (for vector graphics) will fail if TeX has not 45 already been installed. Additionally, <application>biber</application> is 46 not provided within the <application>texlive</application> source.</para> 47 48 <para>All of those packages are dealt with on their own pages and can be 49 built after installing this package. If you have not already done so, you 50 should start at <xref linkend="tex-path"/> so that the final commands to 51 initialise the new installation will be found.</para> 40 <para> 41 Most of TeX Live can be built from source without a pre-existing 42 installation, but <application>xindy</application> (for indexing) needs 43 working versions of <command>latex</command> and 44 <command>pdflatex</command> when configure is run, and the testsuite 45 and install for <command>asy</command> (for vector graphics) will fail 46 if TeX has not already been installed. Additionally, 47 <application>biber</application> is not provided within the 48 <application>texlive</application> source. 49 </para> 50 51 <para> 52 All of those packages are dealt with on their own pages and can be 53 built after installing this package. If you have not already done so, you 54 should start at <xref linkend="tex-path"/> so that the final commands to 55 initialise the new installation will be found. 56 </para> 52 57 53 58 &lfs91_checked; … … 56 61 <itemizedlist spacing="compact"> 57 62 <listitem> 58 <para>Download (HTTP): <ulink url="&texlive-download-http;"/></para> 59 </listitem> 60 <listitem> 61 <para>Download (FTP): <ulink url="&texlive-download-ftp;"/></para> 62 </listitem> 63 <listitem> 64 <para>Download MD5 sum: &texlive-md5sum;</para> 65 </listitem> 66 <listitem> 67 <para>Download size: &texlive-size;</para> 68 </listitem> 69 <listitem> 70 <para>Estimated disk space required: &texlive-buildsize;</para> 71 </listitem> 72 <listitem> 73 <para>Estimated build time: &texlive-time;</para> 63 <para> 64 Download (HTTP): <ulink url="&texlive-download-http;"/> 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Download (FTP): <ulink url="&texlive-download-ftp;"/> 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 Download MD5 sum: &texlive-md5sum; 75 </para> 76 </listitem> 77 <listitem> 78 <para> 79 Download size: &texlive-size; 80 </para> 81 </listitem> 82 <listitem> 83 <para> 84 Estimated disk space required: &texlive-buildsize; 85 </para> 86 </listitem> 87 <listitem> 88 <para> 89 Estimated build time: &texlive-time; 90 </para> 74 91 </listitem> 75 92 </itemizedlist> … … 77 94 <bridgehead renderas="sect3">Required Additional Downloads</bridgehead> 78 95 79 <para>Much of the texlive environment (including scripts, documentation, 80 fonts and various other files) is not part of the source tarball. You must 81 download it separately. This will give you all of the additional files 82 which are provided by a full install of the binary version, there is no 83 realistic way to restrict which parts get installed.</para> 96 <para> 97 Much of the texlive environment (including scripts, documentation, 98 fonts, and various other files) is not part of the source tarball. 99 You must download it separately. This will give you all of the 100 additional files which are provided by a full install of the binary 101 version, there is no realistic way to restrict which parts get 102 installed. 103 </para> 84 104 85 105 <para> … … 91 111 <itemizedlist spacing="compact"> 92 112 <listitem> 93 <para>Download (HTTP): <ulink url="&texlive-texmf-download-http;"/></para> 94 </listitem> 95 <listitem> 96 <para>Download (FTP): <ulink url="&texlive-texmf-download-ftp;"/></para> 97 </listitem> 98 <listitem> 99 <para>Download MD5 sum: &texlive-texmf-md5sum;</para> 100 </listitem> 101 <listitem> 102 <para>Download size: &texlive-texmf-size;</para> 103 </listitem> 104 <listitem> 105 <para>Required patch: <ulink 106 url="&patch-root;/texlive-&texlive-version;-source-upstream_fixes-1.patch"/></para> 113 <para> 114 Download (HTTP): <ulink url="&texlive-texmf-download-http;"/> 115 </para> 116 </listitem> 117 <listitem> 118 <para> 119 Download (FTP): <ulink url="&texlive-texmf-download-ftp;"/> 120 </para> 121 </listitem> 122 <listitem> 123 <para> 124 Download MD5 sum: &texlive-texmf-md5sum; 125 </para> 126 </listitem> 127 <listitem> 128 <para> 129 Download size: &texlive-texmf-size; 130 </para> 131 </listitem> 132 <listitem> 133 <para> 134 Required patch: <ulink url= 135 "&patch-root;/texlive-&texlive-version;-source-upstream_fixes-1.patch"/> 136 </para> 107 137 </listitem> 108 138 </itemizedlist> … … 114 144 <xref linkend="gs"/> <emphasis>including 115 145 <filename>libgs.so</filename></emphasis>, <!--(for dvisvgm, which is used by e.g. 116 <xref role="nodep" linkend="asymptote"/>) , :still referenced for dynamic loading,146 <xref role="nodep" linkend="asymptote"/>); still referenced for dynamic loading, 117 147 even without dvisvgm - e.fg. by dvipsk --> 118 148 <xref linkend="x-window-system"/> … … 152 182 </para> 153 183 154 <para>The shared libraries will be installed into a texlive directory. 155 As the <systemitem class="username">root</systemitem> user, add it to 156 your <filename>/etc/ld.so.conf</filename>:</para> 184 <para> 185 The shared libraries will be installed into a texlive directory. 186 As the <systemitem class="username">root</systemitem> user, add it to 187 your <filename>/etc/ld.so.conf</filename>: 188 </para> 157 189 158 190 <screen role="root"><userinput>cat >> /etc/ld.so.conf << EOF … … 171 203 </para> 172 204 173 <!--174 <para>175 If you came here to update an old system (because of the recent176 vulnerability) where the poppler version is before 0.62.0, such as177 BLFS-8.1, do NOT use the commands in the <literal>MYPOPPLER</literal>178 block of instructions, nor the <literal>\-\-with-system-poppler</literal>179 or <literal>\-\-with-system-xpdf</literal> options when configuring.180 </para>-->181 182 205 <para> 183 206 In the 2019 release, <application>dvisvgm</application> cannot be built 184 if shared system libraries are used. This means that <xref linkend="asymptote"/>185 will not be able to create svg files.207 if shared system libraries are used. This means that 208 <xref linkend="asymptote"/> will not be able to create svg files. 186 209 </para> 187 210 </note> … … 193 216 194 217 patch -Np1 -i ../texlive-&texlive-version;-source-upstream_fixes-1.patch && 195 <!-- 196 let MYPOPPLER=$(pkg-config \-\-modversion poppler | cut -d '.' -f2) 197 mv -v texk/web2c/pdftexdir/pdftosrc{-newpoppler,}.cc 198 if [ $MYPOPPLER -lt 68 ]; then 199 mv -v texk/web2c/pdftexdir/pdftoepdf{-newpoppler,}.cc 200 elif [ $MYPOPPLER -lt 69 ]; then 201 mv -v texk/web2c/pdftexdir/pdftoepdf{-poppler0.68.0,}.cc 202 else 203 mv -v texk/web2c/pdftexdir/pdftoepdf{-poppler0.69.0,}.cc 204 fi && 205 unset MYPOPPLER &&--> 218 206 219 mkdir texlive-build && 207 220 cd texlive-build && … … 240 253 make</userinput></screen> 241 254 242 <para>To test the results, issue: <command>make check</command> 243 A few tests may SKIP because kpathsea 244 has not yet been installed.</para> 245 246 <para>Now, as the <systemitem class="username">root</systemitem> 247 user:</para> 255 <para> 256 To test the results, issue: <command>make check</command> 257 A few tests may SKIP because kpathsea 258 has not yet been installed. 259 </para> 260 261 <para> 262 Now, as the <systemitem class="username">root</systemitem> user: 263 </para> 248 264 249 265 <!-- Editors, you can run 'make texlinks' in a DESTDIR by passing … … 263 279 </note> 264 280 265 <para>Now install the additional files as the 266 <systemitem class="username">root</systemitem> user:</para> 281 <para> 282 Now install the additional files as the 283 <systemitem class="username">root</systemitem> user: 284 </para> 267 285 268 286 <!-- if texmf does not need to be patched, remove && from first line, … … 270 288 <screen role="root"><userinput>tar -xf ../../texlive-&texmf-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</userinput></screen> 271 289 272 <para>Still as the <systemitem class="username">root</systemitem> user, 273 initialise the new system (the commands <command>fmtutil-sys --all</command> 274 and <command>mtxrun --generate</command> will produce a 275 <emphasis>lot</emphasis> of output):</para> 290 <para> 291 Still as the <systemitem class="username">root</systemitem> user, 292 initialise the new system (the commands <command>fmtutil-sys 293 --all</command> and <command>mtxrun --generate</command> will produce 294 a <emphasis>lot</emphasis> of output): 295 </para> 276 296 277 297 <!-- Editors, fmtutil-sys and mtxrun \-\-generate can apparently only be run on … … 283 303 mtxrun --generate</userinput></screen> 284 304 285 <para>You can now proceed to <xref linkend="asymptote"/>, 286 <xref linkend="biber"/> and / or <xref linkend="xindy"/> if you 287 wish to install them.</para> 305 <para> 306 You can now proceed to <xref linkend="asymptote"/>, 307 <xref linkend="biber"/> and / or <xref linkend="xindy"/> if you 308 wish to install them. 309 </para> 288 310 289 311 </sect2> … … 336 358 337 359 <para> 338 <command>/sbin/ldconfig</command>: this has to be run here so that <command>make339 texlinks</command> can use kpsewhich.360 <command>/sbin/ldconfig</command>: this has to be run here so that 361 <command>make texlinks</command> can use kpsewhich. 340 362 </para> 341 363 -
pst/typesetting/tl-installer.xml
r47274444 rfa3edfef 33 33 <title>Introduction to TeX Live and its installer</title> 34 34 35 <para>The <application>TeX Live</application> package is a comprehensive 36 TeX document production system. It includes TeX, LaTeX2e, ConTeXt, 37 Metafont, MetaPost, BibTeX and many other programs; an extensive collection 38 of macros, fonts and documentation; and support for typesetting in many 39 different scripts from around the world.</para> 40 41 <para>This page is for people who wish to use the binary installer to 42 provide the programs, the scripts, and a lot of supporting files and 43 documentation. The installer is updated frequently, so its md5sum will 44 change if it is newer than what is shown below. Newer versions of the 45 installer are expected to work with these instructions, for so long as they 46 install to a 47 <filename class="directory">&texlive-year;/</filename> directory.</para> 35 <para> 36 The <application>TeX Live</application> package is a comprehensive 37 TeX document production system. It includes TeX, LaTeX2e, ConTeXt, 38 Metafont, MetaPost, BibTeX and many other programs; an extensive 39 collection of macros, fonts and documentation; and support for 40 typesetting in many different scripts from around the world. 41 </para> 42 43 <para> 44 This page is for people who wish to use the binary installer to 45 provide the programs, the scripts, and a lot of supporting files and 46 documentation. The installer is updated frequently, so its md5sum will 47 change if it is newer than what is shown below. Newer versions of the 48 installer are expected to work with these instructions, for so long as 49 they install to a 50 <filename class="directory">&texlive-year;/</filename> directory. 51 </para> 48 52 49 53 <para> … … 63 67 <itemizedlist spacing="compact"> 64 68 <listitem> 65 <para>Download (HTTP): <ulink url="&tl-installer-download-http;"/></para> 66 </listitem> 67 <listitem> 68 <para>Download (FTP): <ulink url="&tl-installer-download-ftp;"/></para> 69 </listitem> 70 <listitem> 71 <para>Download MD5 sum: &tl-installer-md5sum; (for &tl-installer-date;)</para> 72 </listitem> 73 <listitem> 74 <para>Download size: &tl-installer-size;</para> 75 </listitem> 76 <listitem> 77 <para>Estimated disk space required: &tl-installer-buildsize;</para> 78 </listitem> 79 <listitem> 80 <para>Estimated build time: &tl-installer-time;</para> 69 <para> 70 Download (HTTP): <ulink url="&tl-installer-download-http;"/> 71 </para> 72 </listitem> 73 <listitem> 74 <para> 75 Download (FTP): <ulink url="&tl-installer-download-ftp;"/> 76 </para> 77 </listitem> 78 <listitem> 79 <para> 80 Download MD5 sum: &tl-installer-md5sum; (for &tl-installer-date;) 81 </para> 82 </listitem> 83 <listitem> 84 <para> 85 Download size: &tl-installer-size; 86 </para> 87 </listitem> 88 <listitem> 89 <para> 90 Estimated disk space required: &tl-installer-buildsize; 91 </para> 92 </listitem> 93 <listitem> 94 <para> 95 Estimated build time: &tl-installer-time; 96 </para> 81 97 </listitem> 82 98 </itemizedlist> … … 119 135 <xref linkend="freeglut"/>. 120 136 </para> 121 <para> 122 As always with contributed binary software, it is possible that the required 123 dependencies may change when the installer is updated. In particular, these 124 dependencies have only been checked on x86_64. 125 </para> 137 <note> 138 <para> 139 As always with contributed binary software, it is possible that the 140 required dependencies may change when the installer is updated. In 141 particular, these dependencies have only been checked on x86_64. 142 </para> 143 </note> 126 144 <!-- text for runtime deps, shared with texlive --> 127 145 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" … … 136 154 <title>Binary Installation of TeX Live</title> 137 155 138 <para>The <application>TeX Live</application> set of programs with its 139 supporting documents, fonts, and utilities is very large. The upstream 140 maintainers recommend placing all files in a single directory structure. 141 BLFS recommends <filename class='directory'>/opt/texlive</filename>.</para> 142 143 <para>As with any other package, unpack the installer and change into its 144 directory, <filename class='directory'>install-tl-<CCYYMMDD></filename>. 145 This directory name changes when the installer is updated, so replace 146 <CCYYMMDD> by the correct directory name.</para> 156 <para> 157 The <application>TeX Live</application> set of programs with its 158 supporting documents, fonts, and utilities is very large. The upstream 159 maintainers recommend placing all files in a single directory structure. 160 BLFS recommends <filename class='directory'>/opt/texlive</filename>. 161 </para> 162 163 <para> 164 As with any other package, unpack the installer and change into its 165 directory, <filename class='directory'> 166 install-tl-<CCYYMMDD></filename>. 167 This directory name changes when the installer is updated, so replace 168 <CCYYMMDD> by the correct directory name. 169 </para> 147 170 148 171 <note> 149 <para>150 The distribution binaries installed below may use static linking151 for general linux system libraries. Additional libraries or interpreters152 as specified in the dependencies section do not need to be present during153 the install, but the programs that need them will not run until their154 specific dependencies have been installed.155 </para>172 <para> 173 The distribution binaries installed below may use static linking 174 for general linux system libraries. Additional libraries or 175 interpreters as specified in the dependencies section do not need to 176 be present during the install, but the programs that need them will 177 not run until their specific dependencies have been installed. 178 </para> 156 179 157 180 <!-- please keep something like this in the future --> 158 <para>159 With all contributed binary software, there may be a mismatch between the160 builder's toolchain and your hardware. In most of TeX this will probably161 not matter, but in uncommon corner cases you might hit problems.162 e.g. if your x86_64 processor does not support 3dnowext or 3dnow, the163 2014-06-28 binary failed in conTeXt when running LuaTeX, although lualatex164 worked, as did the i686 binaries on the same machine. In such cases, the165 easiest solution is to install texlive from source. Similarly, the x86_64166 binary version of <command>asy</command> runs very slowly when creating 3-D167 diagrams.168 </para>181 <para> 182 With all contributed binary software, there may be a mismatch between 183 the builder's toolchain and your hardware. In most of TeX this will 184 probably not matter, but in uncommon corner cases you might hit 185 problems. e.g. if your x86_64 processor does not support 3dnowext or 186 3dnow, the 2014-06-28 binary failed in conTeXt when running LuaTeX, 187 although lualatex worked, as did the i686 binaries on the same 188 machine. In such cases, the easiest solution is to install texlive 189 from source. Similarly, the x86_64 binary version of 190 <command>asy</command> runs very slowly when creating 3-D diagrams. 191 </para> 169 192 </note> 170 193 171 <para>Now, as the <systemitem class="username">root</systemitem> 172 user:</para> 194 <para> 195 Now, as the <systemitem class="username">root</systemitem> user: 196 </para> 173 197 174 198 <screen role="root"><userinput>TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl</userinput></screen> 175 199 176 <para>This command is interactive and allows selection or modification of 177 platform, packages, directories, and other options. The full installation 178 scheme will require about 4.9 gigabytes of disk space. The time to complete 179 the download will depend on your internet connection speed and the 180 number of packages selected.</para> 200 <para> 201 This command is interactive and allows selection or modification of 202 platform, packages, directories, and other options. The full installation 203 scheme will require about 4.9 gigabytes of disk space. The time to 204 complete the download will depend on your internet connection speed 205 and the number of packages selected. 206 </para> 181 207 182 208 </sect2> -
pst/typesetting/typesetting.xml
r47274444 rfa3edfef 16 16 <title>Typesetting</title> 17 17 18 <para>This chapter includes <application>texlive</application> applications that 19 create output equivalent to typesetting.</para> 20 21 <para>There are two alternative routes through this chapter:</para> 22 23 <para>Some people may wish to use the binary installer, either because of the 24 complexity of installing all of <application>texlive</application> from 25 source, or because they only want a part of the package, or perhaps because 26 they wish to get updates as soon as those are available (the source is only 27 updated annually, but the binaries and associated tex and sty files are updated 28 for approximately 10 months). These people should begin at <xref 29 linkend="tex-path"/> and then follow the <xref linkend="tl-installer"/> 30 instructions,. After installing, they can run 31 <command>tlmgr</command> to update their system.</para> 32 33 <para>Most people reading BLFS will wish to build from source. BLFS used to 34 start by installing <application>install-tl-unx</application> and then use that 35 to bootstrap the build. Nowadays, we build almost the whole of 36 <application>texlive</application> <emphasis>without</emphasis> a binary install, 37 by adding the separately-packaged texmf files into this build. For this, begin 38 at <xref linkend="tex-path"/> then go to <xref linkend="texlive"/> which will 39 install most of 40 <application>texlive</application>, together with <emphasis>all</emphasis> of the 41 supporting files. This almost-complete install can then be used to build the 42 remaining parts of <application>texlive</application>: <xref 43 linkend="asymptote"/>, <xref linkend="biber"/> and <xref linkend="xindy"/>. 18 <para> 19 This chapter includes <application>texlive</application> applications that 20 create output equivalent to typesetting. 44 21 </para> 45 22 46 <para>Because the texmf files (including documentation, fonts, scripts and 47 supporting files) are all in one tarball, it is not practical to limit what 48 gets extracted in a sensible way (you could exclude one or other of the 49 typesetting engines, not its many supporting files) when building from source 50 in this manner.</para> 23 <para> 24 There are two alternative routes through this chapter: 25 </para> 51 26 52 <para>In either case, BLFS installs into 53 <filename class="directory">/opt/texlive/&texlive-year;</filename>.</para> 27 <para> 28 Some people may wish to use the binary installer, either because of the 29 complexity of installing all of <application>texlive</application> from 30 source, or because they only want a part of the package, or perhaps because 31 they wish to get updates as soon as those are available (the source is only 32 updated annually, but the binaries and associated tex and sty files are 33 updated for approximately 10 months). These people should begin at <xref 34 linkend="tex-path"/> and then follow the <xref linkend="tl-installer"/> 35 instructions. After installing, they can run <command>tlmgr</command> to 36 update their system. 37 </para> 54 38 55 <para>Also, please note that texlive is released annually, and updating from the 56 previous year to the current year is no longer supported. If for some reason 57 you wish to keep versions for multiple years, for most things you can mount the 58 old or new system at /opt/texlive and fix up your PATH as necessary. However 59 doing that will not preserve any changes in <filename 60 class="directory">texmf-local</filename> and if you build from source and try to 61 run a newer version of <application>biber</application> with an older version of 62 <application>biblatex</application> it is unlikely to work.</para> 39 <para> 40 Most people reading BLFS will wish to build from source. BLFS used to 41 start by installing <application>install-tl-unx</application> and then 42 use that to bootstrap the build. Nowadays, we build almost the whole 43 of <application>texlive</application> <emphasis>without</emphasis> a 44 binary install, by adding the separately-packaged texmf files into this 45 build. For this, begin at <xref linkend="tex-path"/> then go to <xref 46 linkend="texlive"/> which will install most of 47 <application>texlive</application>, together with <emphasis>all</emphasis> 48 of the supporting files. This almost-complete install can then be used 49 to build the remaining parts of <application>texlive</application>: 50 <xref linkend="asymptote"/>, <xref linkend="biber"/> and <xref 51 linkend="xindy"/>. 52 </para> 53 54 <para> 55 Because the texmf files (including documentation, fonts, scripts and 56 supporting files) are all in one tarball, it is not practical to limit what 57 gets extracted in a sensible way (you could exclude one or other of the 58 typesetting engines, not its many supporting files) when building from 59 source in this manner. 60 </para> 61 62 <para> 63 In either case, BLFS installs into 64 <filename class="directory">/opt/texlive/&texlive-year;</filename>. 65 </para> 66 67 <para> 68 Also, please note that texlive is released annually, and updating from the 69 previous year to the current year is no longer supported. If for some 70 reason you wish to keep versions for multiple years, for most things 71 you can mount the old or new system at /opt/texlive and fix up your 72 PATH as necessary. However doing that will not preserve any changes in 73 <filename class="directory">texmf-local</filename> and if you build 74 from source and try to run a newer version of 75 <application>biber</application> with an older version of 76 <application>biblatex</application> it is unlikely to work. 77 </para> 63 78 64 79 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="tex-path.xml"/> -
pst/typesetting/xindy.xml
r47274444 rfa3edfef 78 78 <itemizedlist spacing="compact"> 79 79 <listitem> 80 <para>Required patch: <ulink 81 url="&patch-root;/xindy-&xindy-version;-upstream_fixes-1.patch"/></para> 80 <para> 81 Required patch: <ulink 82 url="&patch-root;/xindy-&xindy-version;-upstream_fixes-1.patch"/> 83 </para> 82 84 </listitem> 83 85 </itemizedlist> … … 165 167 href="../../xincludes/tex-prefix.xml"/> 166 168 167 <para><parameter>--includedir=/usr/include</parameter>: 168 This parameter ensures that the <filename>kpathsea</filename> 169 headers from <xref linkend="texlive"/> will be found.</para> 169 <para> 170 <parameter>--includedir=/usr/include</parameter>: 171 This parameter ensures that the <filename>kpathsea</filename> 172 headers from <xref linkend="texlive"/> will be found. 173 </para> 170 174 171 175 <para> -
pst/xml/docbook.xml
r47274444 rfa3edfef 30 30 <title>Introduction to DocBook XML DTD</title> 31 31 32 <para>The <application>DocBook XML DTD</application>-&DocBook-version; 33 package contains document type definitions for verification of XML data 34 files against the DocBook rule set. These are useful for structuring books 35 and software documentation to a standard allowing you to utilize 36 transformations already written for that standard.</para> 32 <para> 33 The <application>DocBook XML DTD</application>-&DocBook-version; 34 package contains document type definitions for verification of XML data 35 files against the DocBook rule set. These are useful for structuring 36 books and software documentation to a standard allowing you to utilize 37 transformations already written for that standard. 38 </para> 37 39 38 40 &lfs91_checked; … … 41 43 <itemizedlist spacing="compact"> 42 44 <listitem> 43 <para>Download (HTTP): <ulink url="&DocBook-download-http;"/></para> 44 </listitem> 45 <listitem> 46 <para>Download (FTP): <ulink url="&DocBook-download-ftp;"/></para> 47 </listitem> 48 <listitem> 49 <para>Download MD5 sum: &DocBook-md5sum;</para> 50 </listitem> 51 <listitem> 52 <para>Download size: &DocBook-size;</para> 53 </listitem> 54 <listitem> 55 <para>Estimated disk space required: &DocBook-buildsize;</para> 56 </listitem> 57 <listitem> 58 <para>Estimated build time: &DocBook-time;</para> 45 <para> 46 Download (HTTP): <ulink url="&DocBook-download-http;"/> 47 </para> 48 </listitem> 49 <listitem> 50 <para> 51 Download (FTP): <ulink url="&DocBook-download-ftp;"/> 52 </para> 53 </listitem> 54 <listitem> 55 <para> 56 Download MD5 sum: &DocBook-md5sum; 57 </para> 58 </listitem> 59 <listitem> 60 <para> 61 Download size: &DocBook-size; 62 </para> 63 </listitem> 64 <listitem> 65 <para> 66 Estimated disk space required: &DocBook-buildsize; 67 </para> 68 </listitem> 69 <listitem> 70 <para> 71 Estimated build time: &DocBook-time; 72 </para> 59 73 </listitem> 60 74 </itemizedlist> … … 80 94 href="../../xincludes/use-unzip.xml"/> 81 95 82 <para>Install <application>DocBook XML DTD</application> by running the 83 following commands as the <systemitem class="username">root</systemitem> 84 user:</para> 96 <para> 97 Install <application>DocBook XML DTD</application> by running the 98 following commands as the <systemitem class="username">root</systemitem> 99 user: 100 </para> 85 101 86 102 <screen role="root"><userinput>install -v -d -m755 /usr/share/xml/docbook/xml-dtd-&DocBook-version; && … … 90 106 /usr/share/xml/docbook/xml-dtd-&DocBook-version;</userinput></screen> 91 107 92 <para>Create (or update) and populate the 93 <filename>/etc/xml/docbook</filename> catalog file by running the following 94 commands as the <systemitem class="username">root</systemitem> user:</para> 108 <para> 109 Create (or update) and populate the <filename>/etc/xml/docbook</filename> 110 catalog file by running the following 111 commands as the <systemitem class="username">root</systemitem> user: 112 </para> 95 113 96 114 <screen role="root"><?dbfo keep-together="auto"?><userinput>if [ ! -e /etc/xml/docbook ]; then … … 142 160 /etc/xml/docbook</userinput></screen> 143 161 144 <para>Create (or update) and populate the 145 <filename>/etc/xml/catalog</filename> catalog file by running the following 146 commands as the <systemitem class="username">root</systemitem> user:</para> 162 <para> 163 Create (or update) and populate the 164 <filename>/etc/xml/catalog</filename> catalog file by running the 165 following commands as the <systemitem class="username">root</systemitem> 166 user: 167 </para> 147 168 148 169 <screen role="root"><userinput>if [ ! -e /etc/xml/catalog ]; then … … 174 195 <title>Config Files</title> 175 196 176 <para><filename>/etc/xml/catalog</filename>, 177 <filename>/etc/xml/docbook</filename></para> 197 <para> 198 <filename>/etc/xml/catalog</filename> and 199 <filename>/etc/xml/docbook</filename> 200 </para> 178 201 179 202 <indexterm zone="DocBook docbook-config"> … … 190 213 <title>Configuration Information</title> 191 214 192 <para>The above installation creates the files and updates the catalogs. 193 In order to 194 utilize <application>DocBook XML DTD</application> V&DocBook-version; 195 when any version 4.x is requested in the System Identifier, you need to 196 add additional statements to the catalog files. If you have any of the 197 <application>DocBook XML DTD</application>'s referenced below already 198 installed on your system, remove those entries from the 199 <command>for</command> command below (issue the commands as the 200 <systemitem class="username">root</systemitem> user):</para> 215 <para> 216 The above installation creates the files and updates the catalogs. 217 In order to utilize <application>DocBook XML DTD</application> 218 V&DocBook-version; when any version 4.x is requested in the System 219 Identifier, you need to add additional statements to the catalog 220 files. If you have any of the <application>DocBook XML 221 DTD</application>'s referenced below already installed on your 222 system, remove those entries from the <command>for</command> command 223 below (issue the commands as the <systemitem 224 class="username">root</systemitem> user): 225 </para> 201 226 202 227 <screen role="root"><userinput>for DTDVERSION in 4.1.2 4.2 4.3 4.4 … … 253 278 <term><filename>DTD files</filename></term> 254 279 <listitem> 255 <para>contain a document type definition which defines the element 256 types and the attribute lists that can be used in the corresponding 257 <filename>XML</filename> files.</para> 280 <para> 281 contain a document type definition which defines the element 282 types and the attribute lists that can be used in the corresponding 283 <filename>XML</filename> files. 284 </para> 258 285 <indexterm zone="DocBook DTD-files"> 259 286 <primary sortas="g-XML-DTD-files">XML DTD Files</primary> … … 265 292 <term><filename>MOD files</filename></term> 266 293 <listitem> 267 <para>files contain components of the document type definition that 268 are sourced into the <filename>DTD</filename> files.</para> 294 <para> 295 contain components of the document type definition that 296 are sourced into the <filename>DTD</filename> files. 297 </para> 269 298 <indexterm zone="DocBook MOD-files"> 270 299 <primary sortas="g-XML-MOD-files">XML MOD files</primary> … … 276 305 <term><filename>ENT files</filename></term> 277 306 <listitem> 278 <para>files contain lists of named character entities allowed in 279 HTML.</para> 307 <para> 308 contain lists of named character entities allowed in HTML. 309 </para> 280 310 <indexterm zone="DocBook ENT-files"> 281 311 <primary sortas="g-XML-ENT-files">XML entity files</primary> -
pst/xml/docbook5.xml
r47274444 rfa3edfef 45 45 <itemizedlist spacing="compact"> 46 46 <listitem> 47 <para>Download (HTTP): <ulink url="&docbook5-download-http;"/></para> 48 </listitem> 49 <listitem> 50 <para>Download (FTP): <ulink url="&docbook5-download-ftp;"/></para> 51 </listitem> 52 <listitem> 53 <para>Download MD5 sum: &docbook5-md5sum;</para> 54 </listitem> 55 <listitem> 56 <para>Download size: &docbook5-size;</para> 57 </listitem> 58 <listitem> 59 <para>Estimated disk space required: &docbook5-buildsize;</para> 60 </listitem> 61 <listitem> 62 <para>Estimated build time: &docbook5-time;</para> 47 <para> 48 Download (HTTP): <ulink url="&docbook5-download-http;"/> 49 </para> 50 </listitem> 51 <listitem> 52 <para> 53 Download (FTP): <ulink url="&docbook5-download-ftp;"/> 54 </para> 55 </listitem> 56 <listitem> 57 <para> 58 Download MD5 sum: &docbook5-md5sum; 59 </para> 60 </listitem> 61 <listitem> 62 <para> 63 Download size: &docbook5-size; 64 </para> 65 </listitem> 66 <listitem> 67 <para> 68 Estimated disk space required: &docbook5-buildsize; 69 </para> 70 </listitem> 71 <listitem> 72 <para> 73 Estimated build time: &docbook5-time; 74 </para> 63 75 </listitem> 64 76 </itemizedlist> … … 318 330 <title>Config Files</title> 319 331 320 <para><filename>/etc/xml/catalog</filename>, 321 <filename>/etc/xml/docbook-5.0</filename></para> 332 <para> 333 <filename>/etc/xml/catalog</filename> and 334 <filename>/etc/xml/docbook-5.0</filename> 335 </para> 322 336 323 337 <indexterm zone="docbook5 docbook-config"> … … 381 395 <term><filename>XSD files</filename></term> 382 396 <listitem> 383 <para>files contain DocBook-5.0 Schematron rules.</para> 397 <para> 398 files contain DocBook-5.0 Schematron rules. 399 </para> 384 400 <indexterm zone="docbook5 XSD5-files"> 385 401 <primary sortas="g-XML-XSD5-files">XML Schematron rules</primary> -
pst/xml/docbook51.xml
r47274444 rfa3edfef 43 43 <itemizedlist spacing="compact"> 44 44 <listitem> 45 <para>Download (HTTP): <ulink url="&docbook51-download-http;"/></para> 46 </listitem> 47 <listitem> 48 <para>Download (FTP): <ulink url="&docbook51-download-ftp;"/></para> 49 </listitem> 50 <listitem> 51 <para>Download MD5 sum: &docbook51-md5sum;</para> 52 </listitem> 53 <listitem> 54 <para>Download size: &docbook51-size;</para> 55 </listitem> 56 <listitem> 57 <para>Estimated disk space required: &docbook51-buildsize;</para> 58 </listitem> 59 <listitem> 60 <para>Estimated build time: &docbook51-time;</para> 45 <para> 46 Download (HTTP): <ulink url="&docbook51-download-http;"/> 47 </para> 48 </listitem> 49 <listitem> 50 <para> 51 Download (FTP): <ulink url="&docbook51-download-ftp;"/> 52 </para> 53 </listitem> 54 <listitem> 55 <para> 56 Download MD5 sum: &docbook51-md5sum; 57 </para> 58 </listitem> 59 <listitem> 60 <para> 61 Download size: &docbook51-size; 62 </para> 63 </listitem> 64 <listitem> 65 <para> 66 Estimated disk space required: &docbook51-buildsize; 67 </para> 68 </listitem> 69 <listitem> 70 <para> 71 Estimated build time: &docbook51-time; 72 </para> 61 73 </listitem> 62 74 </itemizedlist> … … 233 245 <title>Config Files</title> 234 246 235 <para><filename>/etc/xml/catalog</filename>, 236 <filename>/etc/xml/docbook-5.1</filename></para> 247 <para> 248 <filename>/etc/xml/catalog</filename> and 249 <filename>/etc/xml/docbook-5.1</filename> 250 </para> 237 251 238 252 <indexterm zone="docbook51 docbook-config"> -
pst/xml/xml.xml
r47274444 rfa3edfef 16 16 <title>Extensible Markup Language (XML)</title> 17 17 18 <para>This chapter contains the DocBook XML document type definition 19 (DTD) and DocBook Stylesheets which are used to validate, transform, 20 format and publish DocBook documents.</para> 18 <para> 19 This chapter contains the DocBook XML document type definition 20 (DTD) and DocBook Stylesheets which are used to validate, transform, 21 format and publish DocBook documents. 22 </para> 21 23 22 24 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook.xml"/> -
pst/xml/xmlto.xml
r47274444 rfa3edfef 30 30 <title>Introduction to xmlto</title> 31 31 32 <para>The <application>xmlto</application> package is a front-end to a XSL 33 toolchain. It chooses an appropriate stylesheet for the conversion you want 34 and applies it using an external XSLT processor. It also performs any 35 necessary post-processing.</para> 32 <para> 33 The <application>xmlto</application> package is a front-end to a XSL 34 toolchain. It chooses an appropriate stylesheet for the conversion you 35 want and applies it using an external XSLT processor. It also performs 36 any necessary post-processing. 37 </para> 36 38 37 39 &lfs91_checked; … … 40 42 <itemizedlist spacing="compact"> 41 43 <listitem> 42 <para>Download (HTTP): <ulink url="&xmlto-download-http;"/></para> 44 <para> 45 Download (HTTP): <ulink url="&xmlto-download-http;"/> 46 </para> 43 47 </listitem> 44 48 <listitem> 45 <para>Download (FTP): <ulink url="&xmlto-download-ftp;"/></para> 49 <para> 50 Download (FTP): <ulink url="&xmlto-download-ftp;"/> 51 </para> 46 52 </listitem> 47 53 <listitem> 48 <para>Download MD5 sum: &xmlto-md5sum;</para> 54 <para> 55 Download MD5 sum: &xmlto-md5sum; 56 </para> 49 57 </listitem> 50 58 <listitem> 51 <para>Download size: &xmlto-size;</para> 59 <para> 60 Download size: &xmlto-size; 61 </para> 52 62 </listitem> 53 63 <listitem> 54 <para>Estimated disk space required: &xmlto-buildsize;</para> 64 <para> 65 Estimated disk space required: &xmlto-buildsize; 66 </para> 55 67 </listitem> 56 68 <listitem> 57 <para>Estimated build time: &xmlto-time;</para> 69 <para> 70 Estimated build time: &xmlto-time; 71 </para> 58 72 </listitem> 59 73 </itemizedlist> … … 96 110 <title>Installation of xmlto</title> 97 111 98 <para>Install <application>xmlto</application> by running the following 99 commands:</para> 112 <para> 113 Install <application>xmlto</application> by running the following 114 commands: 115 </para> 100 116 101 117 <screen><userinput>LINKS="/usr/bin/links" \ … … 104 120 make</userinput></screen> 105 121 106 <para>To test the results, issue: <command>make check</command>.</para> 122 <para> 123 To test the results, issue: <command>make check</command>. 124 </para> 107 125 108 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 126 <para> 127 Now, as the <systemitem class="username">root</systemitem> user: 128 </para> 109 129 110 130 <screen role="root"><userinput>make install</userinput></screen> … … 151 171 <term><command>xmlif</command></term> 152 172 <listitem> 153 <para>is a conditional processing instructions for XML.</para> 173 <para> 174 is a conditional processing instructions for XML. 175 </para> 154 176 <indexterm zone="xmlto xmlif"> 155 177 <primary sortas="b-xmlif">xmlif</primary> … … 161 183 <term><command>xmlto</command></term> 162 184 <listitem> 163 <para>applies an XSL stylesheet to an XML document.</para> 185 <para> 186 applies an XSL stylesheet to an XML document. 187 </para> 164 188 <indexterm zone="xmlto xmlto-prog"> 165 189 <primary sortas="b-xmlto">xmlto</primary>
Note:
See TracChangeset
for help on using the changeset viewer.