Mercurial > gnulib

annotate lib/version-etc.h @ 17363:5a51fb7777a9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
sys_select, sys_time: port 2013-01-30 Solaris 2.6 fix to Cygwin Problem reported by Marco Atzeri in <http://lists.gnu.org/archive/html/bug-gnulib/2013-03/msg00000.html>. * lib/sys_select.in.h [HAVE_SYS_SELECT_H && _CYGWIN_SYS_TIME_H]: Simply delegate to the system <sys/select.h> in this case too. Also, pay attention to _GL_SYS_SELECT_H_REDIRECT_FROM_SYS_TIME_H only if OSF/1, since otherwise Cygwin breaks, and it doesn't seem to be needed on Solaris either. * lib/sys_time.in.h [_CYGWIN_SYS_TIME_H]: Simply delgate to the system <sys/time.h> in this case.
author Paul Eggert <eggert@cs.ucla.edu>
date Tue, 19 Mar 2013 09:08:47 -0700
parents e542fd46ad6f
children 344018b6e5d7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
11073
5d673ad5f710 version-etc: Add emit_bug_reporting_address.
Simon Josefsson <simon@josefsson.org>
parents: 9309
diff changeset
1 /* Print --version and bug-reporting information in a consistent format.
17249
e542fd46ad6f maint: update all copyright year number ranges
Eric Blake <eblake@redhat.com>
parents: 16358
diff changeset
2 Copyright (C) 1999, 2003, 2005, 2009-2013 Free Software Foundation, Inc.
1942
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
3
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
4 This program is free software: you can redistribute it and/or modify
1942
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
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: 5848
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: 5848
diff changeset
7 (at your option) any later version.
1942
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
8
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
9 This program is distributed in the hope that it will be useful,
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
12 GNU General Public License for more details.
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
13
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
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: 5848
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
1942
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
16
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
17 /* Written by Jim Meyering. */
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
18
1754
ddaa9b176f63 *** empty log message ***
Jim Meyering <jim@meyering.net>
parents:
diff changeset
19 #ifndef VERSION_ETC_H
ddaa9b176f63 *** empty log message ***
Jim Meyering <jim@meyering.net>
parents:
diff changeset
20 # define VERSION_ETC_H 1
ddaa9b176f63 *** empty log message ***
Jim Meyering <jim@meyering.net>
parents:
diff changeset
21
4771
ffc6ac581833 Merge version-etc-2 back into version-etc: Better way to internationalize
Bruno Haible <bruno@clisp.org>
parents: 4397
diff changeset
22 # include <stdarg.h>
4347
df44e79ce676 .h files should stand alone, but we shouldn't include <sys/types.h>
Paul Eggert <eggert@cs.ucla.edu>
parents: 2807
diff changeset
23 # include <stdio.h>
df44e79ce676 .h files should stand alone, but we shouldn't include <sys/types.h>
Paul Eggert <eggert@cs.ucla.edu>
parents: 2807
diff changeset
24
16235
18a38c9615f0 In commentary, do not use ` to quote.
Paul Eggert <eggert@cs.ucla.edu>
parents: 16201
diff changeset
25 /* The 'sentinel' attribute was added in gcc 4.0. */
14351
724011432f7b Consistent macro naming for macros that use GCC __attribute__.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
26 #ifndef _GL_ATTRIBUTE_SENTINEL
11655
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
27 # if 4 <= __GNUC__
14351
724011432f7b Consistent macro naming for macros that use GCC __attribute__.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
28 # define _GL_ATTRIBUTE_SENTINEL __attribute__ ((__sentinel__))
11655
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
29 # else
14351
724011432f7b Consistent macro naming for macros that use GCC __attribute__.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
30 # define _GL_ATTRIBUTE_SENTINEL /* empty */
11655
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
31 # endif
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
32 #endif
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
33
5606
3a8740615faf * MODULES.html.sh (Command-line arguments): Add version-etc-fsf.
Paul Eggert <eggert@cs.ucla.edu>
parents: 4771
diff changeset
34 extern const char version_etc_copyright[];
1942
bc345b25b5bf (version_etc_copyright): Declare it.
Jim Meyering <jim@meyering.net>
parents: 1754
diff changeset
35
11650
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
36 /* The three functions below display the --version information in the
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
37 standard way: command and package names, package version, followed
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
38 by a short GPLv3+ notice and a list of up to 10 author names.
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
39
16358
a712776b11ce maint: spelling fixes
Paul Eggert <eggert@cs.ucla.edu>
parents: 16235
diff changeset
40 If COMMAND_NAME is NULL, the PACKAGE is assumed to be the name of
11650
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
41 the program. The formats are therefore:
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
42
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
43 PACKAGE VERSION
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
44
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
45 or
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
46
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
47 COMMAND_NAME (PACKAGE) VERSION.
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
48
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
49 The functions differ in the way they are passed author names: */
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
50
11655
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
51 /* N_AUTHORS names are supplied in array AUTHORS. */
11650
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
52 extern void version_etc_arn (FILE *stream,
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
53 const char *command_name, const char *package,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
54 const char *version,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
55 const char * const * authors, size_t n_authors);
11650
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
56
11655
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
57 /* Names are passed in the NULL-terminated array AUTHORS. */
11650
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
58 extern void version_etc_ar (FILE *stream,
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
59 const char *command_name, const char *package,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
60 const char *version, const char * const * authors);
11650
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
61
11655
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
62 /* Names are passed in the NULL-terminated va_list. */
4771
ffc6ac581833 Merge version-etc-2 back into version-etc: Better way to internationalize
Bruno Haible <bruno@clisp.org>
parents: 4397
diff changeset
63 extern void version_etc_va (FILE *stream,
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
64 const char *command_name, const char *package,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
65 const char *version, va_list authors);
4771
ffc6ac581833 Merge version-etc-2 back into version-etc: Better way to internationalize
Bruno Haible <bruno@clisp.org>
parents: 4397
diff changeset
66
11650
7b211eff2192 Provide additional interfaces and documentation for version-etc module.
Sergey Poznyakoff <gray@gnu.org.ua>
parents: 11073
diff changeset
67 /* Names are passed as separate arguments, with an additional
11655
ed090c498dd0 version-etc: fix regression
Eric Blake <ebb9@byu.net>
parents: 11650
diff changeset
68 NULL argument at the end. */
4771
ffc6ac581833 Merge version-etc-2 back into version-etc: Better way to internationalize
Bruno Haible <bruno@clisp.org>
parents: 4397
diff changeset
69 extern void version_etc (FILE *stream,
12421
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
70 const char *command_name, const char *package,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
71 const char *version,
e8d2c6fc33ad Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents: 11655
diff changeset
72 /* const char *author1, ..., NULL */ ...)
14351
724011432f7b Consistent macro naming for macros that use GCC __attribute__.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
73 _GL_ATTRIBUTE_SENTINEL;
11073
5d673ad5f710 version-etc: Add emit_bug_reporting_address.
Simon Josefsson <simon@josefsson.org>
parents: 9309
diff changeset
74
16235
18a38c9615f0 In commentary, do not use ` to quote.
Paul Eggert <eggert@cs.ucla.edu>
parents: 16201
diff changeset
75 /* Display the usual "Report bugs to" stanza. */
11073
5d673ad5f710 version-etc: Add emit_bug_reporting_address.
Simon Josefsson <simon@josefsson.org>
parents: 9309
diff changeset
76 extern void emit_bug_reporting_address (void);
1754
ddaa9b176f63 *** empty log message ***
Jim Meyering <jim@meyering.net>
parents:
diff changeset
77
ddaa9b176f63 *** empty log message ***
Jim Meyering <jim@meyering.net>
parents:
diff changeset
78 #endif /* VERSION_ETC_H */