Sun Nov 5 16:09:13 1995 Roland McGrath <roland@churchy.gnu.ai.mit.edu>
[platform/upstream/glibc.git] / gnu-versions.h
1 /* Header with interface version macros for library pieces copied elsewhere.
2 Copyright (C) 1995 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Library General Public License as
7 published by the Free Software Foundation; either version 2 of the
8 License, or (at your option) any later version.
9
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13 Library General Public License for more details.
14
15 You should have received a copy of the GNU Library General Public
16 License along with the GNU C Library; see the file COPYING.LIB.  If
17 not, write to the Free Software Foundation, Inc., 675 Mass Ave,
18 Cambridge, MA 02139, USA.  */
19
20 #ifndef _GNU_VERSIONS_H
21 #define _GNU_VERSIONS_H 1
22
23 /* This file exists to define these few macros.  Each specifies a version
24    number associated with the library interface of a piece of the C library
25    which is also distributed with other GNU packages.  These pieces are
26    both part of the GNU C library and also distributed with other GNU
27    packages so those packages may use their facilities on systems lacking
28    the GNU C library.  The source files for each piece surround all their
29    code with `#ifndef ELIDE_CODE' after defining it with this:
30
31    #define OBSTACK_INTERFACE_VERSION 1
32    #if !defined (_LIBC) && defined (__GNU_LIBRARY__) && __GNU_LIBRARY__ > 1
33    #include <gnu-versions.h>
34    #if _GNU_OBSTACK_INTERFACE_VERSION == OBSTACK_INTERFACE_VERSION
35    #define ELIDE_CODE
36    #endif
37    #endif
38
39    This allows those one to avoid compiling those files when part of a GNU
40    package not libc, on a system using a GNU C library that supports the
41    same interface.
42
43    Please preserve the format of the comments after each macro.  And
44    remember, if any of these versions change, the libc.so major version
45    number must change too (so avoid it)!  */
46
47 #define _GNU_OBSTACK_INTERFACE_VERSION  1 /* vs malloc/obstack.c */
48 #define _GNU_REGEX_INTERFACE_VERSION    1 /* vs posix/regex.c */
49
50 #endif  /* gnu-versions.h */