libburnia/legacy
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Reacted on complaints of lintian spelling check

Browse Source
This commit is contained in:
Thomas Schmitt
2015-09-20 12:51:53 +00:00
parent fca6e259da
commit 06b2949040
19 changed files with 320 additions and 315 deletions
Download Patch File Download Diff File Expand all files Collapse all files

80
libisoburn/trunk/xorriso/xorriso.texi
View File

@ -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.4.1, Sep 16, 2015"
@c man .TH XORRISO 1 "Version 1.4.1, Sep 20, 2015"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -121,7 +121,7 @@ with Rock Ridge extensions.
@c man .PP
@command{xorriso}
is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows
filesystems into Rock Ridge enhanced ISO 9660 filesystems and performs
session-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to
optical media or to filesystem objects.
@ -225,7 +225,7 @@ represent arbitrary media or from regular disk files.
@cindex Multi-session, _definition
This session usage model has been extended on CD media by the concept of
@strong{multi-session} ,
which allows to add information to the CD and gives the mount programs
which adds information to the CD and gives the mount programs
of the operating systems the addresses of the entry points of each
session. The mount programs recognize block devices which represent
CD media and will by default mount the image in the last session.
@ -252,7 +252,7 @@ See paragraph Creating, Growing, Modifying, Blind Growing below.
@sp 1
@command{xorriso} adopts the concept of multi-session by loading an
image directory tree if present,
by allowing to manipulate it by several actions,
by offering to manipulate it by several actions,
and by writing the new image to the target medium.
@c man .br
The first session of a @command{xorriso} run begins by the definition of
@ -283,12 +283,12 @@ unformatted DVD-RW. These media provide a table of content which
describes their existing sessions. See command @strong{-toc}.
@*
Similar to multi-session media are DVD-R DL and minimally blanked DVD-RW.
They allow only a single session of which the size must be known in advance.
They record only a single session of which the size must be known in advance.
@command{xorriso} will write onto them only if command -close is set to "on".
@*
@cindex Overwriteable media, _definition
@strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
They allow random write access but do not provide information about their
They offer random write access but do not provide information about their
session history. If they contain one or more ISO 9660 sessions and if the
first session was written by @command{xorriso}, then a table of content can
be emulated. Else only a single overall session will be visible.
@ -461,8 +461,8 @@ their path in the filesystem. E.g.:
@*
-dev stdio:/dev/sdc
@*
The default setting of -drive_class allows to address files outside the
/dev tree without that prefix. E.g.:
The default setting of -drive_class allows the user to address files outside
the /dev tree without that prefix. E.g.:
@*
-dev /tmp/pseudo_drive
@*
@ -502,7 +502,7 @@ drive.
@*
One may use command
@strong{-ban_stdio_write}
to surely prevent this risk and to allow only MMC drives.
to surely prevent this risk and to restrict drive usage to MMC drives.
@*
One may prepend "mmc:" to a path to surely disallow any automatic "stdio:".
@c man .br
@ -606,8 +606,7 @@ only on GNU/Linux and FreeBSD.
@cindex extattr, _definition
@strong{xattr} (aka EA, or extattr)
are pairs of name and value which can be attached to file objects. AAIP is
able to represent them and @command{xorriso} allows to record and restore
pairs which
able to represent them and @command{xorriso} can record and restore pairs which
have names out of the user namespace. I.e. those which begin with "user.",
like "user.x" or "user.whatever". Name has to be a 0 terminated string.
Value may be any array of bytes which does not exceed the size of 4095 bytes.
@ -691,7 +690,7 @@ quotations or an open quotation cause the next input line to be appended.
Quoted input accepts any 8-bit character except NUL (0) as the content of
the quotes.
Nevertheless it can be cumbersome for the user to produce those characters
directly. Therefore quoted input and program arguments allow optional
directly. Therefore quoted input and program arguments offer optional
@strong{Backslash Interpretation}
which can represent all 8-bit characters except NUL (0) via backslash codes
as in $'...' of bash.
@ -725,7 +724,7 @@ availability
of package readline-dev at the time when @command{xorriso} was built from
its sourcecode.
@*
Readline allows to move the cursor over the text in the line by help of the
Readline lets the user move the cursor over the text in the line by help of the
Left and the Right arrow keys.
Text may be inserted at the cursor position. The Delete key removes the
character under the cursor. Up and Down arrow keys navigate through
@ -1198,8 +1197,8 @@ if any occur despite the prescriptions of ECMA-119.
@kindex -disk_dev_ino fast incremental backup
@cindex Backup, enable fast incremental, -disk_dev_ino
Enable or disable processing of recorded file identification numbers
(dev_t and ino_t). If enabled they are stored as xattr and allow
to substantially accelerate file comparison. The root node gets a global start
(dev_t and ino_t). If enabled they are stored as xattr and can
substantially accelerate file comparison. The root node gets a global start
timestamp. If during comparison a file with younger timestamps is found in the
ISO image, then it is suspected to have inconsistent content.
@*
@ -1232,7 +1231,7 @@ leading bytes replaced by '_'.
iso_rr_paths with the long components will still be able to access the
file paths with truncated components. To avoid confusion by having both
truncated and untrancated names in the same directory, it is not possible
to change this setting after a drive was aquired. All file names get
to change this setting after a drive was acquired. All file names get
truncated by the same length.
@*
File name patterns will only work if they match the truncated name.
@ -1777,13 +1776,13 @@ and re-enables -disk_pattern expansion.
@item -overwrite "on"|"nondir"|"off"
@kindex -overwrite enables overwriting in ISO
@cindex Insert, enable overwriting, -overwrite
Allow or disallow to overwrite existing files in the
Allow or disallow overwriting of existing files in the
ISO image by files with the same name.
@*
With setting "off", name collisions cause FAILURE events.
With setting "nondir", only directories are protected by such events, other
existing file types get treated with -rm before the new file gets added.
Setting "on" allows automatic -rm_r. I.e. a non-directory can replace an
Setting "on" enables automatic -rm_r. I.e. a non-directory can replace an
existing directory and all its subordinates.
@*
If restoring of files is enabled, then the overwrite rule applies to the
@ -2691,7 +2690,7 @@ prevent any suffix renaming.
@*
Attaching or detaching filters will not alter the state of -changes_pending.
If the filter manipulations shall be the only changes in a write run, then
explicitely execute -changes_pending "yes".
explicitly execute -changes_pending "yes".
@c man .TP
@item -set_filter_r name iso_rr_path [***]
@kindex -set_filter_r applies filter to file tree
@ -3481,7 +3480,7 @@ its option -multi is missing.
Set the write type for the next burn run. "auto" will select SAO with blank
CD media, DAO with blank DVD-R[W] if -close is "on", and elsewise CD TAO or the
equivalent write type of the particular DVD/BD media.
Choosing TAO or SAO/DAO explicitely might cause the burn run to fail if the
Choosing TAO or SAO/DAO explicitly might cause the burn run to fail if the
desired write type is not possible with the given media state.
@c man .TP
@item -padding number["k"|"m"]|"included"|"appended"
@ -3870,7 +3869,7 @@ the partition table. 0 chooses a default value. Maximum is 255.
the partition table. 0 chooses a default value. Maximum is 63.
@*
The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size.
It should be divisible by 2048 in order to allow exact alignment.
It should be divisible by 2048 in order to make exact alignment possible.
With appended partitions and "appended_part_as=gpt" there
is no limit for the number of cylinders. Else there may be at most 1024
of them.
@ -3911,9 +3910,8 @@ Only a single boot file can be declared by mipsel_path=.
@*
@cindex SUN Disk Label, production
@strong{sparc_label=}text causes the production of a SUN Disk Label with the
given text as ASCII label. This boot block format allows to append images
for partitions 2 to 8. Partition 1 will always be the ISO image.
See command -append_partition.
given text as ASCII label. Partitions 2 to 8 may occupied by appended images.
Partition 1 will always be the ISO image. See command -append_partition.
The first 512 bytes of any data provided by system_area= will be overwritten.
@*
@strong{grub2_sparc_core=}iso_rr_path causes the content address and size
@ -4497,12 +4495,12 @@ to be the most recent real session then.
Some read-only drives and media show no usable session history at all.
Command -rom_toc_scan might help.
@*
If input device and output device are both aquired and not the same,
If input device and output device are both acquired and not the same,
then both tables-of-content get shown.
@c man .TP
@item -toc_of "in"|"out"|"all"[":short"]
@kindex -toc_of shows list of sessions
Like command -toc but explicitely choosing which drive's table-of-content
Like command -toc but explicitly choosing which drive's table-of-content
to show. "in" shows -indev or -dev, "out" shows -outdev or -dev,
"all" shows the same as -toc.
@*
@ -4510,7 +4508,7 @@ If ":short" is appended to the drive choosing word, then only a short
summary of drive state and medium content is printed.
@*
As further difference to -toc, this command does not emit FAILURE events
if the desired drive is not aquired.
if the desired drive is not acquired.
@c man .TP
@item -mount_cmd drive entity id path
@kindex -mount_cmd composes mount command line
@ -4539,7 +4537,7 @@ for direct execution of this command.
Set options which influence -mount and -mount_cmd. Currently there is only
option "exclusive" which is default and its counterpart "shared". The latter
causes @command{xorriso} not to give up the affected drive with command -mount.
On GNU/Linux it adds mount option "loop" which may allow to mount several
On GNU/Linux it adds mount option "loop" which may enable mounting of several
sessions of the same block device at the same time. One should not write
to a mounted optical medium, of course. Take care to umount all sessions
before ejecting.
@ -5061,10 +5059,10 @@ recorded MD5 checksums. Severity "ALL" disables this event.
tries to read the file given by disk_path as
sector bitmap and to store such a map file after the scan run.
The bitmap tells which blocks have been read successfully in previous runs.
It allows to do several scans on the same medium, even with intermediate
eject, in order to collect readable blocks whenever the drive is lucky enough
to produce them. The stored file contains a human readable TOC of tracks
and their start block addresses, followed by binary bitmap data.
It is the persistent memory for several scans on the same medium, even with
intermediate eject, in order to collect readable blocks whenever the drive
is lucky enough to produce them. The stored file contains a human readable
TOC of tracks and their start block addresses, followed by binary bitmap data.
@*
By default, untested blocks are not considered bad, but rather as intentionally
unread. If you expect time_limit= or item_limit= to abort the run, then
@ -5189,7 +5187,7 @@ are owned by the effective user who runs @command{xorriso}. This happens
by temporarily granting rwx permission to the owner.
@*
Option "sort_lba_on" may improve read performance with optical drives. It
allows to restore large numbers of hard links without exhausting
can restore large numbers of hard links without exhausting
-temp_mem_limit. It does not preserve directory mtime and it needs
-osirrox option auto_chmod_on in order to extract directories which offer no
write permission. Default is "sort_lba_off".
@ -5197,7 +5195,7 @@ write permission. Default is "sort_lba_off".
Option "o_excl_on" is the default unless the program was started with leafname
"osirrox". On GNU/Linux it tries to avoid using drives which are mounted or in
use by other libburn programs.
Option "o_excl_off" allows on GNU/Linux to access such drives. Drives which
Option "o_excl_off" on GNU/Linux enables access to such drives. Drives which
get acquired while "o_excl_off" will refuse to get blanked, formatted,
written, or ejected. But be aware that even harmless inquiries can spoil
ongoing burns of CD-R[W] and DVD-R[W].
@ -5239,9 +5237,9 @@ composed from iso_rr_path by replacing iso_rr_prefix by disk_prefix.
@cindex Restore, copy file piece to disk, -extract_cut
Copy a byte interval from a data file out of an ISO image into a newly created
disk file.
The main purpose for this is to allow handling of large files if they
are not supported by mount -t iso9660 and if the reading system is unable
to buffer them as a whole.
The main purpose for this is to offer a way of handling large files if they
are not supported by mount -t iso9660 or if the target disk filesystem cannot
store large files.
@*
If the data bytes of iso_rr_path are stored in the loaded ISO image,
and no filter is applied,
@ -5786,7 +5784,7 @@ or to send a line via stdin.
@item -sleep seconds
@kindex -sleep waits for a given time span
@cindex Program, wait a time span, -sleep
Wait for the given number of seconds before perfoming the next command.
Wait for the given number of seconds before performing the next command.
Expect coarse granularity no better than 1/100 seconds.
@c man .TP
@item -errfile_log mode path|channel
@ -6427,7 +6425,7 @@ $ xorriso -dev stdio:/dev/sdb ...
@sp 1
If /dev/sdb is to be used frequently and /dev/sda is the system disk,
then consider to place the following lines in a @command{xorriso} Startup File.
They allow to use /dev/sdb without prefix and protect disk /dev/sda
They allow you to use /dev/sdb without prefix and protect disk /dev/sda
from @command{xorriso}:
@*
@sp 1
@ -6789,8 +6787,8 @@ program name pre-select certain settings:
@*
@strong{xorrecord} starts @command{xorriso} with -as cdrecord emulation.
@*
@strong{osirrox} starts with -osirrox "on:o_excl_off" which allows
to copy files from ISO image to disk and to apply command -mount to
@strong{osirrox} starts with -osirrox "on:o_excl_off" which allows further
commands to copy files from ISO image to disk and to apply command -mount to
one or more of the existing ISO sessions.
@c man .SS
@c man .B Startup files: