Subversion Complete Reference
Name
svn propedit -- Edit the property of one or more items under version control.
svn propedit
Synopsis
svn propedit PROPNAME PATH...
svn propedit PROPNAME --revprop -r REV [URL]
Description
Edit one or more properties using your favorite editor. The first form edits versioned properties in your working copy, while the second edits unversioned remote properties on a repository revision.
Alternate Names
pedit, pe
Changes
Working copy, repository only if operating on a URL
Accesses Repository
Only if operating on a URL
Switches
--revision (-r) REV --revprop --username USER --password PASS --no-auth-cache --non-interactive --encoding ENC --editor-cmd EDITOR --config-dir DIR
Examples
svn propedit makes it easy to modify properties that have multiple values:
$ svn propedit svn:keywords foo.c
<svn will launch your favorite editor here, with a buffer open containing the current contents of the svn:keywords property. You can add multiple values to a property easily here by entering one value per line.>
Set new value for property 'svn:keywords' on 'foo.c'
204
Subversion Complete Reference
Name
svn propget -- Print the value of a property. svn propget
Synopsis
svn propget PROPNAME [TARGET[@REV]...]
svn propget PROPNAME --revprop -r REV [URL]
Description
Print the value of a property on files, directories, or revisions. The first form prints the versioned property of an item or items in your working copy, while the second prints unversioned remote property on a repository revision. See the section called “Properties” for more information on properties.
Alternate Names
pget, pg
Changes
Working copy, repository only if operating on a URL
Accesses Repository
Only if operating on a URL
Switches
--recursive (-R) --revision (-r) REV --revprop
--strict --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR
Examples
Examine a property of a file in your working copy:
$ svn propget svn:keywords foo.c Author
Date
Rev
The same goes for a revision property:
205
Subversion Complete Reference
$ svn propget svn:log --revprop -r 20 Began journal.
206
Subversion Complete Reference
Name
svn proplist -- List all properties.
svn proplist
Synopsis
svn proplist [TARGET[@REV]...]
svn proplist --revprop -r REV [URL]
Description
List all properties on files, directories, or revisions. The first form lists versioned properties in your working copy, while the second lists unversioned remote properties on a repository revision.
Alternate Names
plist, pl
Changes
Working copy, repository only if operating on a URL
Accesses Repository
Only if operating on a URL
Switches
--verbose (-v) --recursive (-R) --revision (-r) REV --quiet (-q) --revprop --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR
Examples
You can use proplist to see the properties on an item in your working copy:
$ svn proplist foo.c Properties on 'foo.c':
svn:mime-type svn:keywords owner
But with the --verbose flag, svn proplist is extremely handy as it also shows you the values for the properties:
207
Subversion Complete Reference
$ svn proplist --verbose foo.c Properties on 'foo.c':
svn:mime-type : text/plain svn:keywords : Author Date Rev owner : sally
208
Subversion Complete Reference
Name
svn propset -- Set PROPNAME to PROPVAL on files, directories, or revisions. svn propset
Synopsis
svn propset PROPNAME [PROPVAL | -F VALFILE] PATH...
svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [URL]
Description
Set PROPNAME to PROPVAL on files, directories, or revisions. The first example creates a versioned, local property change in the working copy, and the second creates an unversioned, remote property change on a repository revision.
Tip
Subversion has a number of “special” properties that affect its behavior. See the section called “Special Properties” for more on these properties.
Alternate Names
pset, ps
Changes
Working copy, repository only if operating on a URL
Accesses Repository
Only if operating on a URL
Switches
--file (-F) FILE --quiet (-q) --revision (-r) REV --targets FILENAME --recursive (-R) --revprop --username USER --password PASS --no-auth-cache --non-interactive --encoding ENC --force --config-dir DIR
Examples
Set the mimetype on a file:
209
Subversion Complete Reference
$ svn propset svn:mime-type image/jpeg foo.jpg property 'svn:mime-type' set on 'foo.jpg'
On a UNIX system, if you want a file to have the executable permission set:
$ svn propset svn:executable ON somescript property 'svn:executable' set on 'somescript'
Perhaps you have an internal policy to set certain properties for the benefit of your coworkers:
$ svn propset owner sally foo.c property 'owner' set on 'foo.c'
If you made a mistake in a log message for a particular revision and want to change it, use --revprop and set svn:log to the new log message:
$ svn propset --revprop -r 25 svn:log "Journaled about trip to New York." property 'svn:log' set on repository revision '25'
Or, if you don't have a working copy, you can provide a URL.
$ svn propset --revprop -r 26 svn:log "Document nap." http://svn.red-bean.com/repos property 'svn:log' set on repository revision '25'
Lastly, you can tell propset to take its input from a file. You could even use this to set the contents of a property to something binary:
$ svn propset owner-pic -F sally.jpg moo.c property 'owner-pic' set on 'moo.c'
Note
By default, you cannot modify revision properties in a Subversion repository. Your repository administrator must explicitly enable revision property modifications by creating a hook named pre- revprop-change. See the section called “Hook Scripts” for more information on hook scripts.
210