A list of minor man page flaws

[email protected]
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.