gaim/www

Instructions for running wingaim from a USB Drive.

2005-09-20, Daniel Atallah
7a9be40f80e0
Parents 933e7ceb7c66
Children 142b27a53cc2
Instructions for running wingaim from a USB Drive.
1 files changed, 35 insertions(+), 1 deletions(-)
  • +35 -1
    htdocs/win32/index.php
    • --- a/htdocs/win32/index.php Tue Sep 20 18:36:16 2005 -0400
    +++ b/htdocs/win32/index.php Tue Sep 20 22:06:45 2005 -0400
    @@ -26,6 +26,7 @@
    <li><a href="#tcl">TCL Plugin Support</a></li>
    <li><a href="#debug">Windows Gaim Crash Reporting - Howto</a></li>
    <li><a href="build.php">Windows Gaim Build Instructions</a></li>
    +<li><a href="#portable">Running Gaim from a USB Drive</a></li>
    </ul>
    <h2 id="faq">Windows Gaim FAQ</h2>
    @@ -139,4 +140,37 @@
    <h2 id="debug">Debugging Windows Gaim</h2>
    <h3>What to do if Gaim crashes</h3>
    <p>First make sure that you are not affected by 'Dll Hell' as described above. Download and install the <a href="http://prdownloads.sourceforge.net/gaim/gaim-<?php print $current_win32_version; ?>-debug.exe">debug version of WinGaim <?php print $current_win32_version; ?></a>. The next time you run Gaim and it crashes, the call stack will be dumped to <code>gaim.RPT</code> in your Gaim install dir. When submitting a bug report, give a detailed description on how to produce your bug and attach the most recent crash dump from your <code>gaim.RPT</code> file.</p>
    -
    +<p>Caveats
    +<ul>
    + <li>SpellChecking doesn't work yet, it requires some minor changes that aren't in a released version of Gaim yet.</li>
    +</ul>
    +</p>
    +<h2 id="portable">Running Windows Gaim From a USB Drive</h2>
    +<p>It is relatively easy to set up Gaim to run from a USB Drive. Most of Gaim is very good about not assuming that it is installed; a slightly customized launcher makes it all easy.</p>
    +<p>The way that this is set up, other GTK+ applications can use the same GTK+ runtime.</p>
    +<h3>How to setup your USB-Drive Gaim</h3>
    +<ul>
    + <li>Download and Install Gaim</li>
    + <li>Prepare your USB Drive: (This assumes that your drive is <code>U:</code> for the purpose of explanation)
    + <ul>
    + <li>Create a directory: <code>U:\Programs</code> (This can be whatever you want, the idea is that (GTK and Gaim are at the same level)</li>
    + <li>Create <code>GTK</code> and <code>Gaim</code> directories in this directory.
    + </ul>
    + </li>
    + <li>Copy a minimal part of your Gaim installation to the USB Drive from the installed instance of Gaim. The directory stucture stays the same, but we don't need everything that is included in the standard installation.
    + <ul>
    + <li>Copy the whole <code>pixmaps</code> and <code>sounds</code> directories.</li>
    + <li>Create a <code>U:\Programs\Gaim\plugins</code> directory and copy the contents of the installed <code>Gaim\plugins</code> directory into it excluding <code>perl.dll</code>, <code>tcl.dll</code>.</li>
    + <li>If you want to use a language other than en_US, create a <code>U:\Programs\Gaim\locale</code> directory and copy any language directories that you want from your installed <code>Gaim\locale</code> directory.</li>
    + <li>Copy the contents of your root installed Gaim directory except <code>gaim.exe</code>, and if you don't want spellchecking support, <code>libgtkspell.dll</code>.</li>
    + <li>Download <a href="gaim-portable.exe">gaim-portable.exe</a> and put it in <code>U:\Programs\Gaim</code>. The file uses the same source as the standard <code>gaim.exe</code> from versions 2.0.0 and newer, the difference being that when it was compiled <code>PORTABLE</code> was defined which causes some of the initialization to be done differently.<li>
    + </ul>
    + </li>
    + <li>In the same spirit, create a minimal GTK+ runtime installation from your GTK+ installation.
    + <ul>
    + <li>Copy the <code>bin</code>, <code>etc</code> and <code>lib</code> directories to your <code>U:\Programs\GTK</code> directory.<li>
    + <li>If you want to use a language other than en_US, create a <code>U:\Programs\GTK\locale</code> directory and copy any language directories that you want from your installed GTK+ runtime's <code>locale</code> directory.</li>
    + </ul>
    + </li>
    + <li>You are done! Running <code>U:\Programs\Gaim\gaim-portable.exe</code> will cause gaim to run off the USB Drive, saving the settings, logs and etc. to <code>U:\Programs\.gaim</code>.<li>
    +</ul>