The Subversion client is built on three libraries. One operates strictly on the working copy and does not talk to the repository. Another talks to the repository but never changes the working copy. The third library uses the first two to provide operations such as commit and update – operations which need to both talk to the repository and change the working copy. The initial client is a Unix-style command-line tool (like standard CVS), but it should be easy to write a GUI client as well, based on the same libraries. The libraries capture the core Subversion functionality, segregating it from user interface concerns. This chapter describes the libraries, and the physical layout of working copies. Working copies are client-side directory trees containing both versioned data and Subversion administrative files. The functions in the working copy management library are the only functions in Subversion which operate on these trees. This section gives an overview of how working copies are arranged physically, but is not a full specification of working copy layout. As with CVS, Subversion working copies are simply directory trees with special administrative subdirectories, in this case named ".svn" instead of "CVS": myproj / | \ _____________/ | \______________ / | \ .svn src doc ___/ | \___ /|\ ___/ \___ | | | / | \ | | base ... ... / | \ myproj.texi .svn / | \ ___/ | \___ ____/ | \____ | | | | | | base ... ... .svn foo.c bar.c | ___/ | \___ | | | | | base ... ... myproj.texi ___/ \___ | | foo.c bar.c Each dir/.svn/ directory records the files in dir, their revision numbers and property lists, pristine revisions of all the files (for client-side delta generation), the repository from which dir came, and any local changes (such as uncommitted adds, deletes, and renames) that affect dir. Although it would often be possible to deduce certain information (such as the original repository) by examining parent directories, this is avoided in favor of making each directory be as much a self-contained unit as possible. For example, immediately after a checkout the administrative information for the entire working tree could be stored in one top-level file. But subdirectories instead keep track of their own revision information. This would be necessary anyway once the user starts committing new revisions for particular files, and it also makes it easier for the user to prune a big, complete tree into a small subtree and still have a valid working copy. The .svn subdir contains: A format file, which indicates which version of the working copy adm format this is (so future clients can be backwards compatibleeasily). A text-base directory, containing the pristine repository revisions of the files in the corresponding working directory An entries file, which holds revision numbers and other information for this directory and its files, and records the presence of subdirs. It also contains the repository URLs that each file and directory came from. It may help to think of this file as the functional equivalent of the CVS/Entries file. A props directory, containing property names and values for each file in the working directory. A prop-base directory, containing pristine property names and values for each file in the working directory. A dir-props file, recording properties for this directory. A dir-prop-base file, recording pristine properties for thisdirectory. A lock file, whose presence implies that some client is currently operating on the administrative area. A tmp directory, for holding scratch-work and helping make working copy operations more crash-proof. A log file. If present, indicates a list of actions that need to be taken to complete a working-copy-operation that is still "in progress". You can read much more about these files in the file subversion/libsvn_wc/README. Requires: a working copy Provides: ability to manipulate the working copy's versioned data ability to manipulate the working copy's administrative files This library performs "offline" operations on the working copy, and lives in subversion/libsvn_wc/. The API for libsvn_wc is always evolving; please read the header file for a detailed description: subversion/include/svn_wc.h. Requires: network access to a Subversion server Provides: the ability to interact with a repository This library performs operations involving communication with the repository. The interface defined in subversion/include/svn_ra.h provides a uniform interface to both local and remote repository access. Specifically, libsvn_ra_dav will provide this interface and speak to repositories using DAV requests. At some future point, another library libsvn_ra_local will provide the same interface – but will link directly to the filesystem library for accessing local disk repositories. Requires: the working copy management library a repository access library Provides: all client-side Subversion commands These functions correspond to user-level client commands. In theory, any client interface (command-line, GUI, emacs, Python, etc.) should be able to link to libsvn_client and have the ability to act as a full-featured Subversion client. Again, the detailed API can be found in subversion/include/svn_client.h.