Editing Subclipse.unkrig.de

= Introduction =

This ECLIPSE plug-in adds an additional ANT task 'de.unkrig.subclipse.svn' which is available in ANT builds which have the option 'Run in the same JRE as the workspace' set.

The ANT task uses the SVN client that is provided by the SUBCLIPSE plug-in. Thus no configuration is required, because it is re-used from SUBCLIPSE.

= Download and Installation =

Within ECLIPSE, download and install the feature from the update site

 http://subclipse.unkrig.de/update

= Task Descriptions =

== Task <de.unkrig.subclipse.svn> ==

Executes a series of SVN commands

=== Attributes ===

(None.)

=== Subelements ===

==== <addDirectory> ====
(Not yet implemented.)

==== <addFile> ====
(Not yet implemented.)

==== <addKeywords> ====
(Not yet implemented.)

==== <annotate> ====
(Not yet implemented.)

==== <checkout> ====
(Not yet implemented.)

==== <commit> ====
(Not yet implemented.)

==== <copy> ====
Representation of an [http://svnbook.red-bean.com/en/1.7/svn.ref.svn.c.copy.html svn copy] subcommand.

===== Attributes =====
;srcUrl, srcPath:   File to copy (resource collection subelements are an alternative to specify multiple source files; see below)
;destUrl, destPath: Where to copy the file(s) (must be an existing directory iff multiple source files are specified)
;message
;revision
;pegRevision
;copyAsChild
;makeParents

===== Subelements =====
;Resource collection (<fileset>, <dirset>, ...): An alternative to the 'srcPath' and 'srcUrl' attributes to specify ''multiple'' source files.

==== <createPatch> ====
(Not yet implemented.)

==== <createRepository> ====
(Not yet implemented.)

==== <diff> ====
(Not yet implemented.)

==== <diffSummarize> ====
(Not yet implemented.)

==== <export> ====
Representation of an [http://svnbook.red-bean.com/en/1.7/svn.ref.svn.c.export.html svn export] subcommand.

===== Attributes =====
;srcUrl, srcPath: File or directory to export
;destPath:        Where to copy the file or directory
;revision
;force:           Whether to overwrite existing files

==== <import> ====
Representation of an [http://svnbook.red-bean.com/en/1.7/svn.ref.svn.c.import.html svn import] subcommand.

===== Attributes =====
;path:     File or directory to import
;url:      Destination repository location
;message
;recurse

==== <getProperties> ====
(Not yet implemented.)

==== <getRevProperties> ====
(Not yet implemented.)

==== <lock> ====
(Not yet implemented.)

==== <merge> ====
(Not yet implemented.)

==== <mkdir> ====
Representation of an [http://svnbook.red-bean.com/en/1.7/svn.ref.svn.c.mkdir.html svn mkdir] subcommand.
===== Attributes =====
;url
;message

==== <move> ====
(Not yet implemented.)

==== <relocate> ====
(Not yet implemented.)

==== <remove> ====
(Not yet implemented.)

==== <revert> ====
(Not yet implemented.)

==== <unlock> ====
(Not yet implemented.)

==== <update> ====
(Not yet implemented.)

= Example =

Tagging projects in SVN:

 &lt;!-- Verify that ANT is running in the same JVM as ECLIPSE. -->
 <fail
     unless="eclipse.running"
     message="Please activate the ECLIPSE external tool configuration option 'Run in the same JRE as the workspace' and re-run."
 />
 
 &lt;!-- Verify that the 'de.unkrig.subclipse' plugin is available. -->
 <fail message="Please install the 'de.unkrig.subclipse' ECLIPSE feature and re-run.">
     <condition><not><typefound name="de.unkrig.subclipse.svn" /></not></condition>
 </fail>
 
 <property name="d" value="http://svn.acme.com/svn/MyRepo/tags/${tag}"/>
 <de.unkrig.subclipse.svn>
     <mkdir                          url="${d}"/>
     <copy srcpath="."           desturl="${d}"/>
     <copy srcpath="../project2" desturl="${d}"/>
 </de.unkrig.subclipse.svn>

If you like loading ANT tasks in separate XML namespaces, you can alternatively write:

 <''some-enclosing-tag-e-g-project-or-target'' <font color="red">xmlns:unkrig="antlib:de.unkrig.subclipse"</font>>
     ...
     <!-- Verify that ANT is running in the same JVM as ECLIPSE. -->
     <fail
         unless="eclipse.running"
         message="Please activate the ECLIPSE external tool configuration option 'Run in the same JRE as the workspace' and re-run."
     />
 
     <!-- Verify that the 'de.unkrig.subclipse' plugin is available. -->
     <fail message="Please install the 'de.unkrig.subclipse' ECLIPSE feature and re-run.">
         <condition><not><typefound <font color="red">uri="antlib:de.unkrig.subclipse" name="svn"</font> /></not></condition>
     </fail>
 
     <<font color="red">unkrig:svn</font>>...

, where "<code>unkrig</code>" is the (arbitrary) XML namespace prefix.

= License =

SUBCLIPSE.UNKRIG.DE is published under the "[[New BSD License]]".

= Source Code =

Source code is available via SVN on

:https://svn.code.sf.net/p/loggifier/code

. From that repository, check out the projects
*de.unkrig.checkstyle-configuration
*de.unkrig.commons.nullanalysis
*de.unkrig.subclipse_dist
*de.unkrig.subclipse.ant.tasks
*de.unkrig.subclipse.branding
*de.unkrig.subclipse.core
*org.apache.ant-1.8.4
, or, if you are using ECLIPSE, just import https://svn.code.sf.net/p/loggifier/code/trunk/de.unkrig.subclipse_dist/projectSet.psf.

= Contact =

For bugs, improvements, complaints, or any other kind of feedback, send email to [mailto:arno@subclipse.unkrig.de arno@subclipse.unkrig.de].