Documentation
From QTermWiki
Main Page | Downloads | Scripts | Documentation | Development | Screenshots | FAQ | Forum (http://www.qtopia.org.cn/phpBB2/viewforum.php?f=22) | Help us | About
Welcome to QTerm, a BBS client in Linux, QTerm serves as a replacement of telnet, and provide many features useful when you are browsing a BBS site, such as mouse support, article download, anti-idle. It has a address book where you can store your favorite site addresses. And thanks to the power of Qt, QTerm have no problem converting between GB and BIG5.
This document is for getting you started in a few minutes. It may not answer all of your questions. If you have problems, please read FAQ and search your problem with google.
| Table of contents |
Requirements
- Since QTerm is written in Qt, To run QTerm you need a working X environment with Qt.
- If you want sound support, you might need to install EsounD and/or aRts packages.
- For the SSH support, you need OpenSSL package.
- If you want to compile QTerm, you need the development package of X, Qt, EsounD (optional), aRts (optional) and OpenSSL (optional).
Getting QTerm
Download the latest source from our download page. Currently the stable version is 0.2, but the code is very old and outdated. On the other side the unstable version is almost stable enough for everyday use, so we recommend using the unstable version.
Usually we will provide binary packages: rpm ,deb etc, you can easily install them just like other packages. But because of the lacking of man power, you might need to download the source package and compile it by yourself. Don't be afraid, we will show you how to compile QTerm in the following part.
If you enjoy hunting bugs and committing patches, the CVS source is your best choice. You can find instructions in the download page too.
Configuring QTerm
Suppose you need to compile QTerm by yourself, the first thing you need to do is unpacking the source package and configuring QTerm:
tar zxvf qterm-0.4pre3.tar.gz cd qterm-0.4pre3 ./configure
By default, QTerm will be installed to /usr/local, if you want to install it to some other place, use the following option
./configure --prefix=/the/new/path
In the latest pre release, EsounD and aRts support is disabled by default, to enable them, run
./configure --enable-esd --enable-arts
If something does not work as expected, try
./configure --help
to see the available options and select what you need.
On suse x86_64 systems, pathes to 64bit qt library must be provided, try
./configure --with-qt-dir=/usr/lib64/qt3 --with-qt-includes=/usr/lib64/qt3/include --with-qt-libraries=/usr/lib64/qt3/lib64 --enable-libsuffix=64
Compiling QTerm
Now you can start the compilation by typing
make
You can install QTerm with
make install
provided that you have write permission in the installation directory.
If all went well, you can run QTerm by typing
qterm