[ Tcllib Home | Main Table Of Contents | Table Of Contents | Keyword Index | Categories | Modules | Applications ]

# fileutil::multi(n) 0.2 tcllib "file utilities"

## Name

fileutil::multi - Multi-file operation, scatter/gather, standard object

## Synopsis

- package require Tcl 8.5 9
- package require fileutil::multi ?0.2?
- package require fileutil::multi::op ?0.5.4?
- package require wip ?1.1?

- ::fileutil::multi ?word...?

## Description

This package provides a single command to perform actions on multiple files selected by glob patterns. It is a thin layer over the package fileutil::multi::op which provides objects for the same. This package simply creates a single such object and directs all file commands to it.

At the core is a domain specific language allowing the easy specification of multi-file copy and/or move and/or deletion operations. Alternate names would be scatter/gather processor, or maybe even assembler. For the detailed specification of this language, and examples, please see the documention for the package fileutil::multi::op.

## PUBLIC API

The main command of the package is:

::fileutil::multi ?word...?

  This command interprets the specified words as file commands to execute. See the section FILE API of the documentation for the package fileutil::multi::op for the set of acceptable commands, their syntax, and semantics.

  The result of the command is the result generated by the last file command it executed.

## Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category fileutil of the Tcllib Trackers. Please also report any ideas for enhancements you may have for either package and/or documentation.

When proposing code changes, please provide unified diffs, i.e the output of diff -u.

Note further that attachments are strongly preferred over inlined patches. Attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar.

## Keywords

copy, file utilities, move, multi-file, remove

## Category

Programming tools