--- chmodjob.h.orig	2003-07-15 23:36:58.000000000 +0900
+++ chmodjob.h	2003-07-18 05:11:54.000000000 +0900
@@ -80,13 +80,38 @@
 	class ChmodJobPrivate* d;
     };
 
+    /**
+     * Creates a job that changes permissions/ownership on several files or directories,
+     * optionally recursively.
+     *
+     * TODO: a general job that stats each url and returns a KFileItemList.
+     *
+     * Note that change of ownership is only supported for local files.
+     *
+     * Inside directories, the "x" bits will only be changed for files that had
+     * at least one "x" bit before, and for directories.
+     * This emulates the behaviour of chmod +X.
+     *
+     * @param srcList the list of source URLs
+     * @param permissions the permissions we want to set
+     * @param mask the bits we are allowed to change.
+     * For instance, if mask is 0077, we don't change
+     * the "user" bits, only "group" and "others".
+     * @param newOwner If non-empty, the new owner for the files
+     * @param newGroup If non-empty, the new group for the files
+     * @param recursive whether to open directories recursively
+     * @param showProgressInfo true to show progess information
+     * @return The job handling the operation.
+     */
+    ChmodJob * chmod( const KURL::List& urlList, int permissions, int mask,
+		      QString owner, QString group,
+		      bool recursive, bool showProgressInfo = true );
 
     /**
      * Creates a job that changes permissions/ownership on several files or directories,
      * optionally recursively.
-     * This version of chmod uses a KFileItemList so that it directly knows
-     * what to do with the items. TODO: a version that takes a KURL::List,
-     * and a general job that stats each url and returns a KFileItemList.
+     *
+     * TODO: a general job that stats each url and returns a KFileItemList.
      *
      * Note that change of ownership is only supported for local files.
      *
