svn-win32-1.5.5_dev.zip（详细配置svn文档）

/** * @copyright * ==================================================================== * Copyright (c) 2000-2007 CollabNet. All rights reserved. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms * are also available at http://subversion.tigris.org/license-1.html. * If newer versions of this license are posted there, you may use a * newer version instead, at your option. * * This software consists of voluntary contributions made by many * individuals. For exact contribution history, see the revision * history and logs, available at http://subversion.tigris.org/. * ==================================================================== * @endcopyright * * @file svn_wc.h * @brief Subversion's working copy library * * Requires: * - A working copy * * Provides: * - Ability to manipulate working copy's versioned data. * - Ability to manipulate working copy's administrative files. * * Used By: * - Clients. */ #ifndef SVN_WC_H #define SVN_WC_H  #include <apr.h> #include <apr_pools.h> #include <apr_tables.h> #include <apr_hash.h> #include "svn_types.h" #include "svn_string.h" #include "svn_delta.h" #include "svn_error.h" #include "svn_opt.h" #include "svn_ra.h" /* for svn_ra_reporter_t type */ #ifdef __cplusplus extern "C" { #endif /* __cplusplus */  /** * Get libsvn_wc version information. * * @since New in 1.1. */ const svn_version_t *svn_wc_version(void); /** * @defgroup svn_wc Working copy management * @{ */ /** Flags for use with svn_wc_translated_file2 * * @defgroup translate_flags Translation flags * * @{ */ /** Translate from Normal Form. * * The working copy text bases and repository files are stored * in normal form. Some files' contents - or ever representation - * differs between the working copy and the normal form. This flag * specifies to take the latter form as input and transform it * to the former. * * Either this flag or @c SVN_WC_TRANSLATE_TO_NF should be specified, * but not both. */ #define SVN_WC_TRANSLATE_FROM_NF 0x00000000 /** Translate to Normal Form. * * Either this flag or @c SVN_WC_TRANSLATE_FROM_NF should be specified, * but not both. */ #define SVN_WC_TRANSLATE_TO_NF 0x00000001 /** Force repair of eol styles, making sure the output file consistently * contains the one eol style as specified by the svn:eol-style * property and the required translation direction. * */ #define SVN_WC_TRANSLATE_FORCE_EOL_REPAIR 0x00000002 /** Don't register a pool cleanup to delete the output file */ #define SVN_WC_TRANSLATE_NO_OUTPUT_CLEANUP 0x00000004 /** Guarantee a new file is created on successful return. * The default shortcuts translation by returning the path * of the untranslated file when no translation is required. */ #define SVN_WC_TRANSLATE_FORCE_COPY 0x00000008 /** Use a non-wc-local tmp directory for creating output files, * instead of in the working copy admin tmp area which is the default. * * @since New in 1.4. */ #define SVN_WC_TRANSLATE_USE_GLOBAL_TMP 0x00000010 /** @} */ /* Locking/Opening/Closing */ /** Baton for access to a working copy administrative area. * * One day all such access will require a baton, we're not there yet. * * Access batons can be grouped into sets, by passing an existing open * baton when opening a new baton. Given one baton in a set, other batons * may be retrieved. This allows an entire hierarchy to be locked, and * then the set of batons can be passed around by passing a single baton. */ typedef struct svn_wc_adm_access_t svn_wc_adm_access_t; /** * Return, in @a *adm_access, a pointer to a new access baton for the working * copy administrative area associated with the directory @a path. If * @a write_lock is TRUE the baton will include a write lock, otherwise the * baton can only be used for read access. If @a path refers to a directory * that is already write locked then the error @c SVN_ERR_WC_LOCKED will be * returned. The error @c SVN_ERR_WC_NOT_DIRECTORY will be returned if * @a path is not a versioned directory. * * If @a associated is an open access baton then @a adm_access will be added * to the set containing @a associated. @a associated can be @c NULL, in * which case @a adm_access is the start of a new set. * * @a levels_to_lock specifies how far to lock. Zero means just the specified * directory. Any negative value means to lock the entire working copy * directory hierarchy under @a path. A positive value indicates the number of * levels of directories to lock -- 1 means just immediate subdirectories, 2 * means immediate subdirectories and their subdirectories, etc. All the * access batons will become part of the set containing @a adm_access. This * is an all-or-nothing option, if it is not possible to lock all the * requested directories then an error will be returned and @a adm_access will * be invalid, with the exception that subdirectories of @a path that are * missing from the physical filesystem will not be locked and will not cause * an error. The error @c SVN_ERR_WC_LOCKED will be returned if a * subdirectory of @a path is already write locked. * * If @a cancel_func is non-NULL, call it with @a cancel_baton to determine * if the client has cancelled the operation. * * @a pool will be used to allocate memory for the baton and any subsequently * cached items. If @a adm_access has not been closed when the pool is * cleared, it will be closed automatically at that point, and removed from * its set. A baton closed in this way will not remove physical locks from * the working copy if cleanup is required. * * The first baton in a set, with @a associated passed as @c NULL, must have * the longest lifetime of all the batons in the set. This implies it must be * the root of the hierarchy. * * @since New in 1.2. */ svn_error_t * svn_wc_adm_open3(svn_wc_adm_access_t **adm_access, svn_wc_adm_access_t *associated, const char *path, svn_boolean_t write_lock, int levels_to_lock, svn_cancel_func_t cancel_func, void *cancel_baton, apr_pool_t *pool); /** * Similar to svn_wc_adm_open3(), but without cancellation support. * * @deprecated Provided for backward compatibility with the 1.1 API. */ svn_error_t * svn_wc_adm_open2(svn_wc_adm_access_t **adm_access, svn_wc_adm_access_t *associated, const char *path, svn_boolean_t write_lock, int levels_to_lock, apr_pool_t *pool); /** * Similar to svn_wc_adm_open2(), but with @a tree_lock instead of * @a levels_to_lock. @a levels_to_lock is set to -1 if @a tree_lock * is @c TRUE, else 0. * * @deprecated Provided for backward compatibility with the 1.0 API. */ svn_error_t * svn_wc_adm_open(svn_wc_adm_access_t **adm_access, svn_wc_adm_access_t *associated, const char *path, svn_boolean_t write_lock, svn_boolean_t tree_lock, apr_pool_t *pool); /** * Checks the working copy to determine the node type of @a path. If * @a path is a versioned directory then the behaviour is like that of * svn_wc_adm_open3(), otherwise, if @a path is a file or does not * exist, then the behaviour is like that of svn_wc_adm_open3() with * @a path replaced by the parent directory of @a path. If @a path is * an unversioned directory, the behaviour is also like that o