Meta tags:

Headings (most frequently used words):

and, copy, files, repository, working, directories, the, local, changes, what, is, your, to, url, apache, subversion, quick, start, installing, svn, client, terminology, basic, tasks, setting, up, getting, more, help, importing, data, into, checking, out, updating, making, in, performing, file, directory, operations, branching, tagging, modifying, existing, committing, adding, new, moving, renaming, copying, deleting, reverting, or, discarding, creating, branch, using, direct,

Text of the page (most frequently used words):
the (119), svn (57), you (55), copy (47), and (39), working (35), your (34), repository (34), #subversion (31), project (23), myrepo (22), changes (20), files (19), command (18), can (16), create (16), with (15), directory (15), for (14), trunk (14), file (14), local (14), apache (13), are (12), new (12), repositories (12), myproject (11), will (11), that (11), client (11), commit (10), use (10), example (10), not (10), should (10), using (9), them (9), directories (9), svnrepos (8), branch (8), data (8), com (7), start (7), branches (7), source (7), modifications (7), version (6), https (6), update (6), import (6), home (6), control (5), help (5), into (5), where (5), this (5), run (5), want (5), foo (5), move (5), software (5), repos (5), svnbook (4), getting (4), quick (4), add (4), checkout (4), change (4), mkdir (4), tags (4), creating (4), out (4), from (4), any (4), delete (4), tree (4), made (4), message (4), server (4), code (4), read (3), see (3), initial (3), unversioned (3), located (3), under (3), existing (3), result (3), modify (3), track (3), interact (3), single (3), projects (3), branching (3), direct (3), url (3), copying (3), system (3), called (3), revert (3), rename (3), tracking (3), perform (3), regular (3), commands (3), about (3), but (3), log (3), others (3), yourself (3), here (3), committing (3), central (3), making (3), download (3), have (3), versioned (3), contains (3), install (3), binary (3), foundation (3), book (2), must (2), more (2), also (2), schedule (2), added (2), force (2), convert (2), current (2), recommended (2), layout (2), structure (2), svnadmin (2), parent (2), place (2), windows (2), unix (2), following (2), minimal (2), computer (2), locally (2), person (2), setting (2), form (2), requires (2), remote (2), used (2), because (2), familiar (2), when (2), takes (2), time (2), complete (2), copies (2), same (2), uncommitted (2), able (2), deleting (2), bar (2), moving (2), renaming (2), automatically (2), such (2), within (2), operations (2), note (2), include (2), descriptive (2), good (2), too (2), review (2), before (2), status (2), usually (2), soon (2), modifying (2), contents (2), right (2), colleagues (2), fetch (2), committed (2), get (2), whole (2), better (2), resides (2), myworkingcopy (2), instead (2), checking (2), line (2), gui (2), issuing (2), basic (2), tasks (2), acts (2), capabilities (2), administrative (2), its (2), what (2), access (2), style (2), svnserve (2), http (2), terminology (2), list (2), release (2), page (2), official (2), packages (2), installing (2), logo (2), trademarks (2), license (2), documentation (2), bible, users, administrators, find, red, bean, instructions, procedure, creates, environment, converts, newly, created, scheme, approach, personal, mynewbranch, simple, simplest, against, urls, let, mainline, technically, however, ordinary, similar, symlinks, therefore, practically, space, regardless, size, scope, cheap, items, historically, related, tagging, discarded, lost, forever, recover, reverted, caution, discard, reverting, discarding, alias, put, unless, adding, does, heurisic, explicit, filesystem, know, operation, aware, actions, involve, performed, corresponding, performing, option, always, including, understand, reason, why, idea, summary, diff, order, publish, favorite, text, processor, graphics, editor, audio, editing, ide, etc, save, disk, recognize, most, going, satisfied, reviewed, thoroughly, ready, practice, only, means, stay, date, sync, updating, refrain, doing, generally, speaking, need, work, instantly, switched, another, development, moreover, contain, number, unrelated, dedicated, each, all, check, some, tag, assuming, they, already, exist, begin, based, prefer, case, non, importing, there, much, combination, looks, like, one, major, difference, tracks, think, has, named, root, metadata, necessary, manage, private, workspace, var, mybranch, examples, database, often, exposed, either, through, module, truth, storage, history, revisions, mod_dav_svn, may, served, graphical, maintain, clients, recommend, web, search, now, type, usage, after, test, output, program, build, package, sites, obtain, pre, built, available, compile, grab, collaborating, privacy, policy, copyright, 2026, licensed, registered, online, thanks, donate, asf, conduct, involved, wiki, reporting, issues, mailing, lists, community, notes, blog, security, roadmap, faq, features, news,

