No description
Find a file
Jeff Teunissen acf2de7612 Enabled time stamped messages for server. To turn it on, set
sv_timestamps.

To configure how timestamps are formatted, use the sv_timefmt Cvar. It's a
formatted string, with the following special tokens (taken from the
strftime() manual page):

       %a     The abbreviated weekday name according to the  cur­
              rent locale.

       %A     The  full  weekday  name  according  to the current
              locale.

       %b     The abbreviated month name according to the current
              locale.

       %B     The  full  month  name  according  to  the  current
              locale.

       %c     The preferred date and time representation for  the
              current locale.

       %C     The century number (year/100) as a 2-digit integer.
              (SU)

       %C     The century number (the year divided by   100   and
              truncated  to  an integer).

       %d     The  day of the month as a decimal number (range 01
              to 31).

       %D     Equivalent to  %m/%d/%y.  (Yecch  -  for  Americans
              only.   Americans  should  note that in other coun­
              tries %d/%m/%y is rather common. This means that in
              international  context this format is ambiguous and
              should not be used.) (SU)

       %e     Like %d, the day of the month as a decimal  number,
              but a leading zero is replaced by a space. (SU)

       %E     Modifier: use alternative format, see below. (SU)

       %G     The ISO 8601 year with century as a decimal number.
              The 4-digit year corresponding to the ISO week num­
              ber  (see  %V).  This has the same format and value
              as %y, except that if the ISO week  number  belongs
              to  the  previous  or  next year, that year is used
              instead. (TZ)

       %g     Like %G, but without century, i.e., with a  2-digit
              year (00-99). (TZ)

       %h     Equivalent to %b. (SU)

       %H     The  hour as a decimal number using a 24-hour clock
              (range 00 to 23).

       %I     The hour as a decimal number using a 12-hour  clock
              (range 01 to 12).

       %j     The  day of the year as a decimal number (range 001
              to 366).

       %k     The hour (24-hour clock) as a decimal number (range
              0  to  23);  single digits are preceded by a blank.
              (See also %H.) (TZ)

       %l     The hour (12-hour clock) as a decimal number (range
              1  to  12);  single digits are preceded by a blank.
              (See also %I.) (TZ)

       %m     The month as a decimal number (range 01 to 12).

       %M     The minute as a decimal number (range 00 to 59).

       %n     A newline character. (SU)

       %O     Modifier: use alternative format, see below. (SU)

       %p     Either `AM' or `PM' according  to  the  given  time
              value, or the corresponding strings for the current
              locale.  Noon is treated as `pm'  and  midnight  as
              `am'.

       %P     Like  %p but in lowercase: `am' or `pm' or a corre­
              sponding string for the current locale. (GNU)

       %r     The time in a.m. or p.m. notation.   In  the  POSIX
              locale this is equivalent to `%I:%M:%S %p'. (SU)

       %R     The  time  in  24-hour notation (%H:%M). (SU) For a
              version including the seconds, see %T below.

       %s     The number of seconds since the Epoch, i.e.,  since
              1970-01-01 00:00:00 UTC. (TZ)

       %S     The second as a decimal number (range 00 to 61).

       %t     A tab character. (SU)

       %T     The time in 24-hour notation (%H:%M:%S). (SU)

       %u     The  day  of  the  week as a decimal, range 1 to 7,
              Monday being 1.  See also %w. (SU)

       %U     The week number of the current year  as  a  decimal
              number,  range  00  to  53, starting with the first
              Sunday as the first day of week 01. See also %V and
              %W.

       %V     The  ISO  8601:1988 week number of the current year
              as a decimal number, range 01 to 53, where  week  1
              is  the  first week that has at least 4 days in the
              current year, and with Monday as the first  day  of
              the week. See also %U and %W. (SU)

       %w     The  day  of  the  week as a decimal, range 0 to 6,
              Sunday being 0.  See also %u.

       %W     The week number of the current year  as  a  decimal
              number,  range  00  to  53, starting with the first
              Monday as the first day of week 01.

       %x     The preferred date representation for  the  current
              locale without the time.

       %X     The  preferred  time representation for the current
              locale without the date.

       %y     The year as a  decimal  number  without  a  century
              (range 00 to 99).

       %Y     The year as a decimal number including the century.

       %z     The time-zone as hour offset from GMT.  Required to
              emit  RFC822-conformant  dates (using "%a, %d %b %Y
              %H:%M:%S %z"). (GNU)

       %Z     The time zone or name or abbreviation.

       %+     The date and time in date(1) format. (TZ)

       %%     A literal `%' character.

