readme final update v0.11

README.md

@@ -1,9 +1,9 @@
 ## Locating your files has never been faster!
 
-**bloc** is a **b**etter **loc**ate which is capable of quickly finding any file/archive you have stored in your computer with as much flexibility as needed. The speed increase may be of up to 10 times faster compared to normal locate, and up to 30 times compared to find.
+**bloc** is a **b**etter **loc**ate which is capable of quickly finding any file/archive you have stored in your computer with as much flexibility as needed. The speed increase may be of up to 10 times faster compared to normal locate, and up to 30 times compared to find. (Pictures will be available in a future release)
 
 ### How it works
-`bloc`works pretty much in the same way that locate does: it is a cli searching tool that creates a database where it looks for the specified file or directory and outputs it to STDOUT. The 2 major differences here are that:
+`bloc`works pretty much in the same way that locate does: it is a cli searching tool that creates a database where it looks for the specified file and outputs its name/location to STDOUT. The 2 major differences here are that:
 
 * 1: `bloc` does not compress the database.  
 whereas this means that the database file is larger, it also means that it doesn't have to waste time decompressing the database before searching for certain query. Moreover, most tests reported that locate can only decrease database size to about a third of the original's, which, nowadays, isn't that much of a problem for most computers.
@@ -15,24 +15,18 @@ whereas this means that the database file is larger, it also means that it doesn
 
 ### Installation
 
-***Warning:*** bloc-populate is the file responsible for creating and updating the database, but in order to map every accessible directory it has to have root priveleges (setUID). If you do no want it have these privileges, you can still run `bloc`, except it won't search files you can't normally access.
-
-As this is the first release of `bloc` no official installation is provided, but here is what you need to do if you want to run `bloc` in your computer:
+As `bloc` is still in it's early development, no official installation is provided, but here is what you need to do if you want to run `bloc` in your computer:
 
 **1.** Clone this repo to your local machine
 
     git clone https://github.com/bootzin/bloc
 
-**2.** Edit both bloc and bloc-populate files with your editor of choice and change both database and OUTPUT default values so that they match the location of the database in your computer
-
-    database=/home/user/path/to/bloc.db
-
-**3.** Make both `bloc` and `bloc-populate` executables with the following commands:
+**2** Add `bloc` to your local bin folder so that you can execute it from anywhere. I usually keep them on a separate folder and symlink them to ~/bin (which must be in $PATH).
 
-    sudo chmod +x /path/to/bloc
-    sudo chmod +x /path/to/bloc-populate
+**3** Edit the default path for database file in bloc/bloc-populate. They default to ~/Software/bloc, but make sure that folder exists before running the program.
 
-**4.** Run `bloc-populate` or `bloc --populate` in order to create the initial database
+**4.** Run `bloc-populate` or `bloc --populate` in order to create the initial database (In a future release `bloc` will automatically do this before it's first run)
+
     bloc --populate
 
 **5.** [Optional] Add on your autostart script an execution command to populate bloc database, so that when you start the system it gets automatically updated
@@ -50,16 +44,16 @@ As this is the first release of `bloc` no official installation is provided, but
 
 ### Tips
 
-* By default `bloc` does not detect directories and files you do not normally have access to. To change this, simply run `bloc` as sudo, and it will detect /root/ files as well
-* You can use any searcher you want with bloc (grep, ag, ack ...), as long as you pass it as an argument using the `-s` tag or change the default searcher command on bloc file
-* If you want to add any arguments to the searcher (i.e. -v, -E, -N) you can do so by specifing them with the `-s` tag, they should all work just right!
+* By default `bloc` does not detect files you do not normally have access to. To change this, simply run `bloc` as sudo, and it will detect /root/ files as well
+* You can use any searching toll you want with bloc (grep, ag, ack ...), as long as you pass it as an argument using the `-s` tag or change the default searcher command in the bloc file
+* If you want to add any arguments to the searcher (i.e. -v, -E, -N) you can do so by specifing them with the `-s` tag, they should all work just right! (Remember to also add the searcher you're using, i.e 'rg -vE')
 * You can populate `bloc` database by running `bloc -p` instead of `bloc-populate`
 * bloc-populate can recieve an output file as an argument when used with the `-o` tag
 * You can use the `-c` tag on `bloc` to make it search for any file, not just its database
 
 ### Troubleshooting
 
-If you're getting /root/path/to/db instead of /home/user/path/to/db in when running `bloc-populate` make sure you have the following line in your sudoers file:
+If you're getting /root/path/to/db instead of /home/user/path/to/db in when running `bloc-populate` as sudo make sure you have the following line in your sudoers file:
 
 	Default env_keep += "HOME"