annotate Include/modsupport.h @ 15842:f6cd36498a50 legacy-trunk

Document extensions to .pth files.
author Martin v. Löwis <martin@v.loewis.de>
date Sat, 13 Jan 2001 09:54:41 +0000
parents 081671cef7c1
children 77958266c7d7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
1
13435
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
2 #ifndef Py_MODSUPPORT_H
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
3 #define Py_MODSUPPORT_H
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
4 #ifdef __cplusplus
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
5 extern "C" {
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
6 #endif
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
7
6
fc6fcd7df4f7 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
8 /* Module support interface */
fc6fcd7df4f7 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
9
1746
1940892d2fe3 Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1329
diff changeset
10 #include <stdarg.h>
1940892d2fe3 Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1329
diff changeset
11
13435
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
12 extern DL_IMPORT(int) PyArg_Parse(PyObject *, char *, ...);
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
13 extern DL_IMPORT(int) PyArg_ParseTuple(PyObject *, char *, ...);
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
14 extern DL_IMPORT(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
15 char *, char **, ...);
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
16 extern DL_IMPORT(PyObject *) Py_BuildValue(char *, ...);
1746
1940892d2fe3 Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1329
diff changeset
17
13435
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
18 extern DL_IMPORT(int) PyArg_VaParse(PyObject *, char *, va_list);
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
19 extern DL_IMPORT(PyObject *) Py_VaBuildValue(char *, va_list);
1252
c4cd0d9d8281 * Changed many files to use mkvalue() instead of newtupleobject().
Guido van Rossum <guido@python.org>
parents: 819
diff changeset
20
14781
081671cef7c1 Andrew Kuchling <akuchlin@mems-exchange.org>:
Fred Drake <fdrake@acm.org>
parents: 14375
diff changeset
21 extern DL_IMPORT(int) PyModule_AddObject(PyObject *, char *, PyObject *);
081671cef7c1 Andrew Kuchling <akuchlin@mems-exchange.org>:
Fred Drake <fdrake@acm.org>
parents: 14375
diff changeset
22 extern DL_IMPORT(int) PyModule_AddIntConstant(PyObject *, char *, long);
081671cef7c1 Andrew Kuchling <akuchlin@mems-exchange.org>:
Fred Drake <fdrake@acm.org>
parents: 14375
diff changeset
23 extern DL_IMPORT(int) PyModule_AddStringConstant(PyObject *, char *, char *);
081671cef7c1 Andrew Kuchling <akuchlin@mems-exchange.org>:
Fred Drake <fdrake@acm.org>
parents: 14375
diff changeset
24
12088
3789b643fe89 Version updated to 1.6; API version to 1009.
Guido van Rossum <guido@python.org>
parents: 9744
diff changeset
25 #define PYTHON_API_VERSION 1009
3789b643fe89 Version updated to 1.6; API version to 1009.
Guido van Rossum <guido@python.org>
parents: 9744
diff changeset
26 #define PYTHON_API_STRING "1009"
2095
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
27 /* The API version is maintained (independently from the Python version)
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
28 so we can detect mismatches between the interpreter and dynamically
13620
5b727ab37092 Spelling fixes supplied by Rob W. W. Hooft. All these are fixes in either
Thomas Wouters <thomas@python.org>
parents: 13435
diff changeset
29 loaded modules. These are diagnosed by an error message but
3831
96851f51ad6b Two bumps for the price of one (PYTHON_API_VERSION)
Guido van Rossum <guido@python.org>
parents: 3318
diff changeset
30 the module is still loaded (because the mismatch can only be tested
96851f51ad6b Two bumps for the price of one (PYTHON_API_VERSION)
Guido van Rossum <guido@python.org>
parents: 3318
diff changeset
31 after loading the module). The error message is intended to
96851f51ad6b Two bumps for the price of one (PYTHON_API_VERSION)
Guido van Rossum <guido@python.org>
parents: 3318
diff changeset
32 explain the core dump a few seconds later.
2095
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
33
4110
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
34 The symbol PYTHON_API_STRING defines the same value as a string
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
35 literal. *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
36
2095
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
37 Please add a line or two to the top of this log for each API
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
38 version change:
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
39
12088
3789b643fe89 Version updated to 1.6; API version to 1009.
Guido van Rossum <guido@python.org>
parents: 9744
diff changeset
40 14-Mar-2000 GvR 1009 Unicode API added
3789b643fe89 Version updated to 1.6; API version to 1009.
Guido van Rossum <guido@python.org>
parents: 9744
diff changeset
41
9744
85ab28644201 New version identification scheme.
Guido van Rossum <guido@python.org>
parents: 9586
diff changeset
42 3-Jan-1999 GvR 1007 Decided to change back! (Don't reuse 1008!)
85ab28644201 New version identification scheme.
Guido van Rossum <guido@python.org>
parents: 9586
diff changeset
43
85ab28644201 New version identification scheme.
Guido van Rossum <guido@python.org>
parents: 9586
diff changeset
44 3-Dec-1998 GvR 1008 Python 1.5.2b1
9578
299284ee669d New API version (enough has changed!).
Guido van Rossum <guido@python.org>
parents: 8563
diff changeset
45
299284ee669d New API version (enough has changed!).
Guido van Rossum <guido@python.org>
parents: 8563
diff changeset
46 18-Jan-1997 GvR 1007 string interning and other speedups
5004
4c8e4e9311e4 Bump API version due to the various speedup hacks.
Guido van Rossum <guido@python.org>
parents: 4503
diff changeset
47
4403
3b3f7c3f6da2 Ellipses -> Ellipsis rename (the dictionary really says that it should
Guido van Rossum <guido@python.org>
parents: 4110
diff changeset
48 11-Oct-1996 GvR renamed Py_Ellipses to Py_Ellipsis :-(
3b3f7c3f6da2 Ellipses -> Ellipsis rename (the dictionary really says that it should
Guido van Rossum <guido@python.org>
parents: 4110
diff changeset
49
3831
96851f51ad6b Two bumps for the price of one (PYTHON_API_VERSION)
Guido van Rossum <guido@python.org>
parents: 3318
diff changeset
50 30-Jul-1996 GvR Slice and ellipses syntax added
96851f51ad6b Two bumps for the price of one (PYTHON_API_VERSION)
Guido van Rossum <guido@python.org>
parents: 3318
diff changeset
51
96851f51ad6b Two bumps for the price of one (PYTHON_API_VERSION)
Guido van Rossum <guido@python.org>
parents: 3318
diff changeset
52 23-Jul-1996 GvR For 1.4 -- better safe than sorry this time :-)
96851f51ad6b Two bumps for the price of one (PYTHON_API_VERSION)
Guido van Rossum <guido@python.org>
parents: 3318
diff changeset
53
3318
8b8d60fbe3bf bump api version
Guido van Rossum <guido@python.org>
parents: 2129
diff changeset
54 7-Nov-1995 GvR Keyword arguments (should've been done at 1.3 :-( )
8b8d60fbe3bf bump api version
Guido van Rossum <guido@python.org>
parents: 2129
diff changeset
55
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2095
diff changeset
56 10-Jan-1995 GvR Renamed globals to new naming scheme
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2095
diff changeset
57
2095
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
58 9-Jan-1995 GvR Initial version (incompatible with older API)
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
59 */
0d7e4aa595f7 api version checking
Guido van Rossum <guido@python.org>
parents: 2078
diff changeset
60
4110
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
61 #ifdef MS_WINDOWS
6350
9a121b3fbebb Removed special Windows defines, at Mark Hammond's request.
Guido van Rossum <guido@python.org>
parents: 5978
diff changeset
62 /* Special defines for Windows versions used to live here. Things
9a121b3fbebb Removed special Windows defines, at Mark Hammond's request.
Guido van Rossum <guido@python.org>
parents: 5978
diff changeset
63 have changed, and the "Version" is now in a global string variable.
9a121b3fbebb Removed special Windows defines, at Mark Hammond's request.
Guido van Rossum <guido@python.org>
parents: 5978
diff changeset
64 Reason for this is that this for easier branding of a "custom DLL"
9a121b3fbebb Removed special Windows defines, at Mark Hammond's request.
Guido van Rossum <guido@python.org>
parents: 5978
diff changeset
65 without actually needing a recompile. */
4110
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
66 #endif /* MS_WINDOWS */
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
67
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
68 #ifdef Py_TRACE_REFS
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
69 /* When we are tracing reference counts, rename Py_InitModule4 so
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
70 modules compiled with incompatible settings will generate a
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
71 link-time error. */
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
72 #define Py_InitModule4 Py_InitModule4TraceRefs
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
73 #endif
07a35fd2e0a1 Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal.
Guido van Rossum <guido@python.org>
parents: 3831
diff changeset
74
13435
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
75 extern DL_IMPORT(PyObject *) Py_InitModule4(char *name, PyMethodDef *methods,
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
76 char *doc, PyObject *self,
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
77 int apiver);
7e3cd9480f66 ANSI-fication of the sources -- remove Py_PROTO!
Fred Drake <fdrake@acm.org>
parents: 13256
diff changeset
78
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2095
diff changeset
79 #define Py_InitModule(name, methods) \
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2095
diff changeset
80 Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2095
diff changeset
81 PYTHON_API_VERSION)
1329
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1313
diff changeset
82
8563
419ee95df2d8 Define new macro Py_InitModule3(name, methods, doc) which calls
Guido van Rossum <guido@python.org>
parents: 6601
diff changeset
83 #define Py_InitModule3(name, methods, doc) \
419ee95df2d8 Define new macro Py_InitModule3(name, methods, doc) which calls
Guido van Rossum <guido@python.org>
parents: 6601
diff changeset
84 Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
419ee95df2d8 Define new macro Py_InitModule3(name, methods, doc) which calls
Guido van Rossum <guido@python.org>
parents: 6601
diff changeset
85 PYTHON_API_VERSION)
419ee95df2d8 Define new macro Py_InitModule3(name, methods, doc) which calls
Guido van Rossum <guido@python.org>
parents: 6601
diff changeset
86
9586
60fdb1db1175 Add DL_IMPORT(returntype) for all officially exported functions.
Guido van Rossum <guido@python.org>
parents: 9578
diff changeset
87 extern DL_IMPORT(char *) _Py_PackageContext;
6601
1e428f51ed4e Add declaration for _Py_PackageContext -- needed to fix importing
Guido van Rossum <guido@python.org>
parents: 6350
diff changeset
88
1329
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1313
diff changeset
89 #ifdef __cplusplus
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1313
diff changeset
90 }
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1313
diff changeset
91 #endif
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1313
diff changeset
92 #endif /* !Py_MODSUPPORT_H */