Some of these may not work on some systems.
2000-08-02 07:13:12 +00:00
doc Swapped the meaning of cl_chatmode 1 and cl_chatmode 2 for consistency reasons 2000-06-17 23:24:53 +00:00
include add gl_skymultipass to conroll whether the skydome is single or double pass. 2000-07-30 02:54:17 +00:00
RPM Removed strange file ;) 2000-05-17 17:15:18 +00:00
source Enabled time stamped messages for server. To turn it on, set 2000-08-02 07:13:12 +00:00
tools menu.c: change "help" to "menu_help" to get rid of error on startup. 2000-05-23 07:29:02 +00:00
.gitignore some fixes to make quakeforge build on solaris. not quite done yet as the 2000-05-25 05:01:20 +00:00
acconfig.h We have -3dfx again, took me a hour or two to do it.. 2000-06-09 20:15:08 +00:00
acinclude.m4 Add AM_PATH_SDL to acinclude.m4 2000-07-13 05:14:53 +00:00
AUTHORS Automake stuff. Don't blame me for this. ;) 2000-05-17 09:25:03 +00:00
bootstrap Add bootstrap script, delete aclocal.m4 2000-05-17 09:34:52 +00:00
configure.in Clean up the warnings Tonik didn't 2000-08-01 21:55:26 +00:00
COPYING Initial revision 2000-05-10 11:29:38 +00:00
INSTALL Automake stuff. Don't blame me for this. ;) 2000-05-17 09:25:03 +00:00
Makefile.am remove servers.txt from EXTRA_DIST 2000-05-22 08:48:04 +00:00
NEWS Automake stuff. Don't blame me for this. ;) 2000-05-17 09:25:03 +00:00
newtree.dsw added gas2masm to the workspace 2000-05-14 01:40:20 +00:00
quakeforge.lsm.in Automake stuff. Don't blame me for this. ;) 2000-05-17 09:25:03 +00:00
README Testing. 2000-06-10 02:13:57 +00:00
README.WIN Added instructions how to compile SDL/SGL... 2000-07-30 10:25:27 +00:00
ROADMAP Clean up the warnings Tonik didn't 2000-08-01 21:55:26 +00:00

QuakeForge - Release Notes
Copyright (C) 1996-1997  Id Software, Inc.
Copyright (C) 1999,2000  contributors of the QuakeForge Project
Please see the file "AUTHORS" for a list of contributors

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
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 program; if not, write to:

	Free Software Foundation, Inc.
	59 Temple Place, Suite 330
	Boston, MA 02111-1307 USA

See file COPYING for license details.

Quake(R) and QuakeWorld(R) are registered trademarks of Id Software,
Inc. The NIN logo is a registered trademark licensed to Nothing
Interactive, Inc. All other trademarks are the property of their
respective owners


Table of Contents
~~~~~~~~~~~~~~~~~

1	Special Thanks
2	System Requirements
3	Compiling and Running QuakeForge
4	Platform-Specific Issues
5	Errata and Known Bugs
6	Troubleshooting
7	Technical Support
8	Joystick Notes
9	Tested Systems


1	Special Thanks
~~~~~~~~~~~~~~~~~~~~~~

The QuakeForge Project would like to thank Id Software, Inc. for writing
and releasing Quake under the GNU GPL.  We'd like to thank John Carmack
and Dave Kirsch in particular for the support they have provided to us
and to the Free Software community as a whole.

