annotate lib/dummy.c @ 17255:d81be792518a

update from texinfo
author Karl Berry <karl@freefriends.org>
date Tue, 01 Jan 2013 15:51:49 -0800
parents e542fd46ad6f
children 344018b6e5d7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5106
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* A dummy file, to prevent empty libraries from breaking builds.
17249
e542fd46ad6f maint: update all copyright year number ranges
Eric Blake <eblake@redhat.com>
parents: 16201
diff changeset
2 Copyright (C) 2004, 2007, 2009-2013 Free Software Foundation, Inc.
5106
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 8440
diff changeset
4 This program is free software: you can redistribute it and/or modify
5265
7721189665d4 Change copyright notice to FSF, and change license to GPL.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5106
diff changeset
5 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 8440
diff changeset
6 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 8440
diff changeset
7 (at your option) any later version.
5106
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
5265
7721189665d4 Change copyright notice to FSF, and change license to GPL.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5106
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7721189665d4 Change copyright notice to FSF, and change license to GPL.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5106
diff changeset
12 GNU General Public License for more details.
5106
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13
5265
7721189665d4 Change copyright notice to FSF, and change license to GPL.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5106
diff changeset
14 You should have received a copy of the GNU General Public License
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 8440
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
5106
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 /* Some systems, reportedly OpenBSD and Mac OS X, refuse to create
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 libraries without any object files. You might get an error like:
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 > ar cru .libs/libgl.a
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 > ar: no archive members specified
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 Compiling this file, and adding its object file to the library, will
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 prevent the library from being empty. */
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25
8421
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
26 /* Some systems, such as Solaris with cc 5.0, refuse to work with libraries
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
27 that don't export any symbol. You might get an error like:
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
28
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
29 > cc ... libgnu.a
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
30 > ild: (bad file) garbled symbol table in archive ../gllib/libgnu.a
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
31
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
32 Compiling this file, and adding its object file to the library, will
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
33 prevent the library from exporting no symbols. */
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
34
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
35 #ifdef __sun
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
36 /* This declaration ensures that the library will export at least 1 symbol. */
8440
6f61a4aca9d7 Try to avoid clashing symbols.
Bruno Haible <bruno@clisp.org>
parents: 8421
diff changeset
37 int gl_dummy_symbol;
8421
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
38 #else
5106
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
39 /* This declaration is solely to ensure that after preprocessing
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
40 this file is never empty. */
0d18d9cee047 New module 'dummy'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41 typedef int dummy;
8421
faaa486649e7 Avoid error with SunPRO C 5.0 on Solaris 2.5.1.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
42 #endif