✓ TextMate theme support
✓ Automatic indentation support
✓ Interactive console
✓ File navigator
✓ Intelligent bracket matching
✓ Custom compile flags
✓ Symbol navigator
✓ Run with arguments & input sets
✓ Auto Save
✓ Word-completions
✓ Live run statistics
✓ Software updates
Language Overview
Below is a summary of all the languages CodeRunner supports out-of-the-box.
Run Instantly
Code Completion
No Extra Installation
Syntax Highlighting
AppleScript
Coming Soon
JavaScript
Coming Soon
Library functions
Objective-C
Objective-C++
Library functions
Shell Script
Coming Soon
Syntax Highlighting Only
ActionScript
AngularJS*
Fortran - Modern
Fortran - Punchcard
Java Server Page (JSP)
Postscript
Property List
RequireJS*
Strings File
* Also supports IDE-level code completion.Note that you can add your own syntax definitions. CodeRunner supports TextMate 1 language grammars.All languages support word-completions.
What's New in CodeRunner 2?
CodeRunner 2 is a complete overhaul of the original app, and introduces major new features and improvements across the board. You'll love CodeRunner 2's slick interface, ease of use, and powerful editing features. Major changes include:
Revamped syntax highlighting. CodeRunner 2 now uses TextMate syntax definitions, which provide better syntax highlighting and support for many more languages. You can even install your own syntaxes.
Revamped code completion. CodeRunner 2 features fully-dynamic code completion with fuzzy search, tab-selectable placeholders, and documentation snippets.
Improved multi-file run support. CodeRunner 2 does a better job running multiple-file projects.
TextMate theme support. You can now use the popular TextMate theme format in CodeRunner 2.
Revamped templates. CodeRunner 2 features vastly improved template functionality, including multiple and dynamic templates. It's now super easy to create classes, document structures, etc.
Improved extendability. With CodeRunner 2, you can now import and export languages. This makes it easy to share your custom languages with others, or download languages from the web.
HTML and Browser JavaScript support. The console in CodeRunner 2 has a new web mode enabling support for HTML and DOM JavaScript. It even supports live preview of your document while it's being edited.
Text editing improvements. CodeRunner 2 contains many new text editing features, such as the symbol navigator, better indentation support, improved behavior under source control, word-completions and more.
Run statistics. You can now keep better track of your code while it's running. CodeRunner 2 displays live CPU and memory usage, in addition to spent CPU time once your code is finished running.
Bundled compilers. CodeRunner 2 now includes the compilers necessary for running C and C++ code, so you don't need to have Xcode installed for these languages.
Yosemite support. In addition to loads of UI enhancements, CodeRunner 2's look and feel now integrates seamlessly with OS X Yosemite.
Mac App Store Customer?
If you have purchased CodeRunner on the Mac App Store, you can choose to pay if you want, or you can get a copy of CodeRunner 2 for free.
To get a free license, make sure you have the Mac App Store version on your computer before downloading CodeRunner 2.
Then simply
and follow the instructions in the licensing window. Don't replace your Mac App Store copy of CodeRunner.app until after you've migrated.
Because of new Mac App Store restrictions, CodeRunner 2 is currently only available outside of the Mac App Store.svn—Subversion Command-Line Client
This documentation was written to describe the 1.7.x series of
Apache(TM) Subversion(R).
If you are running a different
version of Subversion, you are strongly encouraged to visit
instead consult the version of this documentation appropriate for
your version of Subversion.
svn—Subversion Command-Line Client
svn is the official command-line client
of Subversion.
Its functionality is offered via a collection of
task-specific subcommands, most of which accept a number of
options for fine-grained control of the program's
When using the svn program, subcommands
and other non-option arguments must appear in a specified order
on the command line.
Options, on the other hand, may appear
anywhere on the command line (after the program name, of
course), and in general, their order is irrelevant.
example, all of the following are valid ways to use svn
status, and are interpreted in exactly the same
The following sections describe each of the various
subcommands and options provided by the svn
command-line client program, including some examples of each
subcommand's typical uses.
svn Options
While Subversion has different options for its
subcommands, all options exist in a single
namespace—that is, each option is guaranteed to mean the
roughly same thing regardless of the subcommand you use it
For example, --verbose
(-v) always means “verbose
output,” regardless of the subcommand you use it
The svn command-line client usually
exits quickly with an error if you pass it an option which
does not apply to the specified subcommand.
Subversion 1.5, several of the options which apply to
all—or nearly all—of the subcommands have been
deemed acceptable by all subcommands, even if they have no
effect on some of them.
(This change was made primarily to
improve the client's ability to called from custom wrapping
These options appear grouped together in the
command-line client's usage messages as global options, as can
be seen in the following bit of output:
svn subcommands recognize the following
global options:
--config-dir DIR
Instructs Subversion to read configuration
information from the specified directory instead of the
default location (.subversion in
the user's home directory).
--config-option CONFSPEC
Sets, for the duration of the command, the value of
a runtime configuration
CONFSPEC is a string
which specifies the configuration option namespace, name
and value that you'd like to assign, formatted as
FILE:SECTION:OPTION=[VALUE].
In this syntax, FILE
and SECTION are the runtime
configuration file (either config
or servers) and the section thereof,
respectively, which contain the option whose value you
wish to change.
OPTION is,
of course, the option itself,
and VALUE the value (if any)
you wish to assign to the option.
For example, to
temporarily disable the use of the automatic property
setting feature,
use --config-option=config:miscellany:enable-auto-props=no.
You can use this option multiple times to change
multiple option values simultaneously.
--no-auth-cache
Prevents caching of authentication information
(e.g., username and password) in the Subversion
runtime configuration directories.
--non-interactive
Disables all interactive prompting.
Some examples
of interactive prompting include requests for
authentication credentials and conflict resolution
decisions.
This is useful if you're running Subversion
inside an automated script and it's more appropriate
to have Subversion fail than to prompt for more
information.
--password PASSWD
Specifies the password to use when authenticating
against a Subversion server.
If not provided, or if
incorrect, Subversion will prompt you for this
information as needed.
--trust-server-cert
When used with --non-interactive,
instructs Subversion to accept SSL server certificates
issued by unknown certificate authorities without first
prompting the user.
For security's sake, you should use
this option only when the integrity of the remote server
and the network path between it and your client is known
to be trustworthy.
--username NAME
Specifies the username to use when authenticating
against a Subversion server.
If not provided, or if
incorrect, Subversion will prompt you for this
information as needed.
The rest of the options apply and are accepted by only a
subset of the subcommand.
They are as follows:
--accept ACTION
Specifies an action for automatic conflict
resolution, disabling the interactive prompts which ask
the user how to handle each conflict as it is noticed.
Though which of the specific actions are applicable
differs depending on which subcommand is in use,
Subversion supports the following long (and short)
values for ACTION:
Take no resolution action at all and instead
allow the conflicts to be recorded for future
resolution.
Open each conflicted file in a text editor for
manual resolution of line-based conflicts.
Launch an interactive merge conflict
resolution tool for each conflicted file.
Choose the file that was the (unmodified)
BASE revision before you tried
to integrate changes from the server into
your working copy.
Assuming that you've manually handled the
conflict resolution, choose the version of the file
as it currently stands in your working copy.
Resolve conflicted files by preserving all
local modifications and discarding all changes
fetched from the server during the operation which
caused the conflict.
theirs-full
Resolve conflicted files by discarding all
local modifications and integrating all changes
fetched from the server during the operation which
caused the conflict.
mine-conflict
Resolve conflicted files by preferring local
modifications over the changes fetched from the
server in conflicting regions of each file's
theirs-conflict
Resolve conflicted files by preferring the
changes fetched from the server over local
modifications in conflicting regions of each file's
Consult the output of svn help
SUBCOMMAND to see
exactly which actions are supported by the specific
subcommand of interest.
--allow-mixed-revisions
Disables the verification—performed by default
by svn merge as of Subversion
1.7—that the target of a merge operation and all
of its children are at a uniform revision.
merging into a single-revision working copy target is
the recommended best practice, this option may be used
to permit merges into mixed-revision working copies as
necessary.
--auto-props
Enables automatic property assignment (per runtime
configuration rules), overriding the
enable-auto-props runtime
configuration directive.
--change (-c) ARG
Perform the requested operation using a specific
“change”.
Generally speaking, this option
is syntactic sugar for -r
ARG-1:ARG.
Some subcommands permit a comma-separated list of
revision number arguments (e.g., -c
ARG1,ARG2,ARG3).
Alternatively, you can provide two arguments separated
by a dash (as
in -c ARG1-ARG2)
to identify the range of revisions
between ARG1
and ARG2, inclusive.
Finally, if the revision argument is negated, the
implied revision range is reversed: -c
-45 is equivalent to -r
--changelist (--cl) ARG
Instructs Subversion to operate only on members of the changelist named
You can use this option
multiple times to specify sets of changelists.
--depth ARG
Instructs Subversion to limit the scope of an
operation to a particular tree
ARG is one of
empty (only the target
itself), files (the target and any
immediate file children thereof),
immediates (the target and any
immediate children thereof), or
infinity (the target and all of its
descendants—full recursion).
Enables a special output mode for svn
log which includes a difference report (a
la svn diff) as part of each
revision's information.
--diff-cmd CMD
Specifies an external program to use to show
differences between files.
diff is invoked without this option, it uses
Subversion's internal differencing engine, which provides
unified diffs by default.
If you want to use an
external differencing program, use --diff-cmd.
You can then pass options to the specified program using the
--extensions (-x)
--diff3-cmd CMD
Specifies an external 3-way differencing program
(used to merge line-based changes into files).
Goes through all the motions of running a command,
but makes no actual changes—either on disk or in
the repository.
--editor-cmd CMD
Specifies an external program to use to edit a log message
or a property value.
See the editor-cmd
section in
for ways to specify a default editor.
--encoding ENC
Tells Subversion that your commit message is
composed using the character encoding provided.
default character encoding is derived from your
operating system' use this option if
your commit message is composed using any other
--extensions (-x) ARG
Specifies customizations which Subversion should
make when performing difference calculations.
extensions include:
--ignore-space-change (-b)
Ignore changes in the amount of white space.
--ignore-all-space (-w)
Ignore all white space.
--ignore-eol-style
Ignore changes in EOL (end-of-line) style.
--show-c-function (-p)
Show C function names in the diff output.
--unified (-u)
Show three lines of unified diff context.
The default value of ARG
If you wish to pass multiple
arguments, you must enclose all of them in quotes.
Note that when Subversion is configured to invoke an
external diff command, the value of
the --extension (-x)
option isn't restricted to the previously mentioned
options, but may be any additional
arguments which Subversion should pass to that command.
--file (-F) FILENAME
Uses the contents of the named file for the
specified subcommand.
Different subcommands do
different things with this content.
For example,
svn commit uses the content as a
commit log message, whereas svn
propset uses it as a property value.
Forces a particular command or operation to run.
Subversion will prevent you from performing some
operations in normal usage, but you can pass this option
to tell Subversion “I know what I'm doing as well
as the possible repercussions of doing it, so let me at
'em.” This option is the programmatic equivalent
of doing your own electrical work with the power
on—if you don't know what you're doing, you're
likely to get a nasty shock.
--force-log
Forces a suspicious parameter passed to the
--message (-m) or
--file (-F) option to
be accepted as valid.
By default, Subversion will
produce an error if parameters to these options look
like they might instead be targets of the subcommand.
For example, if you pass a versioned file's path to the
--file (-F) option,
Subversion will assume you've made a mistake, that the
path was instead intended as the target of the
operation, and that you simply failed to provide some
other—unversioned—file as the source of your
log message.
To assert your intent and override these
types of errors, pass the --force-log
option to subcommands that accept log messages.
Enables a special output mode for svn
diff designed for cross-compatibility with the
popular Git distributed version control system.
--help (-h, -?)
If used with one or more subcommands, shows the
built-in help text for each.
If used alone, it displays
the general client help text.
--ignore-ancestry
Tells Subversion to ignore ancestry when calculating
differences (rely on path contents alone).
Also disables
when used with the svn merge subcommand.
--ignore-externals
Tells Subversion to ignore externals definitions and
the external working copies managed by them.
--ignore-keywords
Disables keyword expansion.
--ignore-whitespace
Instructs svn patch to ignore
whitespace when attempting to identify patch
--incremental
Prints output in a format suitable for
concatenation to prior similar output.
--internal-diff
Instructs Subversion to use its built-in
differencing engine despite any external differencing
mechanism that may be specified for use in the user's
runtime configuration.
--keep-changelists
Tells Subversion not to remove the changelist assigments
from working copy items after committing.
--keep-local
Keeps the local copy of a file or directory (used
with the svn delete command).
--limit (-l) NUM
Shows only the first NUM
log messages.
--message (-m) MESSAGE
Indicates that you will specify either a log message
or a lock comment on the command line, following this
For example:
--native-eol ARG
Causes svn export to use a
specific end-of-line sequence as if it was the native
sequence for the client platform.
ARG may be one
of CR, LF,
Uses ARG as the newer
target (for use with svn diff).
--no-auto-props
Disables automatic property setting, overriding the
enable-auto-props runtime
configuration directive.
--no-diff-deleted
Prevents Subversion from printing differences for
deleted files.
The default behavior when you remove a
file is for svn diff to print the
same differences that you would see if you had kept
the file but removed all of its content.
--no-ignore
Shows files in the status listing that would
normally be omitted since they match a pattern in the
global-ignores configuration option
or the svn:ignore property.
information.
--no-unlock
Tells Subversion not to automatically unlock files.
(The default commit behavior is to unlock all files
listed as part of the commit.)
information.
--non-recursive (-N)
Deprecated.
Stops a subcommand
from recursing into subdirectories.
Most subcommands
recurse by default, but some do not.
Users should avoid
this option and use the more precise --depth
option instead.
For most subcommands, specifying
--non-recursive produces behavior which
is the same as if you'd specified
--depth=files, but there are exceptions:
non-recursive svn status operates at the
immediates depth, and the
non-recursive
forms of svn revert,
svn add, and svn commit
operate at an empty depth.
--notice-ancestry
Pays attention to ancestry when calculating
differences.
Uses ARG as the older
target (for use with svn diff).
Creates and adds nonexistent or nonversioned parent
subdirectories to the working copy or repository as part
of an operation.
This is useful for automatically
creating multiple subdirectories where none currently
If performed on a URL, all the directories will
be created in a single commit.
--quiet (-q)
Requests that the client print only essential
information while performing an operation.
--record-only
Enables a special mode of svn
merge in which the specified merge operation is
recorded in the local merge tracking information, but is
not actually performed.
--recursive (-R)
Makes a subcommand recurse into subdirectories.
(Most subcommands recurse by default.)
--reintegrate
Used with the svn merge
subcommand to merge all of the source URL's changes into
the working copy.
for details.
--relocate
Deprecated.
When used with the svn
switch subcommand, changes the location of the
repository that your working copy references.
preferred approach as of Subversion 1.7, however, is to
use the svn relocate subcommand.
details and an example.
Used with svn changelist to
disassociate—rather than associate (which is the
default operation)—the target(s) from a
changelist.
--reverse-diff
Causes svn patch to interpret the
input patch instructions in reverse—treating added
lines as removed ones and vice-versa.
--revision (-r) REV
Specifies a revision (or range of revisions) on with
which to operate.
You can provide revision numbers,
keywords, or dates (in curly braces) as arguments to the
revision option.
If you wish to offer a range of
revisions, you can provide two revisions separated by a
For example:
information.
Operates on a revision property instead of a
property specific to a file or directory.
This option
requires that you also pass a revision with the
--revision (-r)
--set-depth ARG
Sets the sticky depth on a directory in a working
copy to one of exclude, empty,
files, immediates,
or infinity.
For detailed coverage
of what these mean and how to use this option, see
--show-copies-as-adds
Enables a special output mode for svn
diff in which the content difference for a
file created via a copy operation appears as it would
for a brand new file (with each line therein appearing
as an addition to an empty file) rather than as a delta
against the original file from which the copy was
--show-revs ARG
Used to make svn mergeinfo
display certain classes of merge tracking
information.
ARG may be
either merged
or eligible, indicating a desire to
see revisions either already merged or eligible for future
merge from the specified source URL, respectively.
--show-updates (-u)
Causes the client to display information about
which files in your working copy are out of date.
This doesn't actually update any of your
files—it just shows you which files will be
updated if you then use svn update.
--stop-on-copy
Causes a Subversion subcommand that traverses
the history of a versioned resource to stop harvesting
that historical information when a copy—that is, a
location in history where that resource was copied from
another location in the repository—is
encountered.
Causes Subversion to use strict semantics, a notion
that is rather vague unless talking about specific
subcommands (namely, svn propget).
--strip NUM
Used by svn patch to
ignore NUM leading path
components found on paths specified in the patch input
--summarize
Display only high-level summary notifications about
the operation instead of its detailed output.
--targets FILENAME
Tells Subversion to read additional target paths for
the operation from FILENAME.
FILENAME should contain one
path per line, with each path expected to use the same
encoding and formatting that it would if you had
specified it directly as an argument on the command
--use-merge-history (-g)
Uses or displays additional information from merge
--verbose (-v)
Requests that the client print out as much
information as it can while running any subcommand.
This may result in Subversion printing out additional
fields, detailed information about every file, or
additional information regarding its actions.
Prints the client version info.
This information
includes not only the version number of the client, but
also a listing of all repository access modules that the
client can use to access a Subversion repository.
With --quiet (-q) it
prints only the version number in a compact form.
--with-all-revprops
Used with the --xml option
to svn log, instructs Subversion to
retrieve and display all revision properties—the
standard ones used internally by Subversion as well as any
user-defined ones—in the log output.
--with-no-revprops
Used with the --xml option
to svn log, instructs Subversion to
omit all revision properties—including the standard
log message, author, and revision datestamp—from the
log output.
--with-revprop ARG
When used with any command that writes to the
repository, sets the revision property, using the
NAME=VALUE format,
When used with
svn log in --xml mode, this displays the value of
ARG in the log output.
Prints output in XML format.
svn Subcommands
Here are the various subcommands for
the svn program.
For the sake of brevity,
we omit the global options (described in
) from the subcommand
descriptions which follow.