aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'docs/build/man/autodep.1')
-rw-r--r--docs/build/man/autodep.165
1 files changed, 28 insertions, 37 deletions
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-level]]
\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 analysis.
+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 analysis.
.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=PACKAGES
-.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 stages.
.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 files
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\-misc/util\-macros package:
+autodep emerge net\-irc/xchat
+.SS Get the potential dependencies for net\-irc/xchat, blocking files from 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 accessed:
+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