2008-08-04T18:31:22Z

Changed instuctions to use ssh 106 Usinghg-unixmac 14

[[Home|» Project Kenai Documentation and Training]]    [[Howdoi|» How Do I ...]]    [[SourceControl#About_Mercurial|» Source Code Management]] ==Using Mercurial on UNIX and Mac Systems== Once you have a <a href="SourceControl#About_Mercurial">Mercurial client</a> installed on your local system, you can check out code and check it back into your project repository. The following instructions for command-line Mercurial should get you started. For full instructions on using Mercurial, see [http://hgbook.red-bean.com/]. '''Note:''' Because of better security and better handling of large files, it's best to use the SSH protocol to check files into your project repository. Before using SSH with Project Kenai, you have to generate an SSH key pair and save the public key to the [[ProfileSettings#SSH_Keys|SSH Keys tab]] in your user profile. For more information on generating SSH keys, see [[GeneratingAnSSHKey|Generating an SSH Key]]. # To initially set up your kenai.com repository, you need to know the name of the project and the name of the source repository. For example, for a project named <tt>bluebird</tt> with a Mercurial repository named <tt>bluebird~mercurial-code-repository</tt>, the secure read-write URL would be: <tt>  <nowiki>ssh://</nowiki>''your-username''<nowiki>@hg.kenai.com/bluebird~mercurial-code-repository</nowiki></tt> # Change directories to where you want your new hg repository directory to be created, then do the initial clone and create: <tt> > cd ~</tt> <tt> > hg clone <nowiki>ssh://</nowiki>''your-username''<nowiki>@hg.kenai.com/bluebird~mercurial-code-repository</nowiki> bluebird-hg</tt> # Change directories to the new directory: <tt> > cd bluebird-hg</tt> # Copy a file to the local working copy and then add it in hg. <tt> > cp ~/myjavafiles/helloworld.java helloworld.java</tt> <tt> > hg add helloworld.java</tt> # Commit the file to the local repository. <tt> > hg commit -m"First commit to bluebird repository" helloworld.java</tt> # Pull any changes from the server repository: <tt> > hg pull </tt> # Update the local working copy: <tt> > hg update</tt> # Check the file into your project repository on the server: <tt> > hg push</tt> # When the system accepts your entries, you see the following responses for the initial <tt>helloworld.java</tt> checkin: <tt> adding changesets</tt> <tt> adding manifests</tt> <tt> adding file changes</tt> <tt> added 1 changesets with 1 changes to 1 files</tt>

<a href='<?url_for_page Home?>' class='internal'>» Project Kenai Documentation and Training</a>    <a href='<?url_for_page Howdoi?>' class='internal'>» How Do I ...</a>    <a href='<?url_for_page SourceControl?>#About_Mercurial' class='internal'>» Source Code Management</a> <h2><a name='Using_Mercurial_on_UNIX_and_Mac_Systems'></a>Using Mercurial on UNIX and Mac Systems</h2> Once you have a <a href="SourceControl#About_Mercurial">Mercurial client</a> installed on your local system, you can check out code and check it back into your project repository. The following instructions for command-line Mercurial should get you started. For full instructions on using Mercurial, see <a class='external' href="http://hgbook.red-bean.com/">http://hgbook.red-bean.com/</a>. Note: Because of better security and better handling of large files, it's best to use the SSH protocol to check files into your project repository. Before using SSH with Project Kenai, you have to generate an SSH key pair and save the public key to the <a href='<?url_for_page ProfileSettings?>#SSH_Keys' class='internal'>SSH Keys tab</a> in your user profile. For more information on generating SSH keys, see <a href='<?url_for_page GeneratingAnSSHKey?>' class='internal'>Generating an SSH Key</a>. <ol><li> To initially set up your kenai.com repository, you need to know the name of the project and the name of the source repository. For example, for a project named <tt>bluebird</tt> with a Mercurial repository named <tt>bluebird~mercurial-code-repository</tt>, the secure read-write URL would be: <tt>  ssh://your-username@hg.kenai.com/bluebird~mercurial-code-repository</tt></li><li> Change directories to where you want your new hg repository directory to be created, then do the initial clone and create: <tt> > cd ~</tt> <tt> > hg clone ssh://your-username@hg.kenai.com/bluebird~mercurial-code-repository bluebird-hg</tt></li><li> Change directories to the new directory: <tt> > cd bluebird-hg</tt></li><li> Copy a file to the local working copy and then add it in hg. <tt> > cp ~/myjavafiles/helloworld.java helloworld.java</tt> <tt> > hg add helloworld.java</tt></li><li> Commit the file to the local repository. <tt> > hg commit -m"First commit to bluebird repository" helloworld.java</tt></li><li> Pull any changes from the server repository: <tt> > hg pull </tt></li><li> Update the local working copy: <tt> > hg update</tt></li><li> Check the file into your project repository on the server: <tt> > hg push</tt></li><li> When the system accepts your entries, you see the following responses for the initial <tt>helloworld.java</tt> checkin: <tt> adding changesets</tt> <tt> adding manifests</tt> <tt> adding file changes</tt> <tt> added 1 changesets with 1 changes to 1 files</tt></li></ol>

2009-06-29T23:38:46Z