Log
The Log window shows the history of a versioned file or directory ('entry').
A Log is typically invoked by
from the Project Window, but there are various
other ways/windows to invoke a Log in SmartSVN.
The central component of the Log window is the Revisions table,
which shows the found revisions with their attributes.
You can filter out certain revisions by using Search Author and Commit Message.
To the right of the Revisions table, the detailed Revision Info of
the currently selected revision is displayed.
The lower part of the window shows the Directories/Files view for the selected
revision.
The displayed structure is restricted to those files and directories, which are children
of the log context root; all other files/directories which have been modified
within this revision are skipped.
The log context root depends on the context from which the log has been
invoked.
For example, the log context root for logs performed by
from the Project Window is either the corresponding
project root directory, or the Externals
root directory.
The context root can be enlarged to the corresponding Project Root
if necessary.
Note |
For repositories in Subversion 1.6 format, the received log data contains
information on whether a changed entry is of file or directory type.
Unfortunately this information is not present for older servers, hence SmartSVN
tries to detect the entry types itself.
The more log information is present, the better are the results of this detection.
However, without complete log information SmartSVN may still be wrong.
In this case, the entry is assumed to be a file (although it might actually
be a directory).
|
When merged revisions have been requested (see Log), they
are added in a tree-like manner to their parent revision which can then be expanded
or collapsed.
Because merged revisions have no direct link to the logged revisions themselves various
commands subsequently listed will not be applicable for these revisions.
The context root for merged revisions is the corresponding repository root.
Always exactly one of the four views is 'active' which is displayed by its highlighted
title.
Menu bar actions (as well as toolbar buttons) are always referring to the currently
active view.
Log menu
-
Use to extend the displayed log range.
-
Use to export the log information to a file.
Refer to File Export for details.
-
Use to fetch all properties for all displayed
revisions from the repository.
The Revisions table will be extended by corresponding table columns, one for
each property.
This command is only available for file Logs.
The upper limit of columns to be added can be configured by the system properties.
-
Use to close the frame.
-
Use to cancel the currently running operation.
-
Use to open the selected revision/file/directory, for
details refer to Edit.
This command will only be applicable for revisions of file Logs.
-
Use to copy the commit message of the selected
revision.
-
Use to copy the name of the selected file.
If multiple files are selected, all names will be copied, each on a new line.
-
Use to copy the path of the selected file relative
to the log context root.
If multiple files are selected, all paths will be copied, each on a new line.
-
Use to customize accelerators (see Customize).
View menu
-
Select to skip revisions for which
the logged entry has not actually been changed, but has only been reported due to
a copy operation of one of its parents.
E.g. when creating a Tag of the project
root, the log for every entry of that tag will contain this tag-revision.
-
Select to toggle the Directories/Files
view in the lower part of the frame.
-
Select to restrict
the Directories/Files view to only those directories and files which are actually
children of the logged directory.
-
Use to change the commit message of
the currently selected revision.
Enter the new Commit Message and wait until SmartSVN has rebuilt the corresponding
Log Cache, if necessary.
-
Use to merge the selected revision/file/directory
to your local working copy.
If you want to configure advanced options for the merge, use the default Merge command.
-
Use to roll back the selected revision/file/directory
locally, i.e. in your local working copy.
You may then review the rolled back changes and, if acceptable, commit them.
This command will only be applicable for logs which have a link to a local working
copy.
-
Use to compare the selected revision/file/directory
against its preceding revision or to compare two selected revisions/files/directories
against each other.
Depending on whether two files or directories are compared, either the File Compare
or the Properties Compare will come up.
When invoking on a revision, the Revision Compare
will come up.
-
Use to compare the selected revision/file
against the file's working copy within your project.
This command will only be applicable for revisions of file Logs.
-
Use to perform another Log for the selected file/directory.
This command will not be applicable for revisions as it would result in the same
log as already present.
-
Use to create a Revision Graph
for the selected revision/file/directory.
-
Use to Annotate the selected
revision/file.
This command will only be applicable for revisions of file Logs.
-
Use to save the contents of the selected revision/file
to a local file, for details refer to .
This command will only be applicable for revisions of file Logs.
Window menu
Refer to Window for more details.
File Export
You can export log data in various formats to a file using .
Select either to export All revisions, independent of the selection or
only the Selected revisions.
Specify the Output file to which the log information will be written.
If Include changed paths is selected, not only the main revision information
but also the details on which files/directories have been changed will be exported.
Specify the file Format which shall be used for the export.
XML will export in raw XML format, as used by svn log --xml.
HTML will give a basic HTML output.
Plain text will give a simply formatted plain text file.
Custom maybe used to export in an arbitrary format, by performing a style
sheet transformation on the raw XML data.
In this case, enter the path of the stylesheet for XSTL-File.