annotate README.txt @ 349:8662c07455be

Added tag dev-0_9_6 for changeset f3572f4f73d1
author Matti Hamalainen <ccr@tnsp.org>
date Thu, 23 Jun 2011 01:37:43 +0300
parents e97c764927ce
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
d83c544c8077 TRICKS -> README
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
1 NNChat - extremely simple NN chat applet compatible client
d83c544c8077 TRICKS -> README
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
2 ==========================================================
200
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
3 Written and designed by Anonymous Finnish Guy
260
e97c764927ce Update copyright.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
4 (C) Copyright 2008-2011 Anonymous Finnish Guy
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
5
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
6
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
7 Distributed under DWETFYWTPL (Do What Ever The Fuck You Want
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
8 To Public License), see file COPYING for more information.
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
9
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
10
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
11 What is this?
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
12 -------------
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
13 A simple NCurses-based client compatible with NewbieNudes.com chatroom
60
fc8b5265a3d2 Improve grammar.
Matti Hamalainen <ccr@tnsp.org>
parents: 59
diff changeset
14 protocol. There is a basic line-editing interface with some bells and
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
15 whistles, such as a input history, logging to file, ignore lists,
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
16 persistent configuration, etc.
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
17
166
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
18 The original Flash-based chat client can be accessed through NN website:
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
19
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
20 http://www.newbienudes.com/chat/
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
21
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
22
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
23 Usage
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
24 -----
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
25 See the help, 'nnchat --help' for available command line options. By
255
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
26 default the client connects to main room (TCP port 8005). By using
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
27 other ports (option -p) you can connect to "passion pit" (8003).
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
28
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
29 Connect as registered user to members only chat:
66
11b45ba0132f Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 60
diff changeset
30 > nnchat username password
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
31
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
32 Connect as guest to free for all main chat:
255
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
33 > nnchat -p 8003 AnonymousAndy ""
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
34
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
35 You can also leave out the username and password from the commandline,
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
36 NNChat will prompt for those if necessary.
0
728243125263 Import.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
37
38
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
38
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
39 Keys
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
40 ----
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
41 arrow left/right - Move cursor in the current buffer.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
42 arrow up/down - Browse input history.
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
43 ctrl+left/right - Move cursor through words.
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
44
173
317df807da54 Update.
Matti Hamalainen <ccr@tnsp.org>
parents: 171
diff changeset
45 ins - Toggle between insert and overwrite modes.
317df807da54 Update.
Matti Hamalainen <ccr@tnsp.org>
parents: 171
diff changeset
46 del - Delete one character at cursor position.
317df807da54 Update.
Matti Hamalainen <ccr@tnsp.org>
parents: 171
diff changeset
47 backspace - Delete one character left to the cursor position.
52
8d9c065241b7 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 44
diff changeset
48
200
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
49 tab(ulator) - Try to complete a username. For example "an<tab>"
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
50 would check the userlist for usernames beginning with
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
51 "an" and replace this with the first match. Subsequent
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
52 tab-keypresses will "cycle" around other matches.
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
53
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
54 F2 - Clear current edit buffer.
171
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
55 F5 - Toggle ignore mode on/off.
192
a2e9bbd8ca18 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 178
diff changeset
56 F7 - Clear current PRV target, if any.
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
57 F8 - Toggle private chat mode on/off.
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
58 F9 - Quit.
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
59
171
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
60 ctrl+L - Refresh/redraw screen.
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
61
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
62
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
63 Commands
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
64 --------
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
65 /to <user> - Set target for private chat. Example: "/to foobar"
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
66 will set target to user "foobar". After this, pressing
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
67 function key F8 will toggle between private mode and
171
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
68 public. Private chat mode is indicated by "username>"
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
69 on the input line.
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
70
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
71 /ignore [user] - Toggle user to/from ignore. "/ignore" without specified
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
72 username will list users currently on the ignore list.
200
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
73 When ignore mode is ENABLED (via function key F5),
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
74 no messages or actions from users on the list will be
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
75 displayed. However, they will go into log file, if
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
76 logging is active.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
77
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
78 /color <color> - Changes your current user color visible to OTHER people
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
79 using the regular NN chat. Of course, this does not
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
80 affect this client in any way, as user colors are
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
81 ignored.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
82
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
83 /save - Save current configuration (username, password, etc.)
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
84 Notice that this may be a risk, if your computer
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
85 has several users as just starting the client will
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
86 automatically log into the chat with your username and
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
87 password!
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
88
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
89 /who - Lists all users on the chat currently.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
90
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
91
38
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
92 Installation
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
93 ------------
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
94 NNChat requires a curses library, preferably ncurses. It is
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
95 also possible to compile NNChat for Windows via MinGW and use
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
96 PDCurses instead, but this includes certain complexities in
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
97 build process (see Makefile.w32)
38
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
98
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
99 1) Edit Makefile (optional)
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
100
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
101 2) make / gmake
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
102
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
103 3) ./nnchat --help