home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / program / funnel / environ.h < prev    next >
Encoding:
C/C++ Source or Header  |  1993-10-23  |  11.3 KB  |  232 lines
  1. /*##############################################################################
  2.  
  3. FUNNNELWEB COPYRIGHT
  4. ====================
  5. FunnelWeb is a literate-programming macro preprocessor.
  6.  
  7. Copyright (C) 1992 Ross N. Williams.
  8.  
  9.    Ross N. Williams
  10.    ross@spam.adelaide.edu.au
  11.    16 Lerwick Avenue, Hazelwood Park 5066, Australia.
  12.  
  13. This program is free software; you can redistribute it and/or modify
  14. it under the terms of Version 2 of the GNU General Public License as
  15. published by the Free Software Foundation.
  16.  
  17. This program is distributed WITHOUT ANY WARRANTY; without even the implied
  18. warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  19. See Version 2 of the GNU General Public License for more details.
  20.  
  21. You should have received a copy of Version 2 of the GNU General Public
  22. License along with this program. If not, you can FTP the license from
  23. prep.ai.mit.edu/pub/gnu/COPYING-2 or write to the Free Software
  24. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  25.  
  26. Section 2a of the license requires that all changes to this file be
  27. recorded prominently in this file. Please record all changes here.
  28.  
  29. Programmers:
  30.    RNW  Ross N. Williams  ross@spam.adelaide.edu.au
  31.  
  32. Changes:
  33.    07-May-1992  RNW  Program prepared for release under GNU GPL V2.
  34.  
  35. ##############################################################################*/
  36.  
  37.  
  38. /******************************************************************************/
  39. /*                                   ENVIRON.H                                */
  40. /******************************************************************************/
  41. /*                                                                            */
  42. /* WARNING: DO NOT ADD ANY PROGRAM-DEPENDENT DEFINITIONS.                     */
  43. /*                                                                            */
  44. /* This header file environ.h contains definitions and objects whose values   */
  45. /* depends directly on the compilation and execution environment, but are     */
  46. /* otherwise independent of any particular computer program.                  */
  47. /*                                                                            */
  48. /* This is one of two machine-dependent, program-independent modules. The     */
  49. /* other module is machin (machin.h,machin.c). This "environ" module contains */
  50. /* definitions and objects that are considered essential. The "machin" module */
  51. /* contains less essential definitions. Motivation for the division came from */
  52. /* the fact that style.h (used by almost every module) includes environ.h     */
  53. /* (this file), and from the need for the stuff in style.h by some            */
  54. /* environment-dependent definitions.                                         */
  55. /*                                                                            */
  56. /* There seems to be two ways to organize a module such as this one. The      */
  57. /* first is to have a different version of this module for each target        */
  58. /* environment. The second is to have a single file that uses #defines and    */
  59. /* #ifs to select between code for each target environment. I have chosen the */
  60. /* latter method as this allows many different environments to share the same */
  61. /* definitions.                                                               */
  62. /*                                                                            */
  63. /******************************************************************************/
  64.  
  65. /* Ensure that the body of this header file is included at most once.         */
  66. #ifndef DONE_ENVIRON
  67. #define DONE_ENVIRON
  68.  
  69. /******************************************************************************/
  70.  
  71. /* Select An Environment                                                      */
  72. /* ---------------------                                                      */
  73. /* Choose the environment in which the program will be compiled and executed. */
  74. /* This may be the only change you need to make to get FunnelWeb to compile.  */
  75. /*                                                                            */
  76. /* If your exact environment is not listed, try one that is close.            */
  77. /* If problems arise, an attempt should be made to solve them                 */
  78. /* without creating a new environment definition.  However, if this is not    */
  79. /* possible, define a new environment below and "implement" it by going       */
  80. /* through environ.h and machin.h and machin.c and adding appropriate         */
  81. /* definitions.                                                               */
  82. /*                                                                            */
  83. /* The following table lists real/defined environment pairs under which       */
  84. /* FunnelWeb is known to compile cleanly.                                     */
  85. /*                                                                            */
  86. /* Symbol = Processor  Machine       OS            Compiler                   */
  87. /* ------   ---------  -------       --            --------                   */
  88. /*    MAC = 68000      Macintosh-SE  Mac           THINK-C V4.0.5             */
  89. /*    SUN = SPARC      SUN ELC       Unix(SunOS)   GNUC                       */
  90. /*    VMS = VAX        VAXStation    VMS           VAXC                       */
  91. /*     PC = 386        IBM PC Clone  MSDOS5.0      Borland C++                */
  92. /*                                                                            */
  93. /* Set exactly one of the following environments to 1, the others to 0.       */
  94.  
  95. #define MAC 0
  96. #define SUN 1
  97. #define VMS 0
  98. #define PC  0
  99.  
  100. /* Ensure that exactly one environment has been selected.                     */
  101. #if MAC+SUN+VMS+PC != 1
  102.    #error Error: You must choose exactly one machine in ENVIRON.H.
  103. #endif
  104.  
  105. /******************************************************************************/
  106.  
  107. /* Establish Presence or Absence of __STDC__                                  */
  108. /* -----------------------------------------                                  */
  109. /* The __STDC__ symbol is very useful for determining if the compiler is      */
  110. /* ANSI. However, some "nearly ANSI" compilers don't set this symbol, and     */
  111. /* experience shows that things turn out better if it is set.                 */
  112. /* This section decides if __STDC__ should be defined.                        */
  113.  
  114. /* The Macintosh THINK C compiler seems to be ANSI standard but, strangely    */
  115. /* does not define the standard preprocessor symbol __STDC__ that indicates   */
  116. /* this. Instead it defines THINK_C. Here, we execute the link manually.      */
  117. /* For more information see the THINK C User's Manual, Chapter 57: "Language  */
  118. /* Reference", Section 12.10, p.442.                                          */
  119. #ifdef THINK_C
  120. #define __STDC__ 1
  121. #endif
  122.  
  123. /* The problem seems to exist with VAX C too. */
  124. #if VMS
  125. #define __STDC__ 1
  126. #endif
  127.  
  128. /******************************************************************************/
  129.  
  130. /* Switch From Definedness to Boolean Symbols                                 */
  131. /* ------------------------------------------                                 */
  132. /* Use of the definedness of a preprocessor symbol to detect a condition is   */
  133. /* convenient if it is desired that only one condition be tested at a time.   */
  134. /* However, if we want to OR conditions, it is more convenient to use defined */
  135. /* symbols that are either 0 or 1. This section contains ifdefs that do this. */
  136.  
  137. #ifdef __STDC__
  138. #define STDC 1
  139. #else
  140. #define STDC 0
  141. #endif
  142.  
  143. /* Note: If THINK_C is predefined, it is predefined to be 1. */
  144. #ifndef THINK_C
  145. #define THINK_C 0
  146. #endif
  147.  
  148. /******************************************************************************/
  149.  
  150. /* Void                                                                       */
  151. /* ----                                                                       */
  152. /* Define void if necessary and define pointer to void.                       */
  153. /* This idea from the book "Portable C", p.41.                                */
  154. /* If necessary, add a boolean condition to cover your environment.           */
  155. /* Note: The "| SUN" is a last minute desperate hack.                         */
  156. #if STDC | SUN
  157. typedef void   *p_void;
  158. #else
  159. typedef int       void;
  160. typedef char   *p_void;
  161. #endif
  162.  
  163. /* The following function is here solely to act as a first tripping point for */
  164. /* environments with no "void" so that the users trying to port this code     */
  165. /* will look here first instead of starting to delete voids in the program.   */
  166. extern void test_void();
  167.  
  168. /******************************************************************************/
  169.  
  170. /* Const                                                                      */
  171. /* -----                                                                      */
  172. /* It's useful to be able to specify that certain objects are constants.      */
  173. /* Unfortunately, the "const" construct is only available in ANSI C and so we */
  174. /* have to have a macro so as to cope with non-ANSI compilers.                */
  175. /* Note: THINK-C is nearly ANSI, but does not support "const".                */
  176. #if STDC & !THINK_C
  177. #define CONST const
  178. #else
  179. #define CONST
  180. #endif
  181.  
  182. /******************************************************************************/
  183.  
  184. /* Prototypes                                                                 */
  185. /* ----------                                                                 */
  186. /* Define a macro to wrap around prototype parameter lists so as to support   */
  187. /* compilers with and without prototypes.                                     */
  188. /* This idea came from the book "Portable C", S3.1, p.32.                     */
  189. #if STDC
  190. #define P_(A) A
  191. #else
  192. #define P_(A) ()
  193. #endif
  194.  
  195. /******************************************************************************/
  196.  
  197. /* Structure Assignments                                                      */
  198. /* ---------------------                                                      */
  199. /* Structure assignments are not supported on some of the older compilers and */
  200. /* so we use a macro to perform such operations.                              */
  201. /* This idea came from the book "Portable C", S8.2.2, p.184.                  */
  202. #if STDC
  203. #define ASSIGN(a,b) ((a)=(b))
  204. #else
  205. #define ASSIGN(a,b) (memcpy((char *)&(a),(char *)&(b),sizeof(a)))
  206. #endif
  207.  
  208. /******************************************************************************/
  209.  
  210. /* VMS EXIT STATUS */
  211. /* --------------- */
  212. /* The VAX C compiler I used doesn't seem to be ANSI. This means that the    */
  213. /* exit symbols aren't set up properly. Furthermore, the sensible defaults   */
  214. /* in the style.h file don't work for VMS. The upshot is that we have to do  */
  215. /* a special case. Note: The top bit set in a VMS exit status means suppress */
  216. /* diagnostic message. Even status means failure. Odd means success.         */
  217. #if VMS
  218. #undef  EXIT_SUCCESS
  219. #undef  EXIT_FAILURE
  220. #define EXIT_SUCCESS 1
  221. #define EXIT_FAILURE (0x10000002)
  222. #endif
  223.  
  224. /******************************************************************************/
  225.  
  226. /* For #ifndef preventing multiple inclusion of the body of this header file. */
  227. #endif
  228.  
  229. /******************************************************************************/
  230. /*                                End of ENVIRON.H                            */
  231. /******************************************************************************/
  232.