The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
AxKit2-1.1
River stage zero No dependents
++
/ dir_to_xml

NAME

dir_to_xml - Convert a directory request to XML

SYNOPSIS

  Plugin dir_to_xml
  # optional
  DirExternalEncoding iso-8859-1

DESCRIPTION

This module turns a directory request into XML so that other plugins can process the directory in the same way as other XML inputs.

FORMAT

The following is an example of the XML format to expect from this plugin:

  <?xml version="1.0" encoding="UTF-8"?>
  <filelist xmlns="http://axkit.org/2002/filelist">
    <directory size="4096" atime="1077320634" mtime="1077312841" ctime="1077312841" readable="1" executable="1">.</directory>
    <directory size="4096" atime="1077316522" mtime="1076743711" ctime="1076743711" readable="1" executable="1">..</directory>
    <file size="0" atime="1076770889" mtime="1076770889" ctime="1076770889" readable="1">index.xml</file>
    <directory size="4096" atime="1076954718" mtime="1076774280" ctime="1076774280" readable="1" executable="1">images</directory>
    <file size="580626" atime="1077319951" mtime="1076774007" ctime="1076774007" readable="1">link-4.1a.tar.gz</file>
    <file size="708" atime="1077319951" mtime="1076774018" ctime="1076774018" readable="1" executable="1">Bender.pl</file>
  </filelist>

CONFIG

DirExternalEncoding STRING

File systems aren't consistent with what encodings they use to represent accented filenames or filenames in non-ascii encodings. In order to cope with these sorts of filenames you need to specify an encoding. The filenames will then be converted to unicode using the perl Encode module.

By default, filenames are accepted as either UTF-8 or ISO-8859-15, autodetecting the character set of each filename. This makes transition to UTF-8 filenames rather painless.

A warning on encodings: On some platforms,you may get different byte sequences for the same character. For example, Perl on MacOS X seems to like [base-letter+combining-char] more than [combined character], while on other systems it doesn't care. This doesn't affect XSLT or other truly XML aware processors but may hit you when you process the resulting XML with regexes or similar.