diff -r 81326a94fdca -r 37f0444c3479 Documentation/Source/eric5.VCS.VersionControl.html --- a/Documentation/Source/eric5.VCS.VersionControl.html Thu Jan 14 17:27:31 2010 +0000 +++ b/Documentation/Source/eric5.VCS.VersionControl.html Thu Jan 14 18:35:52 2010 +0000 @@ -22,8 +22,8 @@ <body><a NAME="top" ID="top"></a> <h1>eric5.VCS.VersionControl</h1> <p> -Module implementing an abstract base class to be subclassed by all specific -VCS interfaces. +Module implementing an abstract base class to be subclassed by all specific +VCS interfaces. </p> <h3>Global Attributes</h3> <table> @@ -33,7 +33,7 @@ <table> <tr> <td><a href="#VersionControl">VersionControl</a></td> -<td>Class implementing an abstract base class to be subclassed by all specific VCS interfaces.</td> +<td>Class implementing an abstract base class to be subclassed by all specific VCS interfaces.</td> </tr> </table> <h3>Functions</h3> @@ -44,20 +44,20 @@ <a NAME="VersionControl" ID="VersionControl"></a> <h2>VersionControl</h2> <p> - Class implementing an abstract base class to be subclassed by all specific - VCS interfaces. + Class implementing an abstract base class to be subclassed by all specific + VCS interfaces. </p><p> - It defines the vcs interface to be implemented by subclasses - and the common methods. + It defines the vcs interface to be implemented by subclasses + and the common methods. </p><h4>Signals</h4> <dl> <dt>vcsStatusMonitorData(QStringList)</dt> <dd> -emitted to update the VCS status +emitted to update the VCS status </dd><dt>vcsStatusMonitorStatus(QString, QString)</dt> <dd> -emitted to signal the status of the - monitoring thread (ok, nok, op, off) and a status message +emitted to signal the status of the + monitoring thread (ok, nok, op, off) and a status message </dd> </dl> <h3>Derived from</h3> @@ -70,1068 +70,1068 @@ <table> <tr> <td><a href="#VersionControl.__init__">VersionControl</a></td> -<td>Constructor</td> +<td>Constructor</td> </tr><tr> <td><a href="#VersionControl.__statusMonitorData">__statusMonitorData</a></td> -<td>Private method to receive the status monitor status.</td> +<td>Private method to receive the status monitor status.</td> </tr><tr> <td><a href="#VersionControl.__statusMonitorStatus">__statusMonitorStatus</a></td> -<td>Private method to receive the status monitor status.</td> +<td>Private method to receive the status monitor status.</td> </tr><tr> <td><a href="#VersionControl._createStatusMonitorThread">_createStatusMonitorThread</a></td> -<td>Protected method to create an instance of the VCS status monitor thread.</td> +<td>Protected method to create an instance of the VCS status monitor thread.</td> </tr><tr> <td><a href="#VersionControl.addArguments">addArguments</a></td> -<td>Protected method to add an argument list to the already present arguments.</td> +<td>Protected method to add an argument list to the already present arguments.</td> </tr><tr> <td><a href="#VersionControl.checkVCSStatus">checkVCSStatus</a></td> -<td>Public method to wake up the VCS status monitor thread.</td> +<td>Public method to wake up the VCS status monitor thread.</td> </tr><tr> <td><a href="#VersionControl.clearStatusCache">clearStatusCache</a></td> -<td>Public method to clear the status cache.</td> +<td>Public method to clear the status cache.</td> </tr><tr> <td><a href="#VersionControl.clearStatusMonitorCachedState">clearStatusMonitorCachedState</a></td> -<td>Public method to clear the cached VCS state of a file/directory.</td> +<td>Public method to clear the cached VCS state of a file/directory.</td> </tr><tr> <td><a href="#VersionControl.getStatusMonitorAutoUpdate">getStatusMonitorAutoUpdate</a></td> -<td>Public method to retrieve the status of the auto update function.</td> +<td>Public method to retrieve the status of the auto update function.</td> </tr><tr> <td><a href="#VersionControl.getStatusMonitorInterval">getStatusMonitorInterval</a></td> -<td>Public method to get the monitor interval.</td> +<td>Public method to get the monitor interval.</td> </tr><tr> <td><a href="#VersionControl.setStatusMonitorAutoUpdate">setStatusMonitorAutoUpdate</a></td> -<td>Public method to enable the auto update function.</td> +<td>Public method to enable the auto update function.</td> </tr><tr> <td><a href="#VersionControl.setStatusMonitorInterval">setStatusMonitorInterval</a></td> -<td>Public method to change the monitor interval.</td> +<td>Public method to change the monitor interval.</td> </tr><tr> <td><a href="#VersionControl.splitPath">splitPath</a></td> -<td>Public method splitting name into a directory part and a file part.</td> +<td>Public method splitting name into a directory part and a file part.</td> </tr><tr> <td><a href="#VersionControl.splitPathList">splitPathList</a></td> -<td>Public method splitting the list of names into a common directory part and a file list.</td> +<td>Public method splitting the list of names into a common directory part and a file list.</td> </tr><tr> <td><a href="#VersionControl.startStatusMonitor">startStatusMonitor</a></td> -<td>Public method to start the VCS status monitor thread.</td> +<td>Public method to start the VCS status monitor thread.</td> </tr><tr> <td><a href="#VersionControl.startSynchronizedProcess">startSynchronizedProcess</a></td> -<td>Public method to start a synchroneous process</td> +<td>Public method to start a synchroneous process</td> </tr><tr> <td><a href="#VersionControl.stopStatusMonitor">stopStatusMonitor</a></td> -<td>Public method to stop the VCS status monitor thread.</td> +<td>Public method to stop the VCS status monitor thread.</td> </tr><tr> <td><a href="#VersionControl.vcsAdd">vcsAdd</a></td> -<td>Public method used to add a file/directory in the vcs.</td> +<td>Public method used to add a file/directory in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsAddBinary">vcsAddBinary</a></td> -<td>Public method used to add a file/directory in binary mode in the vcs.</td> +<td>Public method used to add a file/directory in binary mode in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsAddTree">vcsAddTree</a></td> -<td>Public method to add a directory tree rooted at path in the vcs.</td> +<td>Public method to add a directory tree rooted at path in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsAllRegisteredStates">vcsAllRegisteredStates</a></td> -<td>Public method used to get the registered states of a number of files in the vcs.</td> +<td>Public method used to get the registered states of a number of files in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsCheckout">vcsCheckout</a></td> -<td>Public method used to check the project out of the vcs.</td> +<td>Public method used to check the project out of the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsCleanup">vcsCleanup</a></td> -<td>Public method used to cleanup the local copy.</td> +<td>Public method used to cleanup the local copy.</td> </tr><tr> <td><a href="#VersionControl.vcsCommandLine">vcsCommandLine</a></td> -<td>Public method used to execute arbitrary vcs commands.</td> +<td>Public method used to execute arbitrary vcs commands.</td> </tr><tr> <td><a href="#VersionControl.vcsCommit">vcsCommit</a></td> -<td>Public method used to make the change of a file/directory permanent in the vcs.</td> +<td>Public method used to make the change of a file/directory permanent in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsConvertProject">vcsConvertProject</a></td> -<td>Public method to convert an uncontrolled project to a version controlled project.</td> +<td>Public method to convert an uncontrolled project to a version controlled project.</td> </tr><tr> <td><a href="#VersionControl.vcsDefaultOptions">vcsDefaultOptions</a></td> -<td>Public method used to retrieve the default options for the vcs.</td> +<td>Public method used to retrieve the default options for the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsDiff">vcsDiff</a></td> -<td>Public method used to view the diff of a file/directory in the vcs.</td> +<td>Public method used to view the diff of a file/directory in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsExists">vcsExists</a></td> -<td>Public method used to test for the presence of the vcs.</td> +<td>Public method used to test for the presence of the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsExport">vcsExport</a></td> -<td>Public method used to export a directory from the vcs.</td> +<td>Public method used to export a directory from the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsGetOptions">vcsGetOptions</a></td> -<td>Public method used to retrieve the options of the vcs.</td> +<td>Public method used to retrieve the options of the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsGetOtherData">vcsGetOtherData</a></td> -<td>Public method used to retrieve vcs specific data.</td> +<td>Public method used to retrieve vcs specific data.</td> </tr><tr> <td><a href="#VersionControl.vcsGetProjectBrowserHelper">vcsGetProjectBrowserHelper</a></td> -<td>Public method to instanciate a helper object for the different project browsers.</td> +<td>Public method to instanciate a helper object for the different project browsers.</td> </tr><tr> <td><a href="#VersionControl.vcsGetProjectHelper">vcsGetProjectHelper</a></td> -<td>Public method to instanciate a helper object for the project.</td> +<td>Public method to instanciate a helper object for the project.</td> </tr><tr> <td><a href="#VersionControl.vcsHistory">vcsHistory</a></td> -<td>Public method used to view the history of a file/directory in the vcs.</td> +<td>Public method used to view the history of a file/directory in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsImport">vcsImport</a></td> -<td>Public method used to import the project into the vcs.</td> +<td>Public method used to import the project into the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsInit">vcsInit</a></td> -<td>Public method used to initialize the vcs.</td> +<td>Public method used to initialize the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsLog">vcsLog</a></td> -<td>Public method used to view the log of a file/directory in the vcs.</td> +<td>Public method used to view the log of a file/directory in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsMerge">vcsMerge</a></td> -<td>Public method used to merge a tag/branch into the local project.</td> +<td>Public method used to merge a tag/branch into the local project.</td> </tr><tr> <td><a href="#VersionControl.vcsMove">vcsMove</a></td> -<td>Public method used to move a file/directory.</td> +<td>Public method used to move a file/directory.</td> </tr><tr> <td><a href="#VersionControl.vcsName">vcsName</a></td> -<td>Public method returning the name of the vcs.</td> +<td>Public method returning the name of the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsNewProjectOptionsDialog">vcsNewProjectOptionsDialog</a></td> -<td>Public method to get a dialog to enter repository info for getting a new project.</td> +<td>Public method to get a dialog to enter repository info for getting a new project.</td> </tr><tr> <td><a href="#VersionControl.vcsOptionsDialog">vcsOptionsDialog</a></td> -<td>Public method to get a dialog to enter repository info.</td> +<td>Public method to get a dialog to enter repository info.</td> </tr><tr> <td><a href="#VersionControl.vcsRegisteredState">vcsRegisteredState</a></td> -<td>Public method used to get the registered state of a file in the vcs.</td> +<td>Public method used to get the registered state of a file in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsRemove">vcsRemove</a></td> -<td>Public method used to add a file/directory in the vcs.</td> +<td>Public method used to add a file/directory in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsRepositoryInfos">vcsRepositoryInfos</a></td> -<td>Public method to retrieve information about the repository.</td> +<td>Public method to retrieve information about the repository.</td> </tr><tr> <td><a href="#VersionControl.vcsRevert">vcsRevert</a></td> -<td>Public method used to revert changes made to a file/directory.</td> +<td>Public method used to revert changes made to a file/directory.</td> </tr><tr> <td><a href="#VersionControl.vcsSetData">vcsSetData</a></td> -<td>Public method used to set an entry in the otherData dictionary.</td> +<td>Public method used to set an entry in the otherData dictionary.</td> </tr><tr> <td><a href="#VersionControl.vcsSetDataFromDict">vcsSetDataFromDict</a></td> -<td>Public method used to set entries in the otherData dictionary.</td> +<td>Public method used to set entries in the otherData dictionary.</td> </tr><tr> <td><a href="#VersionControl.vcsSetOptions">vcsSetOptions</a></td> -<td>Public method used to set the options for the vcs.</td> +<td>Public method used to set the options for the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsSetOtherData">vcsSetOtherData</a></td> -<td>Public method used to set vcs specific data.</td> +<td>Public method used to set vcs specific data.</td> </tr><tr> <td><a href="#VersionControl.vcsShutdown">vcsShutdown</a></td> -<td>Public method used to shutdown the vcs interface.</td> +<td>Public method used to shutdown the vcs interface.</td> </tr><tr> <td><a href="#VersionControl.vcsStatus">vcsStatus</a></td> -<td>Public method used to view the status of a file/directory in the vcs.</td> +<td>Public method used to view the status of a file/directory in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsSwitch">vcsSwitch</a></td> -<td>Public method used to switch a directory to a different tag/branch.</td> +<td>Public method used to switch a directory to a different tag/branch.</td> </tr><tr> <td><a href="#VersionControl.vcsTag">vcsTag</a></td> -<td>Public method used to set the tag of a file/directory in the vcs.</td> +<td>Public method used to set the tag of a file/directory in the vcs.</td> </tr><tr> <td><a href="#VersionControl.vcsUpdate">vcsUpdate</a></td> -<td>Public method used to update a file/directory in the vcs.</td> +<td>Public method used to update a file/directory in the vcs.</td> </tr> </table> <a NAME="VersionControl.__init__" ID="VersionControl.__init__"></a> <h4>VersionControl (Constructor)</h4> <b>VersionControl</b>(<i>parent=None, name=None</i>) <p> - Constructor + Constructor </p><dl> <dt><i>parent</i></dt> <dd> -parent widget (QWidget) +parent widget (QWidget) </dd><dt><i>name</i></dt> <dd> -name of this object (string) +name of this object (string) </dd> </dl><a NAME="VersionControl.__statusMonitorData" ID="VersionControl.__statusMonitorData"></a> <h4>VersionControl.__statusMonitorData</h4> <b>__statusMonitorData</b>(<i>statusList</i>) <p> - Private method to receive the status monitor status. + Private method to receive the status monitor status. </p><p> - It simply reemits the received status list. + It simply reemits the received status list. </p><dl> <dt><i>statusList</i></dt> <dd> -list of status records (list of strings) +list of status records (list of strings) </dd> </dl><a NAME="VersionControl.__statusMonitorStatus" ID="VersionControl.__statusMonitorStatus"></a> <h4>VersionControl.__statusMonitorStatus</h4> <b>__statusMonitorStatus</b>(<i>status, statusMsg</i>) <p> - Private method to receive the status monitor status. + Private method to receive the status monitor status. </p><p> - It simply reemits the received status. + It simply reemits the received status. </p><dl> <dt><i>status</i></dt> <dd> -status of the monitoring thread (QString, ok, nok or off) +status of the monitoring thread (QString, ok, nok or off) </dd><dt><i>statusMsg</i></dt> <dd> -explanotory text for the signaled status (string) +explanotory text for the signaled status (string) </dd> </dl><a NAME="VersionControl._createStatusMonitorThread" ID="VersionControl._createStatusMonitorThread"></a> <h4>VersionControl._createStatusMonitorThread</h4> <b>_createStatusMonitorThread</b>(<i>interval, project</i>) <p> - Protected method to create an instance of the VCS status monitor thread. + Protected method to create an instance of the VCS status monitor thread. </p><p> - Note: This method should be overwritten in subclasses in order to support - VCS status monitoring. + Note: This method should be overwritten in subclasses in order to support + VCS status monitoring. </p><dl> <dt><i>interval</i></dt> <dd> -check interval for the monitor thread in seconds (integer) +check interval for the monitor thread in seconds (integer) </dd><dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd> </dl><dl> <dt>Returns:</dt> <dd> -reference to the monitor thread (QThread) +reference to the monitor thread (QThread) </dd> </dl><a NAME="VersionControl.addArguments" ID="VersionControl.addArguments"></a> <h4>VersionControl.addArguments</h4> <b>addArguments</b>(<i>args, argslist</i>) <p> - Protected method to add an argument list to the already present arguments. + Protected method to add an argument list to the already present arguments. </p><dl> <dt><i>args</i></dt> <dd> -current arguments list (list of strings) +current arguments list (list of strings) </dd><dt><i>argslist</i></dt> <dd> -list of arguments (list of strings) +list of arguments (list of strings) </dd> </dl><a NAME="VersionControl.checkVCSStatus" ID="VersionControl.checkVCSStatus"></a> <h4>VersionControl.checkVCSStatus</h4> <b>checkVCSStatus</b>(<i></i>) <p> - Public method to wake up the VCS status monitor thread. + Public method to wake up the VCS status monitor thread. </p><a NAME="VersionControl.clearStatusCache" ID="VersionControl.clearStatusCache"></a> <h4>VersionControl.clearStatusCache</h4> <b>clearStatusCache</b>(<i></i>) <p> - Public method to clear the status cache. + Public method to clear the status cache. </p><a NAME="VersionControl.clearStatusMonitorCachedState" ID="VersionControl.clearStatusMonitorCachedState"></a> <h4>VersionControl.clearStatusMonitorCachedState</h4> <b>clearStatusMonitorCachedState</b>(<i>name</i>) <p> - Public method to clear the cached VCS state of a file/directory. + Public method to clear the cached VCS state of a file/directory. </p><dl> <dt><i>name</i></dt> <dd> -name of the entry to be cleared (string) +name of the entry to be cleared (string) </dd> </dl><a NAME="VersionControl.getStatusMonitorAutoUpdate" ID="VersionControl.getStatusMonitorAutoUpdate"></a> <h4>VersionControl.getStatusMonitorAutoUpdate</h4> <b>getStatusMonitorAutoUpdate</b>(<i></i>) <p> - Public method to retrieve the status of the auto update function. + Public method to retrieve the status of the auto update function. </p><dl> <dt>Returns:</dt> <dd> -status of the auto update function (boolean) +status of the auto update function (boolean) </dd> </dl><a NAME="VersionControl.getStatusMonitorInterval" ID="VersionControl.getStatusMonitorInterval"></a> <h4>VersionControl.getStatusMonitorInterval</h4> <b>getStatusMonitorInterval</b>(<i></i>) <p> - Public method to get the monitor interval. + Public method to get the monitor interval. </p><dl> <dt>Returns:</dt> <dd> -interval in seconds (integer) +interval in seconds (integer) </dd> </dl><a NAME="VersionControl.setStatusMonitorAutoUpdate" ID="VersionControl.setStatusMonitorAutoUpdate"></a> <h4>VersionControl.setStatusMonitorAutoUpdate</h4> <b>setStatusMonitorAutoUpdate</b>(<i>auto</i>) <p> - Public method to enable the auto update function. + Public method to enable the auto update function. </p><dl> <dt><i>auto</i></dt> <dd> -status of the auto update function (boolean) +status of the auto update function (boolean) </dd> </dl><a NAME="VersionControl.setStatusMonitorInterval" ID="VersionControl.setStatusMonitorInterval"></a> <h4>VersionControl.setStatusMonitorInterval</h4> <b>setStatusMonitorInterval</b>(<i>interval, project</i>) <p> - Public method to change the monitor interval. + Public method to change the monitor interval. </p><dl> <dt><i>interval</i></dt> <dd> -new interval in seconds (integer) +new interval in seconds (integer) </dd><dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd> </dl><a NAME="VersionControl.splitPath" ID="VersionControl.splitPath"></a> <h4>VersionControl.splitPath</h4> <b>splitPath</b>(<i>name</i>) <p> - Public method splitting name into a directory part and a file part. + Public method splitting name into a directory part and a file part. </p><dl> <dt><i>name</i></dt> <dd> -path name (string) +path name (string) </dd> </dl><dl> <dt>Returns:</dt> <dd> -a tuple of 2 strings (dirname, filename). +a tuple of 2 strings (dirname, filename). </dd> </dl><a NAME="VersionControl.splitPathList" ID="VersionControl.splitPathList"></a> <h4>VersionControl.splitPathList</h4> <b>splitPathList</b>(<i>names</i>) <p> - Public method splitting the list of names into a common directory part and - a file list. + Public method splitting the list of names into a common directory part and + a file list. </p><dl> <dt><i>names</i></dt> <dd> -list of paths (list of strings) +list of paths (list of strings) </dd> </dl><dl> <dt>Returns:</dt> <dd> -a tuple of string and list of strings (dirname, filenamelist) +a tuple of string and list of strings (dirname, filenamelist) </dd> </dl><a NAME="VersionControl.startStatusMonitor" ID="VersionControl.startStatusMonitor"></a> <h4>VersionControl.startStatusMonitor</h4> <b>startStatusMonitor</b>(<i>project</i>) <p> - Public method to start the VCS status monitor thread. + Public method to start the VCS status monitor thread. </p><dl> <dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd> </dl><dl> <dt>Returns:</dt> <dd> -reference to the monitor thread (QThread) +reference to the monitor thread (QThread) </dd> </dl><a NAME="VersionControl.startSynchronizedProcess" ID="VersionControl.startSynchronizedProcess"></a> <h4>VersionControl.startSynchronizedProcess</h4> <b>startSynchronizedProcess</b>(<i>proc, program, arguments, workingDir = None</i>) <p> - Public method to start a synchroneous process + Public method to start a synchroneous process </p><p> - This method starts a process and waits - for its end while still serving the Qt event loop. + This method starts a process and waits + for its end while still serving the Qt event loop. </p><dl> <dt><i>proc</i></dt> <dd> -process to start (QProcess) +process to start (QProcess) </dd><dt><i>program</i></dt> <dd> -path of the executable to start (string) +path of the executable to start (string) </dd><dt><i>arguments</i></dt> <dd> -list of arguments for the process (list of strings) +list of arguments for the process (list of strings) </dd><dt><i>workingDir</i></dt> <dd> -working directory for the process (string) +working directory for the process (string) </dd> </dl><dl> <dt>Returns:</dt> <dd> -flag indicating normal exit (boolean) +flag indicating normal exit (boolean) </dd> </dl><a NAME="VersionControl.stopStatusMonitor" ID="VersionControl.stopStatusMonitor"></a> <h4>VersionControl.stopStatusMonitor</h4> <b>stopStatusMonitor</b>(<i></i>) <p> - Public method to stop the VCS status monitor thread. + Public method to stop the VCS status monitor thread. </p><a NAME="VersionControl.vcsAdd" ID="VersionControl.vcsAdd"></a> <h4>VersionControl.vcsAdd</h4> <b>vcsAdd</b>(<i>name, isDir = False, noDialog = False</i>) <p> - Public method used to add a file/directory in the vcs. + Public method used to add a file/directory in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be added (string) +file/directory name to be added (string) </dd><dt><i>isDir</i></dt> <dd> -flag indicating name is a directory (boolean) +flag indicating name is a directory (boolean) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations (boolean) +flag indicating quiet operations (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsAddBinary" ID="VersionControl.vcsAddBinary"></a> <h4>VersionControl.vcsAddBinary</h4> <b>vcsAddBinary</b>(<i>name, isDir = False</i>) <p> - Public method used to add a file/directory in binary mode in the vcs. + Public method used to add a file/directory in binary mode in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be added (string) +file/directory name to be added (string) </dd><dt><i>isDir</i></dt> <dd> -flag indicating name is a directory (boolean) +flag indicating name is a directory (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsAddTree" ID="VersionControl.vcsAddTree"></a> <h4>VersionControl.vcsAddTree</h4> <b>vcsAddTree</b>(<i>path</i>) <p> - Public method to add a directory tree rooted at path in the vcs. + Public method to add a directory tree rooted at path in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>path</i></dt> <dd> -root directory of the tree to be added (string) +root directory of the tree to be added (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsAllRegisteredStates" ID="VersionControl.vcsAllRegisteredStates"></a> <h4>VersionControl.vcsAllRegisteredStates</h4> <b>vcsAllRegisteredStates</b>(<i>names, dname</i>) <p> - Public method used to get the registered states of a number of files in the vcs. + Public method used to get the registered states of a number of files in the vcs. </p><dl> <dt><i>names</i></dt> <dd> -dictionary with all filenames to be checked as keys +dictionary with all filenames to be checked as keys </dd><dt><i>dname</i></dt> <dd> -directory to check in (string) +directory to check in (string) </dd> </dl><dl> <dt>Returns:</dt> <dd> -the received dictionary completed with a combination of - canBeCommited and canBeAdded or None in order to signal an error +the received dictionary completed with a combination of + canBeCommited and canBeAdded or None in order to signal an error </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsCheckout" ID="VersionControl.vcsCheckout"></a> <h4>VersionControl.vcsCheckout</h4> <b>vcsCheckout</b>(<i>vcsDataDict, projectDir, noDialog = False</i>) <p> - Public method used to check the project out of the vcs. + Public method used to check the project out of the vcs. </p><dl> <dt><i>vcsDataDict</i></dt> <dd> -dictionary of data required for the checkout +dictionary of data required for the checkout </dd><dt><i>projectDir</i></dt> <dd> -project directory to create (string) +project directory to create (string) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations +flag indicating quiet operations </dd> </dl><dl> <dt>Returns:</dt> <dd> -flag indicating an execution without errors (boolean) +flag indicating an execution without errors (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsCleanup" ID="VersionControl.vcsCleanup"></a> <h4>VersionControl.vcsCleanup</h4> <b>vcsCleanup</b>(<i>name</i>) <p> - Public method used to cleanup the local copy. + Public method used to cleanup the local copy. </p><dl> <dt><i>name</i></dt> <dd> -directory name to be cleaned up (string) +directory name to be cleaned up (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsCommandLine" ID="VersionControl.vcsCommandLine"></a> <h4>VersionControl.vcsCommandLine</h4> <b>vcsCommandLine</b>(<i>name</i>) <p> - Public method used to execute arbitrary vcs commands. + Public method used to execute arbitrary vcs commands. </p><dl> <dt><i>name</i></dt> <dd> -directory name of the working directory (string) +directory name of the working directory (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsCommit" ID="VersionControl.vcsCommit"></a> <h4>VersionControl.vcsCommit</h4> <b>vcsCommit</b>(<i>name, message, noDialog = False</i>) <p> - Public method used to make the change of a file/directory permanent in the vcs. + Public method used to make the change of a file/directory permanent in the vcs. </p><p> - It must return a boolean to indicate an execution without errors. + It must return a boolean to indicate an execution without errors. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be committed (string) +file/directory name to be committed (string) </dd><dt><i>message</i></dt> <dd> -message for this operation (string) +message for this operation (string) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations +flag indicating quiet operations </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsConvertProject" ID="VersionControl.vcsConvertProject"></a> <h4>VersionControl.vcsConvertProject</h4> <b>vcsConvertProject</b>(<i>vcsDataDict, project</i>) <p> - Public method to convert an uncontrolled project to a version controlled project. + Public method to convert an uncontrolled project to a version controlled project. </p><dl> <dt><i>vcsDataDict</i></dt> <dd> -dictionary of data required for the conversion +dictionary of data required for the conversion </dd><dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsDefaultOptions" ID="VersionControl.vcsDefaultOptions"></a> <h4>VersionControl.vcsDefaultOptions</h4> <b>vcsDefaultOptions</b>(<i></i>) <p> - Public method used to retrieve the default options for the vcs. + Public method used to retrieve the default options for the vcs. </p><dl> <dt>Returns:</dt> <dd> -a dictionary with the vcs operations as key and - the respective options as values. The key 'global' must contain - the global options. The other keys must be 'commit', 'update', - 'add', 'remove', 'diff', 'log', 'history', 'tag', 'status' and 'export'. +a dictionary with the vcs operations as key and + the respective options as values. The key 'global' must contain + the global options. The other keys must be 'commit', 'update', + 'add', 'remove', 'diff', 'log', 'history', 'tag', 'status' and 'export'. </dd> </dl><a NAME="VersionControl.vcsDiff" ID="VersionControl.vcsDiff"></a> <h4>VersionControl.vcsDiff</h4> <b>vcsDiff</b>(<i>name</i>) <p> - Public method used to view the diff of a file/directory in the vcs. + Public method used to view the diff of a file/directory in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be diffed (string) +file/directory name to be diffed (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsExists" ID="VersionControl.vcsExists"></a> <h4>VersionControl.vcsExists</h4> <b>vcsExists</b>(<i></i>) <p> - Public method used to test for the presence of the vcs. + Public method used to test for the presence of the vcs. </p><p> - It must return a bool to indicate the existance and a QString giving - an error message in case of failure. + It must return a bool to indicate the existance and a QString giving + an error message in case of failure. </p><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsExport" ID="VersionControl.vcsExport"></a> <h4>VersionControl.vcsExport</h4> <b>vcsExport</b>(<i>vcsDataDict, projectDir</i>) <p> - Public method used to export a directory from the vcs. + Public method used to export a directory from the vcs. </p><p> - It must return a boolean to indicate an execution without errors. + It must return a boolean to indicate an execution without errors. </p><dl> <dt><i>vcsDataDict</i></dt> <dd> -dictionary of data required for the export +dictionary of data required for the export </dd><dt><i>projectDir</i></dt> <dd> -project directory to create (string) +project directory to create (string) </dd> </dl><dl> <dt>Returns:</dt> <dd> -flag indicating an execution without errors (boolean) +flag indicating an execution without errors (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsGetOptions" ID="VersionControl.vcsGetOptions"></a> <h4>VersionControl.vcsGetOptions</h4> <b>vcsGetOptions</b>(<i></i>) <p> - Public method used to retrieve the options of the vcs. + Public method used to retrieve the options of the vcs. </p><dl> <dt>Returns:</dt> <dd> -a dictionary of option strings that can be passed to - vcsSetOptions. +a dictionary of option strings that can be passed to + vcsSetOptions. </dd> </dl><a NAME="VersionControl.vcsGetOtherData" ID="VersionControl.vcsGetOtherData"></a> <h4>VersionControl.vcsGetOtherData</h4> <b>vcsGetOtherData</b>(<i></i>) <p> - Public method used to retrieve vcs specific data. + Public method used to retrieve vcs specific data. </p><dl> <dt>Returns:</dt> <dd> -a dictionary of vcs specific data +a dictionary of vcs specific data </dd> </dl><a NAME="VersionControl.vcsGetProjectBrowserHelper" ID="VersionControl.vcsGetProjectBrowserHelper"></a> <h4>VersionControl.vcsGetProjectBrowserHelper</h4> <b>vcsGetProjectBrowserHelper</b>(<i>browser, project, isTranslationsBrowser = False</i>) <p> - Public method to instanciate a helper object for the different project browsers. + Public method to instanciate a helper object for the different project browsers. </p><dl> <dt><i>browser</i></dt> <dd> -reference to the project browser object +reference to the project browser object </dd><dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd><dt><i>isTranslationsBrowser</i></dt> <dd> -flag indicating, the helper is requested for the - translations browser (this needs some special treatment) +flag indicating, the helper is requested for the + translations browser (this needs some special treatment) </dd> </dl><dl> <dt>Returns:</dt> <dd> -the project browser helper object +the project browser helper object </dd> </dl><a NAME="VersionControl.vcsGetProjectHelper" ID="VersionControl.vcsGetProjectHelper"></a> <h4>VersionControl.vcsGetProjectHelper</h4> <b>vcsGetProjectHelper</b>(<i>project</i>) <p> - Public method to instanciate a helper object for the project. + Public method to instanciate a helper object for the project. </p><dl> <dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd> </dl><dl> <dt>Returns:</dt> <dd> -the project helper object +the project helper object </dd> </dl><a NAME="VersionControl.vcsHistory" ID="VersionControl.vcsHistory"></a> <h4>VersionControl.vcsHistory</h4> <b>vcsHistory</b>(<i>name</i>) <p> - Public method used to view the history of a file/directory in the vcs. + Public method used to view the history of a file/directory in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to show the history for (string) +file/directory name to show the history for (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsImport" ID="VersionControl.vcsImport"></a> <h4>VersionControl.vcsImport</h4> <b>vcsImport</b>(<i>vcsDataDict, projectDir, noDialog = False</i>) <p> - Public method used to import the project into the vcs. + Public method used to import the project into the vcs. </p><dl> <dt><i>vcsDataDict</i></dt> <dd> -dictionary of data required for the import +dictionary of data required for the import </dd><dt><i>projectDir</i></dt> <dd> -project directory (string) +project directory (string) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations +flag indicating quiet operations </dd> </dl><dl> <dt>Returns:</dt> <dd> -flag indicating an execution without errors (boolean) - and a flag indicating the version controll status (boolean) +flag indicating an execution without errors (boolean) + and a flag indicating the version controll status (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsInit" ID="VersionControl.vcsInit"></a> <h4>VersionControl.vcsInit</h4> <b>vcsInit</b>(<i>vcsDir, noDialog = False</i>) <p> - Public method used to initialize the vcs. + Public method used to initialize the vcs. </p><p> - It must return a boolean to indicate an execution without errors. + It must return a boolean to indicate an execution without errors. </p><dl> <dt><i>vcsDir</i></dt> <dd> -name of the VCS directory (string) +name of the VCS directory (string) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations (boolean) +flag indicating quiet operations (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsLog" ID="VersionControl.vcsLog"></a> <h4>VersionControl.vcsLog</h4> <b>vcsLog</b>(<i>name</i>) <p> - Public method used to view the log of a file/directory in the vcs. + Public method used to view the log of a file/directory in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to show the log for (string) +file/directory name to show the log for (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsMerge" ID="VersionControl.vcsMerge"></a> <h4>VersionControl.vcsMerge</h4> <b>vcsMerge</b>(<i>name</i>) <p> - Public method used to merge a tag/branch into the local project. + Public method used to merge a tag/branch into the local project. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be merged (string) +file/directory name to be merged (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsMove" ID="VersionControl.vcsMove"></a> <h4>VersionControl.vcsMove</h4> <b>vcsMove</b>(<i>name, project, target = None, noDialog = False</i>) <p> - Public method used to move a file/directory. + Public method used to move a file/directory. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be moved (string) +file/directory name to be moved (string) </dd><dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd><dt><i>target</i></dt> <dd> -new name of the file/directory (string) +new name of the file/directory (string) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations +flag indicating quiet operations </dd> </dl><dl> <dt>Returns:</dt> <dd> -flag indicating successfull operation (boolean) +flag indicating successfull operation (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsName" ID="VersionControl.vcsName"></a> <h4>VersionControl.vcsName</h4> <b>vcsName</b>(<i></i>) <p> - Public method returning the name of the vcs. + Public method returning the name of the vcs. </p><dl> <dt>Returns:</dt> <dd> -name of the vcs (string) +name of the vcs (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsNewProjectOptionsDialog" ID="VersionControl.vcsNewProjectOptionsDialog"></a> <h4>VersionControl.vcsNewProjectOptionsDialog</h4> <b>vcsNewProjectOptionsDialog</b>(<i>parent = None</i>) <p> - Public method to get a dialog to enter repository info for getting a new project. + Public method to get a dialog to enter repository info for getting a new project. </p><dl> <dt><i>parent</i></dt> <dd> -parent widget (QWidget) +parent widget (QWidget) </dd> </dl><a NAME="VersionControl.vcsOptionsDialog" ID="VersionControl.vcsOptionsDialog"></a> <h4>VersionControl.vcsOptionsDialog</h4> <b>vcsOptionsDialog</b>(<i>project, archive, editable = False, parent = None</i>) <p> - Public method to get a dialog to enter repository info. + Public method to get a dialog to enter repository info. </p><dl> <dt><i>project</i></dt> <dd> -reference to the project object +reference to the project object </dd><dt><i>archive</i></dt> <dd> -name of the project in the repository (string) +name of the project in the repository (string) </dd><dt><i>editable</i></dt> <dd> -flag indicating that the project name is editable (boolean) +flag indicating that the project name is editable (boolean) </dd><dt><i>parent</i></dt> <dd> -parent widget (QWidget) +parent widget (QWidget) </dd> </dl><a NAME="VersionControl.vcsRegisteredState" ID="VersionControl.vcsRegisteredState"></a> <h4>VersionControl.vcsRegisteredState</h4> <b>vcsRegisteredState</b>(<i>name</i>) <p> - Public method used to get the registered state of a file in the vcs. + Public method used to get the registered state of a file in the vcs. </p><dl> <dt><i>name</i></dt> <dd> -filename to check (string) +filename to check (string) </dd> </dl><dl> <dt>Returns:</dt> <dd> -a combination of canBeCommited and canBeAdded or - 0 in order to signal an error +a combination of canBeCommited and canBeAdded or + 0 in order to signal an error </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsRemove" ID="VersionControl.vcsRemove"></a> <h4>VersionControl.vcsRemove</h4> <b>vcsRemove</b>(<i>name, project = False, noDialog = False</i>) <p> - Public method used to add a file/directory in the vcs. + Public method used to add a file/directory in the vcs. </p><p> - It must return a flag indicating successfull operation + It must return a flag indicating successfull operation </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be removed (string) +file/directory name to be removed (string) </dd><dt><i>project</i></dt> <dd> -flag indicating deletion of a project tree (boolean) +flag indicating deletion of a project tree (boolean) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations +flag indicating quiet operations </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsRepositoryInfos" ID="VersionControl.vcsRepositoryInfos"></a> <h4>VersionControl.vcsRepositoryInfos</h4> <b>vcsRepositoryInfos</b>(<i>ppath</i>) <p> - Public method to retrieve information about the repository. + Public method to retrieve information about the repository. </p><dl> <dt><i>ppath</i></dt> <dd> -local path to get the repository infos (string) +local path to get the repository infos (string) </dd> </dl><dl> <dt>Returns:</dt> <dd> -string with ready formated info for display (string) +string with ready formated info for display (string) </dd> </dl><a NAME="VersionControl.vcsRevert" ID="VersionControl.vcsRevert"></a> <h4>VersionControl.vcsRevert</h4> <b>vcsRevert</b>(<i>name</i>) <p> - Public method used to revert changes made to a file/directory. + Public method used to revert changes made to a file/directory. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be reverted (string) +file/directory name to be reverted (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsSetData" ID="VersionControl.vcsSetData"></a> <h4>VersionControl.vcsSetData</h4> <b>vcsSetData</b>(<i>key, value</i>) <p> - Public method used to set an entry in the otherData dictionary. + Public method used to set an entry in the otherData dictionary. </p><dl> <dt><i>key</i></dt> <dd> -the key of the data (string) +the key of the data (string) </dd><dt><i>value</i></dt> <dd> -the value of the data +the value of the data </dd> </dl><a NAME="VersionControl.vcsSetDataFromDict" ID="VersionControl.vcsSetDataFromDict"></a> <h4>VersionControl.vcsSetDataFromDict</h4> <b>vcsSetDataFromDict</b>(<i>dict</i>) <p> - Public method used to set entries in the otherData dictionary. + Public method used to set entries in the otherData dictionary. </p><dl> <dt><i>dict</i></dt> <dd> -dictionary to pick entries from +dictionary to pick entries from </dd> </dl><a NAME="VersionControl.vcsSetOptions" ID="VersionControl.vcsSetOptions"></a> <h4>VersionControl.vcsSetOptions</h4> <b>vcsSetOptions</b>(<i>options</i>) <p> - Public method used to set the options for the vcs. + Public method used to set the options for the vcs. </p><dl> <dt><i>options</i></dt> <dd> -a dictionary of option strings with keys as - defined by the default options +a dictionary of option strings with keys as + defined by the default options </dd> </dl><a NAME="VersionControl.vcsSetOtherData" ID="VersionControl.vcsSetOtherData"></a> <h4>VersionControl.vcsSetOtherData</h4> <b>vcsSetOtherData</b>(<i>data</i>) <p> - Public method used to set vcs specific data. + Public method used to set vcs specific data. </p><dl> <dt><i>data</i></dt> <dd> -a dictionary of vcs specific data +a dictionary of vcs specific data </dd> </dl><a NAME="VersionControl.vcsShutdown" ID="VersionControl.vcsShutdown"></a> <h4>VersionControl.vcsShutdown</h4> <b>vcsShutdown</b>(<i></i>) <p> - Public method used to shutdown the vcs interface. + Public method used to shutdown the vcs interface. </p><a NAME="VersionControl.vcsStatus" ID="VersionControl.vcsStatus"></a> <h4>VersionControl.vcsStatus</h4> <b>vcsStatus</b>(<i>name</i>) <p> - Public method used to view the status of a file/directory in the vcs. + Public method used to view the status of a file/directory in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to show the status for (string) +file/directory name to show the status for (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsSwitch" ID="VersionControl.vcsSwitch"></a> <h4>VersionControl.vcsSwitch</h4> <b>vcsSwitch</b>(<i>name</i>) <p> - Public method used to switch a directory to a different tag/branch. + Public method used to switch a directory to a different tag/branch. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -directory name to be switched (string) +directory name to be switched (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsTag" ID="VersionControl.vcsTag"></a> <h4>VersionControl.vcsTag</h4> <b>vcsTag</b>(<i>name</i>) <p> - Public method used to set the tag of a file/directory in the vcs. + Public method used to set the tag of a file/directory in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be tagged (string) +file/directory name to be tagged (string) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl><a NAME="VersionControl.vcsUpdate" ID="VersionControl.vcsUpdate"></a> <h4>VersionControl.vcsUpdate</h4> <b>vcsUpdate</b>(<i>name, noDialog = False</i>) <p> - Public method used to update a file/directory in the vcs. + Public method used to update a file/directory in the vcs. </p><p> - It must not return anything. + It must not return anything. </p><dl> <dt><i>name</i></dt> <dd> -file/directory name to be updated (string) +file/directory name to be updated (string) </dd><dt><i>noDialog</i></dt> <dd> -flag indicating quiet operations (boolean) +flag indicating quiet operations (boolean) </dd> </dl><dl> <dt>Returns:</dt> <dd> -flag indicating, that the update contained an add - or delete (boolean) +flag indicating, that the update contained an add + or delete (boolean) </dd> </dl><dl> <dt>Raises <b>RuntimeError</b>:</dt> <dd> -not implemented +not implemented </dd> </dl> <div align="right"><a href="#top">Up</a></div>