Commits

Steve Borho committed ceee801

More wiki pages

  • Participants
  • Parent commits 88608d9

Comments (0)

Files changed (4)

 
 TortoiseHg is a Windows shell extension and a series of applications for
 the Mercurial distributed revision control system. It also includes a
-Gnome/Nautilus extension and a standalone wrapper application so the
-TortoiseHG tools and dialogs can be used on non-Windows platforms.
+Gnome/Nautilus extension and a CLI wrapper application so the TortoiseHG tools
+and dialogs can be used on non-Windows platforms.
 
 //work in progress//
 
 
 [[ssh|PuTTY and TortoisePlink (for ssh repositories)]]
 
-[[hgtk|Standalone wrapper application hgtk]]
+[[hgtk|CLI application hgtk]]
 
 [[nautilus|Gnome Nautilus integration]]
 

File RoadMap.wiki

+=== Release 0.7 (Targeted for March, 2009):
+
+* coincide with hg-1.2 release, if possible
+* remove qct, hg-config, and PyQt from installer
+* qct features merged into internal commit tool
+* integrated record and shelve features
+* better support for copies, renames, and moves
+* improved support for bundles
+* new hgignore dialog
-= Hgtk 
+== Hgtk 
 
-TortoiseHG comes with a simple python application, hgtk, which allows you to launch the TortoiseHg dialogs on any platform that supports Python, Mercurial, and PyGtk. This is the easiest way to start using TortoiseHg on Linux and MacOSX.
+TortoiseHG comes with a simple python application, hgtk, which allows you to
+launch the TortoiseHg dialogs on any platform that supports Mercurial, and
+PyGtk. This is the easiest way to start using TortoiseHg on Linux and MacOSX.
 
-# Clone the TortoiseHg repository: hg clone http://bitbucket.org/tortoisehg/crew tortoisehg-dev
+# Clone the TortoiseHg repository: 
+{{{hg clone http://bitbucket.org/tortoisehg/crew tortoisehg-dev}}}
 # **Do NOT run setup.py, it is unnecessary**
-# Symlink the contrib/hgtk file into your path:  //ln -s ~/repos/tortoisehg-dev/contrib/hgtk ~/bin//
+# Symlink the contrib/hgtk file into your path:  
+{{{ln -s ~/repos/tortoisehg-dev/contrib/hgtk ~/bin}}}
 
-That's it. You should be able to launch any of the TortoiseHg dialogs by running: **hgtk [DIALOG]**
-Running hgtk without any arguments tells you what dialogs are available. For instance:
+That's it. You should be able to launch any of the TortoiseHg dialogs.  Running
+hgtk without any arguments tells you what dialogs are available. For instance:
 
 {{{
+# hgtk
  datamine     repository search and annotate tool
  guess		  guess renames and copies
  init         repository initialization tool
 For instance, //hgtk ci// will launch the commit dialog.
 
 
-= Using Hgtk On Windows
+== Using Hgtk On Windows
 
 If you are using a TortoiseHg binary install, hgtk.exe is already installed and in your path.
 
 If you are using TortoiseHg from a source install, then you need to create an hgtk.bat file with
 {{{
 TORTOISEHG_PATH=\path\to\tortoisehg-dev
-python location\to\hgtk %*'
+python \path\to\tortoisehg-dev\contrib\hgtk %*'
 }}}
 
-= Prerequisites
+== Prerequisites
 
-Note that TortoiseHg is developed on PyGtk2.10 and 2.12, on Mercurial versions 0.9.5 and newer, and Python 2.5. Older versions of those tools may work or they may not. Please report any problems you find as we would like to fix any simple compatibility problems that are discovered.
+Note that TortoiseHg is developed on PyGtk2.10 and 2.12, on Mercurial versions
+0.9.5 and newer, and Python 2.5. Older versions of those libraries and tools
+may work or they may not. Please report any problems you find as we would like
+to fix any simple compatibility problems that are discovered.
 
 It seems that PyGtk-2.6 is too old to run the log dialog, since it does not support cairo.

File nautilus.wiki

+== Gnome/Nautilus Integration
+The TortoiseHg nautilus extension has been tested successfully on Ubuntu 7.10,
+8.04 and Fedora 8. In theory it should work on any Gnome/Nautilus desktop.
+
+Installation steps:
+# Install python-nautilus (or equivalent package for your system, such as nautilus-python for Fedora and Centos).
+# Clone the tortoisehg-dev development branch to your machine
+# Copy the nautilus extension file into your local python-extensions directory
+# add a [tortoisehg] section to your ~/.hgrc as per the [[FAQ]].
+
+Step 1 (for debian or ubuntu) as shell command:
+{{{
+sudo apt-get install python-nautilus
+}}}
+Steps 2 and 3 as shell commands:
+{{{
+mkdir -p ~/src/ && cd ~/src
+hg clone https://bitbucket.org/tortoisehg/stable tortoisehg
+mkdir -p ~/.nautilus/python-extensions/
+cp tortoisehg/contrib/nautilus-thg.py ~/.nautilus/python-extensions/
+}}}
+
+To use the extension without restart the whole desktop, you can launch a
+different instance of nautilus using the following script (create a link to the
+script on your desktop for easy access):
+{{{
+#!/bin/sh
+export TORTOISEHG_PATH=~/src/tortoisehg/           # edit to suit
+TMPDIR=`mktemp -d -p /tmp/` nautilus --no-desktop
+}}}
+
+Note that when debugging problems with the nautilus extension, error messages are typically
+piped to ~/.xsession-errors
+
+**To have tortoishg available full time** in nautilus, export TORTOISEHG_PATH
+in ~/.profile or ~/.xprofile. (A restart of nautilus or your session is
+necessary. To restart nautilus from your current session, you will need to
+apply 'killall nautilus'.) Also note that **mercurial** must be installed in
+system wide in /usr/lib/python or someplace similar for this to work.
+
+== Caveats
+
+While the python extension interface to Nautilus is //much// cleaner than the
+same for Explorer, it also has fewer features. 
+
+The interface does not support drag-n-drop and to keep the context menus from
+being completely unwieldy, they've limited them to just the most frequently
+used tools.
+
+== TODO
+
+The nautilus integration is now stable enough to be packaged into a .deb with
+dependencies on mercurial, python-nautilus, and tortoisehg.  This just needs a
+volunteer with some debian packaging experience and some time.