interface - add deprecated warnings for old fn names

Author: jeremylt

Makefile

@@ -876,6 +876,7 @@ install : $(libceed) $(OBJDIR)/ceed.pc
 	  "$(includedir)/ceed/jit-source/gallery/" "$(includedir)/ceed/jit-source/magma/"\
 	  "$(includedir)/ceed/jit-source/sycl/" "$(libdir)" "$(pkgconfigdir)")
 	$(INSTALL_DATA) include/ceed/ceed.h "$(DESTDIR)$(includedir)/ceed/"
+	$(INSTALL_DATA) include/ceed/deprecated.h "$(DESTDIR)$(includedir)/ceed/"
 	$(INSTALL_DATA) include/ceed/types.h "$(DESTDIR)$(includedir)/ceed/"
 	$(INSTALL_DATA) include/ceed/ceed-f32.h "$(DESTDIR)$(includedir)/ceed/"
 	$(INSTALL_DATA) include/ceed/ceed-f64.h "$(DESTDIR)$(includedir)/ceed/"

include/ceed/ceed.h

@@ -474,12 +474,7 @@ CEED_EXTERN int  CeedOperatorAssemblyDataStrip(CeedOperator op);
 CEED_EXTERN int  CeedOperatorDestroy(CeedOperator *op);
 
 // Compatibility with previous composite CeedOperator naming
-#define CeedCompositeOperatorCreate(a, b) CeedOperatorCreateComposite(a, b)
-#define CeedCompositeOperatorAddSub(a, b) CeedOperatorCompositeAddSub(a, b)
-#define CeedCompositeOperatorGetNumSub(a, b) CeedOperatorCompositeGetNumSub(a, b)
-#define CeedCompositeOperatorGetSubList(a, b) CeedOperatorCompositeGetSubList(a, b)
-#define CeedCompositeOperatorGetSubByName(a, b) CeedOperatorCompositeGetSubByName(a, b, c)
-#define CeedCompositeOperatorGetMultiplicity(a, b, c, d) CeedOperatorCompositeGetMultiplicity(a, b, c, d)
+#include "deprecated.h"
 
 CEED_EXTERN int CeedOperatorGetFieldByName(CeedOperator op, const char *field_name, CeedOperatorField *op_field);
 CEED_EXTERN int CeedOperatorFieldGetName(CeedOperatorField op_field, const char **field_name);

include/ceed/deprecated.h

@@ -0,0 +1,36 @@
+/// Copyright (c) 2017-2025, Lawrence Livermore National Security, LLC and other CEED contributors.
+/// All Rights Reserved. See the top-level LICENSE and NOTICE files for details.
+///
+/// SPDX-License-Identifier: BSD-2-Clause
+///
+/// This file is part of CEED:  http://github.com/ceed
+
+/// @file
+/// Public header for user and utility components of libCEED
+#pragma once
+
+// Compatibility with previous composite CeedOperator naming
+[[deprecated("Use CeedOperatorCreateComposite()")]]
+static inline int CeedCompositeOperatorCreate(Ceed a, CeedOperator *b) {
+  return CeedOperatorCreateComposite(a, b);
+}
+[[deprecated("Use CeedOperatorCompositeAddSub()")]]
+static inline int CeedCompositeOperatorAddSub(CeedOperator a, CeedOperator b) {
+  return CeedOperatorCompositeAddSub(a, b);
+}
+[[deprecated("Use CeedOperatorCompositeGetNumSub()")]]
+static inline int CeedCompositeOperatorGetNumSub(CeedOperator a, CeedInt *b) {
+  return CeedOperatorCompositeGetNumSub(a, b);
+}
+[[deprecated("Use CeedOperatorCompositeGetSubList()")]]
+static inline int CeedCompositeOperatorGetSubList(CeedOperator a, CeedOperator **b) {
+  return CeedOperatorCompositeGetSubList(a, b);
+}
+[[deprecated("Use CeedCompositeOperatorGetSubByName()")]]
+static inline int CeedCompositeOperatorGetSubByName(CeedOperator a, const char *b, CeedOperator *c) {
+  return CeedOperatorCompositeGetSubByName(a, b, c);
+}
+[[deprecated("Use CeedOperatorCompositeGetMultiplicity()")]]
+static inline int CeedCompositeOperatorGetMultiplicity(CeedOperator a, CeedInt b, CeedInt *c, CeedVector d) {
+  return CeedOperatorCompositeGetMultiplicity(a, b, c, d);
+}

python/build_ceed_cffi.py

@@ -34,6 +34,7 @@ def get_ceed_dirs():
         lines += [line.strip() for line in f if
                   not (line.startswith("#") and not line.startswith("#include")) and
                   not line.startswith("  static") and
+                  not line.startswith("#include \"deprecated.h\"") and
                   not line.startswith("  CEED_QFUNCTION_ATTR") and
                   "CeedErrorImpl" not in line and
                   "const char *, ...);" not in line and