Comment 2 for bug 586555

Revision history for this message
Samuel Bronson (naesten) wrote :

Okay, I have to admit that what I want to see is not going to fit in 30 lines! I've revised the title and description of this bug accordingly: linking would be fine too; the real point is that doing "bzr help svn-layout" should help the user find the information, not that the information necessarily be displayed immediately.

What do I mean by "linking", given that console output does not normally support arbitrary hyperlinks? Well, a URL works, as would a path relative to an easy-to-find directory (especially if a command to find this directory is also supplied). For a link to the user guide, I would suggest linking to the "latest" online version as I have in the description: if the user is working offline and has her own copy of the guide, she can probably figure out what part of that to paste onto the end of her local URL to get to the page in question without much difficulty; and if she's on the net, she'd probably not want to have to hunt up a base URL on her own.

Honestly, though, even putting a good text file in the source tree and mentioning the path in the help text (along with a hint about "bzr plugins -v") would be a big improvement!