Description This task provides an interface to Sub version revision control system that is a compelling replacement for CVS in the open source community. The setup of these external tasks can be studied here. Parameters The following parameters are supported by the svn task:AttributeDescriptionRequi redusername username that will be used for all nested svn commands.Deprecated. This at tribute won't work with SVNANT 1.3.2+ . Use refid for svnSetting instead. Nopassword password that will be used for all nested svn commands.Deprecated. This at tribute won't work with SVNANT 1.3.2+ . Use refid for svnSetting instead. Nojavahl Set to "false" to use command line client interface instead of JNI JavaHL bin ding.Deprecated. This attribute won't work with SVNANT 1.3.2+ . Use refid for svnSetting instead. Default: trueNosvnkit Set to "false" to use command line client interface instead of SVNKit binding .Deprecated. This attribute won't work with SVNANT 1.3.2+ . Use refid for svn Setting instead. Default: falseNodateFormatter formatter definition used to format/parse dates (e.g. when revision is specif ied as date).Deprecated. This attribute won't work with SVNANT 1.3.2+ . Use r efid for svnSetting instead. Default: MM/DD/YYYY HH:MM AM_PMNodateTimeZone time zone used to format/parse dates (e.g. when revision is specified as date ).Deprecated. This attribute won't work with SVNANT 1.3.2+ . Use refid for sv nSetting instead. Default: localNofailonerror Controls whether an error stops the build or is merely reported to the screen.Deprecated. This attribute won't work with SVNANT 1.3.2+ . Use refid for svn Setting instead. Default: trueNologFile Write the output of the commands into the log file instead of the console. Norefid If set the configuration for this task is taken from a svnSetting object. Suc h a settings instance simply provides default values, so they will be overridden in case the corresponding attribute on this task has been set. No Svn commands specified as nested elements addcatcheckoutcleanupcommitcopycreateRepositor ydeletediffdiffSummarizeexportignoreimportinfokeywordsaddkeywordsremove keywordssetlistlog< /td>mkdirmovepropdelpropgetpropsetrevertsingleinfostatusswitchupdate wcversion add You can add files and directories to svn repository with nested e lements. AttributeDescriptionRequi redfile file to add to the repository Nodir directory to add to the repository Norecurse Set to "false" to operate on a single directory only (applies only when dir attribute is set). Default: trueNoforce Set to "true" to check the contents of a directory that is already under sour ce control for new directories/files (applies only when dir attr ibute is set). Default: falseNo Parameters specified as nested elements : fileset Filesets are used to select sets of files to add to the repository. Note that directories needed to add selected files will be added to the repos itory even if they are not selected by the fileset. dirset Dirsets are used to select sets of directories to add. cat Get the content of a file on repository. AttributeDescriptionRequi reddestFile Name of the destination file Default: The name of the file on the url placed in the ant project's bas edirNourl Url of the file in repository Yesrevision revision to get.Possible values are: a date with the format as specified in dateFormatter attributea revision numberHEAD, BASE, COMMITED or PREV Default: HEADNo checkout Check out a working copy from a repository.AttributeDescriptionRequi redrecurse Set to "false" to operate on single directory only.Don't use this in combi nation with 'depth' ! Default: trueOne of thesedepth Specifies which resources have to be checked out. Following values are legal: empty : Just checkout the top level (empty directory).files : Just checkout toplevel files.immediates : Checkout toplevel files and directories (unpopulated).infinity : Checkout everything. Don't use this in combination with 'recurse' ! ignoreexternals If set to true svn externals will be skipped.Only in combinat ion with 'depth' ! Default: falseNoforce Enforces the execution of the checkout commands.Only in combination with ' depth' ! Default: falseNourl url to checkout from YesdestPath destination directory Yesrevision revision to checkout.Possible values are: a date with the format as specified in dateFormatter attributea revision numberHEAD, BASE, COMMITED or PREV Default: HEADNo cleanup cleanup your working copy AttributeDescriptionRequi reddir directory to cleanup Yes commit Send changes from your working copy to the repository. AttributeDescriptionRequi redfile file to commitNorecurse Set to "false" to operate on single directory only. Apply only when dir attribute is set. Default: trueNodir directory to commit Nomessage commit message Yes Parameters specified as nested elements : fileset Filesets are used to select sets of files to commit.dirset Dirsets are used to select sets of directories to commit. copy Duplicate something in working copy or repository, remembering history. source and destination can each be either a working copy (WC) path or URL: WC->WC: copy and schedule for addition (with history)WC->URL: immediately commit a copy of WC to URLURL->WC: check out URL into WC, schedule for additionURL->URL: complete server-side copy; used to branch & tagAttributeDescriptionRequi redsrcPath source path One of thesesrcUrl source url destPath destination path One of thesedestUrl destination url message commit message when destUrl is setrevision revision to copy from (when srcUrl is set).Possible values are: a date with the format as specified in dateFormatter attributea revision numberHEAD, BASE, COMMITED or PREV Default: HEADNomakeParents Create parents first (only useful for copies from srcUrl to destUrl). Default: falseNo createRepository Create a new, empty repository at path. AttributeDescriptionRequi redpath Path where to create the new repository yes Example: delete If run on a working copy target, the item is scheduled for deletion upon the next commit. Files, and directories that have not been committed, are immediately removed f rom the working copy. The command will not remove targets that are, or contain, unversioned or modi fied items; use the force attribute to override this behaviour. If run on an url, the item is deleted from the repository via an immediate co mmit. AttributeDescriptionRequi redfile file to delete Nourlurl to delete Nodir directory to delete Nomessage commit message when url attribute is setforce forces the deletion Default: falseNo Parameters specified as nested elements : fileset Filesets are used to select sets of files to delete.dirset Dirsets are used to select sets of directories to delete. diff Display the differences between two paths (oldPath and newPath) or two urls ( oldUrl and newUrl). AttributeDescriptionRequi redoldPath the old path Default: .One of theseoldUrl the old url Default: .oldTargetRevision the revision used for the comparison of the old repository Default: BASE or, if oldUrl is set, to HEADNonewPath the new path Default: .One of thesenewUrl the new url Default: .newTargetRevision the revision used for the comparison of the new repository Default: The current working version or, if newUrl is set, to HEAD< td class="lastcol">No outFile the destination file for the diff result Default: patchNorecurse Set to "false" to operate on single directory only Default: trueNo Example: diff between BASE and current working version diffSummarize TO BE DONE export Exports a clean directory tree from the repository specified by srcurl , at revision revision if it is given, otherwise at HEAD, into destPath.Exports a clean directory tree from the working copy specified by srcP ath into destPath. all local changes will be preserved, but files not un der revision control will not be copied. AttributeDescriptionRequi redsrcUrl source url to export from One of thesesrcPath source path to export from destPath destination path Yesforce Allows to overwrite an already existing destination. Default: falseNorevision revision of the source url to export from.Possible values are: a date with the format as specified in dateFormatter attributea revision numberHEAD, BASE, COMMITED or PREV Default: HEADNo ignore Add a given file or a pattern to the ignored files list (modifies svn:ignore property) AttributeDescriptionRequi redfile file to ignore One of thesedir directory to ignore pattern pattern to add to svn:ignore on the directory. Only when dir is set. Yesrecurse Set to "true" to add the pattern recursively to directories (only when dir is set). Default: falseNoExamples: import Commit an unversioned file or tree into the repository. Recursively commit a copy of path to url. AttributeDescriptionRequi redpath source path to export from Yesurl source url to import to YesnewEntry If set, copy top-level contents of path into url di rectly. Otherwise, create newEntry underneath url and be gin copy there. Nomessage commit message Yesrecurse Set to "false" to operate on single directory only. Default: trueNo info Gets the information from the repository for a file, directory or url and set s the values to ant properties. AttributeDescriptionRequi redtarget Directory or file to gather the information about. YespropPrefix Prefix to use for the properties. Default: svn.info.Noverbose Default: falseNo The task sets the following properties (prefix applied accordingly): PropertyDescriptionpathAlwaysnameFor files onlyurlAlwaysrepourlAlwaysrepouuidAlwaysrevAlwaysnodekindAlwaysscheduleAlwaysauthorAlwayslastRevAlwayslastDateAlwayslastTextUpdateFor files onlylastPropUpdateFor files onlychecksumFor files only keywordsadd Keywordsadd add some keywords to be substituted on the given files. Present k eywords are not modified. The attributes are the same than for keywordsset command. keywordsremove Keywordsadd remove some keywords to be substituted on the given files. Other present keywords are not modified. The attributes are the same than for keywordsset command. keywordsset Keywordsset controls which keywords will be substituted on the given files. V alid keywords are: URL, HeadURL : The URL for the head version of the object.Author, LastChangedBy : The last person to modify the file.Date, LastChangedDate : The date/time the object was last modified.Rev, LastChangedRevision : The last revision the object changed.Id : A compressed summary of the previous. AttributeDescriptionRequi redfile File for which keywords will be substituted (specify nested filesets alternat ively). One of thesedir All files in this directory will have their keywords substituted (recursively ). Specify nested filesets alternatively. keywords The keywords to substitute on the given files. NoHeadURL Set to "true" the keyword to substitute it on the given file. One of theseURL Set to "true" the keyword to substitute it on the given file. Author Set to "true" the keyword to substitute it on the given file. LastChangedBy Set to "true" the keyword to substitute it on the Date Set to "true" the keyword to substitute it on the LastChangedDate Set to "true" the keyword to substitute it on the Rev Set to "true" the keyword to substitute it on the LastChangedRevision Set to "true" the keyword to substitute it on the Id Set to "true" the keyword to substitute it on the Parameters specified as nested elements: given file.given file.given file.given file.given file.given file.fileset Filesets are used to select the files where the keywords will be set.dirset Dirsets are used to select the directories where the keywords will be set. list lists the content of a repository AttributeDescriptionRequi reddelimiter The delimiter to be used for separation of the list. Default: ,NolistDirs If enabled directory entries will be listed. Default: trueNolistFiles If enabled file entries will be listed. Default: trueNoonlyNames If enabled only the names will be listed otherwise the complete urls. Default: falseNoproperty Property which will receive the resulting value. Yesrecurse Allows to list the complete subtree if true. Use it carefully. Default: falseNorevision The revision used to get the listing from. Default: HEADNourl The URL which content shall be listed. Yes log Display commit log messages.AttributeDescriptionRequi redpath path to create One of theseurl url to create startRevision start revision YesstopRevision stop revision YesdestFile destination file Default: The name of the file on the url placed in the ant project's bas edir.NoasXml Output log as xml. Default: trueNochangedpathes Include changed paths in the log. Default: falseNostopOnCopy Useful for determining branch points. Default: trueNolimit Restricts output to the first n log messages. Default: All in the rangeNo mkdir Create a new directory under revision control. If target is a working copy path the directory is scheduled for addition in t he working copy. If target is an url the directory is created in the repository via an i mmediate commit. In both cases all the intermediate directories must already exist. AttributeDescriptionRequi redpath path to create One of theseurl url to create message commit message YesmakeParents Create parents first. Default: falseNo move Move/rename something in working copy or repository. Source and destination can both be working copy (WC) paths or URLs: WC -> WC: move and schedule for addition (with history).URL -> URL: complete server-side rename. AttributeDescriptionRequi redsrcPath source path One of thesesrcUrl source url destPath destination path One of thesedestUrl destination url message commit message Yes propdel Remove a property from files or dirs. AttributeDescriptionRequi redpath path of the file or directory on which to delete the property Yesnamename of the property to delete Yesrecurse if set, property will be removed recursively Default: falseNo propget Get a property from a file or a directory. AttributeDescriptionRequi redpath path of the file or directory on which to get the property. One of theseurl url of the file or directory in repository on which to get the property name name of the property to get Yesproperty the name of the property to set with the value of the svn property One of thesefile file that will contain the value of the property Example: propset Set a property on files or dirs. AttributeDescriptionRequi redpath path of the file or directory on which to set the property. Yesname name of the property to set. Yesvalue the value of the property One of thesefile the file that will be used as a value recurse if set, property will be set recursively No Note: svn recognizes the following special versioned properties but will store any arbitrary properties set: svn:ignore : A newline separated list of file patterns to ignore.svn:keywords : Keywords to be expanded. Valid keywords are:URL, HeadURL : The URL for the head version of the object.Author, LastChangedBy : The last person to modify the file.Date, LastChangedDate : The date/time the object was last modified.Rev, LastChangedRevision : The last revision the object changed.Id : A compressed summary of the previous 4 keywords. svn:executable : If present, make the file executable. This property cannot be set on a directory. A non-recursive attempt will fail, and a recursive attempt will set the property only on the file children of the directory.svn:eol-style : One of 'native', 'LF', 'CR', 'CRLF'.svn:mime-type : The mimetype of the file. Used to determine whether to merg e the file, and how to serve it from Apache. A mimetype beginning with 'text/' (or an absent mimetype) is treated as text . Anything else is treated as binary.svn:externals : A newline separated list of module specifiers, each of which consists of a relative directory path, optional revision flags, and an URL. For exam ple: foo http://example.com/repos/zig foo/bar -r 1234 http://example.com/repos/zag revert Restore pristine working copy file (undo most local edits). AttributeDescriptionRequi redfile file to revert Nodir directory to revert Norecurse Set to "false" to operate on a single directory only (applies only when dir a ttribute is set or a dirset is provided). Default: falseNorevision revision.Possible values are: a date with the format as specified in dateFormatter attributea revision numberHEAD, BASE, COMMITED or PREV Default: HEADNo Parameters specified as nested elements: fileset Filesets are used to select sets of files to revert.dirset Dirsets are used to select sets of directories to revert. singleinfo Similar to the info command with the difference that this one allows to request a specific information. AttributeDescriptionRequi redtarget Directory or file to gather the information about. Yesproperty The property that will be set. It will be set to an empty string if the infor mation could not be gathered. Yesrequest Specifies the information that has to be retrieved. Following values are supp orted: pathnameurlrepourlrepouuidrevisionnodekindscheduleauthorlastRevisionlastDatelastTextUpdatelastPropUpdatechecksum Yes status Get the status of working copy files and directories. AttributeDescriptionRequi redpath path of the file or directory YestextStatusProperty Name of the property to set to the status of the item.Allowed values: non-svnnormal : no modificationsaddedmissing : item is missing (removed by non-svn command)incompletedeletedreplacedmodifiedmergedconflictedobstructedignoredexternalunversioned NopropStatusProperty Name of the property to set to the status of the item propertiesAllowed value s:normal : no modificationsconflictedmodifiedNorevisionProperty Name of the property to set to the revision of the item (or "" if unversioned ) NolastChangedRevisionProperty Name of the property to set to the last changed revision of the item (or "" i f unversioned) NolastChangedDateProperty Name of the property to set to the last changed date of the item (or "" if un versioned). The date is formatted according to task's "dateFormatter" NolastCommitAuthorProperty Name of the property to set to the last commit author (or "" if unversioned). NourlProperty Name of the property to set to the url of the item. No Example: switch Update the working copy to mirror a new URL within the repository. This behav iour is similar to 'svn update', and is the way to move a working copy to a branch or tag within the same repository. AttributeDescriptionRequi redpath The working copy to switch to the given url. Yesurl The url to switch to. Yesrecurse Set to "false" to operate on a single directory only. Default: falseNorevision revision.Possible values are: a date with the format as specified in dateFormatter attributea revision numberHEAD, BASE, COMMITED or PREV Default: HEADNo Example: update Bring changes from the repository into the working copy. If no revision given , bring working copy up-to-date with HEAD rev. Else synchronize working copy to revisi on. AttributeDescriptionRequi redfile file to update Nodir directory to update Norecurse Set to "false" to operate on a single directory only (applies only if dir has been set or a dirset has been given). Default: falseNorevision revision.Possible values are: a date with the format as specified in dateFormatter attributea revision numberHEAD, BASE, COMMITED or PREV Default: HEADNo Parameters specified as nested elements : filesetFilesets are used to select sets of files to update.dirset Dirsets are used to select sets of directories to update. wcversion Retrieves a state of the working copy. Similar to the svn's utility svnversio n, just providing more. Crawls the working copy and retrieves the maximum revisio n number, revision range if workingCopy is mixed etc. AttributeDescriptionRequi redpath a path to the working copy Yesprefix a string which will be prefixed to output properties set/filled by this comma nd NoprocessUnversioned flag whether presence of unversioned resoures should be treated as changes Default: falseNo The command fill set the following properties: (with optional prefix applied) PropertyDescriptionrepository.urlURL of the repository of the working copy rootrepository.pathpath in the repositoryrevision.maxthe highest revision number in the working copyrevision.max-with-flagsthe highest revision number in the working copy plus flags (M - modifi ed, X - mixed)revision.rangethe revision range (in mixed wc), similar to svnversion format. (e.g. 1000:1010MX)committed.maxthe highest 'last committed revision'committed.max-with-flagsthe highest 'last committed revision' plus flags (M, X)modifiedset to "true" if working copy is modified, property not set otherwise< /td> mixedset to "true" if working copy is mixed, property not set otherwise An example of the properties that would be set in a sample working copy (with modifications, with prefix="svn."): svn.repository.url -> https://server/repos/branches/1.2.x svn.repository.path -> /repos/branches/1.2.x svn.revision.max -> 676 svn.revision.max-with-flags -> 676M svn.revision.range -> 676M svn.committed.max -> 651 svn.committed.max-with-flags -> 651M svn.modified -> true Examples checkouts a working copy from repository deletes some files from repository (and commit changes) add my_repos/propTest to repository and set two properties on file.png subversion command line interface is used (javahl="false"). ... ... Declaration of basic subversion settings and their reference. This little sni ppet also shows that a setting can be overriden in the end (failonerror).