Menu
▾
▴
[Gaim-commits] SF.net SVN: gaim: [17421] web/htdocs/sean/posts/gaim-text.txt
|
From: <sea...@us...> - 2006-10-04 02:49:22
|
Revision: 17421
http://svn.sourceforge.net/gaim/?rev=17421&view=rev
Author: seanegan
Date: 2006-10-02 15:16:13 -0700 (Mon, 02 Oct 2006)
Log Message:
-----------
gaim-text post from sadrul
Added Paths:
-----------
web/htdocs/sean/posts/gaim-text.txt
Added: web/htdocs/sean/posts/gaim-text.txt
===================================================================
--- web/htdocs/sean/posts/gaim-text.txt (rev 0)
+++ web/htdocs/sean/posts/gaim-text.txt 2006-10-02 22:16:13 UTC (rev 17421)
@@ -0,0 +1,252 @@
+gaim-text
+
+<p>Following up on my last e-mail, Sadrul wrote me with a more thorough description of gaim-text
+and the UI library it uses. I'll be posting follow-ups for other Summer of Code projects soon!
+</p>
+
+<p>
+Hi! I am Sadrul, and I am going to talk about gaim-text. gaim-text is a text-frontend for Gaim. It
+uses libgaim for the IM-services, and libgnt for the UI widgets. gaim-text was developed for
+Google's Summer of Code 2006 program.
+</p>
+
+<h3>Overview</h3>
+
+<p>
+I tried to make sure gaim-text looks pretty close to Gaim to make sure a Gaim user can easily use
+gaim-text without having to go through a steep learning curve. There are buttons, textboxes, windows
+etc. which closely resemble the same widgets in GTK+ (the toolkit used by Gaim). So a user should
+feel at home with the environment (more on this later).
+</p>
+
+<h4>Buddy List</h4>
+<p>
+When you start gaim-text, it starts with the buddy-list window.
+You can expand/collapse the selected group or contact by pressing the space-bar. If you want to
+start a conversation with a buddy, then simply select the buddy and press Return. You can use the
+menu-key (right-click key) to show a context menu for the selected buddy/contact/chat/group. This
+context menu allows you to start chat with a buddy, get information about the buddy, add a new
+buddy/chat in the group etc.
+</p>
+
+<center>
+<pre><span style="background:#efefef;color:#000000">- GaimDudes </span><span style="background:#000000;color:#00adad">^</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#efefef">(<a href="mailto:sa...@ir..." target="_blank">sa...@ir...</a> -- IRC)</span><span style="background:#efefef;color:#000000">|--------[X] </span>
+<span style="background:#efefef;color:#adad00"> <b><u><b></b></u></b></span><span style="background:#adad00;color:#efefef"> </span><span style="background:#efefef;color:#adad00"> Bleeter Yaluser </span><span style="background:#efefef;color:#000000"> | </span><span style="background:#000000;color:#00adad"> </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> deryni9 </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#adad00"> <b><u><b></b></u></b></span><span style="background:#adad00;color:#efefef"> </span><span style="background:#efefef;color:#adad00"> ecoffey </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> grim elite </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> MarkDoliner </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#adad00"> <b><u><b></b></u></b></span><span style="background:#adad00;color:#efefef"> </span><span style="background:#efefef;color:#adad00"> nathan walp </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> PacoPaco31 </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> r0bby </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> SeanEgn </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#0000ad;color:#efefef">- Meself </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">+----|</span><span style="background:#000000;color:#efefef">Meself</span><span style="background:#efefef;color:#000000">|----+ </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> Adil SHC |</span><span style="background:#000000;color:#00adad">Add Buddy </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> asd |Add Chat </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> Booya |Add Group </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000"> <b><u><b></b></u></b></span><span style="background:#000000;color:#efefef"> </span><span style="background:#efefef;color:#000000"> Krusty </span><span style="background:#000000;color:#00adad">v</span><span style="background:#efefef;color:#000000">|Rename </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">+--------------------+|Remove </span><span style="background:#000000;color:#00adad"> </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad"> </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">|Away |v|+----------------+</span><span style="background:#000000;color:#000000"> </span><span style="background:#000000;color:#00adad">_________________________</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">+--------------------+ </span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000">-------------------------+</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#000000;color:#00adad">"For me to poop on"___</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#0000ad;color:#efefef">Buddy List</span><span style="background:#efefef;color:#000000">|#gaim (sad|#guificati|#ion (sadr|#gaim-comm|#gaim-test (s</span>
+
+</pre>
+<i>Context menu for a group</i>
+</center>
+
+<h4>Status Selector</h4>
+<p>
+There is a status-selector at the bottom of the buddy-list window which you can use to set your
+status. Selecting 'New...' will bring up a dialog to set a new custom status. Selecting 'Saved...'
+will bring up a dialog with all the previously-saved statuses which you can use to change your
+status.
+</p>
+
+<h4>Conversation Windows</h4>
+<p>
+Each conversation has its own window in gaim-text, unlike Gaim where you can group conversations in
+tabbed windows. However, in gaim-text, it is possible to write plugins which will manage the conversation
+windows to closely resemble the same functionality (more on this later).
+</p>
+<p>
+
+The textbox in which you type your messages is single-line. Right now, there is no support for
+entering multi-line messages. However, the text-boxes do have other useful features, like
+tab-completion, and history (ctrl+up/down to use previous messages).
+</p>
+
+<center>
+<pre><span style="background:#efefef;color:#000000">+------------|</span><span style="background:#0000ad;color:#efefef">#gaim (<a href="mailto:sa...@ir..." target="_blank">sa...@ir...</a> -- IRC)</span><span style="background:#efefef;color:#000000">|-----------[X] </span>
+<span style="background:#efefef;color:#000000">|</span><span style="background:#efefef;color:#adad00">on). </span><span style="background:#000000;color:#00adad">^</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">|</span><span style="background:#efefef;color:#adad00">(20:36:50) <b></b></span><span style="background:#efefef;color:#000000">ForlornPenguin: I recind my question about raping the |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">| GPL, and replace it with the statement that I believe that the |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">|shareware version of x-chat is an illegal violation of the GPL. |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">|</span><span style="background:#efefef;color:#adad00">(20:37:47) <b></b></span><span style="background:#efefef;color:#000000">kyevan: Gaim's bonjour doesn't work very well. Or is |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">|+--------------+ bonjour chat system sucks? |</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">||</span><span style="background:#000000;color:#00adad">sadrul </span><span style="background:#efefef;color:#000000">|<b>ere: </b>ours needs work. patches welcome |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">||seanegan </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|<b>n: </b>Or does the implimentation used by iChat and |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">||seph </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|.3 not work very well? |</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">||Sgeo </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|<b>n: </b>LSchiere: well, I don't really have the skill |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">||siege </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|on it :( |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">||SimGuy |</span><span style="background:#efefef;color:#adad00"> [n=<a href="mailto:ge...@ba..." target="_blank">geoff@bas2-ottawa23-1177884781<WBR>.dsl.bell.ca</a>] </span><span style="background:#efefef;color:#000000"> |</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">||Singularity |</span><span style="background:#efefef;color:#adad00">. </span><span style="background:#efefef;color:#000000"> |</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">||slaytanic </span><span style="background:#000000;color:#00adad">v</span><span style="background:#efefef;color:#000000">|</span><span style="background:#efefef;color:#adad00">ar left the room (quit: Remote closed the connec</span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">|+--------------+</span><span style="background:#efefef;color:#adad00"> </span><span style="background:#000000;color:#00adad"> </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">|</span><span style="background:#0000ad;color:#efefef">s</span><span style="background:#efefef;color:#0000ad">_</span><span style="background:#0000ad;color:#efefef">______________________________<WBR>______________________________<WBR>___</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">+-----------------------------<WBR>------------------------------<WBR>------+</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#0000ad;color:#efefef">#gaim (sadrul@ir</span><span style="background:#efefef;color:#000000">|#guifications (s|#ion (sadrul@irc|#gaim-commits (sa</span>
+</pre>
+<i>Tab-completion in entry boxes</i>
+</center>
+<h4>Accounts Window</h4>
+<p>
+You can add, delete or modify accounts from the accounts window, just like Gaim. Take a look at the
+screenshot:
+</p>
+<center>
+<pre><span style="background:#efefef;color:#000000">+----------|</span><span style="background:#000000;color:#efefef">#gaim-test (<a href="mailto:sa...@ir..." target="_blank">sa...@ir...</a> -- IRC)</span><span style="background:#efefef;color:#000000">|--------[X] </span>
+
+<span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#00adad"> </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">| +-----------------------|</span><span style="background:#0000ad;color:#efefef">Accounts</span><span style="background:#efefef;color:#000000">|---------------------[X] </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">| |You can enable/disable accounts from the following list.|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">| | ------------------------------<WBR>------------------------ |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">| |[ ] adil040 |Yahoo </span><span style="background:#000000;color:#00adad"> </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">| |[ ] <a href="mailto:adi...@ho..." target="_blank">adi...@ho...</a> |MSN </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">| |</span><span style="background:#0000ad;color:#efefef">[X] <a href="http://im...@gm.../Gaim" target="_blank">im...@gm.../Gaim</a> |Jabber </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">| |[X] <a href="mailto:sa...@ir..." target="_blank">sa...@ir...</a> |IRC |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">| |[X] gaim_adil |Yahoo |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">| |[ ] <a href="http://sa...@ja.../Gaim" target="_blank">sa...@ja.../Gaim</a> |Jabber </span><span style="background:#000000;color:#00adad">v</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">| | ------------------------------<WBR>------------------------ |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">| | +-----+ +--------+ +--------+ |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">|</span><span style="background:#efefef;color:#adad00">(20</span><span style="background:#efefef;color:#000000">| | Add |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> | Modify |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> | Delete |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#adad00"> </span><span style="background:#000000;color:#00adad">#</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">|</span><span style="background:#efefef;color:#adad00">[ B</span><span style="background:#efefef;color:#000000">| +-----+</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> +--------+</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> +--------+</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> |</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#adad00"> </span><span style="background:#000000;color:#00adad"> </span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#00adad">___</span><span style="background:#efefef;color:#000000">| </span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> |</span><span style="background:#000000;color:#000000"> </span><span style="background:#000000;color:#00adad">___</span><span style="background:#efefef;color:#000000">|</span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">+---+-------------------------<WBR>------------------------------<WBR>-+</span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000">---+</span><span style="background:#000000;color:#000000"> </span>
+
+<span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#000000"> </span><span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000"> </span><span style="background:#000000;color:#000000"> </span>
+<span style="background:#efefef;color:#000000">#gaim (sad|#guificati|#ion (sadr|#gaim-comm|</span><span style="background:#0000ad;color:#efefef">Accounts </span><span style="background:#efefef;color:#000000">|#gaim-test (s</span>
+</pre>
+<i>Accounts window</i>
+</center>
+
+<h4>Plugins</h4>
+<p>
+gaim-text also has a plugin-window where you can enable/disable plugins. Note that there many
+UI-specific plugins for gaim, which, obviously, will not work in gaim-text. However, there are a lot of
+UI-independent plugins, which can be used with gaim-text.
+</p>
+<p>
+There are also a few gnt-plugins which can be use by gaim-text. The gnt-plugins use libgnt for its
+ui. If you are an interested developer, you should be able to convert many GTK-plugins into
+gnt-plugins without too much trouble.
+</p>
+
+
+<h3>Gaim Ncurses Toolkit (GNT) Environment</h3>
+<p>
+Now let's talk about the toolkit used by gaim-text. The toolkit is called 'Gaim Ncurses Toolkit', or
+'GLib Ncurses Toolkit'. It was developed as part of the Google Summer of Code project along with gaim-text. This
+toolkit provides a set of UI elements, which you can use with event callbacks, much like how GTK+
+widgets are used.
+</p>
+
+<h4>Keyboard Shortcuts</h4>
+
+<p>
+Here's a list of shortcuts that you will find useful while using gaim-text:
+<ul>
+ <li>Alt + a: Brings up a list of available actions. You can use this to open the accounts window,
+ plugins window, preferences window etc.</li>
+ <li>Alt + w: Brings up a list of open windows to quickly switch between windows.</li>
+ <li>Alt + d: Dump the contents of the screen into "dump.html" (that's how the screenshots in
+ this page were created.)</li>
+ <li>Alt + m: This allows you to move a window.</li>
+
+ <li>Alt + r: This allows you to resize a window.</li>
+ <li>Alt + n: Switch to the next window.</li>
+ <li>Alt + p: Switch to the previous window.</li>
+ <li>Alt + c: Close the current window.</li>
+ <li>Alt + q: Quit.</li>
+ <li>Alt + ,: Move the position of the window one place to the left.</li>
+
+ <li>Alt + .: Move the position of the window one place to the right.</li>
+ <li>Alt + 1 2 ...0: Jump to the 1st, 2nd ... 10th window.</li>
+ <li>Ctrl + o: Bring up the menu for a window if it has one. (Note: currently only the buddylist
+ has a menu).
+</li></ul>
+</p>
+
+<h4>Configuration Script</h4>
+<p>
+You can configure some settings in the environment by setting the appropriate options in ~/.gntrc.
+For example, you can enable shadows in the windows, enable mouse support, use a window manager etc.
+using the file.
+</p>
+
+<h4>Window Manager</h4>
+<p>
+To manage all the windows, libgnt uses a window manager. The default window manager is <i>very</i>
+naive. However, gaim-text comes with a simple custom window manager as a sample. A custom window
+manager is able to control the size, position, appearance of the windows. It can also change the
+default behaviour of the keystrokes, mouse-events etc.
+</p>
+<p>
+To use a custom window-manager, set the following option in ~/.gntrc:
+<pre>
+[general]
+wm = /path/to/custom/wm.so
+</pre>
+</p>
+
+<h4>Mouse Support</h4>
+
+<p>
+You can enable mouse support by setting
+<pre>
+[general]
+mouse = 1
+</pre>
+in ~/.gntrc. The mouse support will work if your version of ncurses/ncursesw is not too old. The mouse
+support includes clicking on a window to gain focus, click on buttons to activate, drag-n-drop to
+move a window etc. Note that although quite useful, the mouse support is still experimental, and
+patches to improve the functionalities are always welcome.
+</p>
+
+<h4>Others</h4>
+<p>
+Do a `man gaim-text` to see how you can add more options in ~/.gntrc.
+</p>
+
+<h3>Contributing</h3>
+
+<p>
+There are quite a few places in both gaim-text and libgnt that can use improvements. For example, a
+multi-line input-box can be useful. The mouse support can also be extended. A more robust
+window-manager would be cool. If you are interested, feel most welcome to jump in and start
+hacking! There are a few small test applications included that you can take a look at to get started. I
+will also be happy to reply to any questions you may have about gaim-text or/and libgnt.
+</p>
Property changes on: web/htdocs/sean/posts/gaim-text.txt
___________________________________________________________________
Name: svn:mime-type
+ text/html
Name: svn:eol-style
+ native
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
