# HG changeset patch # User Mark Doliner # Date 1158560436 0 # Node ID bcf89a7c69db59a99a23e470cd4cf4751e954add # Parent 1f7581a5d2b8d36ec93c4e13001ae90ae9db33b3 [gaim-migrate @ 17309] Rename the gntgaim executable to gaim-text I feel like this is much more clear to end users, who will probably have no idea what gnt is. committer: Tailor Script diff -r 1f7581a5d2b8 -r bcf89a7c69db ChangeLog --- a/ChangeLog Mon Sep 18 04:40:45 2006 +0000 +++ b/ChangeLog Mon Sep 18 06:20:36 2006 +0000 @@ -5,7 +5,7 @@ * With the Core/UI split completed, it is now possible to build Gaim without any UIs, creating a libgaim library upon which other UIs may be constructed - * A new ncurses-based console UI called gntgaim is now available + * A new ncurses-based console UI called gaim-text is now available (Sadrul Habib Chowdhury, Google Summer of Code) * Reorganized the source tree to split apart the code for the UI changes and libgaim targets diff -r 1f7581a5d2b8 -r bcf89a7c69db configure.ac --- a/configure.ac Mon Sep 18 04:40:45 2006 +0000 +++ b/configure.ac Mon Sep 18 06:20:36 2006 +0000 @@ -3,6 +3,7 @@ AC_CANONICAL_SYSTEM AM_CONFIG_HEADER(config.h) AM_INIT_AUTOMAKE(AC_PACKAGE_NAME, AC_PACKAGE_VERSION) +#AM_INIT_AUTOMAKE([foreign dist-bzip2]) AC_PREREQ([2.50]) @@ -1848,7 +1849,7 @@ gaim.service doc/Makefile doc/gaim.1 - doc/gntgaim.1 + doc/gaim-text.1 m4macros/Makefile gtk/Makefile gtk/pixmaps/Makefile diff -r 1f7581a5d2b8 -r bcf89a7c69db console/Makefile.am --- a/console/Makefile.am Mon Sep 18 04:40:45 2006 +0000 +++ b/console/Makefile.am Mon Sep 18 06:20:36 2006 +0000 @@ -2,9 +2,9 @@ SUBDIRS = libgnt plugins -bin_PROGRAMS = gntgaim +bin_PROGRAMS = gaim-text -gntgaim_SOURCES = \ +gaim_text_SOURCES = \ gntaccount.c \ gntblist.c \ gntconn.c \ @@ -18,7 +18,7 @@ gntstatus.c \ gntui.c -gntgaim_headers = \ +gaim_text_headers = \ gntaccount.h \ gntblist.h \ gntconn.h \ @@ -32,13 +32,13 @@ gntstatus.h \ gntui.h -gntgaimincludedir=$(includedir)/gaim/gnt -gntgaiminclude_HEADERS = \ - $(gntgaim_headers) +gaim_textincludedir=$(includedir)/gaim/gnt +gaim_textinclude_HEADERS = \ + $(gaim_text_headers) -gntgaim_DEPENDENCIES = @LIBOBJS@ $(STATIC_LINK_LIBS) -gntgaim_LDFLAGS = -export-dynamic -gntgaim_LDADD = \ +gaim_text_DEPENDENCIES = @LIBOBJS@ $(STATIC_LINK_LIBS) +gaim_text_LDFLAGS = -export-dynamic +gaim_text_LDADD = \ @LIBOBJS@ \ $(DBUS_LIBS) \ $(STATIC_LINK_LIBS) \ diff -r 1f7581a5d2b8 -r bcf89a7c69db console/gntgaim.c --- a/console/gntgaim.c Mon Sep 18 04:40:45 2006 +0000 +++ b/console/gntgaim.c Mon Sep 18 06:20:36 2006 +0000 @@ -245,7 +245,7 @@ } /* show version message */ if (opt_version) { - printf("gntgaim %s\n", VERSION); + printf("gaim-text %s\n", VERSION); return 0; } diff -r 1f7581a5d2b8 -r bcf89a7c69db doc/Makefile.am --- a/doc/Makefile.am Mon Sep 18 04:40:45 2006 +0000 +++ b/doc/Makefile.am Mon Sep 18 06:20:36 2006 +0000 @@ -1,4 +1,4 @@ -man_MANS = gaim.1 gntgaim.1 +man_MANS = gaim.1 gaim-text.1 EXTRA_DIST = \ C-HOWTO.dox \ @@ -14,7 +14,7 @@ dbus-server-signals.dox \ gaim.1.in \ gaims_funniest_home_convos.txt \ - gntgaim.1.in \ + gaim-text.1.in \ gtkaccount-signals.dox \ gtkblist-signals.dox \ gtkconv-signals.dox \ diff -r 1f7581a5d2b8 -r bcf89a7c69db doc/gaim-text.1.in --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/gaim-text.1.in Mon Sep 18 06:20:36 2006 +0000 @@ -0,0 +1,287 @@ +.\" Copyright (c) 2006, Sadrul Habib Chowdhury +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, +.\" USA. +.TH gaim-text 1 +.SH NAME +GntGaim \- A Pimpin' Penguin console frontend for Instant Messaging client Gaim. +.SH SYNOPSIS +.TP 5 +\fBgaim-text \fI[options]\fR + +.SH DESCRIPTION +.PP +\fBgaim-text\fR is a console-based modular messaging client capable of using +AIM, MSN, Yahoo!, Jabber, ICQ, IRC, SILC, Novell GroupWise, Lotus Sametime, +Zephyr, Gadu-Gadu, and QQ all at once. It has many common features found in +other clients, as well as many unique features. Gaim is not endorsed by or +affiliated with America Online, ICQ, Microsoft, or Yahoo. + +.SH OPTIONS +The following options are provided by \fBgaim-text\fR using the standard GNU +command line syntax: +.TP +.B \-d, \-\-debug +Print debugging messages to stderr and start with the \fBDebug\fR window. The +messages shown in the \fBDebug\fR window are the same as the ones printed in +stderr. +.TP +.B \-c, \-\-config=\fIDIR\fB +Use \fIDIR\fR as the directory for config files instead of \fI~/.gaim\fR. +.TP +.B \-h, \-\-help +Print this help and exit. +.TP +.B \-n, \-\-nologin +Don't automatically login when \fBgaim-text\fR starts. Sets all accounts to +Offline. +.TP +.B \-v, \-\-version +Display the version information window. + +.SH GNT Shortcuts +You can use the following shortcuts: +.TP +.B Alt \+ n +Go to the next window. +.TP +.B Alt \+ p +Go to the previous window. +.TP +.B Alt \+ w +Show the list of windows. You can select and jump to any window from the list. +.TP +.B Alt \+ c +Close the current window. +.TP +.B Alt \+ q +Quit. +.TP +.B Alt \+ m +Start moving a window. Press the cursor keys to move the window. When you are +done, press \fBEnter\fR or \fBEscape\fR. +.TP +.B Alt \+ r +Start resizing a window. Press the cursor keys to resize the window. When you +are done, press \fBEnter\fR or \fBEscape\fR. +.TP +.B Alt \+ d +Dump the contents of the screen in HTML format in a file named "dump.html" in +working directory. +.TP +.B Alt \+ . +Move the position of the current window in the window list one place to the +right. +.TP +.B Alt \+ , +Move the position of the current window in the window list one place to the +left. +.TP +.B Alt \+ l +Refresh the windows. This is useful after resizing the terminal window. +.TP +.B Alt \+ 1 2 ... 0 +Jump to the 1st, 2nd ... 10th window. + +.SH FILES +\fI~/.gntrc\fR: configuration file for gnt applications. +.br +.TP +A sample file looks like: +.br +[general] +.br +shadow = 0 +.br +# There is experimental mouse support +.br +mouse = 1 +.br +# To use some custom window-manager +.br +wm = /usr/local/lib/gaim/s.so +.br + +.br +[colors] +.br +# The RGB values range in [0, 1000] +.br +black = 0; 0; 0 +.br +red = 1000; 0; 0 +.br +green = 0; 1000; 0 +.br +blue = 250; 250; 700 +.br +white = 1000; 1000; 1000 +.br +gray = 700; 700; 700 +.br +darkgray = 256; 256; 256 +.br + +.br +[colorpairs] +.br +normal = white; black +.br +highlight = white; blue +.br +highlightd = black; gray +.br +shadow = black; darkgray +.br +title = white; blue +.br +titled = white; gray +.br +text = white; blue +.br +disabled = gray; black +.br + +.br +# Remap some keys for GntEntry +.br +[GntEntry::remap] +.br +# Remap the up-arrow to the left-arrow +.br +^[[A = ^[[D +.br +# Remap the down-arrow to the right-arrow +.br +^[[B = ^[[C +.br +# Remap 'a' to 'bcd' +.br +a = bcd +.br +# Completely ignore the key 'q' +.br +q = +.br +# But the following will NOT work +.br +#abc = bcd +.br + +# Hitting 'space' will activate a button +.br +[GntButton::remap] +.br +\\ = \\r +.br + +.SH Mouse Support +There is experimental mouse support. You can focus windows, activate buttons, +select rows in a list, scroll using the wheel-scroll etc. Mouse support is +disabled by default, so you need to enable it in ~/.gntrc (see the sample +above). + +.SH Window Management +The default window management is very limited. But it is possible to write +custom window managers to suit your needs. There is a sample window-manager +included (named \fIs.so\fR) which adds a little 'close-button' for the windows, +removes the borders from the buddylist and pops up new windows in the middle of +the screen, instead of at the upper-left corder. It is provided as a sample +simple manager, but it should be possible to write more complex managers, and +it's very possible that the window-manager API will need to be enhanced. Look at +the sample ~/.gntrc file above to see how to select a window-manager. + + +.SH Conversation Commands +There are a few helpful commands in addition to the regular commands. You can +use these from any conversation to access other windows. + +.TP +.B accounts +for the accounts window. + +.TP +.B buddylist +for the buddylist. + +.TP +.B debugwin +for the debug window. + +.TP +.B plugins +for the plugins window. + +.TP +.B prefs +for the preferences window. + +.TP +.B status +for the status window. + +.SH BUGS +Known bugs are listed at +.br +\fIhttp://sourceforge.net/tracker/?group_id=235&atid=100235\fR + +.SH PATCHES +If you fix a bug in \fBgaim-text\fR (or otherwise enhance it), please submit a +patch (using \fIsvn diff > my.diff\fR against the latest SVN version) +at +.br +\fIhttp://sourceforge.net/tracker/?func=add&group_id=235&atid=300235\fR + +Before sending a bug report, please verify that you have the latest +version of \fBgaim-text\fR and \fBlibgaim\fR. Many bugs (major and minor) are +fixed at each release, and if yours is out of date, the problem may already have +been solved. + +You are also encouraged to drop by at \fB#gaim\fR on \fIirc.freenode.net\fR to +discuss about development. + +.SH SEE ALSO +\fIhttp://gaim.sourceforge.net/\fR +.br +\fIhttp://www.sourceforge.net/projects/gaim/\fR + +.SH LICENSE +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, but +\fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +.SH AUTHORS +Sadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR> +.br + +This manpage was written by Sadrul Habib Chowdhury +<\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia +<\fIdennis@dennisr.net\fR>. + diff -r 1f7581a5d2b8 -r bcf89a7c69db doc/gntgaim.1.in --- a/doc/gntgaim.1.in Mon Sep 18 04:40:45 2006 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,287 +0,0 @@ -.\" Copyright (c) 2006, Sadrul Habib Chowdhury -.\" -.\" This is free documentation; you can redistribute it and/or -.\" modify it under the terms of the GNU General Public License as -.\" published by the Free Software Foundation; either version 2 of -.\" the License, or (at your option) any later version. -.\" -.\" The GNU General Public License's references to "object code" -.\" and "executables" are to be interpreted as the output of any -.\" document formatting or typesetting system, including -.\" intermediate and printed output. -.\" -.\" This manual is distributed in the hope that it will be useful, -.\" but WITHOUT ANY WARRANTY; without even the implied warranty of -.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.\" GNU General Public License for more details. -.\" -.\" You should have received a copy of the GNU General Public -.\" License along with this manual; if not, write to the Free -.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, -.\" USA. -.TH gntgaim 1 -.SH NAME -GntGaim \- A Pimpin' Penguin console frontend for Instant Messaging client Gaim. -.SH SYNOPSIS -.TP 5 -\fBgntgaim \fI[options]\fR - -.SH DESCRIPTION -.PP -\fBgntgaim\fR is a console-based modular messaging client capable of using -AIM, MSN, Yahoo!, Jabber, ICQ, IRC, SILC, Novell GroupWise, Lotus Sametime, -Zephyr, Gadu-Gadu, and QQ all at once. It has many common features found in -other clients, as well as many unique features. Gaim is not endorsed by or -affiliated with America Online, ICQ, Microsoft, or Yahoo. - -.SH OPTIONS -The following options are provided by \fBgntgaim\fR using the standard GNU -command line syntax: -.TP -.B \-d, \-\-debug -Print debugging messages to stderr and start with the \fBDebug\fR window. The -messages shown in the \fBDebug\fR window are the same as the ones printed in -stderr. -.TP -.B \-c, \-\-config=\fIDIR\fB -Use \fIDIR\fR as the directory for config files instead of \fI~/.gaim\fR. -.TP -.B \-h, \-\-help -Print this help and exit. -.TP -.B \-n, \-\-nologin -Don't automatically login when \fBgntgaim\fR starts. Sets all accounts to -Offline. -.TP -.B \-v, \-\-version -Display the version information window. - -.SH GNT Shortcuts -You can use the following shortcuts: -.TP -.B Alt \+ n -Go to the next window. -.TP -.B Alt \+ p -Go to the previous window. -.TP -.B Alt \+ w -Show the list of windows. You can select and jump to any window from the list. -.TP -.B Alt \+ c -Close the current window. -.TP -.B Alt \+ q -Quit. -.TP -.B Alt \+ m -Start moving a window. Press the cursor keys to move the window. When you are -done, press \fBEnter\fR or \fBEscape\fR. -.TP -.B Alt \+ r -Start resizing a window. Press the cursor keys to resize the window. When you -are done, press \fBEnter\fR or \fBEscape\fR. -.TP -.B Alt \+ d -Dump the contents of the screen in HTML format in a file named "dump.html" in -working directory. -.TP -.B Alt \+ . -Move the position of the current window in the window list one place to the -right. -.TP -.B Alt \+ , -Move the position of the current window in the window list one place to the -left. -.TP -.B Alt \+ l -Refresh the windows. This is useful after resizing the terminal window. -.TP -.B Alt \+ 1 2 ... 0 -Jump to the 1st, 2nd ... 10th window. - -.SH FILES -\fI~/.gntrc\fR: configuration file for gnt applications. -.br -.TP -A sample file looks like: -.br -[general] -.br -shadow = 0 -.br -# There is experimental mouse support -.br -mouse = 1 -.br -# To use some custom window-manager -.br -wm = /usr/local/lib/gaim/s.so -.br - -.br -[colors] -.br -# The RGB values range in [0, 1000] -.br -black = 0; 0; 0 -.br -red = 1000; 0; 0 -.br -green = 0; 1000; 0 -.br -blue = 250; 250; 700 -.br -white = 1000; 1000; 1000 -.br -gray = 700; 700; 700 -.br -darkgray = 256; 256; 256 -.br - -.br -[colorpairs] -.br -normal = white; black -.br -highlight = white; blue -.br -highlightd = black; gray -.br -shadow = black; darkgray -.br -title = white; blue -.br -titled = white; gray -.br -text = white; blue -.br -disabled = gray; black -.br - -.br -# Remap some keys for GntEntry -.br -[GntEntry::remap] -.br -# Remap the up-arrow to the left-arrow -.br -^[[A = ^[[D -.br -# Remap the down-arrow to the right-arrow -.br -^[[B = ^[[C -.br -# Remap 'a' to 'bcd' -.br -a = bcd -.br -# Completely ignore the key 'q' -.br -q = -.br -# But the following will NOT work -.br -#abc = bcd -.br - -# Hitting 'space' will activate a button -.br -[GntButton::remap] -.br -\\ = \\r -.br - -.SH Mouse Support -There is experimental mouse support. You can focus windows, activate buttons, -select rows in a list, scroll using the wheel-scroll etc. Mouse support is -disabled by default, so you need to enable it in ~/.gntrc (see the sample -above). - -.SH Window Management -The default window management is very limited. But it is possible to write -custom window managers to suit your needs. There is a sample window-manager -included (named \fIs.so\fR) which adds a little 'close-button' for the windows, -removes the borders from the buddylist and pops up new windows in the middle of -the screen, instead of at the upper-left corder. It is provided as a sample -simple manager, but it should be possible to write more complex managers, and -it's very possible that the window-manager API will need to be enhanced. Look at -the sample ~/.gntrc file above to see how to select a window-manager. - - -.SH Conversation Commands -There are a few helpful commands in addition to the regular commands. You can -use these from any conversation to access other windows. - -.TP -.B accounts -for the accounts window. - -.TP -.B buddylist -for the buddylist. - -.TP -.B debugwin -for the debug window. - -.TP -.B plugins -for the plugins window. - -.TP -.B prefs -for the preferences window. - -.TP -.B status -for the status window. - -.SH BUGS -Known bugs are listed at -.br -\fIhttp://sourceforge.net/tracker/?group_id=235&atid=100235\fR - -.SH PATCHES -If you fix a bug in \fBgntgaim\fR (or otherwise enhance it), please submit a -patch (using \fIsvn diff > my.diff\fR against the latest SVN version) -at -.br -\fIhttp://sourceforge.net/tracker/?func=add&group_id=235&atid=300235\fR - -Before sending a bug report, please verify that you have the latest -version of \fBgntgaim\fR and \fBlibgaim\fR. Many bugs (major and minor) are -fixed at each release, and if yours is out of date, the problem may already have -been solved. - -You are also encouraged to drop by at \fB#gaim\fR on \fIirc.freenode.net\fR to -discuss about development. - -.SH SEE ALSO -\fIhttp://gaim.sourceforge.net/\fR -.br -\fIhttp://www.sourceforge.net/projects/gaim/\fR - -.SH LICENSE -This program is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, but -\fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - -.SH AUTHORS -Sadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR> -.br - -This manpage was written by Sadrul Habib Chowdhury -<\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia -<\fIdennis@dennisr.net\fR>. -