NAME

Data::CTable::Listing - CTable holding file and directory listings

SYNOPSIS

        ## Call from a shell script:
        use      Data::CTable::Listing;
        exit    !Data::CTable::Listing->script();

This is an OO implementation of the guts of the "tls" perl script that comes with the Data::CTable distribution.

Please see Listing.pm for the full usage() message, or run the tls perl script with the --help option.

FURTHER INFO

See the Data::CTable home page:

        http://christhorman.com/projects/perl/Data-CTable/

AUTHOR

Chris Thorman <chthorman@cpan.org>

Copyright (c) 1995-2002 Chris Thorman. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

METHODS

        $Class->run()

Main entry point for the "tls" or "tls.pl" script included with the Data::CTable distribution.

        $Class->make_file_table()

Instantiates a table object, gets and inserts file listing and other fields, processes user's arguments, and generates output.

        $Class->process_path_args()

Generates the file listing by interpreting the file-related command-line options.

        $t->make_output()

Parses and processes the sorting, fieldlist, and output options, then calls the appropriate output method. Returns the scalar buffer reference returned by that method, if any; otherwise a ref to an empty buffer.

        ## Class-level utility method
        $Class->list_dir($Path, $Sep, $Cur, $Recurse, $NoTop, $NoChildren)

Platform-neutral recursive directory lister routine.

Caller must supply $Sep (platform's separator character) and $Cur (platform's string meaning "current directory").

If $Dir is empty/undef, then $Cur will be used as the starting point.

$Recurse means recurse to list subdirectories.

$NoTop means don't include $Dir itself in the listing.

$NoChildren means don't include children of $Dir. This option is ignored if $Recurse is true.