We would also like to thank the following organizations for their
contributions to QuakeForge:

   VA Linux Systems, Inc.
   3Dfx Interactive, Inc.

And last but certainly not least, we would like to thank every single
person who has contributed even one line of code, documentation, or
other support to the QuakeForge project.

Without all of you, we would not be where we are right now.

Id Software, Inc. thanks MPath Interactive and Gandalf Technology for
their help and support.

If you'd like to contribute in any way to the QuakeForge project, please
contact our mailing list at quake-devel@lists.sourceforge.net.


2	System Requirements
~~~~~~~~~~~~~~~~~~~~~~~~~~~

* A Raster capable display. ;-)
* 16 megabytes of memory beyond operating system footprint.
* A Floating-point processor. While not strictly required, QuakeForge
  uses a lot of floating-point math, so a FPU is highly recommended.
* 10MB of free hard disk space to build all targets. In addition to the
  base system, you will require game data files. For the default game
  ("Quake"), you will need either the shareware or registered version of
  Quake.


3	Compiling and Running QuakeForge
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Please read the INSTALL file for more information on compiling.

Autoconf 2.13 or later and automake 1.3 or later are required to use
the bootstrap script, which creates the "configure" script.

After you have compiled successfully, you must download the shareware
version of Quake 1 to play. Insert the proper binaries in the same
directory as the unpacked shareware files, and run.

We are currently working on a free replacement for the Quake game data
files.


4	Platform-Specific Issues
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This section discusses issues that affect only certain operating
platforms.

4.1	DOS

If you experience page faults while running Quarterdeck's QDPMI DPMI
server, this is caused by a bug in QDPMI.  Workarounds:  Remove QDPMI
from CONFIG.SYS, issue the command QDPMI OFF before running QuakeForge,
or get the update patch for QDPMI from Quarterdeck.  You may be running
QDPMI without knowing it if you have QEMM installed, because it can be
installed as part of the QEMM installation.

4.2	Linux

SVGALib-using targets (-svga and -3dfx) can't be started from within X.
We are aware of the problem, and if you can figure out the reason, we'd
appreciate a patch, PLEASE! As a workaround, you can use "open" to start
those targets from within X.  (e.g. "open -s -- qw-client-svga")

Some 3Dfx Voodoo-based 3D accelerators may have issues with the way
QuakeForge uses the "3dfxgl" minidriver to interface to the Glide
library.

Video boards based on the Riva
128/128ZX/TNT/TNT2/TNT2 Ultra/Vanta/GeForce 256 chipsets from nVidia
Corp. using the latest (as of 13 Jan 2000) nVidia OpenGL drivers may
have problems with transparency. Under some conditions, these drivers
may lock the X Window System server, possibly rendering the system
unusable. The currently-recommended drivers for video cards with Riva
128/128ZX/TNT/TNT2/TNT2 Ultra chipsets are those from the Utah GLX
project, located at http://utah-glx.sourceforge.net/ -- for the Vanta
and GeForce 256 chipsets, there is no suggested hardware-accelerated
OpenGL alternative at this time. We believe the bug to be in nVidia's
drivers, because our code seems to work under other OpenGL
implementations.

4.4	Windows 95/98/Millennium

Currently, we are unable to determine the status of the Windows-based
targets of QuakeForge. Because of our move to GNU Autoconf and the
dearth of "proper" GNU tools available on the Windows platform, our
build system may not work properly on Windows. We are working on
solutions for this problem.

4.5	Windows NT/2000

For the most part, issues for Windows 9x-based operating environments
will be similar. However, because of numerous differences in the way
Windows NT and Windows 9x operate, these systems may have specific
issues.

5	Errata and Known Bugs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Problem:  After running the X11 target my keyboard repeat turns off! How
          do I turn it back on?
Solution: xset r on

