List Info

Thread: Couple minor doc tweaks




Couple minor doc tweaks
user name
2007-08-01 19:19:57
While doing some conversions just now, I tripped over a
couple minor  
errors in www/cvs2svn.html.  A patch file is attached, and
here's a  
commit log.  I've subscribed to this list, so if this needs
more  
discussion, I'm available.

In detail:

1. The discussion of eol handling claims that CVS defaults
to  
"binary," but in fact CVS defaults to
"text" (with built-in overrides  
for some file-name patterns), and of course the whole
discussion of  
the CVS "-k b" flag is about how to change that
default behavior.   
It's SVN that defaults to "binary."  Fixed the CVS
claim.

2. The discussion of repo topology helpfully links to a
section of  
The Book that discusses repo topo.  But The Book actually
describes  
two "standard" layouts, one for single-project
repositories and  
another for multi-project ones.  And, wouldn't ya know it,
the  
section linked from here describes the one that cvs2svn
_doesn't_  
use!   Linked
to the section that describes both, and added  
keywords to clue the reader as to which is intended.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Correct some minor but confusing hiccups.

  * www/cvs2svn.html
    (End-of-line translation): correctly describe CVS
default behavior
    (Symbol handling): link to a section in The Book that
actually  
does match cvs2svn behavior
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-





-==-
Jack Repenning
jackrepenningtigris.org
Project Owner
SCPlugin
http://scplugin.tigris.org

"Subversion for the rest of OS X"


------------------------------------------------------------
---------
To unsubscribe, e-mail: dev-unsubscribecvs2svn.tigris.org
For additional commands, e-mail: dev-helpcvs2svn.tigris.org
  
Re: Couple minor doc tweaks
user name
2007-08-02 08:49:48
Jack Repenning wrote:
> While doing some conversions just now, I tripped over a
couple minor
> errors in www/cvs2svn.html.  A patch file is attached,
and here's a
> commit log.  I've subscribed to this list, so if this
needs more
> discussion, I'm available.
> 
> In detail:
> 
> 1. The discussion of eol handling claims that CVS
defaults to "binary,"
> but in fact CVS defaults to "text" (with
built-in overrides for some
> file-name patterns), and of course the whole discussion
of the CVS "-k
> b" flag is about how to change that default
behavior.  It's SVN that
> defaults to "binary."  Fixed the CVS claim.
> 
> 2. The discussion of repo topology helpfully links to a
section of The
> Book that discusses repo topo.  But The Book actually
describes two
> "standard" layouts, one for single-project
repositories and another for
> multi-project ones.  And, wouldn't ya know it, the
section linked from
> here describes the one that cvs2svn _doesn't_ use!   Linked
to the
> section that describes both, and added keywords to clue
the reader as to
> which is intended.
> 
> -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
> Correct some minor but confusing hiccups.
> 
>  * www/cvs2svn.html
>    (End-of-line translation): correctly describe CVS
default behavior
>    (Symbol handling): link to a section in The Book
that actually does
> match cvs2svn behavior
> -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Jack,

Thanks for the patch.  Your first point is entirely correct
and I just
committed your fix.

Your second complaint is also valid.  But now that cvs2svn
supports
multiproject conversions, either of the trunk/branches/tags
layouts is
possible.  Therefore I rewrote that section of the docs to
be clearer
about both possibilities, and changed the link to the one
that you
suggested (which is indeed much better than the old link).

Please let me know if you think that the revised text is
inaccurate or
confusing.

Thanks,
Michael

------------------------------------------------------------
---------
To unsubscribe, e-mail: dev-unsubscribecvs2svn.tigris.org
For additional commands, e-mail: dev-helpcvs2svn.tigris.org


[1-2]

about | contact  Other archives ( Real Estate discussion Medical topics )