phls in phtools-0.10.0

- old
+ new
@@ -9,19 +9,23 @@
   file_type = FILE_TYPE_IMAGE + FILE_TYPE_VIDEO + FILE_TYPE_AUDIO
   usage = <<DOCOPT
 ***************************************************
 phtools - *Keep Your Photos In Order* (c) ANB
 ***************************************************
-#{tool_name} scans given directories and generates list of files to standard output.
-In short it acts like a smart 'ls' command (or 'dir' in Windows).
+  #{tool_name} scans given directories and generates list of files to standard
+output. In short it acts like a smart 'ls' command (or 'dir' in Windows).
 Set DIRs to be scanned as a parameters. If no DIRs are set - current dir (.)
 will be scanned. Set FILEMASKs as a parameters - and only files matching the
-masks will be processed. If no FILEMASK is set *.* will be used by-default.
+masks will be processed. If no FILEMASK is set '*.*' will be used by-default.
 To avoid unnessesary mask extraction by OS - put it in ''.
 Note, #{tool_name} works only with phtools-friendly file types: #{file_type * ','}
-#{tool_name} is a starting point for all other phtools to be connected via pipes.
 
-Example: #{tool_name} abc '*aaa*' | phrename -a anb => scans 'abc' folder and
+  #{tool_name} acts as a 'source' program meaning it does not require any input
+from STDIN, it generates list of files based on input parameters and send it
+to STDOUT.
+  In other words this command is intended to be used with other programs
+connected via pipes as a 1st command in the pipe chain, e.g.:
+  #{tool_name} abc '*aaa*' | phrename -a anb => scans 'abc' folder and
 sends all found phtools friendly files filtered with *aaa* to phrename command.
 
 Usage:
   #{tool_name} [-D] [-R] [DIR_OR_FILEMASK...]
   #{tool_name} -h | --help