New command -sh_style_result

libisoburn/trunk/xorriso/xorriso.texi

@@ -50,7 +50,7 @@
 @c man .\" First parameter, NAME, should be all caps
 @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 @c man .\" other parameters are allowed: see man(7), man(1)
-@c man .TH XORRISO 1 "Version 1.3.1, Jun 29, 2013"
+@c man .TH XORRISO 1 "Version 1.3.1, Jul 01, 2013"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -5171,6 +5171,20 @@ quotation marks.
 For brevity the list delimiter is referred as "@minus{}@minus{}"
 throughout this text.
 @c man .TP
+@item -sh_style_result "on"|"off"
+@kindex -sh_style_result   makes results look more like shell
+@cindex Result layout, more shell-like, -sh_style_result
+Make the result output of some filesystem inspection commands look more like
+the output of equivalent shell commands. The most important effect is to
+prevent the wrapping of file addresses into quotation marks with commands
+  -pwd -pwdx -ls -lsd -lsl -lsdl -lsx -lsdx -lslx -lsdlx
+  -du -dus -dux -dusx -findx -find
+@*
+This will make ambigous the representation of file names which contain
+newline characters. On the other hand it should facilitate integration
+of xorriso into shell scripts which already use the corresponding
+shell commands.
+@c man .TP
 @item -backslash_codes "on"|"off"|mode[:mode]
 @kindex -backslash_codes   enables backslash conversion
 @cindex Program, backslash conversion, -backslash_codes