Add R_ext/PrtUtil.h stub with a #warning not to use. Also add a

#warning to R_ext/Callbacks.h.


git-svn-id: https://svn.r-project.org/R/trunk@89105 00db46b3-68df-0310-9c12-caf00c1e9a41

Author: luke

doc/NEWS.Rd

@@ -259,8 +259,12 @@
       formally in \file{R_ext/Callbacks.h} are now available in the new
       header file \file{R_ext/ObjectTable.h}.  This new header file
       should be used in packages instead of \file{R_ext/Callbacks.h}. To
-      ease the transition a stub file \file{R_ext/Callbacks.h} has been
-      added that just includes \file{R_ext/ObjectTable.h}.	
+      ease the transition, stub files \file{R_ext/Callbacks.h} and
+      \code{R_ext/PrtUtil.h} have been added. These stub files contain
+      \code{#warning} directives to signal warnings that these files
+      should not be used. The stub \file{R_ext/Callbacks.h} also
+      includes \file{R_ext/ObjectTable.h}. Packages including these headers
+      will install successfully but with warnings for using these files.
     }
   }
 

src/include/Makefile.win

@@ -21,7 +21,7 @@ R_EXT_HEADERS = \
   Connections.h Constants.h Error.h \
   GraphicsDevice.h GraphicsEngine.h Itermacros.h \
   Lapack.h Linpack.h MathThreads.h Memory.h \
-  Parse.h Print.h RS.h Rallocators.h Random.h \
+  Parse.h Print.h PrtUtil.h RS.h Rallocators.h Random.h \
   Rdynload.h Riconv.h RStartup.h Utils.h libextern.h \
   stats_package.h stats_stubs.h Visibility.h ObjectTable.h
 

src/include/R_ext/Callbacks.h

@@ -22,13 +22,14 @@
  */
 
 /* 
-   Not part of the API, subject to change at any time.
+   Not part of the API; this header file will be removed.
 */
 
 #ifndef R_FAKE_CALLBACKS_H
 #define R_FAKE_CALLBACKS_H
 
 // new code should include R_ext/ObjectTable.h directly
+#warning include R_ext/ObjectTable.h for R_ObjectTable declarations
 #include <R_ext/ObjectTable.h>
 
 #endif /* R_FAKE_CALLBACKS_H */

src/include/R_ext/Makefile.in

@@ -20,7 +20,7 @@ R_EXT_HEADERS = \
   Constants.h Error.h GetX11Image.h \
   GraphicsDevice.h GraphicsEngine.h Itermacros.h \
   Lapack.h Linpack.h MathThreads.h Memory.h QuartzDevice.h \
-  Parse.h Print.h RS.h Rallocators.h Random.h \
+  Parse.h Print.h PrtUtil.h RS.h Rallocators.h Random.h \
   Rdynload.h Riconv.h RStartup.h Utils.h eventloop.h libextern.h \
   stats_package.h stats_stubs.h Visibility.h ObjectTable.h
 

src/include/R_ext/PrtUtil.h

@@ -0,0 +1,32 @@
+/*
+ *  R : A Computer Language for Statistical Data Analysis
+ *  Copyright (C) 1998-2023    The R Core Team
+ *
+ *  This header file is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU Lesser General Public License as published by
+ *  the Free Software Foundation; either version 2.1 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This file is part of R. R is distributed under the terms of the
+ *  GNU General Public License, either Version 2, June 1991 or Version 3,
+ *  June 2007. See doc/COPYRIGHTS for details of the copyright status of R.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public License
+ *  along with this program; if not, a copy is available at
+ *  https://www.R-project.org/Licenses/
+ */
+
+/*
+   Not part of the API; this header file will be removed.
+ */
+#ifndef FAKE_PRTUTIL_H_
+#define FAKE_PRTUTIL_H_
+
+#warning non-API header file R_ext/PrtUtil.h is obsolete and will be removed
+
+#endif /* FAKE_PRTUTIL_H_ */