/*

In the current release model, versions are released like the following
(the table shows the year/quarter of the planned GA release):

        Q1              Q2              Q3              Q4
2022    10.7            10.8            10.9            10.10
2023    10.11-LTS       11.0            11.1            11.2
2024    11.3            11.4            11.5            11.6
2025    11.7-LTS        12.0            12.1            12.2
2026    12.3            12.4            12.5            12.6
2027    12.7-LTS        13.0            13.1            13.2
2028    13.3            13.4            13.5            13.6
2029    13.7-LTS        14.0            14.1            14.2
...

A deprecated feature can be removed only when all releases when it's
not deprecated have reached EOL. For example, if something was
deprecated in 11.3, then 10.11 (where it wasn't deprecated) will reach
EOL in Q1 2028 (standard 5 years LTS life time). Meaning, the feature can
be removed in 13.4.

When the release model changes, the table above and templates below
have to be updated.
*/

template<uint V> static inline void check_deprecated_version(void)
{
  static_assert (
     V <= 1004 ? MYSQL_VERSION_ID < 110500 :   /* until 10.4  EOL */
     V <= 1005 ? MYSQL_VERSION_ID < 120100 :   /* until 10.5  EOL */
     V <= 1010 ? MYSQL_VERSION_ID < 120500 :   /* until 10.6  EOL */
     V <= 1107 ? MYSQL_VERSION_ID < 130400 :   /* until 10.11 EOL */
     V == 999999,    /* only for sys_var::do_deprecated_warning() */
     "check_deprecated_version failed"
  );
}

/*
  V is the 2-component 4-digit version where something was deprecated.
  For example, if deprecated in 11.2: warn_deprecated<1102>(thd, "something")
*/
template<uint V> static inline void warn_deprecated(THD *thd,
                                      const char *what, const char *to= NULL)
{
  check_deprecated_version<V>();
  push_warning_printf(thd, Sql_condition::WARN_LEVEL_WARN,
                      ER_WARN_DEPRECATED_SYNTAX, ER_THD(thd, to && *to
                         ? ER_WARN_DEPRECATED_SYNTAX
                         : ER_WARN_DEPRECATED_SYNTAX_NO_REPLACEMENT),
                      what, to);
}

template<uint V> static inline void warn_deprecated(const char *what,
                                                    const char *to= NULL)
{
  check_deprecated_version<V>();
  sql_print_warning(to && *to
                    ? "'%s' is deprecated and will be removed in a future release. Please use %s instead"
                    : "'%s' is deprecated and will be removed in a future release",
                    what, to);
}

/* Prevent direct usage of the error that bypasses the template */
#undef ER_WARN_DEPRECATED_SYNTAX
#undef ER_WARN_DEPRECATED_SYNTAX_WITH_VER
#undef ER_WARN_DEPRECATED_SYNTAX_NO_REPLACEMENT
