lambdamoo/sym_table.h
Roger Crew 0e0d6bf8e1 config.h must be first!!! options.h must be second!!!
Time to impose some discipline on #include header ordering:

(1) We need to be absolutely certain everybody is seeing
    the SAME #define settings from config.h and options.h
    (so many of the my_foo.h depend on config.h settings
    and yet config.h was being listed later.  how did this happen?)

(2) It REALLY helps for documentation and code comprehension
    to have .c files clearly point to the .h files that
    export their interfaces (usually it's the like-named .h
    but sometimes it is not and this can be confusing to
    the newbie maintainer)

So... new rules:

For .h files:
  config.h if referenced, goes FIRST.
  options.h if referenced, goes SECOND.

For .c files the ordering of #includes shall be:

(1) The .h file(s) defining the exported interfaces
    that this .c file is implementing
    (typically this will be just one file, foo.h
     if this is foo.c, but exceptions exist)

(2) config.h, then options.h, in a stanza by themselves
    if referenced and not already included by (1)

For both .c and .h files we then have two more stanzas:

(3) system headers,
    including the "my-foo.h" corrective headers.

(4) own headers, other than the ones that go in (1)

Except for special cases like net_proto.c and net_mplex.c
where the whole purpose of the file is to BE an #include festival,
there should be no further #includes after the initial block.
All includes should appear at the top of the file where we can see them.

... ok, I'm done.
2025-09-29 00:44:47 -07:00

85 lines
2.6 KiB
C

/******************************************************************************
Copyright (c) 1992, 1995, 1996 Xerox Corporation. All rights reserved.
Portions of this code were written by Stephen White, aka ghond.
Use and copying of this software and preparation of derivative works based
upon this software are permitted. Any distribution of this software or
derivative works must comply with all applicable United States export
control laws. This software is made available AS IS, and Xerox Corporation
makes no warranty about the software, its performance or its conformity to
any specification. Any person obtaining a copy of this software is requested
to send their name and post office or electronic mail address to:
Pavel Curtis
Xerox PARC
3333 Coyote Hill Rd.
Palo Alto, CA 94304
Pavel@Xerox.Com
*****************************************************************************/
#ifndef Sym_Table_H
#define Sym_Table_H 1
#include "config.h"
#include "version.h"
typedef struct {
unsigned max_size;
unsigned size;
const char **names;
} Names;
extern Names *new_builtin_names(DB_Version);
extern int first_user_slot(DB_Version);
extern unsigned find_or_add_name(Names **, const char *);
extern int find_name(Names *, const char *);
extern void free_names(Names *);
/* Environment slots for built-in variables */
#define SLOT_NUM 0
#define SLOT_OBJ 1
#define SLOT_STR 2
#define SLOT_LIST 3
#define SLOT_ERR 4
#define SLOT_PLAYER 5
#define SLOT_THIS 6
#define SLOT_CALLER 7
#define SLOT_VERB 8
#define SLOT_ARGS 9
#define SLOT_ARGSTR 10
#define SLOT_DOBJ 11
#define SLOT_DOBJSTR 12
#define SLOT_PREPSTR 13
#define SLOT_IOBJ 14
#define SLOT_IOBJSTR 15
/* Added in DBV_Float: */
#define SLOT_INT 16
#define SLOT_FLOAT 17
#endif /* !Sym_Table_H */
/*
* $Log$
* Revision 2.2 1996/03/10 01:15:53 pavel
* Removed a number of obsolete declarations. Release 1.8.0.
*
* Revision 2.1 1996/02/08 06:11:23 pavel
* Made new_builtin_names() and first_user_slot() version-dependent to support
* version numbers on suspended-task frames. Added SLOT_INT and SLOT_FLOAT.
* Updated copyright notice for 1996. Release 1.8.0beta1.
*
* Revision 2.0 1995/11/30 04:55:57 pavel
* New baseline version, corresponding to release 1.8.0alpha1.
*
* Revision 1.4 1992/10/23 23:03:47 pavel
* Added copyright notice.
*
* Revision 1.3 1992/10/21 03:02:35 pavel
* Converted to use new automatic configuration system.
*
* Revision 1.2 1992/08/31 22:24:26 pjames
* Changed some `char *'s to `const char *'
*
* Revision 1.1 1992/07/20 23:23:12 pavel
* Initial RCS-controlled version.
*/