Editing Cvstools.unkrig.de

<big>'''CVS Tools - an ECLIPSE plug-in for advanced CVS operations'''</big>

== Overview ==

A nice little ECLIPSE plug-in that adds CVS functionality that is sometimes painfully missing from ECLIPSE's built-in CVS client.

== Custom CVS command user interface ==
* A "CVS Tools..." entry in the popup menus of all resources that are under CVS control.
[[Image:CVS_Tools_Menu.jpg|400x400px]]
* A "CVS Tools..." entry in the popup menu of all remote resources in the "CVS Repositories" view.
[[Image:CVS_Tools_Menu_Remote.jpg|400x400px]]
* These open the "Custom CVS Command" dialog in which you can configure and run any CVS command.
[[Image:Custom_CVS_Command_Dialog.jpg|400x400px]]

== The "eclipse.cvs" and "eclipse.rcvs" ANT tasks ==
These ANT tasks provide access to the CVS client that is part of the ECLIPSE platform. Using that is much cooler than running an external "cvs.exe" (as the normal "cvs" ANT task does).

[[Image:Ant_Task.jpg|400x400px]]

=== '''eclipse.cvs''' ===

==== '''Attributes''' ====
'''quiet'''
:No messages in the CVS console.
'''debug'''
:Unexpected exception print stack traces in the CVS console.
'''command'''
:One of add, admin, annotate, commit, diff, edit, editors, history, log, ls, release, remove, status, tag, unedit, update, version, watch-add, watch-off, watch-on, watch-remove, watchers.
'''argument'''
:Only for the "tag" command.

==== '''Subelements''' ====
<'''globaloption''' option="-n"/>
:One of -Q, -q, -r, -n, -t, -l (For descriptions see the "Custom CVS Commands" dialog or "cvs --help-options").

<'''localoption''' option="-r1.5"/><br/>
<'''localoption''' option="-m" argument="My Message"/>
:Command-dependent; for descriptions see the "Custom CVS Commands" dialog or "cvs -H ''command''".
<'''fileset'''>...<br/>
<'''dirset'''>...
:See ANT documentation.

=== '''eclipse.rcvs''' ===

==== '''Attributes''' ====
'''cvsroot'''
:Format:
::* :method:[user[:password]@]hostname[#port]:/path/to/repository (CVSNT)
::* :method:[[user][:password]@]hostname[:[port]]/path/to/repository (other)
'''quiet'''
:No messages in the CVS console.
'''debug'''
:Unexpected exception print stack traces in the CVS console.
'''command'''
:One of checkout, export, import, rannotate, rlog, rdiff, rls, rtag, version.
'''argument'''
:Only for the "rtag" command.

==== '''Subelements''' ====
<'''globaloption''' option="-n"/>
:One of -Q, -q, -r, -n, -t, -l (For descriptions see the "Custom CVS Commands" dialog or "cvs --help-options").

<'''localoption''' option="-r1.5"/><br/>
<'''localoption''' option="-m" argument="My Message"/>
:Command-dependent; for descriptions see the "Custom CVS Commands" dialog or "cvs -H ''command''".
<'''module''' name="foo"/>...
:Target CVS module.

== Download and Installation ==
Download the plug-in JAR file from

:http://cvstools.unkrig.de/download/

and copy it into your ECLIPSE's "dropins" subdirectory, then "File / Restart" your ECLIPSE.

Source code is available via SVN on

:https://cvstools.svn.sourceforge.net/svnroot/cvstools

== Project status ==
Everything is still very experimental, and not all CVS commands, options and combinations thereof have been tested. Still I feel that there may be some interest out there for these tools? Use, comment, contribute!