-----------------
  HOW TO RUN
-----------------

By default hostsblock will run weekly as a cron job, but if you would like otherwise, for instance, you can move the hostsblock symbolic link from "/etc/cron.weekly/" to "/etc/cron.monthly/" or even delete it completely so that you can run hostsblock as and when you want it.

To run hostsblock for the first time or later manually, you can enter the command "sudo hostsblock" in Terminal or if running Nautilus as root, you can simply click the hostsblock script file and select "Run in Terminal".

-----------------
  USER LISTS
-----------------

If you need to add other hosts to "allow.list" and/or "deny.list", do the following as ROOT;
1) Create new plain text files named "allow.user.list" and/or "deny.user.list" in the same directory,
2) Open and enter any additional hosts there, and
3) Run the script "/usr/local/hostsblock/merge-lists" to merge user lists with default lists.
These changes will be taken into account at the first run of hostsblock.

-----------------
  REMOVAL
-----------------

Due to user modifications made later, the folder "/usr/local/hostsblock" may remain after normal package removal together with user created/modified list files, in which case you may need to remove this folder manually with the command "sudo rm -Rf /usr/local/hostsblock/". Other files that may also remain after package removal, and therefore requiring manual removal are: "/etc/hosts.block", "/etc/hosts.block.old" and "/etc/cron.weekly/hostsblock" (or any other user-preferred cron directory).
