Apply suggestions from code review

Co-authored-by: Gina Peter Banyard <girgias@php.net>

Author: TimWolla

ext/date/php_date.stub.php

@@ -121,13 +121,13 @@ function checkdate(int $month, int $day, int $year): bool {}
 /**
  * @refcount 1
  */
-#[\Deprecated]
+#[\Deprecated(since: '8.1', message: 'use the IntlDateFormatter::format() method instead')]
 function strftime(string $format, ?int $timestamp = null): string|false {}
 
 /**
  * @refcount 1
  */
-#[\Deprecated]
+#[\Deprecated(since: '8.1', message: 'use the IntlDateFormatter::format() method instead')]
 function gmstrftime(string $format, ?int $timestamp = null): string|false {}
 
 function time(): int {}
@@ -261,7 +261,7 @@ function date_default_timezone_get(): string {}
 /**
  * @refcount 1
  */
-#[\Deprecated]
+#[\Deprecated(message: 'Use date_sun_info() instead', since: '8.1')]
 function date_sunrise(
     int $timestamp, int $returnFormat = SUNFUNCS_RET_STRING,
     ?float $latitude = null, ?float $longitude = null, ?float $zenith = null,
@@ -270,7 +270,7 @@ function date_sunrise(
 /**
  * @refcount 1
  */
-#[\Deprecated]
+#[\Deprecated(message: 'Use date_sun_info() instead', since: '8.1')]
 function date_sunset(
     int $timestamp, int $returnFormat = SUNFUNCS_RET_STRING,
     ?float $latitude = null, ?float $longitude = null, ?float $zenith = null,

ext/enchant/enchant.stub.php

@@ -90,7 +90,7 @@ function enchant_dict_add(EnchantDictionary $dictionary, string $word): void {}
 /**
 * @alias enchant_dict_add
 */
-#[\Deprecated(since: '8.1')]
+#[\Deprecated(since: '8.1', message: 'use enchant_dict_add() instead')]
 function enchant_dict_add_to_personal(EnchantDictionary $dictionary, string $word): void {}
 
 function enchant_dict_add_to_session(EnchantDictionary $dictionary, string $word): void {}
@@ -100,7 +100,7 @@ function enchant_dict_is_added(EnchantDictionary $dictionary, string $word): boo
 /**
 * @alias enchant_dict_is_added
 */
-#[\Deprecated(since: '8.1')]
+#[\Deprecated(since: '8.1', message: 'use enchant_dict_is_added() instead')]
 function enchant_dict_is_in_session(EnchantDictionary $dictionary, string $word): bool {}
 
 function enchant_dict_store_replacement(EnchantDictionary $dictionary, string $misspelled, string $correct): void {}

ext/intl/php_intl.stub.php

@@ -201,7 +201,7 @@ function intlcal_after(IntlCalendar $calendar, IntlCalendar $other): bool {}
 
 function intlcal_before(IntlCalendar $calendar, IntlCalendar $other): bool {}
 
-#[\Deprecated(since: '8.4')]
+#[\Deprecated(message: 'Use IntlCalendar::set(), IntlCalendar::setDate(), or IntlCalendar::setDateTime() instead', since: '8.4')]
 function intlcal_set(IntlCalendar $calendar, int $year, int $month, int $dayOfMonth = UNKNOWN, int $hour = UNKNOWN, int $minute = UNKNOWN, int $second = UNKNOWN): true {}
 
 /** @param int|bool $value */
@@ -279,7 +279,7 @@ function intlcal_get_error_message(IntlCalendar $calendar): string|false {}
  * @param int $minute
  * @param int $second
  */
-#[\Deprecated(since: '8.4')]
+#[\Deprecated(message: 'Use IntlGregorianCalendar::__construct(), IntlGregorianCalendar::createFromDate(), or IntlGregorianCalendar::createFromDateTime() instead', since: '8.4')]
 function intlgregcal_create_instance($timezoneOrYear = UNKNOWN, $localeOrMonth = UNKNOWN, $day = UNKNOWN, $hour = UNKNOWN, $minute = UNKNOWN, $second = UNKNOWN): ?IntlGregorianCalendar {}
 
 function intlgregcal_set_gregorian_change(IntlGregorianCalendar $calendar, float $timestamp): bool {}

ext/openssl/openssl.stub.php

@@ -443,7 +443,7 @@ function openssl_x509_checkpurpose(OpenSSLCertificate|string $certificate, int $
 
 function openssl_x509_read(OpenSSLCertificate|string $certificate): OpenSSLCertificate|false {}
 
-#[\Deprecated]
+#[\Deprecated(message: 'OpenSSLCertificate object is freed automatically', since: '8.0')]
 function openssl_x509_free(OpenSSLCertificate $certificate): void {}
 
 /**
@@ -507,13 +507,13 @@ function openssl_pkey_get_public($public_key): OpenSSLAsymmetricKey|false {}
  */
 function openssl_get_publickey($public_key): OpenSSLAsymmetricKey|false {}
 
-#[\Deprecated]
+#[\Deprecated(message: 'OpenSSLAsymmetricKey object is freed automatically', since: '8.0')]
 function openssl_pkey_free(OpenSSLAsymmetricKey $key): void {}
 
 /**
  * @alias openssl_pkey_free
  */
-#[\Deprecated]
+#[\Deprecated(message: 'OpenSSLAsymmetricKey object is freed automatically', since: '8.0')]
 function openssl_free_key(OpenSSLAsymmetricKey $key): void {}
 
 /**

ext/pgsql/pgsql.stub.php

@@ -666,7 +666,7 @@ function pg_field_prtlen(PgSql\Result $result, $row, string|int $field = UNKNOWN
     /**
      * @param string|int $row
      */
-    #[\Deprecated]
+    #[\Deprecated(since: '8.0', message: 'use pg_field_prtlen() instead')]
     function pg_fieldprtlen(PgSql\Result $result, $row, string|int $field = UNKNOWN): int|false {}
 
     /** @param string|int|null $row */
@@ -675,7 +675,7 @@ function pg_field_is_null(PgSql\Result $result, $row, string|int $field = UNKNOW
     /**
      * @param string|int $row
      */
-    #[\Deprecated]
+    #[\Deprecated(since: '8.0', message: 'use pg_field_is_null() instead')]
     function pg_fieldisnull(PgSql\Result $result, $row, string|int $field = UNKNOWN): int|false {}
 
     function pg_free_result(PgSql\Result $result): bool {}

ext/shmop/shmop.stub.php

@@ -12,7 +12,7 @@ function shmop_open(int $key, string $mode, int $permissions, int $size): Shmop|
 
 function shmop_read(Shmop $shmop, int $offset, int $size): string {}
 
-#[\Deprecated]
+#[\Deprecated(message: 'Shmop object is freed automatically', since: '8.0')]
 function shmop_close(Shmop $shmop): void {}
 
 function shmop_size(Shmop $shmop): int {}

ext/standard/basic_functions.stub.php

@@ -2138,7 +2138,7 @@ function crypt(#[\SensitiveParameter] string $string, string $salt): string {}
  * @return array<string, int|string>|false
  * @refcount 1
  */
-#[\Deprecated]
+#[\Deprecated(since: '8.2', message: 'use date_parse_from_format() (for locale-independent parsing), or IntlDateFormatter::parse() (for locale-dependent parsing) instead')]
 function strptime(string $timestamp, string $format): array|false {}
 #endif
 
@@ -2656,14 +2656,14 @@ function substr_compare(string $haystack, string $needle, int $offset, ?int $len
  * @compile-time-eval
  * @refcount 1
  */
-#[\Deprecated]
+#[\Deprecated(since: '8.2', message: 'visit the php.net documentation for various alternatives')]
 function utf8_encode(string $string): string {}
 
 /**
  * @compile-time-eval
  * @refcount 1
  */
-#[\Deprecated]
+#[\Deprecated(since: '8.2', message: 'visit the php.net documentation for various alternatives')]
 function utf8_decode(string $string): string {}
 
 /* dir.c */