Overview
Examples
Screenshots
Comparisons
Applications
Download
Documentation
Tutorials
Bazaar
Status & Roadmap
FAQ
Authors & License
Forums
Funding Ultimate++
Search on this site











SourceForge.net Logo

Subversion Install and Permissions

 


Table of contents

 

1. Subversion Install

2. Upload Permissions

3. Generating patch

4. Mirrors

 


1. Subversion Install

Upp project and Bazaar packages are hosted in Upp hosting system and latest releases are available through Subversion. This is an Open Source version control system.

So first of all you will have to install a Subversion (SVN) client like TortoiseSVN, SmartSVN, SlikSVN, kdesvn or just an "apt install subversion" in Linux. Be sure that in Windows the svn client is in PATH environment variable although this is usually done by installer.


2. Upload Permissions

Well. You have svn installed so that you could get the latest source code from official repository with just this command line:

 

svn checkout svn://www.ultimatepp.org/upp/trunk/ my-upp

 

To get upload permissions you will have to send a post to Forum/Bazaar, explain as much details as possible about your project and ask for permission to upload it to Bazaar.

If the project is accepted (as usual), Upp administrator will contact you and give you the address where you have to upload your new package, username (your Upp Forum nick) and password.

However, if you are not interested in creating your own package and you want to help in U++ development throw writing documentation or new features for TheIDE. Please contact Upp administrator directly.

For example, if the svn base address is "svn://192.168.0.1/upp", you should have to upload your package to "svn://192.168.0.1/upp/trunk/bazaar/My_Cool_Package".

Please do not put spaces in your package name. You also should take care to not modify others packages (you may have write access to them too).

When you commit (upload to svn server) the changes do not forget to enter a comment following this format:

 

"My_Cool_Package: First release"

 

or

 

"My_Cool_Package: Added X an Y. Fixed bug Z"

 

You can monitor that your changes are correctly commited by observing following site: https://github.com/ultimatepp/mirror/commits/master.

And do not put many different features into a single commit. It is better to separate them if they do different things.


3. Generating patch

Sometimes you need to deliver patch for the whole library, but you don't have permission to commit. In this case it is good to consider generating a diff file that can be easily applied by U++ developer.

At the beginning, we need to move to the directory that holds U++ sources tracked by subversion. Next, we will generate the diff file. At command line described history looks like this:

 

cd ~/upp/uppsrc

svn diff > ../MyAwsomeUppPath.diff

 

In the above scenario the diff file will be stored in ~/upp directory. Now, all you need to do is post your patch.


4. Mirrors

Besides the official U++ official repository there are following mirrors:

 

svn checkout "https://github.com/ultimatepp/mirror" my-upp-mirror

 

Do you want to contribute?