From bb6619d332a76ce1da9ab20ecf1d4d5827b51b79 Mon Sep 17 00:00:00 2001
From: Bill Currie <bill@taniwha.org>
Date: Wed, 13 Jan 2010 06:48:54 +0000
Subject: [PATCH] docs and a bit of cleanup

delete core files with boostrap clean
fix the placement of a comment
simple docs for the standard client connection process (no mention of
downloads)
---
 bootstrap           |  1 +
 doc/connect.txt     | 28 ++++++++++++++++++++++++++++
 qw/source/sv_user.c | 18 +++++++++---------
 3 files changed, 38 insertions(+), 9 deletions(-)
 create mode 100644 doc/connect.txt

diff --git a/bootstrap b/bootstrap
index 8147b541d..350cd9dbe 100755
--- a/bootstrap
+++ b/bootstrap
@@ -24,6 +24,7 @@ if test "$1" = "clean"; then
 
 	cd -
 	find . -name Makefile -print0 | xargs $ARGS rm -f
+	find . -name core -print0 | xargs $ARGS rm -f
 	rm -f RPM/build_rpm RPM/quakeforge.conf RPM/quakeforge.spec RPM/rpmmacros
 	find . -name '*.o' -type f -print0 | xargs $ARGS rm -f
 	find . -name '*.lo' -type f -print0 | xargs $ARGS rm -f
diff --git a/doc/connect.txt b/doc/connect.txt
new file mode 100644
index 000000000..45c4085fb
--- /dev/null
+++ b/doc/connect.txt
@@ -0,0 +1,28 @@
+[oob]getchallenge\n
+                                [oob]c[challenge][ext]
+[oob]connect [protover] [qport] [challenge] [userinfo]
+                                [oob]j
+[chan][clc_stringcmd]new
+                                [chan][svc_serverdata][data]
+[chan][clc_stringcmd]soundlist [svcount] 0
+{
+                                    [chan][svc_soundlist][data][next]
+    [chan][clc_stringcmd]soundlist [svcount] [next]
+}
+                                [chan][svc_soundlist][data]0
+[chan][clc_stringcmd]modellist [svcount] 0
+{
+                                    [chan][svc_modellist][data][next]
+    [chan][clc_stringcmd]modellist [svcount] [next]
+}
+                                [chan][svc_modellist][data]0
+[chan][clc_stringcmd]prespawn [svcount] [n=0] [wcsum]
+{
+                                    [chan][signon buffer n][stuffcmd]prespawn...
+    [chan][clc_stringcmd]prespawn [svcount] [n]
+}
+                                [chan][signon buffer n][stuffcmd]spawn...
+[chan][clc_stringcmd]spawn [svcount] 0
+                                [chan][spawn info][stuffcmd]skins
+[chan][clc_stringcmd]begin [svcount]
+....
diff --git a/qw/source/sv_user.c b/qw/source/sv_user.c
index 339f97672..75b761109 100644
--- a/qw/source/sv_user.c
+++ b/qw/source/sv_user.c
@@ -105,12 +105,6 @@ static void OutofBandPrintf (netadr_t where, const char *fmt, ...) __attribute__
 
 //	USER STRINGCMD EXECUTION host_client and sv_player will be valid.
 
-/*
-	SV_New_f
-
-	Sends the first message from the server to a connected client.
-	This will be sent on the initial connection and upon each server load.
-*/
 void
 SV_WriteWorldVars (netchan_t *netchan)
 {
@@ -143,6 +137,12 @@ SV_WriteWorldVars (netchan_t *netchan)
 						 Info_MakeString (svs.info, 0)));
 }
 
+/*
+	SV_New_f
+
+	Sends the first message from the server to a connected client.
+	This will be sent on the initial connection and upon each server load.
+*/
 static void
 SV_New_f (void *unused)
 {
@@ -164,7 +164,7 @@ SV_New_f (void *unused)
 // NOTE:  This doesn't go through MSG_ReliableWrite since it's before the
 // user spawns.  These functions are written to not overflow
 	if (host_client->backbuf.num_backbuf) {
-		SV_Printf ("WARNING %s: [SV_New] Back buffered (%d0, clearing\n",
+		SV_Printf ("WARNING %s: [SV_New] Back buffered (%d), clearing\n",
 					host_client->name, host_client->netchan.message.cursize);
 		host_client->backbuf.num_backbuf = 0;
 		SZ_Clear (&host_client->netchan.message);
@@ -185,8 +185,8 @@ SV_New_f (void *unused)
 
 	// Trigger GIB connection event
 	if (sv_client_connect_e->func)
-		GIB_Event_Callback (sv_client_connect_e, 1, va ("%u",
-														host_client->userid));
+		GIB_Event_Callback (sv_client_connect_e, 1,
+							va ("%u", host_client->userid));
 }
 
 void