From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-commits+bounces-374114-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1QujgP-00050v-Or
	for garchives@archives.gentoo.org; Sat, 20 Aug 2011 11:25:46 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 24A5E21C228;
	Sat, 20 Aug 2011 11:25:38 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
	by pigeon.gentoo.org (Postfix) with ESMTP id 6F69721C228
	for <gentoo-commits@lists.gentoo.org>; Sat, 20 Aug 2011 11:25:36 +0000 (UTC)
Received: from pelican.gentoo.org (unknown [66.219.59.40])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by smtp.gentoo.org (Postfix) with ESMTPS id 531DD1B4035
	for <gentoo-commits@lists.gentoo.org>; Sat, 20 Aug 2011 11:25:36 +0000 (UTC)
Received: from localhost.localdomain (localhost [127.0.0.1])
	by pelican.gentoo.org (Postfix) with ESMTP id 8374D80040
	for <gentoo-commits@lists.gentoo.org>; Sat, 20 Aug 2011 11:25:35 +0000 (UTC)
From: "Александр Берсенев" <bay@hackerdom.ru>
To: gentoo-commits@lists.gentoo.org
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Александр Берсенев" <bay@hackerdom.ru>
Message-ID: <0699154c16c5fc9aefb34d093c8415fe602b3b3e.bay@gentoo>
Subject: [gentoo-commits] proj/autodep:master commit in: docs/build/html/_sources/, docs/build/html/_modules/package_utils/, ...
X-VCS-Repository: proj/autodep
X-VCS-Files: docs/build/doctrees/api.doctree docs/build/doctrees/architecture.doctree docs/build/doctrees/environment.pickle docs/build/doctrees/man.doctree docs/build/html/_images/autodep_arch1.png docs/build/html/_modules/index.html docs/build/html/_modules/logfs/fstracer.html docs/build/html/_modules/package_utils/portage_log_parser.html docs/build/html/_modules/package_utils/portage_misc_functions.html docs/build/html/_modules/package_utils/portage_utils.html docs/build/html/_sources/api.txt docs/build/html/_sources/architecture.txt docs/build/html/_sources/man.txt docs/build/html/api.html docs/build/html/architecture.html docs/build/html/genindex.html docs/build/html/index.html docs/build/html/man.html docs/build/html/objects.inv docs/build/html/py-modindex.html docs/build/html/search.html docs/build/html/searchindex.js docs/build/man/autodep.1 docs/source/api.rst docs/source/architecture.rst docs/source/man.rst src/autodep/autodep
X-VCS-Directories: docs/build/html/_sources/ docs/build/html/_modules/package_utils/ docs/build/html/_images/ docs/build/html/ docs/source/ docs/build/man/ docs/build/html/_modules/logfs/ docs/build/html/_modules/ docs/build/doctrees/ src/autodep/
X-VCS-Committer: bay
X-VCS-Committer-Name: Александр Берсенев
X-VCS-Revision: 0699154c16c5fc9aefb34d093c8415fe602b3b3e
Date: Sat, 20 Aug 2011 11:25:35 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: quoted-printable
X-Archives-Salt: 
X-Archives-Hash: 08470b58e0f050e1f1aaf4e6b821a47d

commit:     0699154c16c5fc9aefb34d093c8415fe602b3b3e
Author:     Alexander Bersenev <bay <AT> hackerdom <DOT> ru>
AuthorDate: Sat Aug 20 17:24:10 2011 +0000
Commit:     =D0=90=D0=BB=D0=B5=D0=BA=D1=81=D0=B0=D0=BD=D0=B4=D1=80 =D0=91=
=D0=B5=D1=80=D1=81=D0=B5=D0=BD=D0=B5=D0=B2 <bay <AT> hackerdom <DOT> ru>
CommitDate: Sat Aug 20 17:24:10 2011 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=3Dproj/autodep.git;a=
=3Dcommit;h=3D0699154c

documentation fixes

---
 docs/build/doctrees/api.doctree                    |  Bin 46733 -> 46746=
 bytes
 docs/build/doctrees/architecture.doctree           |  Bin 16699 -> 18417=
 bytes
 docs/build/doctrees/environment.pickle             |  Bin 971377 -> 9717=
97 bytes
 docs/build/doctrees/man.doctree                    |  Bin 25760 -> 26064=
 bytes
 docs/build/html/_images/autodep_arch1.png          |  Bin 0 -> 44565 byt=
es
 docs/build/html/_modules/index.html                |    2 +-
 docs/build/html/_modules/logfs/fstracer.html       |    2 +-
 .../_modules/package_utils/portage_log_parser.html |    2 +-
 .../package_utils/portage_misc_functions.html      |    2 +-
 .../html/_modules/package_utils/portage_utils.html |    2 +-
 docs/build/html/_sources/api.txt                   |    2 +-
 docs/build/html/_sources/architecture.txt          |   69 ++++++++++----=
----
 docs/build/html/_sources/man.txt                   |   60 ++++++++------=
--
 docs/build/html/api.html                           |    6 +-
 docs/build/html/architecture.html                  |   76 +++++++++++---=
------
 docs/build/html/genindex.html                      |    2 +-
 docs/build/html/index.html                         |    6 +-
 docs/build/html/man.html                           |   71 +++++++++-----=
----
 docs/build/html/objects.inv                        |  Bin 502 -> 501 byt=
es
 docs/build/html/py-modindex.html                   |    2 +-
 docs/build/html/search.html                        |    2 +-
 docs/build/html/searchindex.js                     |    2 +-
 docs/build/man/autodep.1                           |   65 +++++++-------=
---
 docs/source/api.rst                                |    2 +-
 docs/source/architecture.rst                       |   69 ++++++++++----=
----
 docs/source/man.rst                                |   60 ++++++++------=
--
 src/autodep/autodep                                |   18 +++---
 27 files changed, 265 insertions(+), 257 deletions(-)

diff --git a/docs/build/doctrees/api.doctree b/docs/build/doctrees/api.do=
ctree
index 2516311..4821784 100644
Binary files a/docs/build/doctrees/api.doctree and b/docs/build/doctrees/=
api.doctree differ

diff --git a/docs/build/doctrees/architecture.doctree b/docs/build/doctre=
es/architecture.doctree
index ca0afd1..09810c7 100644
Binary files a/docs/build/doctrees/architecture.doctree and b/docs/build/=
doctrees/architecture.doctree differ

diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees=
/environment.pickle
index 23e328c..8d02379 100644
Binary files a/docs/build/doctrees/environment.pickle and b/docs/build/do=
ctrees/environment.pickle differ

diff --git a/docs/build/doctrees/man.doctree b/docs/build/doctrees/man.do=
ctree
index a6ca5c2..da00d7c 100644
Binary files a/docs/build/doctrees/man.doctree and b/docs/build/doctrees/=
man.doctree differ

diff --git a/docs/build/html/_images/autodep_arch1.png b/docs/build/html/=
_images/autodep_arch1.png
new file mode 100644
index 0000000..d0bfee9
Binary files /dev/null and b/docs/build/html/_images/autodep_arch1.png di=
ffer

diff --git a/docs/build/html/_modules/index.html b/docs/build/html/_modul=
es/index.html
index cc23e30..8141709 100644
--- a/docs/build/html/_modules/index.html
+++ b/docs/build/html/_modules/index.html
@@ -86,7 +86,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/_modules/logfs/fstracer.html b/docs/build/ht=
ml/_modules/logfs/fstracer.html
index 0abbd94..83a2ef6 100644
--- a/docs/build/html/_modules/logfs/fstracer.html
+++ b/docs/build/html/_modules/logfs/fstracer.html
@@ -327,7 +327,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/_modules/package_utils/portage_log_parser.ht=
ml b/docs/build/html/_modules/package_utils/portage_log_parser.html
index a468842..2c9e94b 100644
--- a/docs/build/html/_modules/package_utils/portage_log_parser.html
+++ b/docs/build/html/_modules/package_utils/portage_log_parser.html
@@ -170,7 +170,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/_modules/package_utils/portage_misc_function=
s.html b/docs/build/html/_modules/package_utils/portage_misc_functions.ht=
ml
index 034ad24..13fddfe 100644
--- a/docs/build/html/_modules/package_utils/portage_misc_functions.html
+++ b/docs/build/html/_modules/package_utils/portage_misc_functions.html
@@ -188,7 +188,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/_modules/package_utils/portage_utils.html b/=
docs/build/html/_modules/package_utils/portage_utils.html
index f7eba53..b0e63db 100644
--- a/docs/build/html/_modules/package_utils/portage_utils.html
+++ b/docs/build/html/_modules/package_utils/portage_utils.html
@@ -158,7 +158,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/_sources/api.txt b/docs/build/html/_sources/=
api.txt
index 1397732..502db1e 100644
--- a/docs/build/html/_sources/api.txt
+++ b/docs/build/html/_sources/api.txt
@@ -11,7 +11,7 @@ logfs.fstracer
 package_utils
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D
=20
-This package contains modules which works with the Portage system
+This package contains modules which work with the Portage system
=20
 .. automodule:: package_utils.portage_log_parser
    :members:

diff --git a/docs/build/html/_sources/architecture.txt b/docs/build/html/=
_sources/architecture.txt
index 59b55f8..2caec16 100644
--- a/docs/build/html/_sources/architecture.txt
+++ b/docs/build/html/_sources/architecture.txt
@@ -13,66 +13,71 @@ Format of network messages
 --------------------------
=20
=20
-1. Format of messages to file access registrar::
+1. Format of messages to the File Access Registrar::
=20
    <time of event: sec since 1970>
    <event type: open, read, write>
    <name of file>
    <building stage: stagename or unknown>
    <result:OK,ERR/errno,ASKING,DENIED>
-2. Format of answer for ASKING packet from registrar::
+2. Format of answer for ASKING packet from File Access Registrar::
=20
    <ALLOW | DENY>
=20
 *Notes:*
=20
 * All sockets are SOCK_SEQPACKET
