A list of minor man page flaws
| Newsgroups | gmane.comp.archivers.star.user |
|---|---|
| Message-ID | <[email protected]> |
Hi once again Joerg,
since we are talking about the man page, here my
collection of smaller problem points (as of 1.5a66) :
two typos and some stumble stones in the text.
------------------------------------------------------
It is multiply mentioned throughout the man page of
star-1.5a66 that one should look at the description
of the -C option. But there is only a description of
"C=".
A clarification would be helpful. Like
-C see option C=
------------------------------------------------------
In the description of "level=" there are two instances
of :
"the directory followed by the -C option"
None of the examples in section INCREMENTAL BACKUPS
has a directory which is followed by the -C option.
It is always vice versa.
Can it be you meant :
"the directory following the -C option"
------------------------------------------------------
With the first two example commands in section
INCREMENTAL BACKUPS one should mention that file
archive-name
of level=0 eventually gets overwritten and not appended
by the level=1 backup.
A user could get this wrong, since some other
backup systems indeed append incremental backups
to the media resp. archive files of lower levels.
------------------------------------------------------
Typos:
------------------------------------------------------
man 1 star :
"retore" in "switches star into true incremental retore mode."
------------------------------------------------------
http://cdrecord.berlios.de/old/private/star.html :
"substitutuions" in "'ed' like pattern substitutuions"
(Is above URL the official star homepage ? I remember to
have been pointed to star.berlios.de but that is still
in statu nascendi.)
------------------------------------------------------
Have a nice day :)
Thomas