Difference between revisions of "SubversionServer"
(Add READ-ONLY access section) |
|||
Line 1: | Line 1: | ||
− | LIBISIS source code | + | LIBISIS source code is held in a [http://subversion.tigris.org/ subversion repository]. The repository is world readable and though you can browse the [http://svn.libisis.org/code/ LIBISIS library] repository directly, but a better looking interface is provided by the [http://www.viewvc.org/ ViewVC] or [http://trac.edgewall.org TRAC] browsers. |
* Browse LIBISIS repository using [http://svn.libisis.org/viewvc/LIBISISCode ViewVC] or [http://trac.libisis.org/code/browser TRAC] | * Browse LIBISIS repository using [http://svn.libisis.org/viewvc/LIBISISCode ViewVC] or [http://trac.libisis.org/code/browser TRAC] | ||
Line 9: | Line 9: | ||
* The ''Revision Log'' pages for [http://trac.libisis.org/code/log library] | * The ''Revision Log'' pages for [http://trac.libisis.org/code/log library] | ||
− | ==== | + | ====Read-Only Access==== |
+ | Read-Only access can be obtained via a subversion client such as [http://tortoisesvn.tigris.org/ TortoiseSVN] and the repository URL of '''http://svn.libisis.org/code/trunk'''. On linux you would type: | ||
+ | <PRE> | ||
+ | svn co http://svn.libisis.org/code/trunk libisis | ||
+ | </PRE> | ||
+ | To pull out the top revision (trunk) into a local directory called ''libisis'' | ||
+ | |||
+ | ====Read/Write Access (LOGIN REQUIRED)==== | ||
+ | |||
To update files in these repositories you will need to use a program such as [http://tortoisesvn.tigris.org/ TortoiseSVN] and also provide your LIBISIS Wiki username and password. Note that for subversion write access: | To update files in these repositories you will need to use a program such as [http://tortoisesvn.tigris.org/ TortoiseSVN] and also provide your LIBISIS Wiki username and password. Note that for subversion write access: | ||
* If you Wiki username contains a space, write it with a space (i.e. do not replace the space with an _ as is done in WIKI URLs) | * If you Wiki username contains a space, write it with a space (i.e. do not replace the space with an _ as is done in WIKI URLs) | ||
Line 15: | Line 23: | ||
* Your Wiki account must have an email address assocoiated with it and this address must have been validated. To provide and/or validate your email address, log in and go to your account [[Special:Preferences]] section. | * Your Wiki account must have an email address assocoiated with it and this address must have been validated. To provide and/or validate your email address, log in and go to your account [[Special:Preferences]] section. | ||
− | + | The URL of the subversion repository for read/write access is '''https://svn.libisis.org/code/trunk''' - note this starts '''https:''' and if you type '''http:''' by mistake you will not be prompted for a username/password and will only be granted read access. | |
− | + | On Linux you would type: | |
<PRE> | <PRE> | ||
svn co --username "My WIKI Username" https://svn.libisis.org/code/trunk libisis | svn co --username "My WIKI Username" https://svn.libisis.org/code/trunk libisis | ||
</PRE> | </PRE> | ||
+ | To pull out the top revision (trunk) into a local directory called ''libisis'' | ||
Please report any problems via out the [[IssueReporting]] system | Please report any problems via out the [[IssueReporting]] system |
Revision as of 14:27, 14 December 2006
LIBISIS source code is held in a subversion repository. The repository is world readable and though you can browse the LIBISIS library repository directly, but a better looking interface is provided by the ViewVC or TRAC browsers.
The repository can alse be interrogated for recent updates via a query form e.g show me all Library changes in the last month.
If you wish to receive an email when a change is made to the repository you should join the appropriate mailing list. Alternatively, you can use an RSS feed to keep an eye on changes - TRAC supports this on pages with an orange "XML RSS Feed" icon at their foot such as:
Read-Only Access
Read-Only access can be obtained via a subversion client such as TortoiseSVN and the repository URL of http://svn.libisis.org/code/trunk. On linux you would type:
svn co http://svn.libisis.org/code/trunk libisis
To pull out the top revision (trunk) into a local directory called libisis
Read/Write Access (LOGIN REQUIRED)
To update files in these repositories you will need to use a program such as TortoiseSVN and also provide your LIBISIS Wiki username and password. Note that for subversion write access:
- If you Wiki username contains a space, write it with a space (i.e. do not replace the space with an _ as is done in WIKI URLs)
- You cannot use a "temporary password" (i.e. one that was emailed to you in response to a request). You must first log into MediaWiki with the temporary password and then go to account Special:Preferences and change the password.
- Your Wiki account must have an email address assocoiated with it and this address must have been validated. To provide and/or validate your email address, log in and go to your account Special:Preferences section.
The URL of the subversion repository for read/write access is https://svn.libisis.org/code/trunk - note this starts https: and if you type http: by mistake you will not be prompted for a username/password and will only be granted read access.
On Linux you would type:
svn co --username "My WIKI Username" https://svn.libisis.org/code/trunk libisis
To pull out the top revision (trunk) into a local directory called libisis
Please report any problems via out the IssueReporting system
Committing Changes
As well as needing a valid account, you will not be able to check-in changes unless you indicate (in the log message attached to the commit) which current issues on the IssueReporting system the changes either fix or refer to. This is done by enclosing special phrases in the commit message of the form:
command #1 command #1, #2 command #1 & #2 command #1 and #2
where command is one of the commands detailed below and #1 means "issue number 1" on the system etc. You can have more then one command in a message. The following commands are supported and there is more then one spelling for each command (to make this as user-friendly as possible)
- closes, fixes
The specified issue numbers are closed with the contents of this commit message being added to it. - references, refs, addresses, re
The specified issue numbers are left in their current status, but the contents of this commit message are added to their notes.
For example the commit message
Changed blah and foo to do this or that. Fixes #10 and #12, and refs #12.
This will close issues #10 and #12, and add a note to #12 on the IssueReporting system. For a list of current issues see: