Changes between Version 3 and Version 4 of BitBucket

Timestamp:

Oct 9, 2010, 9:08:58 PM (14 years ago)

Author:

Itamar Ostricher

Comment:

refactor tips

BitBucket

@@ -16 +16 @@
 Note that we maintain an official Mercurial mirror of the SubversionRepository there, see [http://bitbucket.org/edgewall/trac edgewall/trac].
 
-== Windows Tips
-First thing, you will need a Mercurial client.
+== Basic Mercurial Setup
+Obviously, you will need a Mercurial client:
 - The "raw" command-line client can be downloaded here: http://mercurial.selenic.com/
-- A GUI client also exists, surprisingly named [http://tortoisehg.bitbucket.org/ TortoiseHG]
+- A GUI client for Windows also exists, surprisingly named [http://tortoisehg.bitbucket.org/ TortoiseHG]
 
 It is considered Good Practice to first get things working with command-line, before moving to GUI-based solutions.
 
-=== Basic configuration
-You will need to create a configuration file:
-- On Windows XP and earlier, create `C:\Documents and Settings\USERNAME\Mercurial.ini`
-- On Windows Vista and newer, create `C:\Users\USERNAME\Mercurial.ini`
+Once the client is installed, some basic configuration is in order. Create the global configuration file, depending on your platform:
+- On Windows XP and earlier: `C:\Documents and Settings\USERNAME\Mercurial.ini`
+- On Windows Vista and newer: `C:\Users\USERNAME\Mercurial.ini`
+- TODO: Other OS?
 
-Important settings for working with the Trac Mercurial mirror:
+This configuration file is ini-style.
+Important settings for working with the Trac BitBucket mirror:
 {{{
 #!ini
@@ -36 +37 @@
 graphlog = 
 ; See below concerning external extensions
-hgsvnutils = \path\to\HgExts\HgSvnUtils\HgSvnUtils.py
+hgsvnutils = /path/to/HgExts/HgSvnUtils/HgSvnUtils.py
 
 [diff]
@@ -45 +46 @@
 For details on the concept of extensions see http://mercurial.selenic.com/wiki/UsingExtensions
 
-An important external extensions for Trac development with Mercurial is the [http://rc.c-space.org/hg/HgSvnUtils HgSvnUtils] extension (maintained by RemyBlank).
+An important external extension for Trac development with Mercurial is the [http://rc.c-space.org/hg/HgSvnUtils HgSvnUtils] extension (maintained by RemyBlank).
 
 To install it, go to some local directory and run (from command-line)
@@ -59 +60 @@
 - Using `https://USERNAME@bitbucket.org/USERNAME/reponame` over SSL (built-in support in the Mercurial client); or
 - Using `ssh://hg@bitbucket.org/USERNAME/reponame` over SSH (note that this uses `hg` as username!)[[BR]]
-  For this you will need `ssh` client, which is not native to Windows, as well as setting up SSH keys and uploading the public key to your BitBucket account. You may obtain a `ssh` client for Windows (like `plink.exe`), but why bother..?
+  For this you will need `ssh` client and SSH key-pair
+  - See http://confluence.atlassian.com/display/BITBUCKET/Using+SSH+to+Access+your+Bitbucket+Repository for instructions
+  - If you're on Linux, you probably already have `ssh` and keys, so good for you.
+  - If you're on Windows, `ssh` is not native. You may obtain a `ssh` client for Windows (like `plink.exe`), but why bother, when you have the SSL option?