1 /* Copyright (C) 2001 Free Software Foundation, Inc.
3 * This library is free software; you can redistribute it and/or
4 * modify it under the terms of the GNU Lesser General Public
5 * License as published by the Free Software Foundation; either
6 * version 2.1 of the License, or (at your option) any later version.
8 * This library is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * Lesser General Public License for more details.
13 * You should have received a copy of the GNU Lesser General Public
14 * License along with this library; if not, write to the Free Software
15 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28 #include "libguile/_scm.h"
30 #include "libguile/deprecation.h"
31 #include "libguile/strings.h"
32 #include "libguile/ports.h"
34 /* Windows defines. */
36 #define vsnprintf _vsnprintf
41 #if (SCM_ENABLE_DEPRECATED == 1)
43 struct issued_warning
{
44 struct issued_warning
*prev
;
48 static struct issued_warning
*issued_warnings
;
49 static enum { detailed
, summary
, summary_print
} mode
;
52 scm_c_issue_deprecation_warning (const char *msg
)
58 struct issued_warning
*iw
;
59 for (iw
= issued_warnings
; iw
; iw
= iw
->prev
)
60 if (!strcmp (iw
->message
, msg
))
63 fprintf (stderr
, "%s\n", msg
);
66 scm_puts (msg
, scm_current_error_port ());
67 scm_newline (scm_current_error_port ());
70 iw
= scm_malloc (sizeof (struct issued_warning
));
71 if (msg
== NULL
|| iw
== NULL
)
74 iw
->prev
= issued_warnings
;
80 scm_c_issue_deprecation_warning_fmt (const char *msg
, ...)
86 vsnprintf (buf
, 511, msg
, ap
);
89 scm_c_issue_deprecation_warning (buf
);
92 SCM_DEFINE(scm_issue_deprecation_warning
,
93 "issue-deprecation-warning", 0, 0, 1,
95 "Output @var{msgs} to @code{(current-error-port)} when this "
96 "is the first call to @code{issue-deprecation-warning} with "
97 "this specific @var{msgs}. Do nothing otherwise. "
98 "The argument @var{msgs} should be a list of strings; "
99 "they are printed in turn, each one followed by a newline.")
100 #define FUNC_NAME s_scm_issue_deprecation_warning
102 if (mode
!= detailed
)
103 mode
= summary_print
;
106 SCM nl
= scm_str2string ("\n");
107 SCM msgs_nl
= SCM_EOL
;
109 while (SCM_CONSP (msgs
))
111 if (msgs_nl
!= SCM_EOL
)
112 msgs_nl
= scm_cons (nl
, msgs_nl
);
113 msgs_nl
= scm_cons (SCM_CAR (msgs
), msgs_nl
);
114 msgs
= SCM_CDR (msgs
);
116 msgs_nl
= scm_string_append (scm_reverse_x (msgs_nl
, SCM_EOL
));
117 c_msgs
= scm_to_locale_string (msgs_nl
);
118 scm_c_issue_deprecation_warning (c_msgs
);
121 return SCM_UNSPECIFIED
;
126 print_deprecation_summary (void)
128 if (mode
== summary_print
)
131 "Some deprecated features have been used. Set the environment\n"
132 "variable GUILE_WARN_DEPRECATED to \"detailed\" and rerun the\n"
133 "program to get more information. Set it to \"no\" to suppress\n"
134 "this message.\n", stderr
);
140 SCM_DEFINE(scm_include_deprecated_features
,
141 "include-deprecated-features", 0, 0, 0,
143 "Return @code{#t} iff deprecated features should be included "
144 "in public interfaces.")
145 #define FUNC_NAME s_scm_include_deprecated_features
147 return scm_from_bool (SCM_ENABLE_DEPRECATED
== 1);
155 scm_init_deprecation ()
157 #if (SCM_ENABLE_DEPRECATED == 1)
158 const char *level
= getenv ("GUILE_WARN_DEPRECATED");
160 level
= SCM_WARN_DEPRECATED_DEFAULT
;
161 if (!strcmp (level
, "detailed"))
163 else if (!strcmp (level
, "no"))
168 atexit (print_deprecation_summary
);
171 #include "libguile/deprecation.x"