summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2013-04-06 13:14:47 +0200
committerPaul Buetow <paul@buetow.org>2013-04-06 13:14:47 +0200
commitee315a27b72dc967a8a90f132725b7c8e4fd9fba (patch)
tree349db556063b17a3c84dc9348495bd11d73b0417 /README
parent630af0ed6c0af69c7df2e45aef7a87722a3c00c0 (diff)
tagging ychat-0.7.5ychat-0.7.5
Diffstat (limited to 'README')
-rwxr-xr-x[-rw-r--r--]README155
1 files changed, 24 insertions, 131 deletions
diff --git a/README b/README
index 88f1740..16c31df 100644..100755
--- a/README
+++ b/README
@@ -1,9 +1,9 @@
-yChat; Homepage: www.yChat.org; Version 0.7.9.5-RELEASE
+yChat; Homepage: www.yChat.org; Version 0.7.5-RELEASE
Copyright (C) 2003 Paul C. Buetow, Volker Richter
-Copyright (C) 2004 Paul C. Buetow
-Copyright (C) 2005 EXA Digital Solutions GbR
+Copyright (C) 2004, 2005 Paul C. Buetow
-----------------------------------------------------------------
+
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
@@ -21,8 +21,7 @@ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
YCHAT TABLE OF CONTENTS:
-0.0.0 ABOUT RELEASES
-0.0.1 YCHAT FEATURES //<<
+0.0.0 YCHAT FEATURES //<<
1.0.0 REQUIREMENTS
1.1.0 TESTED PLATFORMS
1.2.0 IMPORTANT NOTICES
@@ -31,76 +30,14 @@ YCHAT TABLE OF CONTENTS:
1.3.2 INSTALLATION QUICK-START
1.3.3 MYSQL SETUP //<<
1.4.0 HOW TO USE SCREEN WITH YCHAT
-1.4.1 HOW TO USE SIGNALS WITH YCHAT
1.5.0 CUSTOMIZATION
1.6.0 FILES
1.7.0 WRITING BUG REPORTS
1.8.0 CONTACT
1.9.0 YHTTPD CODE BASE GENERATION //<<
-2.0.0 CREDITS
-
-0.0.0 ABOUT RELEASES
-
-There are several projects involved:
-
-- The chat -
-Its a HTTP based chat server written in C++. Clients are normal web browsers
-such as MSIE or Gecko based browsers using only CSS, HTML and JavaScript.
-
-- The httpd -
-Its a small http server based on the chat's socket and threading engine.
-yhttpd does not have as much features but is easy to use and faster than
-apache. yhttpd is a subset of the chat. It can be generated using the
-srcipts/yhttpdbase.pl script in the chat's source tree.
-
-- The ycurses -
-ycurses is a easy to use and small C++ wrapper of the C ncurses API.
-
-There are different branches:
-
-- CURRENT -
-The CURRENT branch is unstable, this is the bleeding developing edge with
-all the new experimental features.
-
-A RELEASE of CURRENT can be referred as CURRENTRELEASE.
-
-- STABLE -
-The STABLE branch is more stable than CURRENT. This branch may get new
-features as well. But those will be more conservative compared to
-CURRENT.
-
-A RELEASE of STABLE can be referred as STABLERELEASE.
-
-- BASIC -
-The BASIC branch is a very minimal one. This branch may get bugfixes and
-updates and might get minor improvements. This is a version of yChat
-with only very few features.
-
-A RELEASE of BASIC can be referred as BASICRELEASE.
-
-- LEGACY -
-The LEGACY branch has no real support. This branch may get bugfixes and
-updates and might get minor improvements. But there is no garuantee to
-be bug free and stable at all. LEGACY versions are of historic meaning.
-
-- DEVEL -
-DEVEL is only a meta name. If a version is labeled with DEVEL, then its
-currently undefined if this is a CURRENT, STABLE or LEGACY branch. It
-can be everything. Commonly DEVEL versions are CURRENT.
-
-There are also releases made:
-
-- RELEASE -
-There can be RELEASEs made out of each branch. While a branch can get
-new features, a RELEASE can not. A RELEASE of a branch is just like
-a snapshot. RELEASEs are complete versions to test and use. But keep
-in mind, that a RELEASE of the STABLE branch is recommended over a
-RELEASE of a CURRENT or a LEGACY branch in a production environment.
-RELEASEs of CURRENT are still the bleeding edge and RELEASEs of LEGACY
-may be out of date.
//<<*
-0.0.1 YCHAT FEATURES
+0.0.0 YCHAT FEATURES
- Its free & portable -
yChat is developed under the GNU general public license and is based on GNU
@@ -130,8 +67,9 @@ yChat is written in C++ which is faster than any Java based Chat-Server or any
server written in a scripting language like PHP, Python or Perl. As the
internal data structures hash maps are used to garuantee searching certain
values in O(1) amount of time. If a hash maps gets full, it will be rehashed.
-Currently, yChat has been measured providing over 1000 hits/requests per second
-on a FreeBSD based server box while using less than 2% of CPU usage
+The maximum usage in % can be redefined too (standard is 90%). Currently, yChat
+has been measured providing over 5000 hits/requests per second (chat message
+postings) on a FreeBSD based server box while using less than 2% of CPU usage
on a Athlon XP 1900+. Performance seems to be limited by your bandwith only.
Also, each user gets its own session id (random string) with a standard length
of 50 chars to authenticate each logged in user. The length of the session id
@@ -177,7 +115,7 @@ well . To improve performance, you can define the logging puffer (standardly
new logs will be written to disk after each 20 lines). If you want to log
everything immediately, you can reset this option to 1 in ychat.conf.
-- Its modular through own command and dynamic HTML engine -
+- Its modular -
All chat commands are realized through dynamic loadable module files which can
be recompiled and reloaded without restarting the whole yChat server. Also
HTML-Sites with certain tasks can be compiled as a module like
@@ -210,8 +148,8 @@ lot of user and room objects are created and destroyed frequently.
1.0.0 REQUIREMENTS:
-- GNU GCC G++
- The GNU C++ compiler version 3.1 or up.
+- GNU GCC G++ 3.4 or 3.3 or 3.2 or 3.1
+ The GNU C++ compiler. G++ version 3.0 or 2.x does NOT work.
- GNU make 3.80 (gmake) or higher
If you dont have a gmake executable but make is gnu make then you need
@@ -219,11 +157,6 @@ lot of user and room objects are created and destroyed frequently.
yChat Makefiles only have been tested with GNU make and may not work with
other make versions.
-- SGI STL extension
- Includes ext/hash_map which may be already default on every Linux distro.
- On *BSD you have to install it first before compiling. On FreeBSD
- /usr/ports/devel/stlport is your friend.
-
//<<*
- mysql-client 4.x (3.x may do too but is not supported)
Includes libmysqlclient and the mysql.h header files.
@@ -246,8 +179,6 @@ a listed platform did not work at all please contact me:
Operating system (arch) GNU G++ GNU make
- FreeBSD 5.3-RELEASE (i386) 3.4.2 3.80
-
- Tested longer time before:
- FreeBSD 5.2.1-RELEASE (i386) 3.3.3 3.80
- FreeBSD 4.10-RELEASE (i386) 3.4.1 3.80
- FreeBSD 4.9-RELEASE (i386) 3.3.4 3.80
@@ -274,31 +205,22 @@ homepage which is located at http://www.yChat.org.
yChat can be downloaded as a source package or through CVS.
-The packages are located at http://www.yChat.org -> Release Versions
+The packages are located at http://www.yChat.org -> Sourcecode ->
+Packages or go to http://pub.buetow.org/yChat/CPP-yChat .
For CVS download type:
-cvs -d:pserver:anonymous@buetow.org:/cvs/cvsroot login
+cvs -d:pserver:anonymous@buetow.org:/usr/home/cvs/cvsroot login
( You will be asked for a password. Use "just enter" ).
-vs -z3 -d:pserver:anonymous@buetow.org:/cvs/cvsroot co BRANCH
+vs -z3 -d:pserver:anonymous@buetow.org:/usr/home/cvs/cvsroot co ychat
( The sources will be copied into your local folder )
-cvs -d:pserver:anonymous@buetow.org:/cvs/cvsroot logout
+cvs -d:pserver:anonymous@buetow.org:/usr/home/cvs/cvsroot logout
( Logs your CVS session out ).
Now you may continue with the installation.
-There are different branches in the CVS:
-
-ychat: This is the latest CURRENT branch of yChat.
-ychat-stable: This is the latest STABLE branch of yChat.
-ychat-X.Y: This is the branch with the specified version prefix.
-yhttpd: This is the latest CURRENT snapshot of yhttpd.
-
-The CURRENT branch of ychat is mostly untested and unstable, so don't
-cry if you get errors.
-
1.3.1 INSTALLATION:
Invoke "./configure". Afterwards you will get prompted with the before-compile
@@ -322,16 +244,14 @@ or gmake config):
gmake clean (cleans everything)
gmake clean_base (only cleans the base obj and rpo files)
gmake clean_modules (only cleans the modules .so files)
- gmake confdebug (runs ./configure with enabling debugging)
gmake config (runs yChat configurator)
- gmake debug (runs gdb on ./ychat.core)
- gmake dist (creates a .tar.bz2 ball)
gmake gpl (shows the GNU General Public License)
gmake help (shows all available ychat gmake targets)
gmake mail (sends a mail to the yChat developers containing build opts.)
gmake modules (only compiles modules)
gmake mrproper (same as gmake clean plus removing all temp files)
gmake setup (runs all configure scripts and afterwards gmake all)
+ gmake start (compiles everything and starts the server)
gmake stats (generates ychat statistics)
gmake version (shows the current version of yChat)
//<<*
@@ -403,19 +323,6 @@ terminated.
For a closer look read the screen manual page ( man screen ).
-1.4.1 HOW TO USE SIGNALS WITH YCHAT:
-
-You can send UNIX signals to yChat. This becomes very interesting if you
-don't use the command line interface or the ncurses interface and you
-don't have access to the options below.
-
-Run one of the following commands to send the signal you want:
-($PID is here the process id of the current yChat process)
-
-kill -USR1 $PID # yChat clears the HTML template cache
-kill -USR2 $PID # yChat reloads all dynamic loadable modules //<<
-kill -HUP $PID # yChat will shutdown savely
-
1.5.0 CUSTOMIZATION:
If you like to customize the design/layout/language of yChat, you will have
@@ -471,7 +378,7 @@ src/msgs.h - Defines some server side messages
How to submit a good bug report?
-Send them to mail at yChat dot org.
+Send them to Bug@yChat.org.
First you should give the following information:
- yChat version, if CVS (or devel. tarball) then which day?
@@ -517,7 +424,9 @@ If you dont get such a gdb output, you need to recompile the yChat using
debuggig symbols. You can do it this way:
cd ychat
-gmake clean confdebug all run
+gmake mrproper
+./configure -g3 -ggdb
+gmake start
1.8 CONTACT:
@@ -525,10 +434,10 @@ You may contact us through the following addresses:
- Homepage
The yChat homepage is located at http://www.yChat.org
- The EXA Digital Solutions homepage is located at http://www.exa-ds.com
- E-Mail
- Paul C. Buetow: Buetow at yChat point org ( core developer )
+ Paul C. Buetow: Snooper at yChat point org ( core developer )
+ Volker Richter: Rover at yChat dot org ( core developer )
Mail at yChat dot org ( reaches everybody of yChat )
- ICQ
@@ -537,24 +446,8 @@ You may contact us through the following addresses:
- IRC
#Ychat and #Coding at irc.german-elite.net
-- EXA Digital Solutions GbR
- Laubenstr. 16b
- D-44866 Bochum
- Germany
-
//<<*
-1.9.0 YHTTPD CODE BASE GENERATION
+1.9 YHTTPD CODE BASE GENERATION
See docs/yhttpd.txt
//*>>
-
-2.0.0 CREDITS
-
-Thanks to the following persons. Without them yChat would not be like today:
-
-- Volker Richter <volker at exa-ds dot de> of EXA Digital Solutions GbR
- (http://www.exa-ds.com) for adding initial MySQL support and lots of more
- code.
-
-- Joshia Teitelbaum <joshuat at cryptomail.org> of CryptpMail.org for adding
- lots of security patches in the HTTP header handling.