[gamecode] Tweak some docs and macro names

And fix an incorrect definition for RETURN_QUAT.

Prefixed MAX_STACK_DEPTH and LOCALSTACK_SIZE (and LOCALSTACK_SIZE got an
extra _).

The rest is just edits to documentation comments.
This commit is contained in:
Bill Currie 2022-01-22 10:57:26 +09:00
parent e6fbe9fdbc
commit 06b1ea6837
2 changed files with 9 additions and 10 deletions

View File

@ -197,7 +197,7 @@ typedef int pr_load_func_t (progs_t *pr);
/** Initialize a ::progs_t VM struct from an already open file.
\param pr pointer to ::progs_t VM struct
\param file handle of file to read progs data from
\param file handle of file from which to read progs data
\param size bytes of \p file to read
\note \e All runtime strings (permanent or temporary) are allocated from
@ -981,7 +981,7 @@ void PR_Undefined (progs_t *pr, const char *type, const char *name) __attribute_
\hideinitializer
*/
#define RETURN_QUAT(p,q) VectorCopy (q, R_QUAT (p))
#define RETURN_QUAT(p,q) QuatCopy (q, R_QUAT (p))
///@}
/** \defgroup prda_entity_fields Entity Fields
@ -1504,7 +1504,6 @@ void PR_Resources_Clear (progs_t *pr);
\param name The name of the resource. Used for retrieving the
resource.
\param data The resource data.
callback.
\param clear Callback for performing any necessary cleanup. Called
by PR_Resources_Clear(). The parameters are the current
VM (\p pr) and \p data.
@ -1796,8 +1795,8 @@ extern const char *pr_gametype;
//============================================================================
#define MAX_STACK_DEPTH 64
#define LOCALSTACK_SIZE 4096
#define PR_MAX_STACK_DEPTH 64
#define PR_LOCAL_STACK_SIZE 4096
#define PR_RS_SLOTS 16
#define PR_BASE_IND(o, b) (((o) & OP_##b##_BASE) >> OP_##b##_SHIFT)
#define PR_BASE(p, s, b) (p->pr_bases[PR_BASE_IND(s->op, b)])
@ -1927,7 +1926,7 @@ struct progs_s {
bfunction_t *pr_xfunction;
int pr_xstatement;
prstack_t pr_stack[MAX_STACK_DEPTH];
prstack_t pr_stack[PR_MAX_STACK_DEPTH];
int pr_depth;
/// \name progs visible stack
@ -1943,7 +1942,7 @@ struct progs_s {
int stack_size; ///< set by user
///@}
int localstack[LOCALSTACK_SIZE];
int localstack[PR_LOCAL_STACK_SIZE];
int localstack_used;
///@}

View File

@ -137,7 +137,7 @@ PR_PushFrame (progs_t *pr)
{
prstack_t *frame;
if (pr->pr_depth == MAX_STACK_DEPTH)
if (pr->pr_depth == PR_MAX_STACK_DEPTH)
PR_RunError (pr, "stack overflow");
frame = pr->pr_stack + pr->pr_depth++;
@ -272,7 +272,7 @@ PR_EnterFunction (progs_t *pr, bfunction_t *f)
pr->pr_xstatement = f->first_statement - 1; // offset the st++
// save off any locals that the new function steps on
if (pr->localstack_used + f->locals > LOCALSTACK_SIZE)
if (pr->localstack_used + f->locals > PR_LOCAL_STACK_SIZE)
PR_RunError (pr, "PR_EnterFunction: locals stack overflow");
memcpy (&pr->localstack[pr->localstack_used],