--- proposal-v2.txt	Mon Jul 21 19:18:15 2008
+++ proposal-v3.txt	Wed Jul 30 23:54:04 2008
@@ -57,6 +57,28 @@
         and directories which the invoking user has access to will be
         displayed.
 
+        Although Slocate allow user to create his/her own index files,
+        By default Slocate uses a central index file for all users which
+        means one system only has one slocate index file.
+
+        Slocate will check file permissions and ownership before displaying
+        matched files so that files they don't have access to will be 
+        filtered out. 
+
+        Slocate takes care of only filename, which means only creating
+        index on filename, not on file content. 
+
+        Slocate uses system call access() to check file permissions, so
+        it works with ACLs pretty well. Slocate always filter out files
+        the invoking users can't access when creating index file or display
+        the found file name. 
+
+
+        The slocate index file doesn't contain any permission information.
+        It checks permission at run time. so slocate can do the right things
+        if permission change.
+ 
+
     4.2. Bug/RFE Number(s):
 
         None.
@@ -75,15 +97,18 @@
         Exported                       Stability          Comments
         ------------------------------------------------------------------
         SUNWslocate                    Uncommitted        package name
-        /usr/bin/slocate               Volatile           CLI
-        /usr/bin/updatedb              Volatile           CLI
-        /usr/share/man/man1/slocate.1  Volatile           man page
-        /usr/share/man/man1/updatedb.1 Volatile           man page
+        /usr/bin/slocate               Volatile           binary program
+        /usr/bin/updatedb              Volatile           link to slocate
+                                                          that implies -u
+                                                          option 
+        /usr/share/doc/slocate/samples/updatedb.conf
+                                       Volatile           a sample
+                                                          configuration
+                                                          file
         /var/lib/slocate/slocate.db    Volatile           index file
                                                           see comment 1
-        slocate                        Volatile           group name
-                                                          see comment 2
-
+        a cron job entry               Volatile           see comment 2
+        
         ------------------------------------------------------------------
         Imported              Stability    ARC case      Comments
         ------------------------------------------------------------------
@@ -91,20 +116,19 @@
         /usr/lib/libast.so.1  private      2006/550
         (SONMAE libast.so.1)
 
-        /etc/updatedb.conf                               see comment 3
+        /etc/updatedb.conf                                 see comment 3
 
-        Comment 1: slocate.db is the index file which is be created by 
-        package install post, will be updated when using updatedb.
+        Comment 1: slocate.db is the default index file which will be 
+        will be updated by a cron job or when using updatedb.
 
-        Comment 2: slocate is a group which is created by package install
-        post. Both slocate.db and slocate CLI belong to this group and 
-        slocate CLI has the group sticky bit on, so normal user can access
-        index file.
+        Comment 2: this cron job will run updatedb at 3:00 am every day 
+        to update the default index file. It will be added when adding 
+        package and be removed when removing package.
 
         Comment 3: updatedb.conf is a configuration file of locate which
         belongs to another package findutils. Slocate will parse this con-
-        figuration file if it exists. if not, Slocate still can works, it
-        just default or user inputed argument.
+        figuration file if it exists. if not, Slocate still can work, by 
+        using default or inputed argument.
 
     4.6. Doc Impact:
 
@@ -134,8 +158,10 @@
     4.12. Dependencies:
 
         private library /usr/lib/libast.so.1 (SONAME libast.so.1).
+        http://sac.sfbay/Archives/CaseLog/arc/LSARC/2008/447/contracts/libast-PSARC-2006-550.txt
 
 5. Reference Documents:
 
         Slocate community
         http://slocate.trakker.ca/
+
