D.2 FileList
Prev | Appendix D. Core Types | Next

## D.2 FileList

FileLists offer a way to represent a specific list of files. Unlike FileSets, FileLists may contain files that do not exist on the filesystem. Also, FileLists can represent files in a specific order -- whereas FileSets represent files in whichever order they are returned by the filesystem.

Table D.2: Attributes for the `<filelist>` tag

Name | Type | Description | Default | Required
--- | --- | --- | --- | ---
`dir` | `String` | The directory, to which the paths given in `files` or `listfile` are relative. | n/a | Yes
`files` | `String` | Comma or space-separated list of files. | n/a | Yes (or `listfile)`
`listfile` | `String` | A text file with one filename per line. | n/a | Yes (or `files)`

### D.2.1 Usage Examples

    <filelist dir="/etc" files="httpd/conf/httpd.conf,php.ini"/>

Or you can use a `listfile`, which is expected to contain one filename per line:

    <filelist dir="conf/" listfile="ini_files.txt"/>

This will grab each file as listed in `ini_files.txt`. This can be useful if one task compiles a list of files to process and another task needs to read in that list and perform some action to those files.

Prev | Up | Next
Appendix D. Core Types | Home | D.3 FileSet