source: general/prog/perl-deps/perl-file-chdir.xml@ ab4fdfc

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../../general.ent">
  %general-entities;

  <!ENTITY my-download-http "&metacpan_authors;/D/DA/DAGOLDEN/File-chdir-&File-chdir-version;.tar.gz">
  <!ENTITY my-md5sum "932090f6c5f602301ae66c259de23ebb">

]>

  <!-- Begin File::chdir -->
  <sect2 id="perl-file-chdir" xreflabel="File-chdir-&File-chdir-version;">

    <title>File::chdir-&File-chdir-version;</title>

    <indexterm zone="perl-file-chdir">
      <primary sortas="a-File-chdir">File::chdir</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to File::chdir</title>

      <para>
        File::chdir provides a more sensible way to change directories.
      </para>

      <para>
        Perl's chdir() has the unfortunate problem of being very, very, very
        global. If any part of your program calls chdir() or if any library you
        use calls chdir(), it changes the current working directory for the
        *whole* program. File::chdir gives you an alternative, $CWD and @CWD.
      </para>

      &lfs120_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&my-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &my-md5sum;
          </para>
        </listitem>
      </itemizedlist>

    </sect3>

    <sect3 role="installation">
      <title>Installation of File::chdir</title>

      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
                  href="../../../xincludes/perl-standard-install.xml"/>

    </sect3>

  </sect2>