svn-command 0.2.5 → 0.2.7

data/ProjectInfo.rb

@@ -5,7 +5,7 @@ module Project
   PrettyName    = "Enhanced Subversion Command"
   Name          = "svn-command"
   RubyForgeName = "svn-command"
-  Version       = "0.2.5"
+  Version       = "0.2.7"
   Specification = Gem::Specification.new do |s|
     s.name    = Project::Name
     s.summary = "A nifty wrapper command for Subversion's command-line svn client"
@@ -27,7 +27,7 @@ module Project
     s.add_dependency("rscm")
     s.post_install_message = <<-End
 ---------------------------------------------------------------------------------------------------
-Please run _svn_command_post_install to finalize the installation.
+Please run sudo /usr/bin/_svn_command_post_install to finalize the installation.
 ---------------------------------------------------------------------------------------------------
   End
 

data/Readme

@@ -8,25 +8,35 @@
 [<b>Copyright</b>:]        2007 QualitySmith, Inc.
 [<b>License</b>:]          {GNU General Public License}[http://www.gnu.org/copyleft/gpl.html]
 
-== Introduction
+== What is it? 
 
-This is a replacement <b><tt>svn</tt> command-line client</b> meant to be used instead of the standard +svn+ command. (Actually, it's a _wrapper_, not a replacement, because it still uses <tt>/usr/bin/svn</tt> to do all the dirty work.)
+This is a replacement <b><tt>svn</tt> command-line client</b> meant to be used instead of the standard +svn+ command. (Actually, it's a _wrapper_, not a strict replacement, because it still uses <tt>/usr/bin/svn</tt> to do all the dirty work.)
 
 == Installation
 
+=== Dependencies
+
+* termios
+* colored
+* escape
+* facets
+* extensions
+* qualitysmith_extensions
+* rscm
+
 === Installation: Once per _system_
 
-  sudo gem install svn-command 
+* Install the gem (with dependencies):
 
-You will also need to run <tt>_svn_command_post_install</tt>, which will attempt to do the following:
+  sudo gem install svn-command --include-dependencies
+
+You will also need to run <tt>sudo /usr/bin/_svn_command_post_install</tt>, which will attempt to do the following (or you can do this manually):
 
 * Make the svn wrapper command *executable*:
 
     sudo chmod a+x /usr/lib/ruby/gems/1.8/gems/svn-command*/bin/*
 
-(We can't just set <tt>executables = "svn"</tt> and have it automatically install it to /usr/bin because that would cause it to <b>wipe out</b> the existing executable at <tt>/usr/bin/svn</tt>! If you know of a better, more automatic solution to this, please let the developers know!)
-
-(You may have to restart my terminal after doing the chmod step for bash to detect the svn command in that new location.)
+  (Note: We can't just set <tt>executables = "svn"</tt> in the gemspec and have it automatically install it to /usr/bin because that would cause it to <b>wipe out</b> the existing executable at <tt>/usr/bin/svn</tt>! If you know of a better, more automatic solution to this, please let the developers know!)
 
 === Installation: Per user
 
@@ -35,6 +45,8 @@ You will also need to run <tt>_svn_command_post_install</tt>, which will attempt
 * Add a <tt>PATH=</tt> command to your <tt>~/.bash_profile</tt> (or equivalent). For example:
 
     export PATH=`ls -dt --color=never /usr/lib/ruby/gems/1.8/gems/svn-command* | head -n1`/bin:$PATH"
+
+(You may have to source your <tt>~/.bash_profile</tt> after making <tt>svn</tt> in order for bash to detect the new path to the svn command.)
  
 === Check to see if it's working
 
@@ -101,13 +113,26 @@ For *files*, it will show a preview of the _contents_ of that file (limited to t
 
 == <tt>svn revisions</tt> (revisions browser)
 
-Lets you interactively step through all revisions of a file/directory/repository.
+Lets you interactively browse through all revisions of a file/directory/repository (one at a time). For each revision, it will ask you what you want to do with it (view the changeset, edit revision properties, etc.).
 
 Screenshot:
 link:include/svn_revisions.png
 
-Use the <tt>--forwards</tt> flag if you want to <i>start at the oldest revision</i> and step forwards through time rather than starting at the latest revision and stepping backwards (the default).
+It's sort of like <tt>svn log | less</tt>, only it's interactive, it's in color, and it's just plain more useful!
+
+You can step through the revisions using the arrow keys or Enter. 
+
+Here are a couple things you might use it for:
+* <b>View the history of a certain file</b>.
+  * Rather than looking at <tt>svn log -v</tt> (which can be _huge_) directly and then manually calculating revision numbers and doing things like <tt>svn diff -r1492:1493</tt> over and over, you can simply start up <tt>svn revisions</tt>, browse to the revision you're interested in using the Up/Down arrow keys, and press D to get a diff for the selected changeset.
+* <b>See what's been committed since the last public release</b>. So that you can list it in your release notes, for example...
+* <b>Review other people's code</b>. (There's even a mark-as-reviewed feature*, if you want to keep track of which revisions have been reviewed...)
+* <b>Searching for a change you know you've made</b> but don't remember what revision that was it. (Hint: Use the "grep this changeset" feature.)
+* Figure out what the <b>difference is between two branches</b>.
+
+Defaults to latest-first, but you can pass it the <tt>--forwards</tt> flag to browse from the other direction (start at the <i>oldest revision</i> and step forwards through time).
 
+(*The mark-as-reviewed feature requires the modification of your repository's pre-revprop-change hook.)
 
 == <tt>svn status</tt>
 

data/lib/svn-command/svn_command.rb

@@ -101,6 +101,7 @@ module Subversion
       'revisions',
       'get_message', 'set_message', 'edit_message',
       'view_commits',
+      'url',
       'repository_root',
       'latest_revision',
       'delete_svn'

metadata

@@ -3,7 +3,7 @@ rubygems_version: 0.9.2
 specification_version: 1
 name: svn-command
 version: !ruby/object:Gem::Version 
-  version: 0.2.5
+  version: 0.2.7
 date: 2007-05-01 00:00:00 -07:00
 summary: A nifty wrapper command for Subversion's command-line svn client
 require_paths: 
@@ -27,7 +27,7 @@ signing_key:
 cert_chain: 
 post_install_message: |
   ---------------------------------------------------------------------------------------------------
-  Please run _svn_command_post_install to finalize the installation.
+  Please run sudo /usr/bin/_svn_command_post_install to finalize the installation.
   ---------------------------------------------------------------------------------------------------
 
 authors: