You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by kf...@collab.net on 2005/05/04 15:06:22 UTC

[BOOK PATCH] Re: revision no of the WC

anita kulshreshtha <a_...@yahoo.com> writes:
> Thanks, svnversion is what I need. It is not
> documented in
> http://svnbook.red-bean.com/en/1.1/svn-book.html#svn-ch-9.
> Is there any other reference, I should be using?

That's the main one.

It should be in that list.  Book authors, here's a patch.  I don't
even know if this compiles (I'm not set up here to build the book),
but markup problems aside, I think the material itself is probably
about right.

[[[
* src/en/book/ch09.xml
  (svnserve): New reference section.
]]]

Index: src/en/book/ch09.xml
===================================================================
--- src/en/book/ch09.xml	(revision 1261)
+++ src/en/book/ch09.xml	(working copy)
@@ -5404,6 +5404,108 @@
 
   </sect1>
 
+  <!-- ================================================================= -->
+  <!-- ======================== SECTION 5 ============================== -->
+  <!-- ================================================================= -->
+  <sect1 id="svn-ch-9-sect-5">
+
+    <title><command>svnversion</command></title>
+    
+    <sect2 id="svn-ch-9-sect-5.1">
+      <title>Synopsis</title>
+      <programlisting>svnversion [OPTIONS] WC_PATH [TRAIL_URL]</programlisting>
+    </sect2>
+
+    <sect2 id="svn-ch-9-sect-5.2">
+      <title>Description</title>
+      <para><command>svnversion</command> is a program for summarizing
+        the revision mixture of a working copy.  The resultant revision
+        number, or revision range, is written to standard output.</para>
+
+      <para>If the working copy is all at the same revision (for
+        example, immediately after an update), then that revision is
+        printed out:</para>
+
+      <screen>$ svnversion .
+4168</screen>
+
+      <para>For a mixed-revision working copy, the range of revisions
+        present is printed:</para>
+
+      <screen>$ svnversion .
+4123:4168</screen>
+
+      <para>If the working copy contains modifications, a trailing "M"
+        is added:</para>
+
+      <screen>$ svnversion .
+4168M</screen>
+
+      <para>If the working copy is switched, a trailing "S" is added:</para>
+
+      <screen>$ svnversion .
+4168S</screen>
+
+      <para>Thus, here is a mixed-revision, switched working copy
+        containing some local modifications:</para>
+
+      <screen>$ svnversion .
+4212:4168MS</screen>
+
+      <para>If invoked on a directory that is not a working copy, 
+        <command>svnversion</command> assumes it is an exported
+        working copy and prints "exported":</para>
+
+      <screen>$ svnversion .
+exported</screen>
+
+    </sect2>
+
+    <sect2 id="svn-ch-9-sect-5.3">
+      <title><command>svnversion</command> Switches</title>
+      
+      <para>Like <command>svnserve</command>,
+        <command>svnversion</command> has no subcommands, it only has
+        switches.</para>
+
+      <variablelist>
+
+        <varlistentry>
+          <term><option>--no-newline</option> (<option>-n</option>)</term>
+          <listitem>
+            <para>Omit the usual trailing newline from the output.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term><option>--committed</option> (<option>-c</option>)</term>
+          <listitem>
+            <para>Use the last-changed revisions rather than the
+            current (i.e., highest locally available) revisions.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term><option>--help</option> (<option>-h</option>)</term>
+          <listitem>
+            <para>Print a help summary.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term><option>--version</option></term>
+          <listitem>
+            <para>Print the version of <command>svnversion</command>
+            and exit with no error.</para>
+          </listitem>
+        </varlistentry>
+
+      </variablelist>
+
+    </sect2>
+
+  </sect1>
+
 </chapter>
 
 <!--

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: [BOOK PATCH] Re: revision no of the WC

Posted by kf...@collab.net.
"C. Michael Pilato" <cm...@collab.net> writes:
> I've forwarded this patch to the svnbook-dev list.

Thanks, I'll try to remember that for next time!

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: [BOOK PATCH] Re: revision no of the WC

Posted by kf...@collab.net.
"C. Michael Pilato" <cm...@collab.net> writes:
> I've forwarded this patch to the svnbook-dev list.

Thanks, I'll try to remember that for next time!

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org

Re: [BOOK PATCH] Re: revision no of the WC

Posted by "C. Michael Pilato" <cm...@collab.net>.
kfogel@collab.net writes:

> anita kulshreshtha <a_...@yahoo.com> writes:
> > Thanks, svnversion is what I need. It is not
> > documented in
> > http://svnbook.red-bean.com/en/1.1/svn-book.html#svn-ch-9.
> > Is there any other reference, I should be using?
> 
> That's the main one.
> 
> It should be in that list.  Book authors, here's a patch.  I don't
> even know if this compiles (I'm not set up here to build the book),
> but markup problems aside, I think the material itself is probably
> about right.
> 
> [[[
> * src/en/book/ch09.xml
>   (svnserve): New reference section.
> ]]]

I've forwarded this patch to the svnbook-dev list.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: [BOOK PATCH] Re: revision no of the WC

Posted by "C. Michael Pilato" <cm...@collab.net>.
kfogel@collab.net writes:

> anita kulshreshtha <a_...@yahoo.com> writes:
> > Thanks, svnversion is what I need. It is not
> > documented in
> > http://svnbook.red-bean.com/en/1.1/svn-book.html#svn-ch-9.
> > Is there any other reference, I should be using?
> 
> That's the main one.
> 
> It should be in that list.  Book authors, here's a patch.  I don't
> even know if this compiles (I'm not set up here to build the book),
> but markup problems aside, I think the material itself is probably
> about right.
> 
> [[[
> * src/en/book/ch09.xml
>   (svnserve): New reference section.
> ]]]

I've forwarded this patch to the svnbook-dev list.

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org