#85 Moving a paragraph

[Anonymous]

Originally created by: christophe.nanteuil@gmail.com
Originally owned by: christophe.nanteuil@gmail.com

IMHO, it would be better to move the following paragraph :
- located in "Description" of section "svnsync synchronize" of Chapter 9
- to section "svnsync initialize"

"As of Subversion 1.5, you can limit svnsync to a subdirectory of the source repository by specifying the subdirectory as part of the SOURCE_URL"

[Anonymous]

Originally posted by: cmpilato

Thanks for feedback, Christophe.  I actually disagree with this suggestion, though.  First, we do mention in the 'svnsync init' section the fact that Subversion 1.5 adds this functionality.  Secondly, it's not (in my experience) the most common use of svnsync, so I prefer to leave the fuller description down where it is (in a bit of text that flows almost like "stuff you should know when doing atypical things").

That said, would it suffice (in your opinion) to extend the current text of 'svnsync init' a bit to include a notice that there's more to be found on the partial mirroring topic later?

"In Subversion 1.5, though, you can use <command>svnsync</command> to mirror
only some subtree of the repository, too.  We describe this process of <firstterm>partial repository mirroring</firstterm> in more detail later in this section."

[Anonymous]

Originally posted by: christophe.nanteuil@gmail.com

Well, what disturbs me is that the paragraph mentions SOURCE_URL in a section where this option is not available. I would agree with you if the paragraph was in Chapter 5 'Administration', where you present the usual way first, and where you can go back afterwards to introduce an atypical thing.
But it is in Chapter 9 'References' and, as the subtree has to be specified at the initialization, I think the paragraph should be in the corresponding section. If an administrator reminds that this atypical thing is available and wants to confirm the syntax, where will (s)he open the book ?
In conclusion, my opinion (just my opinion) is that the partial repository mirroring should be mentionned in Chapter 5, the way you propose it in your comment, and that the paragraph should be moved in initialize section, maybe with an example to illustrate the thing.

[Anonymous]

Originally posted by: cmpilato

Doh!  Had I read your initial report correctly, I would have totally agreed.  As it was, somehow I thought you *were* talking about Chapter 5.  Yes, the ordering in Chapter 9 is non-ideal.  I'll fix that.  (Sorry for the unnecessary chatter here.)

Labels: Milestone-en-1.6

[Anonymous]

Originally posted by: cmpilato

Committed in [r3750].  Thanks, Christophe.

Status: Fixed