-* All fields are delimited with character with code 0
+* All fields are delimited with character \0
=20
=20
-How Hooklib approach works?
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
+How does the Hooklib approach work?
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-The main idea of Hooklib approach is to load a dynamic library-hooker=20
-**before** any other library(including the C runtime, libc.so).=20
-So, the functions, such as open, read and write, executed from this libr=
ary
-instead of libc.so.
+The main idea behind the Hooklib approach is to load a dynamic library-h=
ook=20
+**before** any other library(including the C runtime).=20
+So, the calls to functions such as open, read and write, are intercepted=
=20
+using this library, instead of executing the ones in *libc*.
=20
-Hooklib module modifies Linux's dynamic linker behavior changing LD_PREL=
OAD=20
-environment variable(see=20
+Hooklib module modifies Linux's dynamic linker behavior, changing LD_PRE=
LOAD=20
+environment variable (see=20
 `man 8 ld-linux <http://linux.die.net/man/8/ld-linux>`_ for details).
-Module protects LD_PRELOAD variable from further changes by program.
+This module also protects LD_PRELOAD variable from further changes by ex=
ecuting=20
+program.
=20
-When hooklib module loads, it connects to file access registrar via Unix=
 domain=20
-sockets. If program forks or creates a new thread, another copy of libra=
ry=20
-loads.=20
+When Hooklib is loaded, it connects to the File Access Registrar via Uni=
x domain=20
+sockets. If a program forks or creates a new thread, another copy of the=
 library=20
+loads to register events from this new process/thread.=20
=20
-When program do open(...), read(...), write(...), library send an inform=
ation=20
-about a call to registrar. Registar can block or allow an event. If regi=
strer=20
-allows an event then the original function is called. Else error=20
-"file not found" is returned.
+When a program calls open(...), read(...), write(...), Hooklib sends a m=
essage =20
+about a call to the File Access Registrar. The Registar can then block=20
+or allow this event. If Registrar responds to the previous query with=20
+an ALLOW packet, then the original function is called. Otherwise, the fu=
nction=20
+is not called and a "File not Found" error is returned instead.
=20
-How Fusefs approach works?
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D
+How does the Fusefs approach work?
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-The main idea if Fusefs approach is to create a loggable filesystem in u=
serspace
-and chroot a program into it.
+The main idea of the Fusefs approach is to create a loggable filesystem =
in userspace
+and jail a program into it, using a chroot.
=20
-Before program is launched registrar prepare mounts. It usually do:
+Before the program is launched, The File Access Registrar prepare the mo=
unts.=20
+It would usually take the following steps:
=20
 1. mount -o bind / /mnt/rootfs/
-2. mount /dev/, /dev/pts, /dev/shm, /proc/, /sys/ same way
+2. mount /dev, /dev/pts, /dev/shm, /proc/, /sys/ binding them to /mnt/ro=
otfs
 3. mount /lib64/, /lib32/, /var/tmp/portage/ same way to increase perfor=
mance at=20
    cost of accuracy
-4. launch fuse over /mnt/rootfs/
+4. launch FUSE over /mnt/rootfs/
=20
-Fuse module blocks all external access to /mnt/rootfs while program runs=
.
-
-Fuse module also asks the registrar about event allowness.
+Fuse module blocks all external access to /mnt/rootfs while the program =
runs.
+The FUSE module will also ask the File Access Registrar to check whether=
 access to=20
+files inside the chroot are allowed or denied. As with the Hooklib appro=
ach, if=20
+access to a file is denied, a "File not Found" error is returned.
=20
 *Notes:*
=20
-* Checking for allowness takes a much time
+* Checking for permission to access a file with the File Access Registra=
r, takes a=20
+lot of time under this approach.
=20
 Futher analysis of file access events
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -90,6 +95,6 @@ unuseful packages.
 Rules of heuristics
 -------------------
=20
-1. *Package is not useful if all files are .desktop or .xml or .m4*.
+1. *Package is not useful if all files are .desktop, .xml or .m4*.
    Aclocal util tries to read all .m4 files in /usr/share/aclocal direct=
ory.
-   Files ending on .desktop and .xml often readed on postrm phase.
\ No newline at end of file
+   Files ending on .desktop and .xml are often read in the postrm phase.
\ No newline at end of file

diff --git a/docs/build/html/_sources/man.txt b/docs/build/html/_sources/=
man.txt
index b49fb54..bf5ad86 100644
--- a/docs/build/html/_sources/man.txt
+++ b/docs/build/html/_sources/man.txt
@@ -10,10 +10,10 @@ SYNOPSIS
 DESCRIPTION
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-Auto dependency builder is a tool for analysis files accessed during=20
-building a package. It also can be used for runtime dependencies analysi=
s.
+Auto dependency (autodep) builder is a tool for the analysis of accessed=
 files during=20
+the build of a package. It also can be used for runtime dependencies ana=
lysis.
=20
-The tool can block an access to files of defined packages.
+The tool can trace, log and block access to files of given packages.
=20
 OPTIONS
 =3D=3D=3D=3D=3D=3D=3D
@@ -22,78 +22,78 @@ OPTIONS
=20
 .. cmdoption:: --help, -h
=20
-   show this help message and exit
+   Show this help message and exit.
=20
 .. cmdoption:: -b, --block
=20
-   strict mode: deny all access to non-dependency packages
+   strict mode: Deny all access to files from non-dependency packages.
=20
 .. cmdoption:: --blockpkgs=3DPACKAGES
=20
-   block an access to files from this packages
+   Block access to files from this packages.
=20
 .. cmdoption:: -f, --files=20
=20
-   show accessed files and not founded files
+   Show all files, accessed and missing (not found).
 .. cmdoption:: -v, --verbose=20
=20
-   show non-important packages, show unknown package and unknown stage
+   Show non-important packages, unknown packages and unknown building st=
ages.
 .. cmdoption:: --nocolor, -C
=20
-   don't output color
+   Don't colorize output
 .. cmdoption:: --hooklib
=20
-   use ld_preload logging approach(default)
+   Use LD_PRELOAD logging approach (default).
 .. cmdoption:: --fusefs
=20
-   use fuse logging approach(slow, but reliable)
+   Use FUSE logging approach (slow, but reliable).
=20
 HOOKLIB VS FUSEFS
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
 +------------------------------------------------+-------------+--------=
-------+
-|                                                |   Hooklib   |     Fus=
efs    |
+|                                                |   Hooklib   |     Fus=
eFS    |
 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D+
 | Who can use this approach?                     | **Any user**|   Only =
root   |
 +------------------------------------------------+-------------+--------=
-------+
-| Is approach allows blocking an access to files?|  **YES**    | **YES**=
       |
+| Does approach allows to block access to files? |  **YES**    | **YES**=
       |
 +------------------------------------------------+-------------+--------=
-------+
-| Is overhead in performance big?                |  **NO**     | YES [#f=
1]_    |
+| Is the overhead in performance noticeable?     |  **NO**     | YES [#f=
1]_    |
 +------------------------------------------------+-------------+--------=
-------+
 | What events are logged?                        |  Most [#f2]_| **ALL**=
       |
 +------------------------------------------------+-------------+--------=
-------+
-| When is it recomended to use an approach?      | For analysis| For ana=
lysis  |
+| When is it recomended to use an approach?      | Analysis    | Analysi=
s      |
 |                                                | of          | of *run=
time*  |
 |                                                | *buildtime* | depende=
ncies  |
 |                                                | dependencies|        =
       |
 +------------------------------------------------+-------------+--------=
-------+
-| Is any pre-requirements for using an approach? | **NO**      | FUSE mu=
st be  |
-|                                                |             | enabled=
 in    |
+| Are there any pre-requirements                 | **NO**      | FUSE mu=
st be  |
+| for using an approach?                         |             | enabled=
 in    |
 |                                                |             | kernel =
       |
 +------------------------------------------------+-------------+--------=
-------+
=20
 .. rubric:: Notes
=20
-.. [#f1] Fuse file system is slower than normal one. Program reads many =
files=20
+.. [#f1] FUSE filesystems are slower than a normal one. A Program access=
es many files=20
    while launching, so this will take more time than usual.
-.. [#f2] Loading of dynamic libraries and direct syscalls will not be lo=
gged.
+.. [#f2] Loading of Dynamic libraries and direct syscalls will not be lo=
gged.
=20
 Examples
 =3D=3D=3D=3D=3D=3D=3D=3D
=20
-Get the potential dependencies of a xchat package:
------------------------------------------------------
-autodep emerge xchat
+Get the potential dependencies for net-irc/xchat:
+-------------------------------------------------
+autodep emerge net-irc/xchat
=20
-Get the potential dependencies of a xchat package, blocking x11-misc/uti=
l-macros package:
-------------------------------------------------------------------------=
--------------------
-autodep emerge --block x11-misc/util-macros emerge xchat
+Get the potential dependencies for net-irc/xchat, blocking files from x1=
1-misc/util-macros package:
+------------------------------------------------------------------------=
---------------------------
+autodep emerge --block x11-misc/util-macros emerge net-irc/xchat
=20
-Get the potential dependencies of a xchat package, and show files access=
ed:
-------------------------------------------------------------------------=
------
-autodep --files emerge xchat
+Get the potential dependencies for net-irc/xchat package, and show acces=
sed files:
+------------------------------------------------------------------------=
----------
+autodep --files emerge net-irc/xchat
=20
-Get the runtime dependencies of a xchat and show files accessed:
--------------------------------------------------------------------
+Get the runtime dependencies of a xchat and show accessed files:
+----------------------------------------------------------------
 autodep --fusefs --files xchat
=20

diff --git a/docs/build/html/api.html b/docs/build/html/api.html
index bec16d7..e485aa5 100644
--- a/docs/build/html/api.html
+++ b/docs/build/html/api.html
@@ -56,7 +56,7 @@ handling dependency logic.</p>
 <p>It can be used to launch a program and get all file events</p>
 <dl class=3D"function">
 <dt id=3D"logfs.fstracer.getfsevents">
-<tt class=3D"descclassname">logfs.fstracer.</tt><tt class=3D"descname">g=
etfsevents</tt><big>(</big><em>prog_name</em>, <em>arguments</em>, <em>ap=
proach=3D'hooklib'</em>, <em>filterproc=3D&lt;function defaultfilter at 0=
x1b2bc80&gt;</em><big>)</big><a class=3D"reference internal" href=3D"_mod=
ules/logfs/fstracer.html#getfsevents"><span class=3D"viewcode-link">[sour=
ce]</span></a><a class=3D"headerlink" href=3D"#logfs.fstracer.getfsevents=
" title=3D"Permalink to this definition">=C2=B6</a></dt>
+<tt class=3D"descclassname">logfs.fstracer.</tt><tt class=3D"descname">g=
etfsevents</tt><big>(</big><em>prog_name</em>, <em>arguments</em>, <em>ap=
proach=3D'hooklib'</em>, <em>filterproc=3D&lt;function defaultfilter at 0=
x1dcb938&gt;</em><big>)</big><a class=3D"reference internal" href=3D"_mod=
ules/logfs/fstracer.html#getfsevents"><span class=3D"viewcode-link">[sour=
ce]</span></a><a class=3D"headerlink" href=3D"#logfs.fstracer.getfsevents=
" title=3D"Permalink to this definition">=C2=B6</a></dt>
 <dd><p>Launches a program and gets file access events</p>
 <table class=3D"docutils field-list" frame=3D"void" rules=3D"none">
 <col class=3D"field-name" />
@@ -90,7 +90,7 @@ Stage can be <em>&#8216;unknown&#8217;</em></p>
 </div>
 <div class=3D"section" id=3D"package-utils">
 <h2>package_utils<a class=3D"headerlink" href=3D"#package-utils" title=3D=
"Permalink to this headline">=C2=B6</a></h2>
-<p>This package contains modules which works with the Portage system</p>
+<p>This package contains modules which work with the Portage system</p>
 <span class=3D"target" id=3D"module-package_utils.portage_log_parser"></=
span><dl class=3D"function">
 <dt id=3D"package_utils.portage_log_parser.get_list_of_merged_packages">
 <tt class=3D"descclassname">package_utils.portage_log_parser.</tt><tt cl=
ass=3D"descname">get_list_of_merged_packages</tt><big>(</big><em>starttim=
e=3D0</em>, <em>endtime=3D-1</em><big>)</big><a class=3D"reference intern=
al" href=3D"_modules/package_utils/portage_log_parser.html#get_list_of_me=
rged_packages"><span class=3D"viewcode-link">[source]</span></a><a class=3D=
"headerlink" href=3D"#package_utils.portage_log_parser.get_list_of_merged=
_packages" title=3D"Permalink to this definition">=C2=B6</a></dt>
@@ -329,7 +329,7 @@ list)</td>
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/architecture.html b/docs/build/html/architec=
ture.html
index f827cff..855b3ab 100644
--- a/docs/build/html/architecture.html
+++ b/docs/build/html/architecture.html
@@ -57,12 +57,12 @@
 <h2>How it works?<a class=3D"headerlink" href=3D"#how-it-works" title=3D=
"Permalink to this headline">=C2=B6</a></h2>
 <div class=3D"section" id=3D"scheme">
 <h3>Scheme<a class=3D"headerlink" href=3D"#scheme" title=3D"Permalink to=
 this headline">=C2=B6</a></h3>
-<img alt=3D"_images/autodep_arch.png" src=3D"_images/autodep_arch.png" /=
>
+<img alt=3D"_images/autodep_arch1.png" src=3D"_images/autodep_arch1.png"=
 />
 </div>
 <div class=3D"section" id=3D"format-of-network-messages">
 <h3>Format of network messages<a class=3D"headerlink" href=3D"#format-of=
-network-messages" title=3D"Permalink to this headline">=C2=B6</a></h3>
 <ol class=3D"arabic">
-<li><p class=3D"first">Format of messages to file access registrar:</p>
+<li><p class=3D"first">Format of messages to the File Access Registrar:<=
/p>
 <div class=3D"highlight-python"><pre>&lt;time of event: sec since 1970&g=
t;
 &lt;event type: open, read, write&gt;
 &lt;name of file&gt;
@@ -70,7 +70,7 @@
 &lt;result:OK,ERR/errno,ASKING,DENIED&gt;</pre>
 </div>
 </li>
-<li><p class=3D"first">Format of answer for ASKING packet from registrar=
:</p>
+<li><p class=3D"first">Format of answer for ASKING packet from File Acce=
ss Registrar:</p>
 <div class=3D"highlight-python"><pre>&lt;ALLOW | DENY&gt;</pre>
 </div>
 </li>
@@ -78,46 +78,52 @@
 <p><em>Notes:</em></p>
 <ul class=3D"simple">
 <li>All sockets are SOCK_SEQPACKET</li>
-<li>All fields are delimited with character with code 0</li>
+<li>All fields are delimited with character 0</li>
 </ul>
 </div>
 </div>
-<div class=3D"section" id=3D"how-hooklib-approach-works">
-<h2>How Hooklib approach works?<a class=3D"headerlink" href=3D"#how-hook=
lib-approach-works" title=3D"Permalink to this headline">=C2=B6</a></h2>
-<p>The main idea of Hooklib approach is to load a dynamic library-hooker
-<strong>before</strong> any other library(including the C runtime, libc.=
so).
-So, the functions, such as open, read and write, executed from this libr=
ary
-instead of libc.so.</p>
-<p>Hooklib module modifies Linux&#8217;s dynamic linker behavior changin=
g LD_PRELOAD
-environment variable(see
+<div class=3D"section" id=3D"how-does-the-hooklib-approach-work">
+<h2>How does the Hooklib approach work?<a class=3D"headerlink" href=3D"#=
how-does-the-hooklib-approach-work" title=3D"Permalink to this headline">=
=C2=B6</a></h2>
+<p>The main idea behind the Hooklib approach is to load a dynamic librar=
y-hook
+<strong>before</strong> any other library(including the C runtime).
+So, the calls to functions such as open, read and write, are intercepted
+using this library, instead of executing the ones in <em>libc</em>.</p>
+<p>Hooklib module modifies Linux&#8217;s dynamic linker behavior, changi=
ng LD_PRELOAD
+environment variable (see
 <a class=3D"reference external" href=3D"http://linux.die.net/man/8/ld-li=
nux">man 8 ld-linux</a> for details).
-Module protects LD_PRELOAD variable from further changes by program.</p>
-<p>When hooklib module loads, it connects to file access registrar via U=
nix domain
-sockets. If program forks or creates a new thread, another copy of libra=
ry
-loads.</p>
-<p>When program do open(...), read(...), write(...), library send an inf=
ormation
-about a call to registrar. Registar can block or allow an event. If regi=
strer
-allows an event then the original function is called. Else error
-&#8220;file not found&#8221; is returned.</p>
+This module also protects LD_PRELOAD variable from further changes by ex=
ecuting
+program.</p>
+<p>When Hooklib is loaded, it connects to the File Access Registrar via =
Unix domain
+sockets. If a program forks or creates a new thread, another copy of the=
 library
+loads to register events from this new process/thread.</p>
+<p>When a program calls open(...), read(...), write(...), Hooklib sends =
a message
+about a call to the File Access Registrar. The Registar can then block
+or allow this event. If Registrar responds to the previous query with
+an ALLOW packet, then the original function is called. Otherwise, the fu=
nction
+is not called and a &#8220;File not Found&#8221; error is returned inste=
ad.</p>
 </div>
-<div class=3D"section" id=3D"how-fusefs-approach-works">
-<h2>How Fusefs approach works?<a class=3D"headerlink" href=3D"#how-fusef=
s-approach-works" title=3D"Permalink to this headline">=C2=B6</a></h2>
-<p>The main idea if Fusefs approach is to create a loggable filesystem i=
n userspace
-and chroot a program into it.</p>
-<p>Before program is launched registrar prepare mounts. It usually do:</=
p>
+<div class=3D"section" id=3D"how-does-the-fusefs-approach-work">
+<h2>How does the Fusefs approach work?<a class=3D"headerlink" href=3D"#h=
ow-does-the-fusefs-approach-work" title=3D"Permalink to this headline">=C2=
=B6</a></h2>
+<p>The main idea of the Fusefs approach is to create a loggable filesyst=
em in userspace
+and jail a program into it, using a chroot.</p>
+<p>Before the program is launched, The File Access Registrar prepare the=
 mounts.
+It would usually take the following steps:</p>
 <ol class=3D"arabic simple">
 <li>mount -o bind / /mnt/rootfs/</li>
-<li>mount /dev/, /dev/pts, /dev/shm, /proc/, /sys/ same way</li>
+<li>mount /dev, /dev/pts, /dev/shm, /proc/, /sys/ binding them to /mnt/r=
ootfs</li>
 <li>mount /lib64/, /lib32/, /var/tmp/portage/ same way to increase perfo=
rmance at
 cost of accuracy</li>
-<li>launch fuse over /mnt/rootfs/</li>
+<li>launch FUSE over /mnt/rootfs/</li>
 </ol>
-<p>Fuse module blocks all external access to /mnt/rootfs while program r=
uns.</p>
-<p>Fuse module also asks the registrar about event allowness.</p>
+<p>Fuse module blocks all external access to /mnt/rootfs while the progr=
am runs.
+The FUSE module will also ask the File Access Registrar to check whether=
 access to
+files inside the chroot are allowed or denied. As with the Hooklib appro=
ach, if
+access to a file is denied, a &#8220;File not Found&#8221; error is retu=
rned.</p>
 <p><em>Notes:</em></p>
 <ul class=3D"simple">
-<li>Checking for allowness takes a much time</li>
+<li>Checking for permission to access a file with the File Access Regist=
rar, takes a</li>
 </ul>
+<p>lot of time under this approach.</p>
 </div>
 <div class=3D"section" id=3D"futher-analysis-of-file-access-events">
 <h2>Futher analysis of file access events<a class=3D"headerlink" href=3D=
"#futher-analysis-of-file-access-events" title=3D"Permalink to this headl=
ine">=C2=B6</a></h2>
@@ -131,9 +137,9 @@ unuseful packages.</p>
 <div class=3D"section" id=3D"rules-of-heuristics">
 <h3>Rules of heuristics<a class=3D"headerlink" href=3D"#rules-of-heurist=
ics" title=3D"Permalink to this headline">=C2=B6</a></h3>
 <ol class=3D"arabic simple">
-<li><em>Package is not useful if all files are .desktop or .xml or .m4</=
em>.
+<li><em>Package is not useful if all files are .desktop, .xml or .m4</em=
>.
 Aclocal util tries to read all .m4 files in /usr/share/aclocal directory=
.
-Files ending on .desktop and .xml often readed on postrm phase.</li>
+Files ending on .desktop and .xml are often read in the postrm phase.</l=
i>
 </ol>
 </div>
 </div>
@@ -153,8 +159,8 @@ Files ending on .desktop and .xml often readed on pos=
trm phase.</li>
 <li><a class=3D"reference internal" href=3D"#format-of-network-messages"=
>Format of network messages</a></li>
 </ul>
 </li>
-<li><a class=3D"reference internal" href=3D"#how-hooklib-approach-works"=
>How Hooklib approach works?</a></li>
-<li><a class=3D"reference internal" href=3D"#how-fusefs-approach-works">=
How Fusefs approach works?</a></li>
+<li><a class=3D"reference internal" href=3D"#how-does-the-hooklib-approa=
ch-work">How does the Hooklib approach work?</a></li>
+<li><a class=3D"reference internal" href=3D"#how-does-the-fusefs-approac=
h-work">How does the Fusefs approach work?</a></li>
 <li><a class=3D"reference internal" href=3D"#futher-analysis-of-file-acc=
ess-events">Futher analysis of file access events</a><ul>
 <li><a class=3D"reference internal" href=3D"#rules-of-heuristics">Rules =
of heuristics</a></li>
 </ul>
@@ -211,7 +217,7 @@ Files ending on .desktop and .xml often readed on pos=
trm phase.</li>
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Jul 25, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.htm=
l
index 3afc1ac..1889b59 100644
--- a/docs/build/html/genindex.html
+++ b/docs/build/html/genindex.html
@@ -200,7 +200,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/index.html b/docs/build/html/index.html
index 95f586e..85fe72a 100644
--- a/docs/build/html/index.html
+++ b/docs/build/html/index.html
@@ -66,8 +66,8 @@
 </li>
 <li class=3D"toctree-l1"><a class=3D"reference internal" href=3D"archite=
cture.html">Internals</a><ul>
 <li class=3D"toctree-l2"><a class=3D"reference internal" href=3D"archite=
cture.html#how-it-works">How it works?</a></li>
-<li class=3D"toctree-l2"><a class=3D"reference internal" href=3D"archite=
cture.html#how-hooklib-approach-works">How Hooklib approach works?</a></l=
i>
-<li class=3D"toctree-l2"><a class=3D"reference internal" href=3D"archite=
cture.html#how-fusefs-approach-works">How Fusefs approach works?</a></li>
+<li class=3D"toctree-l2"><a class=3D"reference internal" href=3D"archite=
cture.html#how-does-the-hooklib-approach-work">How does the Hooklib appro=
ach work?</a></li>
+<li class=3D"toctree-l2"><a class=3D"reference internal" href=3D"archite=
cture.html#how-does-the-fusefs-approach-work">How does the Fusefs approac=
h work?</a></li>
 <li class=3D"toctree-l2"><a class=3D"reference internal" href=3D"archite=
cture.html#futher-analysis-of-file-access-events">Futher analysis of file=
 access events</a></li>
 </ul>
 </li>
@@ -136,7 +136,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/man.html b/docs/build/html/man.html
index 734bd1f..2560335 100644
--- a/docs/build/html/man.html
+++ b/docs/build/html/man.html
@@ -51,58 +51,58 @@
 </div>
 <div class=3D"section" id=3D"description">
 <h2>DESCRIPTION<a class=3D"headerlink" href=3D"#description" title=3D"Pe=
rmalink to this headline">=C2=B6</a></h2>
-<p>Auto dependency builder is a tool for analysis files accessed during
-building a package. It also can be used for runtime dependencies analysi=
s.</p>
-<p>The tool can block an access to files of defined packages.</p>
+<p>Auto dependency (autodep) builder is a tool for the analysis of acces=
sed files during
+the build of a package. It also can be used for runtime dependencies ana=
lysis.</p>
+<p>The tool can trace, log and block access to files of given packages.<=
/p>
 </div>
 <div class=3D"section" id=3D"options">
 <h2>OPTIONS<a class=3D"headerlink" href=3D"#options" title=3D"Permalink =
to this headline">=C2=B6</a></h2>
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep--help">
 <tt class=3D"descname">--help</tt><tt class=3D"descclassname"></tt><tt c=
lass=3D"descclassname">, </tt><tt class=3D"descname">-h</tt><tt class=3D"=
descclassname"></tt><a class=3D"headerlink" href=3D"#cmdoption-autodep--h=
elp" title=3D"Permalink to this definition">=C2=B6</a></dt>
-<dd><p>show this help message and exit</p>
+<dd><p>Show this help message and exit.</p>
 </dd></dl>
=20
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep-b">
 <tt class=3D"descname">-b</tt><tt class=3D"descclassname"></tt><tt class=
=3D"descclassname">, </tt><tt class=3D"descname">--block</tt><tt class=3D=
"descclassname"></tt><a class=3D"headerlink" href=3D"#cmdoption-autodep-b=
" title=3D"Permalink to this definition">=C2=B6</a></dt>
-<dd><p>strict mode: deny all access to non-dependency packages</p>
+<dd><p>strict mode: Deny all access to files from non-dependency package=
s.</p>
 </dd></dl>
=20
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep--blockpkgs">
 <tt class=3D"descname">--blockpkgs</tt><tt class=3D"descclassname">=3DPA=
CKAGES</tt><a class=3D"headerlink" href=3D"#cmdoption-autodep--blockpkgs"=
 title=3D"Permalink to this definition">=C2=B6</a></dt>
-<dd><p>block an access to files from this packages</p>
+<dd><p>Block access to files from this packages.</p>
 </dd></dl>
=20
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep-f">
 <tt class=3D"descname">-f</tt><tt class=3D"descclassname"></tt><tt class=
=3D"descclassname">, </tt><tt class=3D"descname">--files</tt><tt class=3D=
"descclassname"></tt><a class=3D"headerlink" href=3D"#cmdoption-autodep-f=
" title=3D"Permalink to this definition">=C2=B6</a></dt>
-<dd><p>show accessed files and not founded files</p>
+<dd><p>Show all files, accessed and missing (not found).</p>
 </dd></dl>
=20
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep-v">
 <tt class=3D"descname">-v</tt><tt class=3D"descclassname"></tt><tt class=
=3D"descclassname">, </tt><tt class=3D"descname">--verbose</tt><tt class=3D=
"descclassname"></tt><a class=3D"headerlink" href=3D"#cmdoption-autodep-v=
" title=3D"Permalink to this definition">=C2=B6</a></dt>
-<dd><p>show non-important packages, show unknown package and unknown sta=
ge</p>
+<dd><p>Show non-important packages, unknown packages and unknown buildin=
g stages.</p>
 </dd></dl>
=20
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep--nocolor">
 <tt class=3D"descname">--nocolor</tt><tt class=3D"descclassname"></tt><t=
t class=3D"descclassname">, </tt><tt class=3D"descname">-C</tt><tt class=3D=
"descclassname"></tt><a class=3D"headerlink" href=3D"#cmdoption-autodep--=
nocolor" title=3D"Permalink to this definition">=C2=B6</a></dt>
-<dd><p>don&#8217;t output color</p>
+<dd><p>Don&#8217;t colorize output</p>
 </dd></dl>
=20
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep--hooklib">
 <tt class=3D"descname">--hooklib</tt><tt class=3D"descclassname"></tt><a=
 class=3D"headerlink" href=3D"#cmdoption-autodep--hooklib" title=3D"Perma=
link to this definition">=C2=B6</a></dt>
-<dd><p>use ld_preload logging approach(default)</p>
+<dd><p>Use LD_PRELOAD logging approach (default).</p>
 </dd></dl>
=20
 <dl class=3D"cmdoption">
 <dt id=3D"cmdoption-autodep--fusefs">
 <tt class=3D"descname">--fusefs</tt><tt class=3D"descclassname"></tt><a =
class=3D"headerlink" href=3D"#cmdoption-autodep--fusefs" title=3D"Permali=
nk to this definition">=C2=B6</a></dt>
-<dd><p>use fuse logging approach(slow, but reliable)</p>
+<dd><p>Use FUSE logging approach (slow, but reliable).</p>
 </dd></dl>
=20
 </div>
@@ -117,7 +117,7 @@ building a package. It also can be used for runtime d=
ependencies analysis.</p>
 <thead valign=3D"bottom">
 <tr><th class=3D"head">&nbsp;</th>
 <th class=3D"head">Hooklib</th>
-<th class=3D"head">Fusefs</th>
+<th class=3D"head">FuseFS</th>
 </tr>
 </thead>
 <tbody valign=3D"top">
@@ -125,11 +125,11 @@ building a package. It also can be used for runtime=
 dependencies analysis.</p>
 <td><strong>Any user</strong></td>
 <td>Only root</td>
 </tr>
-<tr><td>Is approach allows blocking an access to files?</td>
+<tr><td>Does approach allows to block access to files?</td>
 <td><strong>YES</strong></td>
 <td><strong>YES</strong></td>
 </tr>
-<tr><td>Is overhead in performance big?</td>
+<tr><td>Is the overhead in performance noticeable?</td>
 <td><strong>NO</strong></td>
 <td>YES <a class=3D"footnote-reference" href=3D"#f1" id=3D"id1">[1]</a><=
/td>
 </tr>
@@ -138,15 +138,16 @@ building a package. It also can be used for runtime=
 dependencies analysis.</p>
 <td><strong>ALL</strong></td>
 </tr>
 <tr><td>When is it recomended to use an approach?</td>
-<td>For analysis
+<td>Analysis
 of
 <em>buildtime</em>
 dependencies</td>
-<td>For analysis
+<td>Analysis
 of <em>runtime</em>
 dependencies</td>
 </tr>
-<tr><td>Is any pre-requirements for using an approach?</td>
+<tr><td>Are there any pre-requirements
+for using an approach?</td>
 <td><strong>NO</strong></td>
 <td>FUSE must be
 enabled in
@@ -158,33 +159,33 @@ kernel</td>
 <table class=3D"docutils footnote" frame=3D"void" id=3D"f1" rules=3D"non=
e">
 <colgroup><col class=3D"label" /><col /></colgroup>
 <tbody valign=3D"top">
-<tr><td class=3D"label"><a class=3D"fn-backref" href=3D"#id1">[1]</a></t=
d><td>Fuse file system is slower than normal one. Program reads many file=
s
+<tr><td class=3D"label"><a class=3D"fn-backref" href=3D"#id1">[1]</a></t=
d><td>FUSE filesystems are slower than a normal one. A Program accesses m=
any files
 while launching, so this will take more time than usual.</td></tr>
 </tbody>
 </table>
 <table class=3D"docutils footnote" frame=3D"void" id=3D"f2" rules=3D"non=
e">
 <colgroup><col class=3D"label" /><col /></colgroup>
 <tbody valign=3D"top">
-<tr><td class=3D"label"><a class=3D"fn-backref" href=3D"#id2">[2]</a></t=
d><td>Loading of dynamic libraries and direct syscalls will not be logged=
.</td></tr>
+<tr><td class=3D"label"><a class=3D"fn-backref" href=3D"#id2">[2]</a></t=
d><td>Loading of Dynamic libraries and direct syscalls will not be logged=
.</td></tr>
 </tbody>
 </table>
 </div>
 <div class=3D"section" id=3D"examples">
 <h2>Examples<a class=3D"headerlink" href=3D"#examples" title=3D"Permalin=
k to this headline">=C2=B6</a></h2>
-<div class=3D"section" id=3D"get-the-potential-dependencies-of-a-xchat-p=
ackage">
-<h3>Get the potential dependencies of a xchat package:<a class=3D"header=
link" href=3D"#get-the-potential-dependencies-of-a-xchat-package" title=3D=
"Permalink to this headline">=C2=B6</a></h3>
-<p>autodep emerge xchat</p>
+<div class=3D"section" id=3D"get-the-potential-dependencies-for-net-irc-=
xchat">
+<h3>Get the potential dependencies for net-irc/xchat:<a class=3D"headerl=
ink" href=3D"#get-the-potential-dependencies-for-net-irc-xchat" title=3D"=
Permalink to this headline">=C2=B6</a></h3>
+<p>autodep emerge net-irc/xchat</p>
 </div>
-<div class=3D"section" id=3D"get-the-potential-dependencies-of-a-xchat-p=
ackage-blocking-x11-misc-util-macros-package">
-<h3>Get the potential dependencies of a xchat package, blocking x11-misc=
/util-macros package:<a class=3D"headerlink" href=3D"#get-the-potential-d=
ependencies-of-a-xchat-package-blocking-x11-misc-util-macros-package" tit=
le=3D"Permalink to this headline">=C2=B6</a></h3>
-<p>autodep emerge &#8211;block x11-misc/util-macros emerge xchat</p>
+<div class=3D"section" id=3D"get-the-potential-dependencies-for-net-irc-=
xchat-blocking-files-from-x11-misc-util-macros-package">
+<h3>Get the potential dependencies for net-irc/xchat, blocking files fro=
m x11-misc/util-macros package:<a class=3D"headerlink" href=3D"#get-the-p=
otential-dependencies-for-net-irc-xchat-blocking-files-from-x11-misc-util=
-macros-package" title=3D"Permalink to this headline">=C2=B6</a></h3>
+<p>autodep emerge &#8211;block x11-misc/util-macros emerge net-irc/xchat=
</p>
 </div>
-<div class=3D"section" id=3D"get-the-potential-dependencies-of-a-xchat-p=
ackage-and-show-files-accessed">
-<h3>Get the potential dependencies of a xchat package, and show files ac=
cessed:<a class=3D"headerlink" href=3D"#get-the-potential-dependencies-of=
-a-xchat-package-and-show-files-accessed" title=3D"Permalink to this head=
line">=C2=B6</a></h3>
-<p>autodep &#8211;files emerge xchat</p>
+<div class=3D"section" id=3D"get-the-potential-dependencies-for-net-irc-=
xchat-package-and-show-accessed-files">
+<h3>Get the potential dependencies for net-irc/xchat package, and show a=
ccessed files:<a class=3D"headerlink" href=3D"#get-the-potential-dependen=
cies-for-net-irc-xchat-package-and-show-accessed-files" title=3D"Permalin=
k to this headline">=C2=B6</a></h3>
+<p>autodep &#8211;files emerge net-irc/xchat</p>
 </div>
-<div class=3D"section" id=3D"get-the-runtime-dependencies-of-a-xchat-and=
-show-files-accessed">
-<h3>Get the runtime dependencies of a xchat and show files accessed:<a c=
lass=3D"headerlink" href=3D"#get-the-runtime-dependencies-of-a-xchat-and-=
show-files-accessed" title=3D"Permalink to this headline">=C2=B6</a></h3>
+<div class=3D"section" id=3D"get-the-runtime-dependencies-of-a-xchat-and=
-show-accessed-files">
+<h3>Get the runtime dependencies of a xchat and show accessed files:<a c=
lass=3D"headerlink" href=3D"#get-the-runtime-dependencies-of-a-xchat-and-=
show-accessed-files" title=3D"Permalink to this headline">=C2=B6</a></h3>
 <p>autodep &#8211;fusefs &#8211;files xchat</p>
 </div>
 </div>
@@ -204,10 +205,10 @@ while launching, so this will take more time than u=
sual.</td></tr>
 <li><a class=3D"reference internal" href=3D"#options">OPTIONS</a></li>
 <li><a class=3D"reference internal" href=3D"#hooklib-vs-fusefs">HOOKLIB =
VS FUSEFS</a></li>
 <li><a class=3D"reference internal" href=3D"#examples">Examples</a><ul>
-<li><a class=3D"reference internal" href=3D"#get-the-potential-dependenc=
ies-of-a-xchat-package">Get the potential dependencies of a xchat package=
:</a></li>
-<li><a class=3D"reference internal" href=3D"#get-the-potential-dependenc=
ies-of-a-xchat-package-blocking-x11-misc-util-macros-package">Get the pot=
ential dependencies of a xchat package, blocking x11-misc/util-macros pac=
kage:</a></li>
-<li><a class=3D"reference internal" href=3D"#get-the-potential-dependenc=
ies-of-a-xchat-package-and-show-files-accessed">Get the potential depende=
ncies of a xchat package, and show files accessed:</a></li>
-<li><a class=3D"reference internal" href=3D"#get-the-runtime-dependencie=
s-of-a-xchat-and-show-files-accessed">Get the runtime dependencies of a x=
chat and show files accessed:</a></li>
+<li><a class=3D"reference internal" href=3D"#get-the-potential-dependenc=
ies-for-net-irc-xchat">Get the potential dependencies for net-irc/xchat:<=
/a></li>
+<li><a class=3D"reference internal" href=3D"#get-the-potential-dependenc=
ies-for-net-irc-xchat-blocking-files-from-x11-misc-util-macros-package">G=
et the potential dependencies for net-irc/xchat, blocking files from x11-=
misc/util-macros package:</a></li>
+<li><a class=3D"reference internal" href=3D"#get-the-potential-dependenc=
ies-for-net-irc-xchat-package-and-show-accessed-files">Get the potential =
dependencies for net-irc/xchat package, and show accessed files:</a></li>
+<li><a class=3D"reference internal" href=3D"#get-the-runtime-dependencie=
s-of-a-xchat-and-show-accessed-files">Get the runtime dependencies of a x=
chat and show accessed files:</a></li>
 </ul>
 </li>
 </ul>
@@ -250,7 +251,7 @@ while launching, so this will take more time than usu=
al.</td></tr>
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 03, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv
index 72db0bb..a96802c 100644
Binary files a/docs/build/html/objects.inv and b/docs/build/html/objects.=
inv differ

diff --git a/docs/build/html/py-modindex.html b/docs/build/html/py-modind=
ex.html
index e197fdc..e6d78e4 100644
--- a/docs/build/html/py-modindex.html
+++ b/docs/build/html/py-modindex.html
@@ -132,7 +132,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/search.html b/docs/build/html/search.html
index 14597c1..5ecd73c 100644
--- a/docs/build/html/search.html
+++ b/docs/build/html/search.html
@@ -96,7 +96,7 @@
     </div>
     <div class=3D"footer">
         &copy; Copyright 2011, Alexander Bersenev.
-      Last updated on Aug 04, 2011.
+      Last updated on Aug 20, 2011.
       Created using <a href=3D"http://sphinx.pocoo.org/">Sphinx</a> 1.0.=
7.
     </div>
   </body>

diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex=
.js
index fa12b7a..a593094 100644
--- a/docs/build/html/searchindex.js
+++ b/docs/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({objects:{"":{"-v":[4,0,1],"-f":[4,0,1],"-C":[2,0,1],"-b=
":[4,0,1],"--hooklib":[4,0,1],"--fusefs":[4,0,1],"--blockpkgs":[4,0,1],"-=
-nocolor":[4,0,1],"--help":[4,0,1]},"package_utils.portage_misc_functions=
":{portage_api:[1,4,1]},"package_utils.portage_log_parser":{get_list_of_m=
erged_packages:[1,3,1]},logfs:{fstracer:[1,1,1]},"package_utils.portage_u=
tils":{getfilesbypackage:[1,3,1],getpackagesbyfiles:[1,3,1],get_all_packa=
ges_files:[1,3,1]},"logfs.fstracer":{getfsevents:[1,3,1]},"package_utils.=
portage_misc_functions.portage_api":{get_dep:[1,2,1],get_system_packages_=
list:[1,2,1],get_best_visible_pkg:[1,2,1],get_deps:[1,2,1],get_merge_list=
:[1,2,1],parse_emerge_args:[1,2,1]},package_utils:{portage_misc_functions=
:[1,1,1],portage_utils:[1,1,1],portage_log_parser:[1,1,1]}},terms:{all:[1=
,2,3,4],code:3,chain:1,mnt:3,prog_nam:1,showfsev:2,depend:[1,2,3,4],send:=
3,ebuild:2,program:[1,2,3,4],under:2,sourc:1,string:1,fals:1,util:[2,3,4]=
,candid:1,veri:1,hooker:3,tri:3,level:1,l
 ist:[1,3],mount:3,defaultfilt:1,slower:[2,4],direct:[2,4],second:1,cost:=
3,pass:1,further:3,index:2,what:[2,4],compar:3,access:[0,1,2,3,4],version=
:1,"new":3,modifi:3,sinc:[1,3],search:[1,2],action:1,chang:3,via:3,packag=
enam:1,modul:[1,2,3],filenam:1,unix:3,api:[0,1],heurist:3,instal:[0,1,2,3=
],get_dep:1,from:[1,2,3,4],memori:1,two:1,call:[1,3],usr:3,type:[1,3],mor=
e:[2,4],ld_preload:[2,3,4],endtim:1,getfilesbypackag:1,must:[1,2,4],lib32=
:3,err:3,package_util:[0,1],prepar:3,registar:3,dev:3,can:[1,2,3,4],"0x1d=
bdb90":[],root:[2,4],registr:3,share:3,indic:[0,2],high:1,unreli:1,portag=
e_log_pars:1,chroot:3,end:[1,3],anoth:3,write:[1,3],how:[0,3],answer:3,in=
stead:[1,3],simpl:3,map:3,alwai:1,after:3,befor:3,blockpkg:[2,4],mai:1,ma=
n:3,syscal:[2,4],bind:3,element:1,inform:[1,3],environ:3,allow:[1,2,3,4],=
rdepend:1,origin:3,help:[2,4],over:3,rootf:3,dynam:[2,3,4],paramet:1,get_=
best_visible_pkg:1,cowsai:2,main:3,sock_seqpacket:3,"return":[1,3],thei:1=
,handl:1,auto:[2,4],"0x19e7b18":[],introd
 uct:[0,2],name:[1,3],mode:[2,4],each:1,found:[1,2,3,4],domain:3,idea:3,l=
ogf:[0,1],connect:3,todo:2,event:[0,1,2,3,4],variabl:3,network:3,content:=
0,got:3,lib64:3,believ:3,dictionari:1,ask:3,bash:[1,2],thread:3,launch:[1=
,2,3,4],get_list_of_merged_packag:1,filter:1,registrar:3,getfsev:1,first:=
1,oper:1,misc:[2,4],open:[1,3],gpl:2,start:1,unknown:[1,2,3,4],licens:2,s=
ystem:[1,2,3,4],messag:[2,3,4],scheme:3,low:1,option:[1,2,4],tool:[2,4],c=
opi:3,postrm:3,pars:1,than:[2,4],portage_util:1,get_merge_list:1,charact:=
3,bridg:1,pre:[2,4],"function":[1,3],linker:3,argument:1,raw:1,tabl:[0,2]=
,packag:[1,2,3,4],accuraci:3,note:[2,3,4],also:[1,2,3,4],build:[2,3,4],wh=
ich:1,analysi:[0,2,3,4],loggabl:3,normal:[2,4],who:[2,4],most:[2,4],build=
tim:[2,4],hooklib:[0,1,2,3,4],phase:3,"class":1,don:[2,4],portage_misc_fu=
nct:1,deni:[2,3,4],runtim:[2,3,4],hungri:1,show:[2,4],verbos:[2,4],pkg:1,=
find:1,xml:3,current:1,onli:[2,4],slow:[2,4],activ:2,dep_typ:1,should:1,p=
arse_emerge_arg:1,analys:3,unus:3,variou:
 1,get:[1,2,4],increas:3,requir:[2,4],enabl:[2,4],contain:1,userspac:3,sh=
m:3,kernel:[2,4],set:1,packet:3,see:3,sec:3,result:3,arg:1,fail:1,best:1,=
statu:[0,2],between:1,"import":[2,4],approach:[0,1,2,3,4],kei:1,get_all_p=
ackages_fil:1,xchat:[2,4],both:1,fstracer:[0,1],delimit:3,logic:1,futher:=
[0,3],mani:[2,4],lsof:2,load:[2,3,4],color:[2,4],overview:[0,2],linux:3,r=
eciev:3,fusef:[0,1,2,3,4],empti:1,implicit:[1,3],much:3,recomend:[2,4],pr=
otect:3,ani:[1,2,3,4],look:1,stagenam:3,gnu:2,servic:1,defin:[2,4],"while=
":[2,3,4],behavior:3,error:3,non:[2,4],synopsi:4,develop:2,perform:[2,3,4=
],make:2,belong:1,same:3,read:[1,2,3,4],document:0,fuse:[2,3,4],user:[2,4=
],extern:3,portag:[1,3],macro:[2,4],builder:[2,4],exampl:[0,1,2,4],comman=
d:[2,4],thi:[1,2,3,4],filesystem:3,usual:[2,3,4],execut:3,cut:3,"0x1b2bc8=
0":1,desktop:3,els:3,take:[1,2,3,4],filterproc:1,format:3,libc:3,big:[2,4=
],recurs:1,success:1,nocolor:[2,4],output:[2,4],page:2,often:3,intern:[0,=
1,3],successfulli:1,librari:[2,3,4],tmp:3
 ,autodep:[0,2,4],exit:[2,4],overlai:2,proc:3,run:[0,2,3],starttim:1,x11:=
[2,4],portage_api:1,stage:[1,2,3,4],about:3,socket:3,block:[1,2,3,4],merg=
:1,log:[1,2,4],wai:3,errno:3,strict:[2,4],includ:3,"var":3,overhead:[2,4]=
,fork:3,unexpect:3,tupl:1,atom:1,"true":1,"default":[1,2,4],creat:3,dure:=
[2,4],parser:1,doesn:1,file:[0,1,2,3,4],work:[0,1,3],check:3,emergearg:1,=
acloc:3,when:[2,3,4],detail:3,field:3,other:3,getpackagesbyfil:1,get_syst=
em_packages_list:1,releas:2,directori:3,reliabl:[2,4],descript:4,rule:3,d=
epth:1,emerg:[1,2,4],potenti:[2,4],time:[1,2,3,4],profil:3},objtypes:{"0"=
:"std:option","1":"py:module","2":"py:method","3":"py:function","4":"py:c=
lass"},titles:["Autodep&#8217;s documentation","API","Introduction","Inte=
rnals","USER COMMANDS"],objnames:{"0":"option","1":"Python module","2":"P=
ython method","3":"Python function","4":"Python class"},filenames:["index=
","api","intro","architecture","man"]})
\ No newline at end of file
+Search.setIndex({objects:{"":{"-v":[4,0,1],"-f":[4,0,1],"-C":[2,0,1],"-b=
":[4,0,1],"--hooklib":[4,0,1],"--fusefs":[4,0,1],"--blockpkgs":[4,0,1],"-=
-nocolor":[4,0,1],"--help":[4,0,1]},"logfs.fstracer":{getfsevents:[1,3,1]=
},"package_utils.portage_log_parser":{get_list_of_merged_packages:[1,3,1]=
},logfs:{fstracer:[1,1,1]},"package_utils.portage_utils":{getfilesbypacka=
ge:[1,3,1],getpackagesbyfiles:[1,3,1],get_all_packages_files:[1,3,1]},"pa=
ckage_utils.portage_misc_functions":{portage_api:[1,4,1]},"package_utils.=
portage_misc_functions.portage_api":{get_dep:[1,2,1],get_system_packages_=
list:[1,2,1],get_best_visible_pkg:[1,2,1],get_deps:[1,2,1],get_merge_list=
:[1,2,1],parse_emerge_args:[1,2,1]},package_utils:{portage_misc_functions=
:[1,1,1],portage_utils:[1,1,1],portage_log_parser:[1,1,1]}},terms:{all:[1=
,2,3,4],code:[],chain:1,queri:3,mnt:3,follow:3,prog_nam:1,showfsev:2,depe=
nd:[1,2,3,4],send:3,ebuild:2,program:[1,2,3,4],under:[2,3],sourc:1,string=
:1,fals:1,util:[2,3,4],candid:1,veri:1,ho
 oker:[],tri:3,level:1,list:[1,3],mount:3,defaultfilt:1,slower:[2,4],dire=
ct:[2,4],second:1,cost:3,pass:1,further:3,index:2,what:[2,4],compar:3,acc=
ess:[0,1,2,3,4],version:1,"new":3,net:4,intercept:3,modifi:3,sinc:[1,3],s=
earch:[1,2],action:1,chang:3,via:3,packagenam:1,modul:[1,2,3],filenam:1,u=
nix:3,api:[0,1],heurist:3,instal:[0,1,2,3],get_dep:1,from:[1,2,3,4],would=
:3,memori:1,regist:3,two:1,call:[1,3],usr:3,type:[1,3],more:[2,4],ld_prel=
oad:[2,3,4],notic:4,endtim:1,getfilesbypackag:1,must:[1,2,4],lib32:3,err:=
3,package_util:[0,1],prepar:3,registar:3,dev:3,can:[1,2,3,4],"0x1dbdb90":=
[],root:[2,4],process:3,registr:[],share:3,indic:[0,2],high:1,unreli:1,po=
rtage_log_pars:1,chroot:3,end:[1,3],anoth:3,write:[1,3],how:[0,3],answer:=
3,instead:[1,3],simpl:3,map:3,alwai:1,after:3,befor:3,blockpkg:[2,4],mai:=
1,man:3,syscal:[2,4],bind:3,element:1,inform:1,environ:3,allow:[1,2,3,4],=
rdepend:1,origin:3,help:[2,4],over:3,rootf:3,dynam:[2,3,4],paramet:1,get_=
best_visible_pkg:1,cowsai:2,main:3,them:3
 ,"return":[1,3],thei:1,handl:1,auto:[2,4],"0x19e7b18":[],introduct:[0,2]=
,name:[1,3],"0x1dcb938":1,mode:[2,4],each:1,found:[1,2,3,4],domain:3,idea=
:3,logf:[0,1],connect:3,todo:2,event:[0,1,2,3,4],variabl:3,network:3,miss=
:4,content:0,got:3,lib64:3,insid:3,believ:3,dictionari:1,ask:3,bash:[1,2]=
,thread:3,launch:[1,2,3,4],get_list_of_merged_packag:1,filter:1,registrar=
:3,getfsev:1,first:1,oper:1,misc:[2,4],hook:3,open:[1,3],gpl:2,given:4,st=
art:1,unknown:[1,2,3,4],licens:2,system:[1,2,3],messag:[2,3,4],scheme:3,l=
ow:1,option:[1,2,4],tool:[2,4],copi:3,postrm:3,pars:1,than:[2,4],portage_=
util:1,get_merge_list:1,charact:3,bridg:1,pre:[2,4],"function":[1,3],link=
er:3,argument:1,raw:1,tabl:[0,2],packag:[1,2,3,4],accuraci:3,note:[2,3,4]=
,also:[1,2,3,4],build:[2,3,4],which:1,jail:3,analysi:[0,2,3,4],loggabl:3,=
trace:4,normal:[2,4],who:[2,4],most:[2,4],buildtim:[2,4],hooklib:[0,1,2,3=
,4],phase:3,"class":1,don:[2,4],portage_misc_funct:1,doe:[0,3,4],deni:[2,=
3,4],runtim:[2,3,4],hungri:1,show:[2,4],v
 erbos:[2,4],pkg:1,permiss:3,find:1,xml:3,current:1,onli:[2,4],slow:[2,4]=
,activ:2,dep_typ:1,should:1,parse_emerge_arg:1,analys:3,unus:3,variou:1,g=
et:[1,2,4],increas:3,requir:[2,4],enabl:[2,4],"default":[1,2,4],contain:1=
,userspac:3,shm:3,respond:3,kernel:[2,4],set:1,packet:3,see:3,sec:3,resul=
t:3,arg:1,fail:1,best:1,statu:[0,2],behind:3,between:1,"import":[2,4],irc=
:4,approach:[0,1,2,3,4],kei:1,get_all_packages_fil:1,xchat:[2,4],both:1,p=
rotect:3,delimit:3,logic:1,futher:[0,3],mani:[2,4],lsof:2,load:[2,3,4],co=
lor:[2,4],overview:[0,2],linux:3,reciev:3,fusef:[0,1,2,3,4],empti:1,impli=
cit:[1,3],much:[],recomend:[2,4],fstracer:[0,1],ani:[1,2,3,4],look:1,stag=
enam:3,gnu:2,servic:1,defin:2,"while":[2,3,4],behavior:3,error:3,non:[2,4=
],sock_seqpacket:3,synopsi:4,develop:2,perform:[2,3,4],make:2,belong:1,sa=
me:3,read:[1,2,3],document:0,fuse:[2,3,4],user:[2,4],extern:3,portag:[1,3=
],macro:[2,4],builder:[2,4],exampl:[0,1,2,4],command:[2,4],thi:[1,2,3,4],=
filesystem:[3,4],usual:[2,3,4],execut:3,c
 ut:3,"0x1b2bc80":[],desktop:3,els:[],take:[1,2,3,4],filterproc:1,format:=
3,libc:3,big:2,recurs:1,success:1,nocolor:[2,4],output:[2,4],page:2,often=
:3,intern:[0,1,3],successfulli:1,librari:[2,3,4],tmp:3,autodep:[0,2,4],ex=
it:[2,4],overlai:2,proc:3,previou:3,run:[0,2,3],step:3,starttim:1,x11:[2,=
4],portage_api:1,stage:[1,2,3,4],about:3,socket:3,block:[1,2,3,4],merg:1,=
log:[1,2,4],wai:3,errno:3,strict:[2,4],includ:3,lot:3,"var":3,overhead:[2=
,4],fork:3,unexpect:3,tupl:1,atom:1,"true":1,whether:3,otherwis:3,creat:3=
,dure:[2,4],parser:1,doesn:1,file:[0,1,2,3,4],work:[0,1,3],check:3,emerge=
arg:1,acloc:3,when:[2,3,4],detail:3,field:3,other:3,getpackagesbyfil:1,ge=
t_system_packages_list:1,releas:2,directori:3,reliabl:[2,4],descript:4,ru=
le:3,depth:1,emerg:[1,2,4],potenti:[2,4],time:[1,2,3,4],profil:3},objtype=
s:{"0":"std:option","1":"py:module","2":"py:method","3":"py:function","4"=
:"py:class"},titles:["Autodep&#8217;s documentation","API","Introduction"=
,"Internals","USER COMMANDS"],objnames:{"
 0":"option","1":"Python module","2":"Python method","3":"Python function=
","4":"Python class"},filenames:["index","api","intro","architecture","ma=
n"]})
\ No newline at end of file

diff --git a/docs/build/man/autodep.1 b/docs/build/man/autodep.1
index b338c58..202dd11 100644
--- a/docs/build/man/autodep.1
+++ b/docs/build/man/autodep.1
@@ -1,4 +1,4 @@
-.TH "AUTODEP" "1" "August 04, 2011" "0.1" "Autodep"
+.TH "AUTODEP" "1" "August 20, 2011" "0.1" "Autodep"
 .SH NAME
 autodep \- auto dependency builder for Gentoo
 .
@@ -35,58 +35,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-le=
vel]]
 \fBautodep\fP [options] <command>
 .SH DESCRIPTION
 .sp
-Auto dependency builder is a tool for analysis files accessed during
-building a package. It also can be used for runtime dependencies analysi=
s.
+Auto dependency (autodep) builder is a tool for the analysis of accessed=
 files during
+the build of a package. It also can be used for runtime dependencies ana=
lysis.
 .sp
-The tool can block an access to files of defined packages.
+The tool can trace, log and block access to files of given packages.
 .SH OPTIONS
 .INDENT 0.0
 .TP
 .B \-\-help, \-h
-.sp
-show this help message and exit
+Show this help message and exit.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-b, \-\-block
-.sp
-strict mode: deny all access to non\-dependency packages
+strict mode: Deny all access to files from non\-dependency packages.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-\-blockpkgs=3DPACKAGES
-.sp
-block an access to files from this packages
+Block access to files from this packages.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-f, \-\-files
-.sp
-show accessed files and not founded files
+Show all files, accessed and missing (not found).
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-v, \-\-verbose
-.sp
-show non\-important packages, show unknown package and unknown stage
+Show non\-important packages, unknown packages and unknown building stag=
es.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-\-nocolor, \-C
-.sp
-don\(aqt output color
+Don\(aqt colorize output
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-\-hooklib
-.
-use ld_preload logging approach(default)
+Use LD_PRELOAD logging approach (default).
 .UNINDENT
 .INDENT 0.0
 .TP
 .B \-\-fusefs
-.
-use fuse logging approach(slow, but reliable)
+Use FUSE logging approach (slow, but reliable).
 .UNINDENT
 .SH HOOKLIB VS FUSEFS
 .TS
@@ -97,7 +89,7 @@ T{
 T}	T{
 Hooklib
 T}	T{
-Fusefs
+FuseFS
 T}
 _
 T{
@@ -109,7 +101,7 @@ Only root
 T}
 _
 T{
-Is approach allows blocking an access to files?
+Does approach allows to block access to files?
 T}	T{
 \fBYES\fP
 T}	T{
@@ -117,7 +109,7 @@ T}	T{
 T}
 _
 T{
-Is overhead in performance big?
+Is the overhead in performance noticeable?
 T}	T{
 \fBNO\fP
 T}	T{
@@ -135,18 +127,19 @@ _
 T{
 When is it recomended to use an approach?
 T}	T{
-For analysis
+Analysis
 of
 \fIbuildtime\fP
 dependencies
 T}	T{
-For analysis
+Analysis
 of \fIruntime\fP
 dependencies
 T}
 _
 T{
-Is any pre\-requirements for using an approach?
+Are there any pre\-requirements
+for using an approach?
 T}	T{
 \fBNO\fP
 T}	T{
@@ -158,23 +151,21 @@ _
 .TE
 Notes
 .IP [1] 5
-.
-Fuse file system is slower than normal one. Program reads many files
+FUSE filesystems are slower than a normal one. A Program accesses many f=
iles
 while launching, so this will take more time than usual.
 .IP [2] 5
-.
-Loading of dynamic libraries and direct syscalls will not be logged.
+Loading of Dynamic libraries and direct syscalls will not be logged.
 .SH EXAMPLES
-.SS Get the potential dependencies of a xchat package:
+.SS Get the potential dependencies for net\-irc/xchat:
 .sp
-autodep emerge xchat
-.SS Get the potential dependencies of a xchat package, blocking x11\-mis=
c/util\-macros package:
+autodep emerge net\-irc/xchat
+.SS Get the potential dependencies for net\-irc/xchat, blocking files fr=
om x11\-misc/util\-macros package:
 .sp
-autodep emerge \-\-block x11\-misc/util\-macros emerge xchat
-.SS Get the potential dependencies of a xchat package, and show files ac=
cessed:
+autodep emerge \-\-block x11\-misc/util\-macros emerge net\-irc/xchat
+.SS Get the potential dependencies for net\-irc/xchat package, and show =
accessed files:
 .sp
-autodep \-\-files emerge xchat
-.SS Get the runtime dependencies of a xchat and show files accessed:
+autodep \-\-files emerge net\-irc/xchat
+.SS Get the runtime dependencies of a xchat and show accessed files:
 .sp
 autodep \-\-fusefs \-\-files xchat
 .SH AUTHOR

diff --git a/docs/source/api.rst b/docs/source/api.rst
index 1397732..502db1e 100644
--- a/docs/source/api.rst
+++ b/docs/source/api.rst
@@ -11,7 +11,7 @@ logfs.fstracer
 package_utils
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D
=20
-This package contains modules which works with the Portage system
+This package contains modules which work with the Portage system
=20
 .. automodule:: package_utils.portage_log_parser
    :members:

diff --git a/docs/source/architecture.rst b/docs/source/architecture.rst
index 59b55f8..2caec16 100644
--- a/docs/source/architecture.rst
+++ b/docs/source/architecture.rst
@@ -13,66 +13,71 @@ Format of network messages
 --------------------------
=20
=20
-1. Format of messages to file access registrar::
+1. Format of messages to the File Access Registrar::
=20
    <time of event: sec since 1970>
    <event type: open, read, write>
    <name of file>
    <building stage: stagename or unknown>
    <result:OK,ERR/errno,ASKING,DENIED>
-2. Format of answer for ASKING packet from registrar::
+2. Format of answer for ASKING packet from File Access Registrar::
=20
    <ALLOW | DENY>
=20
 *Notes:*
=20
 * All sockets are SOCK_SEQPACKET
-* All fields are delimited with character with code 0
+* All fields are delimited with character \0
=20
=20
-How Hooklib approach works?
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
+How does the Hooklib approach work?
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-The main idea of Hooklib approach is to load a dynamic library-hooker=20
-**before** any other library(including the C runtime, libc.so).=20
-So, the functions, such as open, read and write, executed from this libr=
ary
-instead of libc.so.
+The main idea behind the Hooklib approach is to load a dynamic library-h=
ook=20
+**before** any other library(including the C runtime).=20
+So, the calls to functions such as open, read and write, are intercepted=
=20
+using this library, instead of executing the ones in *libc*.
=20
-Hooklib module modifies Linux's dynamic linker behavior changing LD_PREL=
OAD=20
-environment variable(see=20
+Hooklib module modifies Linux's dynamic linker behavior, changing LD_PRE=
LOAD=20
+environment variable (see=20
 `man 8 ld-linux <http://linux.die.net/man/8/ld-linux>`_ for details).
-Module protects LD_PRELOAD variable from further changes by program.
+This module also protects LD_PRELOAD variable from further changes by ex=
ecuting=20
+program.
=20
-When hooklib module loads, it connects to file access registrar via Unix=
 domain=20
-sockets. If program forks or creates a new thread, another copy of libra=
ry=20
-loads.=20
+When Hooklib is loaded, it connects to the File Access Registrar via Uni=
x domain=20
+sockets. If a program forks or creates a new thread, another copy of the=
 library=20
+loads to register events from this new process/thread.=20
=20
-When program do open(...), read(...), write(...), library send an inform=
ation=20
-about a call to registrar. Registar can block or allow an event. If regi=
strer=20
-allows an event then the original function is called. Else error=20
-"file not found" is returned.
+When a program calls open(...), read(...), write(...), Hooklib sends a m=
essage =20
+about a call to the File Access Registrar. The Registar can then block=20
+or allow this event. If Registrar responds to the previous query with=20
+an ALLOW packet, then the original function is called. Otherwise, the fu=
nction=20
+is not called and a "File not Found" error is returned instead.
=20
-How Fusefs approach works?
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D
+How does the Fusefs approach work?
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-The main idea if Fusefs approach is to create a loggable filesystem in u=
serspace
-and chroot a program into it.
+The main idea of the Fusefs approach is to create a loggable filesystem =
in userspace
+and jail a program into it, using a chroot.
=20
-Before program is launched registrar prepare mounts. It usually do:
+Before the program is launched, The File Access Registrar prepare the mo=
unts.=20
+It would usually take the following steps:
=20
 1. mount -o bind / /mnt/rootfs/
-2. mount /dev/, /dev/pts, /dev/shm, /proc/, /sys/ same way
+2. mount /dev, /dev/pts, /dev/shm, /proc/, /sys/ binding them to /mnt/ro=
otfs
 3. mount /lib64/, /lib32/, /var/tmp/portage/ same way to increase perfor=
mance at=20
    cost of accuracy
-4. launch fuse over /mnt/rootfs/
+4. launch FUSE over /mnt/rootfs/
=20
-Fuse module blocks all external access to /mnt/rootfs while program runs=
.
-
-Fuse module also asks the registrar about event allowness.
+Fuse module blocks all external access to /mnt/rootfs while the program =
runs.
+The FUSE module will also ask the File Access Registrar to check whether=
 access to=20
+files inside the chroot are allowed or denied. As with the Hooklib appro=
ach, if=20
+access to a file is denied, a "File not Found" error is returned.
=20
 *Notes:*
=20
-* Checking for allowness takes a much time
+* Checking for permission to access a file with the File Access Registra=
r, takes a=20
+lot of time under this approach.
=20
 Futher analysis of file access events
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -90,6 +95,6 @@ unuseful packages.
 Rules of heuristics
 -------------------
=20
-1. *Package is not useful if all files are .desktop or .xml or .m4*.
+1. *Package is not useful if all files are .desktop, .xml or .m4*.
    Aclocal util tries to read all .m4 files in /usr/share/aclocal direct=
ory.
-   Files ending on .desktop and .xml often readed on postrm phase.
\ No newline at end of file
+   Files ending on .desktop and .xml are often read in the postrm phase.
\ No newline at end of file

diff --git a/docs/source/man.rst b/docs/source/man.rst
index b49fb54..bf5ad86 100644
--- a/docs/source/man.rst
+++ b/docs/source/man.rst
@@ -10,10 +10,10 @@ SYNOPSIS
 DESCRIPTION
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-Auto dependency builder is a tool for analysis files accessed during=20
-building a package. It also can be used for runtime dependencies analysi=
s.
+Auto dependency (autodep) builder is a tool for the analysis of accessed=
 files during=20
+the build of a package. It also can be used for runtime dependencies ana=
lysis.
=20
-The tool can block an access to files of defined packages.
+The tool can trace, log and block access to files of given packages.
=20
 OPTIONS
 =3D=3D=3D=3D=3D=3D=3D
@@ -22,78 +22,78 @@ OPTIONS
=20
 .. cmdoption:: --help, -h
=20
-   show this help message and exit
+   Show this help message and exit.
=20
 .. cmdoption:: -b, --block
=20
-   strict mode: deny all access to non-dependency packages
+   strict mode: Deny all access to files from non-dependency packages.
=20
 .. cmdoption:: --blockpkgs=3DPACKAGES
=20
-   block an access to files from this packages
+   Block access to files from this packages.
=20
 .. cmdoption:: -f, --files=20
=20
-   show accessed files and not founded files
+   Show all files, accessed and missing (not found).
 .. cmdoption:: -v, --verbose=20
=20
-   show non-important packages, show unknown package and unknown stage
+   Show non-important packages, unknown packages and unknown building st=
ages.
 .. cmdoption:: --nocolor, -C
=20
-   don't output color
+   Don't colorize output
 .. cmdoption:: --hooklib
=20
-   use ld_preload logging approach(default)
+   Use LD_PRELOAD logging approach (default).
 .. cmdoption:: --fusefs
=20
-   use fuse logging approach(slow, but reliable)
+   Use FUSE logging approach (slow, but reliable).
=20
 HOOKLIB VS FUSEFS
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
 +------------------------------------------------+-------------+--------=
-------+
-|                                                |   Hooklib   |     Fus=
efs    |
+|                                                |   Hooklib   |     Fus=
eFS    |
 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D+
 | Who can use this approach?                     | **Any user**|   Only =
root   |
 +------------------------------------------------+-------------+--------=
-------+
-| Is approach allows blocking an access to files?|  **YES**    | **YES**=
       |
+| Does approach allows to block access to files? |  **YES**    | **YES**=
       |
 +------------------------------------------------+-------------+--------=
-------+
-| Is overhead in performance big?                |  **NO**     | YES [#f=
1]_    |
+| Is the overhead in performance noticeable?     |  **NO**     | YES [#f=
1]_    |
 +------------------------------------------------+-------------+--------=
-------+
 | What events are logged?                        |  Most [#f2]_| **ALL**=
       |
 +------------------------------------------------+-------------+--------=
-------+
-| When is it recomended to use an approach?      | For analysis| For ana=
lysis  |
+| When is it recomended to use an approach?      | Analysis    | Analysi=
s      |
 |                                                | of          | of *run=
time*  |
 |                                                | *buildtime* | depende=
ncies  |
 |                                                | dependencies|        =
       |
 +------------------------------------------------+-------------+--------=
-------+
-| Is any pre-requirements for using an approach? | **NO**      | FUSE mu=
st be  |
-|                                                |             | enabled=
 in    |
+| Are there any pre-requirements                 | **NO**      | FUSE mu=
st be  |
+| for using an approach?                         |             | enabled=
 in    |
 |                                                |             | kernel =
       |
 +------------------------------------------------+-------------+--------=
-------+
=20
 .. rubric:: Notes
=20
-.. [#f1] Fuse file system is slower than normal one. Program reads many =
files=20
+.. [#f1] FUSE filesystems are slower than a normal one. A Program access=
es many files=20
    while launching, so this will take more time than usual.
-.. [#f2] Loading of dynamic libraries and direct syscalls will not be lo=
gged.
+.. [#f2] Loading of Dynamic libraries and direct syscalls will not be lo=
gged.
=20
 Examples
 =3D=3D=3D=3D=3D=3D=3D=3D
=20
-Get the potential dependencies of a xchat package:
------------------------------------------------------
-autodep emerge xchat
+Get the potential dependencies for net-irc/xchat:
+-------------------------------------------------
+autodep emerge net-irc/xchat
=20
-Get the potential dependencies of a xchat package, blocking x11-misc/uti=
l-macros package:
-------------------------------------------------------------------------=
--------------------
-autodep emerge --block x11-misc/util-macros emerge xchat
+Get the potential dependencies for net-irc/xchat, blocking files from x1=
1-misc/util-macros package:
+------------------------------------------------------------------------=
---------------------------
+autodep emerge --block x11-misc/util-macros emerge net-irc/xchat
=20
-Get the potential dependencies of a xchat package, and show files access=
ed:
-------------------------------------------------------------------------=
------
-autodep --files emerge xchat
+Get the potential dependencies for net-irc/xchat package, and show acces=
sed files:
+------------------------------------------------------------------------=
----------
+autodep --files emerge net-irc/xchat
=20
-Get the runtime dependencies of a xchat and show files accessed:
--------------------------------------------------------------------
+Get the runtime dependencies of a xchat and show accessed files:
+----------------------------------------------------------------
 autodep --fusefs --files xchat
=20

diff --git a/src/autodep/autodep b/src/autodep/autodep
index 1152180..f202d0d 100755
--- a/src/autodep/autodep
+++ b/src/autodep/autodep
@@ -19,26 +19,26 @@ def parse_args():
   args_parser=3Doptparse.OptionParser("%prog [options] <command>")
   args_parser.add_option("-b","--block",action=3D"store_true", =20
 	dest=3D"strict_block", default=3D"",=20
-	help=3D"strict mode: deny all access to non-dependency packages")
+	help=3D"strict mode: Deny all access to files from non-dependency packa=
ges.")
   args_parser.add_option("--blockpkgs",action=3D"store", type=3D"string"=
,=20
 	dest=3D"packages", default=3D"",=20
-	help=3D"block an access to files from this packages")
+	help=3D"Block access to files from these packages.")
   args_parser.add_option("-f","--files", action=3D"store_true", dest=3D"=
show_files",=20
-	default=3DFalse, help=3D"show all accessed files and not founded files"=
)
+	default=3DFalse, help=3D"Show all files, accessed and missing ( not fou=
nded).")
   args_parser.add_option("-v","--verbose", action=3D"store_true", dest=3D=
"verbose",=20
-	default=3DFalse, help=3D"show non-important packages, "
-	  "show unknown package and unknown stage")
+	default=3DFalse, help=3D"Show non-important packages, "
+	  "unknown package and unknown stage")
   args_parser.add_option("-n","--numfiles",action=3D"store", type=3D"str=
ing",=20
     dest=3D"numfiles",=20
     default=3D10,=20
-	help=3D"maximum number of files from each package to show(default is 10=
)")
+	help=3D"Maximum number of files from each package to show (default is 1=
0)")
   args_parser.add_option("-C","--nocolor",action=3D"store_true", dest=3D=
"nocolor",=20
-	default=3DFalse, help=3D"don't output color")
+	default=3DFalse, help=3D"Don't colorize output")
=20
   args_parser.add_option("--hooklib",action=3D"store_const", dest=3D"app=
roach",=20
-	const=3D"hooklib", help=3D"use ld_preload logging approach(default)")
+	const=3D"hooklib", help=3D"Use ld_preload logging approach (default)")
   args_parser.add_option("--fusefs",action=3D"store_const", dest=3D"appr=
oach",=20
-	const=3D"fusefs", help=3D"use fuse logging approach(slow, but reliable)=
")
+	const=3D"fusefs", help=3D"Use FUSE logging approach (slow, but reliable=
)")
   args_parser.set_defaults(approach=3D"hooklib")
=20
   args_parser.epilog=3D"Example: %s -blockpkgs lsof,cowsay emerge bash" =
% (