NAME

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

SYNOPSIS

       package require Tcl  8.4

       package require fileutil::multi  ?0.1?

       package require fileutil::multi::op  ?0.1?

       package require wip  ?1.0?

       ::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
       [http://core.tcl.tk/tcllib/reportlist].  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