Problem:  The screen flickers once about every other frame when using GL
Solution: Not all GL implementations support a performance hack which is
          used by the GL renderer allowing it to avoid clearing the
	  Z-buffer.  The console command "gl_ztrick 0" fixes this
	  problem.

Problem:  Zombies can sometimes get "stuck" in the ground.  They can be
	  heard but not killed making it impossible to get 100% on the
	  current level.
Solution: None found yet.

Problem:  It is possible for players to sometimes get stuck in a room or
	  wall, much like the zombies mentioned above.
Solution: The "kill" console command will un-stick you, but it has the
	  unfortunate side effect of killing you in the process (hence
	  the command's name.)  It is a good idea to save your games
	  often.

Problem:  Sometimes during a game the player's view will not center
	  properly.  The end result is that the player view is looking
	  up toward the ceiling while walking.
Solution: Use of freelook (mouse or keyboard) may solve this problem, as
	  will exiting the level or the "kill" console command.


6	Troubleshooting
~~~~~~~~~~~~~~~~~~~~~~~

If QuakeForge fails to start up, or has problems not addressed elsewhere
in the documentation, try the -safe command line switch, which disables
a number of parts of QuakeForge that can be problems if there are
hardware or configuration problems.  The -safe command line switch is
equivalent to -stdvid, -nosound, -nonet, and -nocdaudio together.  Those
four switches do the following:

  -stdvid	disables VESA video modes
  -nosound	disables sound card support
  -nonet	disables network card support
  -nocdaudio	disables CD audio support

If -safe makes the problem go away, try using each of the switches
individually to isolate the area in which you're experiencing the
problem, then either correct the configuration or hardware problem or
play QuakeForge with that functionality disabled.


7	Technical Support
~~~~~~~~~~~~~~~~~~~~~~~~~

Please do not contact Id Software, Inc. regarding technical support
issues related to QuakeForge. QuakeForge is heavily modified from the
original Quake source release and Id Software does not support these
modifications.

Visit the QuakeForge project's webpage for more information on technical
support, bugs reports, and help at: http://www.quakeforge.net/

Thank you.


8	Joystick notes
~~~~~~~~~~~~~~~~~~~~~~

Your joystick must be plugged in when QuakeForge is launched.

If you have a joystick plugged in, but do not wish QuakeForge to try to
use it, just add the -nojoy option to the QuakeForge command line.

You may disable joystick reads from the QuakeForge console with the 
"joystick 0" command.

There are default configuration bindings for joystick buttons.

If your joystick or interface card reports three or four buttons and you
only have two, use the QuakeForge console command "joybuttons 2".

The "mlook" and "sidestep" commands work with a joystick exactly as they
do for a mouse, as does the "invert mouse up/down" menu option.


9	Tested Systems
~~~~~~~~~~~~~~~~~~~~~~

Processors tested:
   AMD Athlon
   AMD K6-2
   Apple/IBM/Motorola PowerPC
   Compaq/Digital Alpha 21x64
   IBM Power3
   Intel Pentium
   Intel Pentium II
   Intel Pentium III
   MIPS R10000
   Sun UltraSPARC
   SGI Indigo 2

Operating systems tested:
   Linux 2.x
   FreeBSD
   Solaris
   SGI Irix
   IBM AIX 4.x
   Compaq/Digital Tru64 Unix
   Windows 98
   Windows NT

Video cards tested (On Intel-based systems):
   3Dfx Voodoo Graphics (Linux)
   3Dfx Voodoo 2 (Linux)
   3Dfx Voodoo 3 3000 (Linux)
   Creative Labs Graphics Blaster RivaTNT (Linux)
   Diamond Stealth 2000 PRO (Linux)
   Matrox G200 (Linux)
   Matrox G400 (Linux)
   STB Velocity 4400 RivaTNT (Linux)

Please send user testimonials via e-mail to the QuakeForge users mailing list,
located at:

	"Quake-User" <quake-user@lists.sourceforge.net>

Visit http://www.quakeforge.net/ to find out more about subscribing to our
mailing lists and for more information.