// NAME
//     enum-dir - enumerates directory entries
//      
// SYNOPSIS
//     enum-dir [-type fdleo] [-showType] [-followLinks] [<dirpath>]
// 
// DESCRIPTION
//     enum-dir prints out the names of selected entries of the directory
//     <dirpath>; or of the current directory if <dirpath> is not given.
// 
//     The names are printed one per line.
//     
// OPTIONS
//     -type <typecodes>
//         Prints only entries of the specified types:
//         
//           f  regular files;
// 
//           d  directories (including "." and "..");
// 
//           l  symbolic links;
// 
//           e  errors (entries that can't be stat'ed);
// 
//           o  other entries (special files, pipes, etc.).
//           
//         The default is to print all entries. 
//         
//         The types are determined by calling lstat(2) or stat(2) on the
//         entry.  If the call fails, then (and only then) the type is "e".
//         
//     -showType
//         Precedes each entry with its type code,
//         according to the table above, followed by
//         a single space.
//         
//     -followLinks
//         If given, the entry type is determined with stat(2) 
//         instead of lstat(2).  
//         
//         The net effect is that the type of symbolic link entries will
//         be the type of their ultimate targets, rather than "l".  In
//         particular, if that target does not exist, or is unreachable,
//         the entry type will be "e".
// 
// SEE ALSO
//     The world ouside.
// 
// AUTHOR
//     J. Stolfi, DCC/Unicamp, february 1995.
// 
//