Bug 175772 - svn help and man svn should mention /usr/share/doc/subversion-*/svn-book.html
Summary: svn help and man svn should mention /usr/share/doc/subversion-*/svn-book.html
Alias: None
Product: Fedora
Classification: Fedora
Component: subversion
Version: 4
Hardware: i386
OS: Linux
Target Milestone: ---
Assignee: Joe Orton
QA Contact:
Depends On:
TreeView+ depends on / blocked
Reported: 2005-12-14 20:38 UTC by Jesse Glick
Modified: 2007-11-30 22:11 UTC (History)
0 users

Clone Of:
Last Closed: 2006-01-10 11:47:18 UTC

Attachments (Terms of Use)

Description Jesse Glick 2005-12-14 20:38:48 UTC
From Bugzilla Helper:
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7.12) Gecko/20050922 Fedora/1.0.7-1.1.fc4 Firefox/1.0.7

Description of problem:
The Subversion RPM for FC4 includes a local copy of the book "Version Control with Subversion", which furthermore looks to be built from the same source version as the actual code, and which is probably the best source of documentation on the tool. But the binary tool does not hint that it is there; you need to use rpm -ql subversion or the like to find it.

It is understandable that after downloading svn sources and building them yourself, the docs would not refer to anything beyond what is definitely included in those sources, plus public web sites. But the RPM has a predefined list of files in it, so FC could patch the svn sources a little bit before building to refer to the book which it will bundle, as a value-add.

Version-Release number of selected component (if applicable):

How reproducible:

Steps to Reproduce:
1. Type svn help.

2. Type man svn.

3. Open an Info browser (e.g. C-h I in Emacs); search for "subversion" or "svn".

Actual Results:  After #1: you see

For additional information, see http://subversion.tigris.org/

which most usefully will link to


if you follow that link. This covers Subversion 1.1, but 1.2.3 is installed.

After #2: you will see (edited down):

For more information [...] visit http://subversion.tigris.org.
Documentation for Subversion [...] can be found at http://svnbook.red-bean.com/.

Again, same links.

After #3: nothing, no matches.

Expected Results:  Both the help summary and the man page should have instructed you to open a web browser and enter the URL


which contains a complete, current local copy of the book. Info page probably unnecessary in this case.

Additional info:

Comment 1 Joe Orton 2005-12-15 12:51:12 UTC
Since it looks like upstream have stopped packaging the book in the tarball it's
likely that the local copy of the docs will actually go away in the future
updates.  Will wait to see what happens with the final 1.3.0 tarball.

Comment 2 Joe Orton 2006-01-10 11:47:18 UTC
Marking WONTFIX since upstream are indeed no longer bundling the book.

Note You need to log in before you can comment on or make changes to this bug.