qf/quakeforge
0
0
Fork 0
mirror of https://git.code.sf.net/p/quake/quakeforge synced 2025-02-23 20:21:20 +00:00
Code Issues Projects Releases Packages Wiki Activity

expand out the tabs

Browse source
This commit is contained in:
Bill Currie 2002-09-23 14:54:52 +00:00
parent b0629d24fa
commit 6721cd05e3
1 changed files with 113 additions and 113 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

226
NEWS
View file

@ -4,125 +4,125 @@ NEWS for the QuakeForge project
Changes from 0.3.0 Changes from 0.3.0
o Progs engine enhancements. o Progs engine enhancements.
* Fully modular. Mod/Server-independant, allowing for * Fully modular. Mod/Server-independant, allowing for
stand-alone QuakeC interpreter and client-side code. stand-alone QuakeC interpreter and client-side code.
* The engine is no longer dependent on progdefs.h. This makes * The engine is no longer dependent on progdefs.h. This makes
QuakeForge have trouble with QuakeC compilers that strip QuakeForge have trouble with QuakeC compilers that strip
symbol names -- but those can be repaired using the new symbol names -- but those can be repaired using the new
"qfdefs" tool. "qfdefs" tool.
* New basic types, and instructions for using them, for version * New basic types, and instructions for using them, for version
0.fff.002 progs (Quake's Version 6 is still supported). 0.fff.002 progs (Quake's Version 6 is still supported).
* Better dynamic string handling. Dynamic strings are * Better dynamic string handling. Dynamic strings are
garbage-collected. garbage-collected.
* Object-oriented runtime system, in the style of Objective-C. * Object-oriented runtime system, in the style of Objective-C.
* Runtime fixups of built-in functions whose builtin number is * Runtime fixups of built-in functions whose builtin number is
zero. If a built-in function is available to the engine, with zero. If a built-in function is available to the engine, with
the same name given in the source code (e.g. the same name given in the source code (e.g.
"void (void) coredump = #0;"), the engine will set the value "void (void) coredump = #0;"), the engine will set the value
to the actual number used by the engine. to the actual number used by the engine.
* Debugging support (needs compiler support, which qfcc * Debugging support (needs compiler support, which qfcc
provides), including line-number information. Can display the provides), including line-number information. Can display the
line of text in the source on which an error occurred, if the line of text in the source on which an error occurred, if the
new Cvar "pr_source_path" is set correctly. new Cvar "pr_source_path" is set correctly.
* Instruction-level code dumps are now formatted in an * Instruction-level code dumps are now formatted in an
easier-to-read "assembly-code" format. easier-to-read "assembly-code" format.
o QuakeForge Code Compiler, qfcc -- a replacement for qcc. o QuakeForge Code Compiler, qfcc -- a replacement for qcc.
* Uses libQFutil for general utility functions such as hash * Uses libQFutil for general utility functions such as hash
tables, file access (incomplete), and pak files. tables, file access (incomplete), and pak files.
* Uses libQFgamecode for progs information, such as opcode * Uses libQFgamecode for progs information, such as opcode
tables, enums, types, etc.) tables, enums, types, etc.)
* Uses a lex/yacc (actually, Flex and Bison) scanner/parser * Uses a lex/yacc (actually, Flex and Bison) scanner/parser
architecture, like a "real" compiler does. architecture, like a "real" compiler does.
* Drastically reduces the number of global defs needed for * Drastically reduces the number of global defs needed for
a given progs, by reusing temporary globals when possible. a given progs, by reusing temporary globals when possible.
* All functions use the same block of defs for their local * All functions use the same block of defs for their local
variables (compatible with all known servers), which further variables (compatible with all known servers), which further
reduces the number of global defs needed. reduces the number of global defs needed.
* Nested/chained function calls work properly. * Nested/chained function calls work properly.
* Simple expressions, such as "a = b + c", compile to a single * Simple expressions, such as "a = b + c", compile to a single
instruction instead of two, and do not use a temporary instruction instead of two, and do not use a temporary
variable. variable.
* Local variables can be initialized to known values, as in * Local variables can be initialized to known values, as in
"local float foo = 0.1;". "local float foo = 0.1;".
* Uses the C preprocessor, so header files are now possible and * Uses the C preprocessor, so header files are now possible and
useful. useful.
* The compiler checks for uninitialized and unused variables in * The compiler checks for uninitialized and unused variables in
functions, to help in finding errors. functions, to help in finding errors.
* The compiler can generate and use object files, for separate * The compiler can generate and use object files, for separate
compilation (you don't have to compile all of your source all compilation (you don't have to compile all of your source all
the time, only the parts that have changed). Normally, object the time, only the parts that have changed). Normally, object
files have a .qfo extension. files have a .qfo extension.
* The compiler can link libraries, which are implemented as .qfo * The compiler can link libraries, which are implemented as .qfo
files inside pak archives. files inside pak archives.
* The compiler implements stricter type checking, to assist in * The compiler implements stricter type checking, to assist in
finding and fixing code errors. finding and fixing code errors.
* The C language's "for", "do...while", and "switch" control * The C language's "for", "do...while", and "switch" control
structures have been adopted to provide a richer set of structures have been adopted to provide a richer set of
structures for programmers to use. structures for programmers to use.
* Additional functionality is given for progs that are to be * Additional functionality is given for progs that are to be
used with QuakeForge's more advanced progs engine: used with QuakeForge's more advanced progs engine:
x IMPORTANT: x IMPORTANT:
The order of operations is slightly different in "native" The order of operations is slightly different in "native"
mode. The evaluation of "!foo & bar" is no longer mode. The evaluation of "!foo & bar" is no longer
"!(foo & bar)", but rather "(!foo) & bar". The new order of "!(foo & bar)", but rather "(!foo) & bar". The new order of
operations rules is more correct, but is different from how operations rules is more correct, but is different from how
QCC evaluated. If you give the --traditional switch to QCC evaluated. If you give the --traditional switch to
qfcc's command-line, the old behavior is used. qfcc's command-line, the old behavior is used.
x The compiler now allows you to create your own functions x The compiler now allows you to create your own functions
that can accept a variable number of arguments, using the that can accept a variable number of arguments, using the
special "..." notation. The special constants "@argc" and special "..." notation. The special constants "@argc" and
"@argv" help with this. @argc contains the number of "@argv" help with this. @argc contains the number of
arguments, and @argv contains a list of those arguments. The arguments, and @argv contains a list of those arguments. The
handling of this is an improvement on C's vararg function handling of this is an improvement on C's vararg function
handling, in our opinion, made possible by how the Quake handling, in our opinion, made possible by how the Quake
system works. system works.
x New basic types: integer, pointer, enum, and id. x New basic types: integer, pointer, enum, and id.
x You can create new complex types, like arrays, structures, x You can create new complex types, like arrays, structures,
and unions, and allocate them at runtime. and unions, and allocate them at runtime.
x String operators. You can add strings together to x String operators. You can add strings together to
concatenate them, and you can compare their contents using concatenate them, and you can compare their contents using
the <=, <, >, >= operators. the <=, <, >, >= operators.
x The integer type has the full array of C operations x The integer type has the full array of C operations
available to it. available to it.
x QFCC and QuakeForge now contain an object-oriented x QFCC and QuakeForge now contain an object-oriented
programming system, in the style of Objective-C and programming system, in the style of Objective-C and
Smalltalk. It's *very* powerful, and can be used to create Smalltalk. It's *very* powerful, and can be used to create
lots of interesting new things with rather little effort. If lots of interesting new things with rather little effort. If
you don't wish to use the new system, you can safely ignore you don't wish to use the new system, you can safely ignore
it with no danger to your code. :) it with no danger to your code. :)
x Special support for using the "self" special variable inside x Special support for using the "self" special variable inside
OO methods as well as the entity of the same name. If you OO methods as well as the entity of the same name. If you
use OO support for entities and want to assign a method as a use OO support for entities and want to assign a method as a
touch/think/etc. function, "self" always refers to the touch/think/etc. function, "self" always refers to the
object that "owns" the method being executed. The special object that "owns" the method being executed. The special
variable "@self" was created to refer to the self entity. variable "@self" was created to refer to the self entity.
"@this" refers to the object. "@this" refers to the object.
o Enhanced console scripting - GIB (GIB Isn't Bash) o Enhanced console scripting - GIB (GIB Isn't Bash)
* New language derived from the quake console. * New language derived from the quake console.
* Functions with arguments and return values. * Functions with arguments and return values.
* Looping (while, for) and branching (if) commands. * Looping (while, for) and branching (if) commands.
* Local and global variables as well as access to cvars. * Local and global variables as well as access to cvars.
Supports Python-like slicing of variables. Supports Python-like slicing of variables.
* A basic math interpreter that respects order of operations * A basic math interpreter that respects order of operations
and provides most arithmetic and logic operators. and provides most arithmetic and logic operators.
* Non-preemptive threading and callbacks to GIB functions in * Non-preemptive threading and callbacks to GIB functions in
response to game events (limited but functional at the moment) response to game events (limited but functional at the moment)
* File reading, writing, and searching. * File reading, writing, and searching.
* Integrates with console -- GIB functions can be exported as * Integrates with console -- GIB functions can be exported as
console commands to be used at the console or in binds. console commands to be used at the console or in binds.
* See gib.html in doc for more information. * See gib.html in doc for more information.
o Enhanced time cheat ("speed cheat") protection o Enhanced time cheat ("speed cheat") protection
* Time cheats only work for a split-second before protection * Time cheats only work for a split-second before protection
kicks in. kicks in.
* Players moving with wrong timings are sped up/slowed down to * Players moving with wrong timings are sped up/slowed down to
the correct speed. the correct speed.
* Delay before protection activates means that lag and normal * Delay before protection activates means that lag and normal
network latency won't affect protection. network latency won't affect protection.
* People who aren't really trying to cheat won't be kicked :) * People who aren't really trying to cheat won't be kicked :)
o Rendering enhancements o Rendering enhancements
* TBD * TBD