ContributingToLibarchiveInGithub

Table of Contents Introduction Forking Cloning Other Guides

Introduction

This page serves as a quick guide for anyone new to github and wants to contribute to libarchive. For a quick guide on how to use git in general, see http://gitref.org/.

Forking

The first thing you should do is create a fork of libarchive via Github's web interface.

1. Go to https://github.com/libarchive/libarchive
2. At the top of the page, you should see a button that says Fork. Click this button.
3. A popup will appear asking Where do you want to fork this to? Click the button that says Fork to <username> where username is your account name in github.
4. A progress page will appear showing the progress of the forking processing. After the forking is done, the page will refresh to a page of your newly created fork of libarchive under your username.

Cloning

Next, you will of course need to clone the newly created fork down to your system. The next lines will show how to clone your fork and then add the main libarchive repository as a "remote" repository in your cloned repository.

1. Go to your fork's webpage, i.e. https://github.com/<username>/libarchive
2. Somewhere at the top of the page, you should see three buttons with the labels "SSH", "HTTP", and "Git Read-Only" followed by a URL. Assuming you want to use SSH, click the "SSH" button, then copy the URL.
3. In a terminal, 'cd' into a directory where you want the libarchive clone to reside.
4. Run the command 'git clone [email protected]:<username>/libarchive.git'.
5. 'cd' into the newly cloned repository, i.e. 'cd libarchive'.
6. Add the main libarchive repository as a "remote", i.e. 'git remote add libarchive [email protected]:libarchive/libarchive.git'.
7. Fetch the sources from the newly added "remote", i.e. 'git fetch libarchive'.

Other Guides

Here are some other guides that may be useful in getting initiated development of libarchive in Github.

• Setting up git
• Forking a repo