Changeset 10a2ee5 for general/prog/perl-modules.xml
- Timestamp:
- 07/14/2005 12:51:10 AM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- ba4b31cf
- Parents:
- dc913a5a
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
general/prog/perl-modules.xml
rdc913a5a r10a2ee5 26 26 <title>Introduction to Perl Modules</title> 27 27 28 <para>The <application>Perl</application> module packages add useful objects 29 to the <application>Perl</application> language. Modules utilized by packages 30 throughout BLFS are listed here, along with their dependencies. Most references to 31 <application>Perl</application> modules are in the form of Module, Module::SubName 32 or Module::Sub::Name, however occasionally you'll also see Module, Module-SubName 33 or Module-Sub-Name. Most references on this page are in the latter form, as these 34 are the official package names.</para> 28 <para>The <application>Perl</application> module packages add useful 29 objects to the <application>Perl</application> language. Modules utilized 30 by packages throughout BLFS are listed here, along with their dependencies. 31 Most references to <application>Perl</application> modules are in the form 32 of Module, Module::SubName or Module::Sub::Name, however occasionally 33 you'll also see Module, Module-SubName or Module-Sub-Name. Most references 34 on this page are in the latter form, as these are the official package 35 names.</para> 35 36 36 37 <itemizedlist spacing="compact"> … … 45 46 </itemizedlist> 46 47 47 <bridgehead renderas="sect3" id="perl-module-info">The Module::Info Module</bridgehead> 48 <bridgehead renderas="sect3" id="perl-module-info" 49 xreflabel="Module::Info">The Module::Info Module</bridgehead> 48 50 49 51 <indexterm zone="perl-modules perl-module-info"> … … 52 54 53 55 <para>One module in particular is shown first, as this module's usefulness 54 warrants installation, even though it won't be required by many other modules.55 The Module::Info module can tell you if a particular module is included in,56 or has been installed into your <application>Perl</application> installation.57 Additionally, the module can tell you what versions are installed and what58 dependencies are required for them. You can even use Module::Info to gather59 dependencies of uninstalled modules.</para>56 warrants installation, even though it won't be required by many other 57 modules. The Module::Info module can tell you if a particular module is 58 included in, or has been installed into your <application>Perl</application> 59 installation. Additionally, Module::Info can tell you what versions are 60 installed and what dependencies are required for them. You can even use 61 Module::Info to gather dependencies of uninstalled modules.</para> 60 62 61 63 <itemizedlist spacing='compact'> … … 63 65 <para><ulink 64 66 url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz"> 65 Module-Info-&Module-Info-version;</ulink></para> 66 </listitem> 67 </itemizedlist> 68 69 <bridgehead renderas="sect3">Perl Module Packages</bridgehead> 70 71 <itemizedlist spacing='compact'> 72 <listitem> 73 <para id="perl-gtk-perl"><ulink 74 url="http://www.cpan.org/authors/id/M/ML/MLEHMANN/Gtk-Perl-&Gtk-Perl-version;.tar.gz"> 75 Gtk-Perl-&Gtk-Perl-version;</ulink></para> 76 <indexterm zone="perl-modules perl-gtk-perl"> 77 <primary sortas="g-Gtk-Perl">Gtk::Perl</primary> 78 </indexterm> 67 Module-Info-&Module-Info-version;</ulink> 68 (<xref linkend="perl-standard-install"/>)</para> 69 </listitem> 70 </itemizedlist> 71 72 <bridgehead renderas="sect3" id="perl-test-pod" 73 xreflabel="Test::Pod">The Test::Pod Module</bridgehead> 74 75 <indexterm zone="perl-modules perl-test-pod"> 76 <primary sortas="g-Test-Pod">Test::Pod</primary> 77 </indexterm> 78 79 <para>Another useful module, and one which is (typically optionally) used 80 by other modules during the build process is the Test:Pod module. This 81 module is used to check the validity of POD (Plain Old Documentation) 82 files. The Test::Pod module is typically included by module authors to 83 automatically find and check all POD files in a module distribution. This 84 module and all the dependencies can be installed using the 85 <xref linkend="perl-standard-install"/>.</para> 86 87 <itemizedlist spacing='compact'> 88 <listitem> 89 <para><ulink 90 url="http://www.cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz"> 91 Test-Pod-&Test-Pod-version;</ulink></para> 92 79 93 <itemizedlist> 80 94 <listitem> 81 <para id="perl-xml-writer"><ulink 82 url="http://www.cpan.org/authors/id/J/JO/JOSEPHW/XML-Writer-&XML-Writer-version;.tar.gz"> 83 XML-Writer-&XML-Writer-version;</ulink></para> 84 <indexterm zone="perl-modules perl-xml-writer"> 85 <primary sortas="g-XML-Writer">XML::Writer</primary> 86 </indexterm> 87 </listitem> 88 <listitem> 89 <para id="perl-xml-parser"><ulink 90 url="http://www.cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz"> 91 XML-Parser-&XML-Parser-version;</ulink></para> 92 <indexterm zone="perl-modules perl-xml-parser"> 93 <primary sortas="g-XML-Parser">XML::Parser</primary> 94 </indexterm> 95 <itemizedlist> 96 <listitem> 97 <para><xref linkend="expat"/></para> 98 </listitem> 99 </itemizedlist> 100 </listitem> 101 <listitem> 102 <para><xref linkend="GTK"/></para> 95 <para id="perl-pod-simple"><ulink 96 url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Simple-&Pod-Simple-version;.tar.gz"> 97 Pod-Simple-&Pod-Simple-version;</ulink></para> 98 <indexterm zone="perl-modules perl-pod-simple"> 99 <primary sortas="g-Pod-Simple">Pod::Simple</primary> 100 </indexterm> 101 102 <itemizedlist> 103 <listitem> 104 <para id="perl-pod-escapes"><ulink 105 url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz"> 106 Pod-Escapes-&Pod-Escapes-version;</ulink></para> 107 <indexterm zone="perl-modules perl-pod-escapes"> 108 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary> 109 </indexterm> 110 </listitem> 111 </itemizedlist> 112 113 </listitem> 114 <listitem> 115 <para id="perl-test-builder-tester"><ulink 116 url="http://www.cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz"> 117 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para> 118 <indexterm zone="perl-modules perl-test-builder-tester"> 119 <primary sortas="g-Test-Builder-Tester"> 120 Test::Builder::Tester</primary> 121 </indexterm> 103 122 </listitem> 104 123 </itemizedlist> 105 </listitem> 106 <listitem> 107 <para id="perl-sgmlspm"><ulink 124 125 </listitem> 126 </itemizedlist> 127 128 <bridgehead renderas="sect3" id="perl-module-build" 129 xreflabel="Module::Build">The Module::Build Module</bridgehead> 130 131 <indexterm zone="perl-modules perl-module-build"> 132 <primary sortas="g-Module-Build">Module::Build</primary> 133 </indexterm> 134 135 <para>The Module::Build module is a system for building, testing, and 136 installing <application>Perl</application> modules. It is meant to be an 137 alternative to ExtUtils::MakeMaker. Developers may alter the behavior of 138 the module through subclassing in a much more straightforward way than with 139 MakeMaker. It also does not require a <command>make</command> command on 140 your system. Most of the Module::Build code is 141 pure-<application>Perl</application> and written in a very cross-platform 142 way.</para> 143 144 <para>The Module::Build module (as well as any other 145 <application>Perl</application> module that uses the Module::Build build 146 system) uses <xref linkend="perl-module-build-install"/>. All the 147 dependencies can be installed using the 148 <xref linkend="perl-standard-install"/>.</para> 149 150 <note> 151 <para>The Compress::Zlib module requires the following 152 <command>sed</command> after untarring the distribution tarball (before 153 any other build commands) to use the system-installed copy of 154 <application>Zlib</application>.</para> 155 156 <screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \ 157 -e "s|INCLUDE = ./zlib-src|INCLUDE = /usr/include|" \ 158 -e "s|LIB = ./zlib-src|LIB = /usr/lib|" \ 159 config.in</userinput></screen> 160 </note> 161 162 <itemizedlist spacing='compact'> 163 <listitem> 164 <para><ulink 165 url="http://www.cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz"> 166 Module-Build-&Module-Build-version;</ulink></para> 167 168 <itemizedlist> 169 <listitem> 170 <para id="perl-module-signature"><ulink 171 url="http://www.cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz"> 172 Module-Signature-&Module-Signature-version;</ulink> (optional)</para> 173 <indexterm zone="perl-modules perl-module-signature"> 174 <primary sortas="g-Module-Signature">Module::Signature</primary> 175 </indexterm> 176 177 <itemizedlist> 178 <listitem> 179 <para id="perl-digest-sha"><ulink 180 url="http://www.cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz"> 181 Digest-SHA-&Digest-SHA-version;</ulink></para> 182 <indexterm zone="perl-modules perl-digest-sha"> 183 <primary sortas="g-Digest-SHA">Digest::SHA</primary> 184 </indexterm> 185 </listitem> 186 <listitem> 187 <para id="perl-par-dist"><ulink 188 url="http://www.cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz"> 189 PAR-Dist-&PAR-Dist-version;</ulink></para> 190 <indexterm zone="perl-modules perl-par-dist"> 191 <primary sortas="g-PAR-Dist">PAR::Dist</primary> 192 </indexterm> 193 </listitem> 194 <listitem> 195 <para><xref linkend="gnupg"/></para> 196 </listitem> 197 </itemizedlist> 198 199 </listitem> 200 <listitem> 201 <para id="perl-extutils-parsexs"><ulink 202 url="http://www.cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz"> 203 ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para> 204 <indexterm zone="perl-modules perl-extutils-parsexs"> 205 <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary> 206 </indexterm> 207 208 <itemizedlist> 209 <listitem> 210 <para id="perl-extutils-cbuilder"><ulink 211 url="http://www.cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz"> 212 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para> 213 <indexterm zone="perl-modules perl-extutils-cbuilder"> 214 <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary> 215 </indexterm> 216 </listitem> 217 </itemizedlist> 218 219 </listitem> 220 <listitem> 221 <para id="perl-archive-tar"><ulink 222 url="http://www.cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz"> 223 Archive-Tar-&Archive-Tar-version;</ulink></para> 224 <indexterm zone="perl-modules perl-archive-tar"> 225 <primary sortas="g-Archive-Tar">Archive::Tar</primary> 226 </indexterm> 227 228 <itemizedlist> 229 <listitem> 230 <para id="perl-io-zlib"><ulink 231 url="http://www.cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz"> 232 IO-Zlib-&IO-Zlib-version;</ulink></para> 233 <indexterm zone="perl-modules perl-io-zlib"> 234 <primary sortas="g-IO-Zlib">IO::Zlib</primary> 235 </indexterm> 236 237 <itemizedlist> 238 <listitem> 239 <para id="perl-compress-zlib"><ulink 240 url="http://www.cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz"> 241 Compress-Zlib-&Compress-Zlib-version;</ulink></para> 242 <indexterm zone="perl-modules perl-compress-zlib"> 243 <primary sortas="g-Compress-Zlib">Compress::Zlib</primary> 244 </indexterm> 245 </listitem> 246 </itemizedlist> 247 248 </listitem> 249 <listitem> 250 <para><xref linkend="perl-test-pod"/></para> 251 </listitem> 252 </itemizedlist> 253 254 </listitem> 255 <listitem> 256 <para id="perl-yaml"><ulink 257 url="http://www.cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz"> 258 YAML-&YAML-version;</ulink></para> 259 <indexterm zone="perl-modules perl-yaml"> 260 <primary sortas="g-YAML">YAML</primary> 261 </indexterm> 262 </listitem> 263 </itemizedlist> 264 265 </listitem> 266 </itemizedlist> 267 268 <bridgehead renderas="sect4" id="perl-module-build-install" 269 xreflabel="modified build instructions">Module::Build Build and 270 Installation Instructions</bridgehead> 271 272 <screen><userinput>perl Build.PL && 273 ./Build test</userinput></screen> 274 275 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para> 276 277 <screen role='root'><userinput>./Build install</userinput></screen> 278 279 <bridgehead renderas="sect3" id="perl-html-parser" 280 xreflabel="HTML::Parser">The HTML::Parser Module</bridgehead> 281 282 <indexterm zone="perl-modules perl-html-parser"> 283 <primary sortas="g-HTML-Parser">HTML::Parser</primary> 284 </indexterm> 285 286 <para>The HTML::Parser distribution is a collection of modules that parse 287 and extract information from HTML documents. In order to use the included 288 HTML::HeadParser module, you will also need to install 289 <xref linkend="perl-lwp"/>. The two modules listed below can be installed 290 using the <application>Perl</application> Module 291 <xref linkend="perl-standard-install"/>.</para> 292 293 <itemizedlist spacing='compact'> 294 <listitem> 295 <para><ulink 296 url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz"> 297 HTML-Parser-&HTML-Parser-version;</ulink></para> 298 299 <itemizedlist> 300 <listitem> 301 <para id="perl-html-tagset"><ulink 302 url="http://www.cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz"> 303 HTML-Tagset-&HTML-Tagset-version;</ulink></para> 304 <indexterm zone="perl-modules perl-html-tagset"> 305 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary> 306 </indexterm> 307 </listitem> 308 </itemizedlist> 309 310 </listitem> 311 </itemizedlist> 312 313 <bridgehead renderas="sect3" id="perl-xml-parser" 314 xreflabel="XML::Parser">The XML::Parser Module</bridgehead> 315 316 <indexterm zone="perl-modules perl-xml-parser"> 317 <primary sortas="g-XML-Parser">XML::Parser</primary> 318 </indexterm> 319 320 <para>The XML::Parser module is a <application>Perl</application> extension 321 interface to James Clark's XML parser, 322 <application>expat</application>. The module can be installed using the 323 <application>Perl</application> Module 324 <xref linkend="perl-standard-install"/>.</para> 325 326 <itemizedlist spacing='compact'> 327 <listitem> 328 <para><ulink 329 url="http://www.cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz"> 330 XML-Parser-&XML-Parser-version;</ulink></para> 331 332 <itemizedlist> 333 <listitem> 334 <para><xref linkend="expat"/></para> 335 </listitem> 336 </itemizedlist> 337 338 </listitem> 339 </itemizedlist> 340 341 <bridgehead renderas="sect3" id="perl-sgmlspm" 342 xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead> 343 344 <indexterm zone="perl-modules perl-sgmlspm"> 345 <primary sortas="g-SGMLSpm">SGMLSpm</primary> 346 </indexterm> 347 348 <para>The SGMLSpm module is a <application>Perl</application> library 349 used for parsing the output from James Clark's SGMLS and NSGMLS 350 parsers. This module requires modified installation instructions, shown 351 below.</para> 352 353 <itemizedlist spacing='compact'> 354 <listitem> 355 <para><ulink 108 356 url="http://www.cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz"> 109 357 SGMLSpm-&SGMLSpm-version;</ulink></para> 110 <indexterm zone="perl-modules perl-sgmlspm"> 111 <primary sortas="g-SGMLSpm">SGMLSpm</primary> 112 </indexterm> 113 </listitem> 114 <listitem> 115 <para id="perl-perl-tk"><ulink 358 </listitem> 359 </itemizedlist> 360 361 <para>If your system's <application>Perl</application> version is different 362 than &LFS-Perl-version;, you'll need to modify the <command>sed</command> 363 command below to reflect the version you have installed.</para> 364 365 <screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \ 366 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \ 367 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \ 368 Makefile</userinput></screen> 369 370 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 371 372 <screen role="root"><userinput>make install && 373 install -v -d -m755 /usr/share/doc/perl5 && 374 make install_html && 375 rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl && 376 install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen> 377 378 <bridgehead renderas="sect3" id="perl-tk" 379 xreflabel="Tk">The Tk Module</bridgehead> 380 381 <indexterm zone="perl-modules perl-tk"> 382 <primary sortas="g-Tk">Tk</primary> 383 </indexterm> 384 385 <para>The <application>Tk</application> module is a 386 <application>Perl</application> interface to the 387 <application>Tk</application> package. The goal of this release is Unicode 388 support via <application>Perl</application>'s and 389 core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version; 390 builds and loads into a threaded <application>Perl</application> but is NOT 391 yet thread safe. The module can be installed using the 392 <application>Perl</application> Module 393 <xref linkend="perl-standard-install"/>.</para> 394 395 <itemizedlist spacing='compact'> 396 <listitem> 397 <para><ulink 116 398 url="http://www.cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz"> 117 399 Tk-&Perl-Tk-version;</ulink></para> 118 <indexterm zone="perl-modules perl-perl-tk"> 119 <primary sortas="g-Perl-Tk">Perl::Tk</primary> 120 </indexterm> 400 121 401 <itemizedlist> 122 402 <listitem> … … 124 404 </listitem> 125 405 </itemizedlist> 126 </listitem> 127 <listitem> 128 <para id="perl-net-dns"><ulink 129 url="http://www.cpan.org/authors/id/C/CR/CREIN/Net-DNS-&Net-DNS-version;.tar.gz"> 406 407 </listitem> 408 </itemizedlist> 409 410 <bridgehead renderas="sect3" id="perl-net-dns" 411 xreflabel="Net-DNS">The Net::DNS Module</bridgehead> 412 413 <indexterm zone="perl-modules perl-net-dns"> 414 <primary sortas="g-Net-DNS">Net::DNS</primary> 415 </indexterm> 416 417 <para>Net::DNS is a DNS resolver implemented in 418 <application>Perl</application>. It can be used to perform nearly any type 419 of DNS query from a <application>Perl</application> script. The Net::DNS 420 module and all its dependencies can be installed using the 421 <application>Perl</application> Module 422 <xref linkend="perl-standard-install"/>.</para> 423 424 <itemizedlist spacing='compact'> 425 <listitem> 426 <para><ulink 427 url="http://www.cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz"> 130 428 Net-DNS-&Net-DNS-version;</ulink></para> 131 <indexterm zone="perl-modules perl-net-dns"> 132 <primary sortas="g-Net-DNS">Net::DNS</primary> 133 </indexterm> 429 134 430 <itemizedlist> 135 431 <listitem> … … 140 436 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary> 141 437 </indexterm> 438 142 439 <itemizedlist> 143 440 <listitem> … … 150 447 </listitem> 151 448 </itemizedlist> 449 450 </listitem> 451 <listitem> 452 <para id="perl-net-ip"><ulink 453 url="http://www.cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz"> 454 Net-IP-&Net-IP-version;</ulink></para> 455 <indexterm zone="perl-modules perl-net-ip"> 456 <primary sortas="g-Net-IP">Net::IP</primary> 457 </indexterm> 458 </listitem> 459 <listitem> 460 <para id="perl-io-socket-inet6"><ulink 461 url="http://www.cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz"> 462 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for 463 IPv6 support)</para> 464 <indexterm zone="perl-modules perl-io-socket-inet6"> 465 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary> 466 </indexterm> 467 468 <itemizedlist> 469 <listitem> 470 <para id="perl-socket6"><ulink 471 url="http://www.cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz"> 472 Socket6-&Socket6-version;</ulink></para> 473 <indexterm zone="perl-modules perl-socket6"> 474 <primary sortas="g-Socket6">Socket6</primary> 475 </indexterm> 476 </listitem> 477 </itemizedlist> 478 479 </listitem> 480 <listitem> 481 <para id="perl-digest-bubblebabble"><ulink 482 url="http://www.cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz"> 483 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink> 484 (optional, only used during the test suite)</para> 485 <indexterm zone="perl-modules perl-digest-bubblebabble"> 486 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary> 487 </indexterm> 152 488 </listitem> 153 489 </itemizedlist> 154 </listitem> 155 <listitem> 156 <para id="perl-lwp"><ulink 490 491 </listitem> 492 </itemizedlist> 493 494 <bridgehead renderas="sect3" id="perl-lwp" 495 xreflabel="LWP">The LWP Module</bridgehead> 496 497 <indexterm zone="perl-modules perl-lwp"> 498 <primary sortas="g-LWP">LWP</primary> 499 </indexterm> 500 501 <para>The libwww-perl (LWP) collection is a set of 502 <application>Perl</application> modules which provides a simple and 503 consistent application programming interface to the World-Wide Web. The 504 main focus of the library is to provide classes and functions that allow 505 you to write WWW clients. The library also contains modules that are of 506 more general use and even classes that help you implement simple HTTP 507 servers. The LWP modules and all its <application>Perl</application> 508 module dependencies can be installed using the 509 <application>Perl</application> Module 510 <xref linkend="perl-standard-install"/>.</para> 511 512 <note> 513 <para>The Compress::Zlib module requires the following 514 <command>sed</command> after untarring the distribution tarball (before 515 any other build commands) to use the system-installed copy of 516 <application>Zlib</application>.</para> 517 518 <screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \ 519 -e "s|INCLUDE = ./zlib-src|INCLUDE = /usr/include|" \ 520 -e "s|LIB = ./zlib-src|LIB = /usr/lib|" \ 521 config.in</userinput></screen> 522 </note> 523 524 <itemizedlist spacing='compact'> 525 <listitem> 526 <para><ulink 157 527 url="http://www.cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz"> 158 528 LWP-&LWP-version;</ulink></para> 159 <indexterm zone="perl-modules perl-lwp"> 160 <primary sortas="g-LWP">LWP</primary> 161 </indexterm> 529 162 530 <itemizedlist> 163 531 <listitem> … … 168 536 <primary sortas="g-URI">URI</primary> 169 537 </indexterm> 538 170 539 <itemizedlist> 171 540 <listitem> 172 541 <para id="perl-business-isbn"><ulink 173 542 url="http://www.cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz"> 174 Business-ISBN-&Business-ISBN-version;</ulink> ( Only used during the175 test suite)</para>543 Business-ISBN-&Business-ISBN-version;</ulink> (optonal, only 544 used during the test suite)</para> 176 545 <indexterm zone="perl-modules perl-business-isbn"> 177 546 <primary sortas="g-Business-ISBN">Business::ISBN</primary> 178 547 </indexterm> 548 179 549 <itemizedlist> 180 550 <listitem> … … 185 555 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary> 186 556 </indexterm> 557 187 558 <itemizedlist> 188 559 <listitem> 189 <para id="perl-test-pod"><ulink 190 url="http://www.cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz"> 191 Test-Pod-&Test-Pod-version;</ulink></para> 192 <indexterm zone="perl-modules perl-test-pod"> 193 <primary sortas="g-Test-Pod">Test::Pod</primary> 194 </indexterm> 195 <itemizedlist> 196 <listitem> 197 <para id="perl-pod-simple"><ulink 198 url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Simple-&Pod-Simple-version;.tar.gz"> 199 Pod-Simple-&Pod-Simple-version;</ulink></para> 200 <indexterm zone="perl-modules perl-pod-simple"> 201 <primary sortas="g-Pod-Simple">Pod::Simple</primary> 202 </indexterm> 203 <itemizedlist> 204 <listitem> 205 <para id="perl-pod-escapes"><ulink 206 url="http://www.cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz"> 207 Pod-Escapes-&Pod-Escapes-version;</ulink></para> 208 <indexterm zone="perl-modules perl-pod-escapes"> 209 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary> 210 </indexterm> 211 </listitem> 212 </itemizedlist> 213 </listitem> 214 <listitem> 215 <para id="perl-test-builder-tester"><ulink 216 url="http://www.cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz"> 217 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para> 218 <indexterm zone="perl-modules perl-test-builder-tester"> 219 <primary sortas="g-Test-Builder-Tester"> 220 Test::Builder::Tester</primary> 221 </indexterm> 222 </listitem> 223 </itemizedlist> 560 <para><xref linkend="perl-test-pod"/></para> 224 561 </listitem> 225 562 <listitem> … … 230 567 <primary sortas="g-Test-Prereq">Test::Prereq</primary> 231 568 </indexterm> 569 232 570 <itemizedlist> 233 571 <listitem> 234 <para><ulink 235 url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz"> 236 Module-Info-&Module-Info-version;</ulink></para> 572 <para><xref linkend="perl-module-info"/></para> 573 </listitem> 574 <listitem> 575 <para><xref linkend="perl-module-build"/> (optional)</para> 237 576 </listitem> 238 577 <listitem> … … 245 584 </listitem> 246 585 </itemizedlist> 586 247 587 </listitem> 248 588 </itemizedlist> 589 249 590 </listitem> 250 591 </itemizedlist> 251 </listitem> 252 </itemizedlist> 253 </listitem> 254 <listitem> 255 <para id="perl-html-parser"><ulink 256 url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz"> 257 HTML-Parser-&HTML-Parser-version;</ulink></para> 258 <indexterm zone="perl-modules perl-html-parser"> 259 <primary sortas="g-HTML-Parser">HTML::Parser</primary> 260 </indexterm> 261 <itemizedlist> 262 <listitem> 263 <para id="perl-html-tagset"><ulink 264 url="http://www.cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz"> 265 HTML-Tagset-&HTML-Tagset-version;</ulink></para> 266 <indexterm zone="perl-modules perl-html-tagset"> 267 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary> 268 </indexterm> 269 </listitem> 270 </itemizedlist> 271 </listitem> 272 <listitem> 273 <para id="perl-compress-zlib"><ulink 592 593 </listitem> 594 </itemizedlist> 595 596 </listitem> 597 <listitem> 598 <para><xref linkend="perl-html-parser"/></para> 599 </listitem> 600 <listitem> 601 <para><ulink 274 602 url="http://www.cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz"> 275 603 Compress-Zlib-&Compress-Zlib-version;</ulink></para> 276 <indexterm zone="perl-modules perl-compress-zlib">277 <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>278 </indexterm>279 604 </listitem> 280 605 <listitem> 281 606 <para id="perl-crypt-ssleay"><ulink 282 607 url="http://www.cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz"> 283 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink></para> 608 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS 609 support)</para> 284 610 <indexterm zone="perl-modules perl-crypt-ssleay"> 285 611 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary> 286 612 </indexterm> 613 614 <itemizedlist> 615 <listitem> 616 <para><xref linkend="openssl"/></para> 617 </listitem> 618 </itemizedlist> 619 287 620 </listitem> 288 621 </itemizedlist> 289 </listitem> 290 <listitem> 291 <para id="perl-datemanip"><ulink 622 623 </listitem> 624 </itemizedlist> 625 626 <bridgehead renderas="sect3" id="perl-date-manip" 627 xreflabel="Date::Manip">The Date::Manip Module</bridgehead> 628 629 <indexterm zone="perl-modules perl-date-manip"> 630 <primary sortas="g-Date-Manip">Date::Manip</primary> 631 </indexterm> 632 633 <para>Date::Manip is a set of routines designed to make any common 634 date/time manipulation easy to do. Operations such as comparing two times, 635 calculating a time a given amount of time from another, or parsing 636 international times are all easily done. From the very beginning, the 637 main focus of Date::Manip has been to be able to do ANY desired date/time 638 operation easily.</para> 639 640 <itemizedlist spacing='compact'> 641 <listitem> 642 <para><ulink 292 643 url="http://www.cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz"> 293 DateManip-&DateManip-version;</ulink></para> 294 <indexterm zone="perl-modules perl-datemanip"> 295 <primary sortas="g-DateManip">DateManip</primary> 296 </indexterm> 297 </listitem> 298 <listitem> 299 <para id="perl-finance-quote"><ulink 644 DateManip-&DateManip-version;</ulink> 645 (<xref linkend="perl-standard-install"/>)</para> 646 </listitem> 647 </itemizedlist> 648 649 <bridgehead renderas="sect3" id="perl-finance-quote" 650 xreflabel="Finance::Quote">The Finance::Quote Module</bridgehead> 651 652 <indexterm zone="perl-modules perl-finance-quote"> 653 <primary sortas="g-Finance-Quote">Finance::Quote</primary> 654 </indexterm> 655 656 <para>Finance::Quote is used to get stock quotes from various Internet 657 sources, including Yahoo! Finance, Fidelity Investments, and the Australian 658 Stock Exchange. There are two methods of using this module – a 659 functional interface that is depreciated, and an object-orientated method 660 that provides greater flexibility and stability. With the exception of 661 straight currency exchange rates, all information is returned as a 662 two-dimensional hash (or a reference to such a hash, if called in a scalar 663 context).</para> 664 665 <para>After you've installed the package, issue 666 <command>perldoc Finance::Quote</command> for full information. 667 Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command> 668 after unpacking the distribution tarball and changing into the top-level 669 directory. The module and dependencies can be installed using the 670 <application>Perl</application> module 671 <xref linkend="perl-standard-install"/>.</para> 672 673 <note> 674 <para>To run the regression test suite, you'll need to create a 675 symbolic link to the <filename class='directory'>test</filename> 676 directory using the following command after unpacking the tarball 677 and changing into the root directory of the sources:</para> 678 679 <screen><userinput>ln -s test t</userinput></screen> 680 681 <para>Some tests will fail depending on certain conditions. See the 682 <filename>INSTALL</filename> file for full details.</para> 683 </note> 684 685 <itemizedlist spacing='compact'> 686 <listitem> 687 <para><ulink 300 688 url="http://www.cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz"> 301 689 Finance-Quote-&Finance-Quote-version;</ulink></para> 302 <indexterm zone="perl-modules perl-finance-quote"> 303 <primary sortas="g-Finance-Quote">Finance::Quote</primary> 304 </indexterm> 690 305 691 <itemizedlist> 306 692 <listitem> … … 311 697 <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary> 312 698 </indexterm> 313 <itemizedlist> 314 <listitem> 315 <para><ulink 316 url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz"> 317 HTML-Parser-&HTML-Parser-version;</ulink></para> 318 <itemizedlist> 319 <listitem> 320 <para><ulink 321 url="http://www.cpan.org/authors/id/S/SB/SBURKE/HTML-Tagset-&HTML-Tagset-version;.tar.gz"> 322 HTML-Tagset-&HTML-Tagset-version;</ulink></para> 323 </listitem> 324 </itemizedlist> 325 </listitem> 326 </itemizedlist> 327 </listitem> 328 <listitem> 329 <para><ulink 330 url="http://www.cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz"> 331 LWP-&LWP-version;</ulink> (see dependencies above)</para> 699 700 <itemizedlist> 701 <listitem> 702 <para><xref linkend="perl-html-parser"/></para> 703 </listitem> 704 </itemizedlist> 705 706 </listitem> 707 <listitem> 708 <para><xref linkend="perl-lwp"/></para> 332 709 </listitem> 333 710 </itemizedlist> 711 334 712 </listitem> 335 713 </itemizedlist> … … 337 715 </sect2> 338 716 339 <sect2 role="installation"> 340 <title>Installation of Perl Modules</title> 341 342 <para>Install <application>Perl</application> modules by running the following 343 commands:</para> 717 <sect2 role="installation" id="perl-standard-install" 718 xreflabel="build and installation instructions"> 719 <title>Standard Installation of Perl Modules</title> 720 721 <para>Install <application>Perl</application> modules by running the 722 following commands:</para> 344 723 345 724 <screen><userinput>perl Makefile.PL && … … 350 729 351 730 <screen role="root"><userinput>make install</userinput></screen> 352 353 <para>The modules listed below require modifications to the instructions in354 order to install successfully.</para>355 356 <sect3>357 <title>Gtk-Perl-&Gtk-Perl-version;:</title>358 359 <screen><userinput>perl Makefile.PL --without-guessing &&360 make &&361 make test</userinput></screen>362 363 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>364 365 <screen role="root"><userinput>make install</userinput></screen>366 367 </sect3>368 369 <sect3>370 <title>SGMLSpm-&SGMLSpm-version;</title>371 372 <para>If your system's <application>Perl</application> version is different373 than &LFS-Perl-version;, you'll need to modify the <command>sed</command>374 command below to reflect the version you have installed.</para>375 376 <screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \377 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \378 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \379 Makefile</userinput></screen>380 381 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>382 383 <screen role="root"><userinput>make install &&384 install -v -d -m755 /usr/share/doc/perl5 &&385 make install_html &&386 rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &&387 install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>388 389 </sect3>390 731 391 732 </sect2> … … 415 756 <para>For additional commands and help, type <command>help</command>.</para> 416 757 758 <para>Alternatively, for scripted or non-interactive installations, use the 759 following syntax as the 760 <systemitem class="username">root</systemitem> user:</para> 761 762 <screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>[Module::Name]</replaceable>'</userinput></screen> 763 417 764 </sect2> 418 765
Note:
See TracChangeset
for help on using the changeset viewer.