Subversion Quick Reference Card
$Re v :
28 $
me r g e
mk d i r
mo v e
Su bversion is a version control system that is a replacement
for CVS. It has most of CVS's features. Generally, Subversion's
interface to a particular feature is similar to CVS's, except where
there's a compelling reason to do otherwise.
p r opd e l
p r op e d i t
p r opg e t
p r op l i s t
Quick start
p r op s e t
s v n a dm i n c r e a t e / v a r / s v n r oo t
s v n i mpo r t Loc a l D i r f i l e : / / / v a r / s v n r oo t / P r o j e c t Name
s v n c h e c k ou t f i l e : / / / v a r / s v n r oo t / P r o j e c t Name
c d P r o j e c t Name
s v n h e l p [ command ]
s t a t us
Subversion URLs
sw i t c h
Direct repository access (on local disk).
Access via WebDAV protocol to Subversion-aware
Apache server.
h t t ps : / /
Same as h t t p : / / , but with SSL encryption.
svn : / /
Access via custom protocol to an s v n s e r v e server.
s v n+ s s h : / / Same as s v n : / / , but through an SSH tunnel.
upd a t e
f i le: / /
ht tp: / /
b l ame
ca t
c h e c k ou t
c l e a nup
c omm i t
c op y
de l e t e
di f f
e x po r t
he l p
i mpo r t
info
l ist
l og
r eve r t
Adds þles and directories.
( p r a i s e , a nno t a t e , a nn ) Shows author and revision information in-line for the speciþed þles or
URLs.
Outputs the contents of the speciþed þles or URLs.
( c o ) Checks out a working copy from a repository.
Recursively clean up the working copy.
( c i ) Send changes from your working copy to the
repository.
( c p ) Copy a þle or directory in a working copy or
in the repository.
( d e l , r emo v e , r m) Delete an item from a working
copy or the repository.
( d i ) Display the diÞerences between two paths.
Exports a clean directory tree.
Prints help text.
Recursively commit a copy of local dir into a repository.
Print information about PATHs.
( l s ) List directory entries in the repository.
Displays commit log messages.
1
≠≠ i gno r e≠a n c e s t r y
Ignore ancestry when calculating diÞerences (rely on path
contents alone).
≠≠ i n c r eme n t a l
Prints output in a format suitable for concatenation.
≠≠me s s a g e ( ≠m ) MSG
Specify a commit message MSG .
≠≠no≠a u t h≠c a c h e
Prevents caching of authentication information.
≠≠no≠a u t o≠p r op s
Disable a u t o≠p r op s , overriding the e n a b l e≠a u t o≠p r op s
directive in the conþg þle.
≠≠no≠d i f f ≠d e l e t e d
Prevents Subversion from printing diÞerences for deleted
þles.
≠≠no≠ i gno r e
Shows þles in the status listing that would normally be
omitted since they match a pattern in the s v n : i gno r e
property.
≠≠non≠ i n t e r a c t i v e
s v n switches
Prevents prompting for authentication information.
≠≠non≠ r e c u r s i v e ( ≠N )
≠≠c on f i g≠d i r D I R
Read conþguration from D I R instead of ~ / . s ub v e r s i on .
≠≠d i f f ≠cmd CMD
Use external program CMD for generating d i f f output instead of internal diÞ engine.
s v n subcommands
a dd
r eso l ved
Apply the diÞerences between two sources to a working copy path.
Create a new directory under version control.
(mv , r e n ame , r e n ) Move a þle or directory.
( pd e l , pd ) Remove a property from an item.
( p e d i t , p e ) Edit the property of one or more items
under version control.
( pg e t , pg ) Prints the value of a property.
( p l i s t , p l ) Lists all properties.
( p s e t , p s ) Sets a property on þles, directories, or
revisions.
Remove con icted state on working copy þles or
directories.
Undo all local edits.
( s t a t , s t ) Print the status of working copy þles
and directories.
( sw) Update working copy to a diÞerent URL.
( up ) Updates your working copy.
≠≠d i f f 3≠cmd CMD
Use external program CMD for merging þles.
≠≠d r y≠ r un
Run the command without changing anything.
≠≠e d i t o r ≠cmd CMD
Use external program CMD for editing þles.
≠≠e n c od i ng ENC
Instructs Subversion to use encoding ENC to store log messages.
Stops a subcommand from recursing into subdirectories.
≠≠no t i c e≠a n c e s t r y
Pay attention to ancestry when calculating diÞerences.
≠≠o l d ARG
Uses ARG as the older target.
≠≠p a s swo r d PASS
Password for authentication.
≠≠qu i e t ( ≠q )
Print only essential information while performing an operation.
≠≠ r e c u r s i v e ( ≠R )
Makes a subcommand recurse into subdirectories.
≠≠ r e l o c a t e FROM TO [ PATH . . . ]
Used with the s v n sw i t c h subcommand, changes the lo-
cation of the repository that your working copy references.
≠≠e x t e n s i on s ARG ( ≠x )
Additional arguments for external diÞ, eg.: s v n ≠≠d i f f ≠cmd
d i f f ≠x ≠≠no r ma l d i f f ma i n . c .
≠≠ f i l e F I LE ( ≠F )
Use the contents of þle F I LE as an argument for a given
subcommand.
≠≠ f o r c e
Forces a particular subcommand to run.
≠≠ f o r c e≠ l og
Forces a suspicious parameter passed to the ≠≠me s s a g e
options to be accepted as valid.
≠≠h e l p ( ≠h or ≠? )
Prints help for a given command or general help text.
2
≠≠ r e v i s i on REV ( ≠ r )
Supply a revision REV (or range of revisions) for a particular operation.
≠≠ r e v p r op
Operates on a revision property instead of a Subversion
property speciþc to a þle or directory (requires ≠≠ r e v i s i on
switch).
≠≠s how≠upd a t e s ( ≠u )
Causes the client to display information about which þles
in your working copy are out-of-date.
3
≠≠s t op≠on≠c op y
Stop harvesting historical information when a copy is encountered.
≠≠s t r i c t
Causes Subversion to use strict semantics.
s v n l oo k subcommands
a u t ho r
ca t
c h a ng e d
da t e
≠≠ t a r g e t s F I LE
Get the list of þles that you wish to operate on from the
þle F I LE .
≠≠u s e r n ame NAME
Username for authentication.
≠≠v e r bo s e ( ≠v )
di f f
≠≠v e r s i on
Prints the client version info.
≠≠xm l
Prints output in XML format.
he l p
info
l og
p r op l i s t
s v n a dm i n subcommands
t r ee
l i s t ≠unu s e d≠db l og s
c r ea t e
dump
he l p
ho t c op y
l oad
l s t xns
r ecove r
rm t xns
s e t l og
Ask Berkeley DB which log þles can be safely deleted.
Create a new, empty repository.
Dump the contents of þlesystem to stdout.
Help.
Makes a hot copy of a repository.
Read a dumpþle-formatted stream from stdin.
Print the names of all uncommitted transactions.
Recovers any lost state in a repository.
Deletes transactions from a repository.
Set the log-message on a revision.
Prints the author.
Print the contents of a þle.
Print the paths that were changed.
Print the date stamp.
Prints diÞerences of changed þles and properties.
y oung e s t
Print the directories that were themselves changed.
Help.
Print information about the history of a path in the
repository.
Print the author, date stamp, log message size, and
log message.
Print the log message.
Print the names and values of versioned þle and
directory properties.
Print the tree.
Print the youngest revision number.
s v n l oo k switches
Prevents svnlook from printing diÞerences for deleted þles.
≠≠ r e v i s i on REV ( ≠ r )
Specify a particular revision number that you wish to examine.
≠≠ t r a n s a c t i on T I D ( ≠ t )
Specify a particular transaction id T I D that you wish to
examine.
≠≠s how≠ i d s
Show the þlesystem node revision IDs for each path in the
þlesystem tree.
≠≠b y p a s s≠hoo k s
≠≠c op i e s
Follow copy history when examining a path.
≠≠ i n≠ r e po s≠ t emp l a t e ARG
Specify a template for the repository structure when creating a new repository.
Dump a revision only as a diÞ against the previous revision, instead of the usual fulltext.
≠≠on≠d i s k≠ t emp l a t e ARG
Specify a template to use for the on-disk structure of the
repository you want to create.
≠≠ r e v i s i on ARG ( ≠ r )
Specify a particular revision to operate on.
4
svn : ex t e r na l s
s v n : k e ywo r d s
date of the last modiþcation
revision number
$Au t ho r $ the last user who changed the þle
$URL$
full URL to the latest version of
the þle in the repository
$ I d$
compressed combination of keywords above
$Da t e $
$Re v $
Client conþguration
[ he l pe r s ]
e d i t o r ≠cmd = v i m
[m i sce l l any ]
l og≠e n c od i ng = i s o≠8859≠2
e n a b l e≠a u t o≠p r op s = y e s
[ a u t o≠p r op s ]
* . sh = svn : execu t ab l e
* . b a t = s v n : e o l ≠s t y l e =CRL F
* . c = s v n : e o l ≠s t y l e =n a t i v e ; s v n : k e ywo r d s = I d
Autocompletion in b a s h :
File status
U
A
D
R
G
≠≠ i n c r eme n t a l
s v n : e o l ≠s t y l e
MIME type of a þle.
List of þle patterns which certain Subversion operations will ignore. Full list may be
obtained by s v n s t a t u s ≠≠no≠ i gno r e .
Possible values are: n a t i v e , CRL F , L F , CR.
Instructions for Subversion to populate a versioned directory with one or more other checkedout Subversion working copies.
List of keywords that will be substituted during commit:
File ~ / . s ub v e r s i on / c on f i g :
≠≠no≠d i f f ≠d e l e t e d
s v n a dm i n switches
Bypass the repository hook system.
s v n : i gno r e
d i r s≠c h a ng e d
h i s tory
Verbose mode.
s v n : m i me≠ t y p e
C
?
!
File was updated.
File was added.
File was deleted.
File was replaced.
File was merged.
Con icting changes.
Resource is not under version control.
Resource is missing or incomplete (removed by another tool
than Subversion).
s hop t ≠s e x t g l ob p r og c omp
.
/ u s r / s h a r e / s ub v e r s i on / . . . / b a s h_ c omp l e t i on
O ther sources of information
h t t p : / / s ub v e r s i on . t i g r i s . o r g
Home page of the Subversion project.
h t t p : / / s v nboo k . r e d≠b e a n . c om
Version Control with Subversion | a book on Subversion.
h t t p : / / t o r t o i sesvn . t i g r i s . o r g /
TortoiseSVN is a Windows client for Subversion implemented as a windows shell extension.
Special properties
svn : execu t ab l e
Executable þle permission.
5
Compiled by C ez a r y Sob a nie c
h t t p : / / www . c s . pu t . po z n a n . p l / c s ob a n i e c /