[<<]Message[>>]    [<<]Author[>>]    [<<]Subject[>>]    [<<]Thread[>>]

Number   :  7210
Date     :  2004-02-07
Author   :  Kan Yabumoto
Subject  :  Re: Suggestions for Documentation Improvement
Size(KB) :  2


Bernard wrote:

>In a recent XXCOPY digest message, Kan acknowledged that the
>documentation for XXCOPY needs some updating.
>
>Certainly the XXCOPY.CHM file by John Zeman is a wonderful
>addition to XXCOPY documentation. In general, Kan has done
>an excellent job in documentation and I certainly intend
>these remarks to be constructive.
>
>When the updating of the "XXTB #n" technical bulletins is
>undertaken, I would like to suggest the following:
>
>In XXTB #01 ("XXCOPY Command Parameters Reference") the /CF
>switch for command files is barely mentioned. I believe the
>/CF switch is a signnificant addition to XXCOPY and I
>believe a reference to XXTB #37 ("The textfiles for XXCOPY
>Command") should be added in XXTB #01.

I'm glad that you like the /CF feature. I think it is
one of the clean designs of XXCOPY that we are proud.
I don't recall any feedback that people gave me that
related to the /CF feature. Apparently, you like it.

I'm not sure how I can improve the exposure of the /CF
switch in the context of XXTB #01 where the command
is given 5 lines of text (whereas most other commands
get just one line). The XXTB #01 article is essentially
a rehash of the /HELP text (In the case of Microsoft's
XCOPY, the text by the /? command is all you get).

So, the XXTB #37 article is the in-death coverage of
the command file feature. I agree with Bernard that
its usefulness is universal and therefore, it should
be more prominent than most other switches. It is
currently classified in the "miscellaneous" commands
along with other less important switches.

On the other hand, the /CF is not a file-management
function at all. It is only one of the "convenience"
features. So, it will never receive an MVP status,
it's like a perennial "best supporting actor".

>XXTB #37 should also be referenced in XXTB #05 ("The
>Exclusion specifier in XXCOPY"), in XXTB #11 ("XXCOPY
>Cookbook: Recipes of command usage") and in XXTB #19
>("XXCOPY in batch files").

We will take your suggestion and make some reference
to the article so that the user can take full advantage
of the /CF feature. In XXTB #01 and XXTB #05,
we will put a hypertext link to the article.

We use the /CF command all the time whenever we
run a debugging session. It is indispensable.
We also use it in a big volume backup operations.
I guess advanced users who frequently write batch files
and programs probably like the /CF feature.

Kan Yabumoto



This message if part of XXCOPY's message Archive.
The archive contains all the messages posted at Yahoo!Groups: XXCOPY.