sb2.1 manual page updates from Kristiina Martin

1 files changed, 46 insertions, 26 deletions

diff --git a/docs/sb2.1 b/docs/sb2.1
index f2fff4c..de4b3b9 100644
--- a/docs/sb2.1
+++ b/docs/sb2.1
@@ -13,52 +13,72 @@ in scratchbox2 environment is started.
 \-v
 Display version number.
 .TP
-\-R
-Execute commands in fakeroot environment.
+\-L LEVEL
+Enable logging. Following values for logging LEVEL are available: error, warning, notice, info, debug, noise, noise2.
 .TP
 \-d
-Output all path mappings to $HOME/sb2_mapping.log.
+Use debug mode: log all redirections (logging LEVEL=debug) to log file under directory $HOME/sb2_logs .
 .TP
 \-h
 Print help.
 .TP
-\-t
-Define target to use. Use sb2-config -d TARGET to set a default.
+\-t TARGET
+Define TARGET to use. Use sb2-config -d TARGET to set a default.
 .TP
 \-e
-Use emulation mode, avoid executing ANY host binaries except qemu.
+Use emulation mode, avoid executing any host binaries except qemu.
 .TP
-\-m
-Use mapping mode given in argument.
+\-m MODE
+Use mapping mode MODE given in argument. Following MODE values are supported: devel, emulate, install, simple, tools.
 .TP
-\-T dir
-Use "dir" as tools_root (override the value which was specified
-to sb2-init when the target specification was created)
+\-M FILE
+Read mapping rules from FILE.
 .TP
-\-s
-Use redirection rules from the directory given in argument.
+\-s DIRECTORY
+Use redirection rules from the DIRECTORY given in argument.
 .TP
-\-S file
-Create a persistent session: Write session information to "file"
+\-Q BUGLIST
+Emulate bugs of the scratchbox 1 (BUGLIST consists of letters: 'x' enables exec permission checking bug emulation).
 .TP
-\-J file
-Join a persistent session.
+\-r
+Disable creating reverse mapping rules: functions like getcwd() and realpath() will always return the real path.
 .TP
-\-D file
-Delete a persistent session. Warning: this does not
-check if the session is still in use!
+\-O OPTIONS
+Set options for the selected mapping mode. OPTIONS is a mode-specific string.
 .TP
-\-r
-Don't create reverse mapping rules: functions like getcwd() and realpath()
-will always return the real path.
+\-R
+Execute commands in fakeroot environment.
+.TP
+\-S FILE
+Create a persistent session: Write session information to FILE
+.TP
+\-J FILE
+Join a persistent session assossiated with FILE.
 .TP
-\-O options
-Set options for the selected mapping mode ("options" is a mode-specific string)
+\-D FILE
+Delete a persistent session assosiated with FILE. 
+Warning: this does not check if the session is still in use!
+.TP
+\-c
+When creating a session, also create a private copy of target_root (rootstrap). Note that this can be really slow, depending on the size of the orig.target_root.
+.TP
+\-T DIRECTORY
+Use DIRECTORY as tools_root (override the value which was specified to sb2-init when the target specification was created).
 
 .SH ENVIRONMENT
 There are quite many environment variables being used. Since sb2 is still
 very volatile, the best documentation is in the source of sb2 script itself.
 
+.SH EXAMPLES
+.TP
+sb2 ./configure
+.TP
+sb2 make
+.TP
+sb2 -eR make install
+.TP
+sb2 -R -m emulate make install
+
 .SH CONFIGURATION
 To configure sb2, do something like this:
 
@@ -66,7 +86,7 @@ To configure sb2, do something like this:
 mkdir $HOME/buildroot
 cd $HOME/buildroot
 [fetch a rootfs from somewhere and extract it here]
-sb2-init -c /abs/path/to/qemu-arm /path/to/cross-compiler/bin/arm-linux-gcc
+sb2-init -c /abs/path/to/qemu-arm TARGET /path/to/cross-compiler/bin/arm-linux-gcc
 .fi
 
 To change default scratchbox2 target: