[rickatnight11]

There have been several reported problems with getting git working, so I decided to write a guide to answer as many questions as possible for both Windows and Linux. Please post feedback below.

I am currently working on this guide. Please bear with me!
I am creating this guide remotely over LogMeIn, but git is crashing on the machine I am using. I'll have to wait until I get home tonight to finish.

1.1 Installation (Windows)
Git is, by nature, a console application created for Unix-based systems. A port has been created, however, call msysgit. Msysgit works via several possible methods, the most commonly used being to run is on an emulated Linux bash prompt. The application has evolved to provide some other useful tools such as a GUI to actually working with the Windows command prompt. I will only be covering the Git Bash and Git GUI methods as these are the methods less likely to screw with your machine.

• Visit http://code.google.com/p/msysgit/downloads/list and download the latest Full Git installer.
  
• Run the installation, press Next to continue, Next to agree to the License, Select your installation directory and press Next, and then choose your Start Menu folder before clicking Next again (the defaults through these screens should be fine)
  
• In the Additional Tasks screen you can choose as you like, but I hate it when programs add lines to my context menu, so I uncheck everything
  
• The "Adjusting your PATH Environment" is where things get a bit tricky, but for most people the default "Use Git Bash only" is sufficient. Unless you know what you are doing, I would not select either of the other two.
  
• Select OpenSSH and continue by pressing Next
  
• Either Unix style or Windows style line endings are fine, but I would stick with Windows style line endings, and press Next to commence the installation
  
• Press Finish to complete the installation
  

1.2 Installation (Ubuntu Linux)
This installation is certainly easier than the Windows one and should work for any of the support Ubuntu ditributions.

• Open up a Terminal prompt
  
• Run the following command to install git:
  Code:

  sudo apt-get install git-core
• You should be asked for your administrative password, and then to confirm the package installation
  
• After the package downloads and installs you are ready to use git!
  
  

2.1 Using Git (Windows)
As I mentioned before, msysgit can be used from a Bash prompt or with the Git GUI application. I will cover both of them enough to get you started.

2.1.1 Git GUI
Incomplete!!!

• Start the Git GUI and select "Clone Existing Repository"
  
• For source location you can paste git://github.com/djh/aeon.git
  
• Select Browse for the target directory and navigate to the skin directory in your XBMC installation (default is C:\Program Files\XBMC\skin)
  
• Manually add a folder name to the Target Directory field to specify where the skin will be downloaded (it cannot exist already or you will get an error)
  
  
• Select Clone to begin cloning. This will take a while and won't look like it's doing anything. Just let it run.
  
  
• The window that opens is what will let you manipulate your git repository. Navigate to Branch->Checkout (or press Ctrl+O) and select the Tracking Branch[B/] option.
  
  If you would like the officially supported version of Aeon (Aeon Stark 0.91) then select the [b]origin/master branch.
  If you want to test the latest and greatest changes as they arrive daily in preparation of Aeon Auriga, then select the origin/auriga branch.
  
• You will get a popup about no longer being on a local branch. Press OK to continue.
  

I am not familiar with the GUI, and thus I don't know if this is really works. Would someone with more experience please post corrections?

2.1.2 Git Bash

• Start Git Bash
  
• Navigate to your XBMC installation directory (pathnames with spaces in the name require quotes around them) with the cd command. Below is the default example:
  
  Code:

  cd "/c/Program Files/XBMC/skin"
• Clone the aeon repository with the git clone command optionally followed by the directory you would like created for it. Below are some examples:
  
  Run the following command to initialize the repository into the default "aeon" directory:
  
  Code:

  git clone git://github.com/djh/aeon.git
  
  Run the following command to initialize the repository into the directory "Aeon Stark" (good for if you are updating Start and Auriga simultanously in different directories; you can run the same command again to set up the repository in "Aeon Auriga" as well):
  
  Code:

  git clone git://github.com/djh/aeon.git "Aeon Stark"
• You can now cd into the directory (or one of the directories) you created. Remember, the path needs quotes around it if it contains spaces.
  
  Code:

  cd "Aeon Stark"
• If you are content with the default main branch (that contains the stable Aeon Stark) then you can simply run git pull to make sure the repository is up to date. If you would like to use the "auriga" branch then you will need to run the following command first:
  
  Code:

  git checkout -b auriga origin/auriga
  This will change your active branch to "auriga". Now you can run git pull to download the changes from that branch.
  

You can now navigate to and run git pull from any of the directories you created with Git Bash, and the latest changes will be downloaded. Here is a screenshot of the command history I generated while building this guide:


2.1 Using Git (Ubuntu Linux)

• Open up Applications->Accessories->Terminal and navigate to the XBMC skin directory. Unless you have manually changed something you should be able to run the following command to go straight to it from wherever:
  
  Code:

  cd ~/.xbmc/skin
• Clone the aeon repository with the git clone command optionally followed by the directory you would like created for it. Below are some examples:
  
  Run the following command to initialize the repository into the default "aeon" directory:
  
  Code:

  git clone git://github.com/djh/aeon.git
  
  Run the following command to initialize the repository into the directory "Aeon Stark" (good for if you are updating Start and Auriga simultanously in different directories; you can run the same command again to set up the repository in "Aeon Auriga" as well):
  
  Code:

  git clone git://github.com/djh/aeon.git "Aeon Stark"
• You can now cd into the directory (or one of the directories) you created. Remember, the path needs quotes around it if it contains spaces.
  
  Code:

  cd "Aeon Stark"
• If you are content with the default main branch (that contains the stable Aeon Stark) then you can simply run git pull to make sure the repository is up to date. If you would like to use the "auriga" branch then you will need to run the following command first:
  
  Code:

  git checkout -b auriga origin/auriga
  This will change your active branch to "auriga". Now you can run git pull to download the changes from that branch.
  

You can now navigate to and run git pull from any of the directories you created with Git Bash, and the latest changes will be downloaded. Here is a screenshot of the command history I generated while building this guide:


3.1 Finishing Up (Fonts)
Lastly you will need to download the fonts from the 0.91 release. You can find it here. Pull the fonts folder from the zip file and copy it into any Aeon skin directories you have created previously. You should now be able to select your new skin(s)!