Text of the page (random words):
apache subversion quick start about subversion news features documentation faq roadmap security quick start blog getting subversion binary packages source download release notes community mailing lists reporting issues wiki getting involved source code code of conduct about the asf license donate thanks read the official subversion documentation online copyright 2026 the apache software foundation licensed under the apache license version 2 0 apache apache subversion and the apache logo are trademarks of the apache software foundation subversion and the apache subversion logo are registered trademarks of the apache software foundation privacy policy apache subversion quick start installing the svn client terminology basic tasks setting up a local repository getting more help installing the svn client install the svn client to start collaborating on a project that is using subversion as its version control system to install the client program you can build it yourself from a source code release or download a binary package the list of sites where you can obtain a pre built subversion client is available at the official binary packages page if you want to compile the software for yourself grab the source at the source code page right after you install the client you should be able to test it by issuing the svn command you should see the following output svn type svn help for usage now you can start using the command line client to interact with the remote repository if you are not familiar with subversion you may be better served by a graphical client we do not maintain a list of such clients instead we recommend you do a web search for subversion gui client terminology what is a repository the repository is a version control database that often resides on a server and is usually exposed either by an apache http server through the mod_dav_svn module or by an svnserve server the repository acts as a single source of truth and as a central storage it contains the complete history of changes of the versioned data in form of revisions repository url examples apache http server https svn example com repos myrepo myproject trunk svnserve svn svn example com repos myrepo myproject branches mybranch direct access unix style file var svn repos myrepo myproject tags 1 1 0 direct access windows style file c repositories myrepo trunk myproject what is a working copy the working copy is your local and private workspace that you use to interact with the central subversion repository you use the working copy to modify the contents of your project and fetch changes committed by others the working copy contains your project s data and looks and acts like a regular directory on your local file system but with one major difference the working copy tracks the status and changes of files and directories within you can think of the working copy as of a regular directory with version control capabilities a working copy has an administrative directory named svn at its root the administrative directory contains metadata necessary for subversion to manage the version control capabilities there can be as much working copies from the same repository or project as you want with any combination of local modifications basic tasks importing data into the repository in case you want to import existing non versioned data into an svn repository you should run the svn import command here is an example svn import https svn example com repos myrepo myproject trunk m initial project import checking out a working copy to begin making modifications to your project s data you have to create a local copy of the versioned project you can use the command line svn client or any gui based client that you prefer your local copy of the project is called a working copy and you create it by issuing the svn checkout command here is an example svn checkout https svn example com repos myrepo myproject trunk myworkingcopy as a result you will get a working copy of the trunk of a project called myproject that resides in myrepo repository the working copy will be located in myworkingcopy directory on your computer note that instead of checking out the trunk you can check out some branch or a tag assuming they already exist in the repository you can get the working copy of the whole repository myrepo too but you should refrain from doing so generally speaking you do not need to have a working copy of the whole repository for your work because your working copy can be instantly switched to another development branch moreover subversion repository can contain a number of unrelated projects and it is better to have a dedicated working copy for each of them not a single working copy for all of the projects updating a working copy you are not the only person working on the project right this means that your colleagues are also making modifications to the project s data to stay up to date and to fetch the modifications committed by others you should run the svn update command in your working copy as a result your working copy will sync with the repository and download the changes made by your colleagues it is a good practice to update your working copy before committing local modifications to the repository making changes in your local working copy most of the time you are going to perform modifications to the project s data by modifying the contents of the working copy as soon as you are satisfied with the modifications and you ve reviewed them thoroughly you are ready to commit them to the central repository modifying existing files modify the files as you usually do using your favorite text processor graphics editor audio editing software ide etc as soon as you save the changes to disk subversion will recognize them automatically committing your changes to the repository in order to publish the changes you made in your working copy you should run the svn commit command review your changes before committing them use the svn status and svn diff commands to review the changes here is an example of the commit command svn commit m my descriptive log message note the m message option you should always include a descriptive commit log message it should help others including yourself understand the reason why you made this commit it is a good idea to include a summary of your changes in the log message too performing file and directory operations you can perform any actions with your project s data within the working copy but operations that involve copying moving renaming and deleting must be performed using the corresponding svn commands subversion does not use heurisic tracking for tree changes in a working copy subversion requires explicit tracking of tree changes if you perform a tree changes such as move or copy with regular filesystem commands subversion will not know about this operation to track tree changes subversion should be made aware of them adding new files and directories put new files or directories to the working copy and subversion will see them as unversioned it will not automatically start tracking the new files unless you run the svn add command svn add foo cs moving and renaming files and directories move and rename files and directories using the svn move or svn rename command svn move foo cs bar cs the command svn rename is an alias for the svn move copying files and directories copy files and directories using the svn copy command svn copy foo cs bar cs deleting files and directories delete files and directories using the svn delete svn delete command svn delete foo cs reverting or discarding local changes discard your local uncommitted changes using the svn revert command svn revert foo cs discarded uncommitted changes will be lost forever you will not be able to recover the reverted changes use svn revert with caution branching and tagging you should use the svn copy command to create branches and tags this is the same command that is used to copy items in your working copy and in the repository when you want them to be historically related the command svn copy is used for branching because branch is technically a copy of the source you copy from however it is not an ordinary copy that you are familiar with when copying files on your local file system branches in subversion repositories are so called cheap copies that are similar to symlinks therefore creating a new branch takes minimal time to complete and takes practically no space in the subversion repository you can create branches and use them for any change you want regardless of the change s size and scope creating a branch using direct url to url copy branching in subversion is simple in the simplest form creating a new branch requires you to run the command against the remote repository s urls for example let s create a new branch out of the mainline trunk svn copy https example com myrepo trunk https example com myrepo branches mynewbranch m creating a new branch setting up a local repository you can create a subversion repository on your computer and use file scheme to interact with it locally this approach can help you use subversion locally to track personal files and single person projects the following procedure creates a minimal environment for an existing project it converts a directory with a project into a working copy of a newly created local subversion repository as result you can modify the files in the working copy and track the changes in your local repository on unix create a parent directory svnrepos where you will place your svn repositories mkdir p home svnrepos create a new repository myrepo under svnrepos svnadmin create svnrepos myrepo create a recommended project layout in the new repository svn mkdir m create directory structure file home svnrepos myrepo trunk file home svnrepos myrepo branches file home svnrepos myrepo tags change directory to myproject where your unversioned project is located cd home myproject convert the current directory into a working copy of the trunk in the repository svn checkout file home svnrepos myrepo trunk schedule your project s files to be added to the repository svn add force commit the project s files svn commit m initial import update your working copy svn update on windows create a parent directory c repositories where you will place your svn repositories mkdir c repositories create a new repository myrepo under c repositories svnadmin create c repositories myrepo create a recommended project layout in the new repository svn mkdir m create directory structure file c repositories myrepo trunk file c repositories myrepo branches file c repositories myrepo tags change directory to c myproject where your unversioned project is located cd c myproject convert the current directory into a working copy of the trunk in the repository svn checkout file c repositories myrepo trunk schedule your project s files to be added to the repository svn add force commit the project s files svn commit m initial import update your working copy svn update see also the quick start instructions in the subversion book getting more help if you are new to apache subversion svn read version control with subversion book svnbook svnbook is the bible of svn and must read for subversion users and administrators you can find svnbook 1 8 at https svnbook red bean com en 1 8