From 789cbcd3c0cd841879c8cfbecc6af5f3ca1e72f1 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sat, 18 Apr 2009 15:00:41 +0000 Subject: [PATCH] Last minute correction in xorriso man page --- libisoburn/trunk/xorriso/xorriso.1 | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index 5469fd65..d168b41c 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/xorriso/xorriso.1 @@ -2,7 +2,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH XORRISO 1 "Apr 14, 2009" +.TH XORRISO 1 "Apr 18, 2009" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -497,7 +497,7 @@ the history of previous input lines. .br See man readline for more info about libreadline. .PP -Option -page activates a builtin result text pager which may be convenient in +Option -page activates a built-in result text pager which may be convenient in dialog. After an action has put out the given number of terminal lines, the pager prompts the user for a line of input. .br @@ -1137,7 +1137,7 @@ External filters may also be banned totally at compile time of xorriso. By default they are banned if xorriso runs under setuid permission. .TP \fB\-set_filter\fR name iso_rr_path [***] -Apply an -external_filter or a builtin filter to the given data files in the +Apply an -external_filter or a built--in filter to the given data files in the ISO image. If the filter suffix is not empty , then it will be applied to the file name. Renaming only happens if the filter really gets attached and is not revoked by @@ -1166,7 +1166,7 @@ Builtin filters are "--zisofs" and "--zisofs-decode". The former is to be applied via -set_filter, the latter is automatically applied if zisofs compressed content is detected with a file when loading the ISO image. .br -Another builtin filter pair is "--gzip" and "--gunzip" with suffix ".gz". +Another built-in filter pair is "--gzip" and "--gunzip" with suffix ".gz". They behave about like external gzip and gunzip but avoid forking a process for each single file. So they are much faster if there are many small files. .TP @@ -1657,7 +1657,7 @@ of different type. Nevertheless those hops can loop. Example: .br \fB$\fR ln -s .. uploop .br -Link hopping has a builtin loop detection which stops hopping at the first +Link hopping has a built-in loop detection which stops hopping at the first repetition of a link target. Then the repeated link is handled as itself and not as its target. Regrettably one can construct link networks which @@ -1805,7 +1805,7 @@ Group id to be used for all files when the new ISO tree gets written to media. \fB\-zisofs\fR option[:options] Set global parameters for zisofs compression. This data format is recognized and transparently uncompressed by some Linux kernels. It is to be applied -via option -set_filter with builtin filter "--zisofs". +via option -set_filter with built-in filter "--zisofs". Parameters are: .br "level="[0-9] zlib compression: 0=none, 1=fast,..., 9=slow @@ -3333,6 +3333,10 @@ the old one. .br This makes sense if the full backup leaves substantial remaining capacity on media and if the expected changes are much smaller than the full backup. +To apply zisofs compression to those data files which get newly copied from +the local filesystem, perform immediately before -commit : +.br + -find / -type f -lba_range -1 2000000000 -exec set_filter --zisofs -- .br Option -disk_dev_ino depends on stable device and inode numbers on disk. Without it, an update run will probably save no time but last longer than