+ 'What is subversion in terms of using it through SVNKit' - the name of a category, as you, Alex, proposed:) Description: Brief introduction to Subversion, about limitation of WC format. What is SVNKit for in this context, what it allows/provides (here comes information about workaround for the WC limitation, listing features: repository creation, replication, flexibility in configuring). Basic operations. Category Articles: ________________________________________________________________________________________________________ | + 'What is so special about SVNKit?' | Description: | 100% pure Java client library used for working with Subversion repositories and | Working Copies, architecture (low-level & high-level APIs), features | | + 'Repository access protocols SVNKit supports' | Description: | All's quite clear here: listing protocols supported by SVNKit, and what | modules (SVNRepositoryfactories) and how should be set up for these purposes. | | + 'Repository types' | Description: | Besides basic repository types this article warns audience that SVNKit supports | file:/// proto (as well as creates local repositories) only for FSFS-type | repositories. | | + 'Managing a Subversion repository with SVNKit' | Description: | Devides all operations into 2 groups: reading ones and modifying (editing) ones. | When telling about the second group - editing operations (not including revprops | and locks) the article smoothly comes to ISVNEditor (why editor and what for) in description. | Here it says that commiting (editing) operations are the following (repository-side): | commit, copy, move, delete, import, mkdir - all are driven by an ISVNEditor returned by | an SVNRepository driver. Then below a list of links to artcles describing some operations | implemented by SVNKit follows. | | Subcategory articles: | ___________________________________________________________________________________________ | | | |+ update operations | |Description: | | how to perform low-level update operation (ISVNEditor + ISVNReporterBaton) | | | |+ modifying (commit or edit) operations: | |Description: | | how to run a low-level commit with the help of ISVNEditor | |__________________________________________________________________________________________ | | + 'How does SVNKit authenticate a client to a server?' | Description: | Tells about ISVNAuthenticationManager and about its implementations: DefaultAuthManager and | BasicAuthManager, what differences there're between them. ISVNAuthenticationProvider and | ISVNAuthStorage - what for? Supported http auth schemes for server- and proxy- authorizations: | basic, digest, ntlm (what way domain is supplied). | | + 'General options' | Description: | About Global run-time config options, ISVNoptions interface. | | + 'Customizing HTTP network connections' | Description: | About IHTTPConnectionFactory and IHTTPConnection interfaces. | | + 'Using SVNKit in multithreaded applications' | Description: | Some notes on using SVNKit in multithreaded environment. | | + 'Supported System properties and configuration options' | Description: | Lists & describes options and parameters SVNKit uses during run-time |____________________________________________________________________________________________________________ + 'SVNKit in different environments' Description: Describes different ways SVNKit can be used. Category articles: _____________________________________________________________________________________________________________ | | + 'Using SVNKit through JavaHL API and JavaHL replacement' | Description: | Describes that SVNKit provides two classe: SVNClient and SVNClientImpl, both implementing | SVNClientInterface and both using only SVNKit. | | + 'Using SVNKit in a standalone application' | Description: | How to: build and use SVNKit in a standalone program. | | + 'Using SVNKit as an Eclipse plugin' | Description: | How to: build and use SVNKit as an Eclipse plugin. | | + 'Using SVNKit with Ant' | Description: | This article describes how you to use SVNKit in Ant tasks. With samples. | + 'Using SVNKit with SvnAnt' | Description: | Brief instructions of how to make SvnAnt use SVNKit. | | + 'Using SVNKit command line client' | Description: | An alternate to svn.exe written on Java? That's it! |_____________________________________________________________________________________________________________ + 'Troubleshooting' Description: Experiencing problems with SVNKit? then this category is for you. Category articles: _______________________________________________________________________________________________________________ | + 'Setting a custom logger' |Description: | Replacing a default SVNKit logger with your own implementation. How to? | |+ 'How to switch on SVNKit logging and where to get its logs?' |Description: | About loggig.properties and 3 levels of logging (FINE, FINER, FINEST). Where do log files | reside? |+ 'FAQ' |Description: | Not sure if it's really needed. Collection of possible questions and answers to them. |_______________________________________________________________________________________________________________ + 'Examples' Description: Simple Java programs which demonstrate a common usage of SVNKit API. 2 groups of programs: for high-level and low-level APIs Category articles: ________________________________________________________________________________________________________________ |Low-level API Examples: |+ 'Commit' |+ 'DisplayFile' |+ 'Display Repository' |+ 'Export' |+ 'History' |+ 'Replicate' | |High-level API Examples: |+ 'WorkingCopy' |________________________________________________________________________________________________________________