Annotate function aliases in stubs

kocsismate · kocsismate · commit a43bc33fb257 · 2020-04-04T13:03:16.000+02:00
diff --git a/build/gen_stub.php b/build/gen_stub.php
diff --git a/ext/bz2/bz2.stub.php b/ext/bz2/bz2.stub.php
@@ -9,13 +9,22 @@ function bzopen($file, string $mode) {}
 /** @param resource $bz */
 function bzread($bz, int $length = 1024): string|false {}
 
-/** @param resource $bz */
+/**
+ * @param resource $bz
+ * @alias fwrite
+ */
 function bzwrite($bz, string $str, int $length = UNKNOWN): int|false {}
 
-/** @param resource $bz */
+/**
+ * @param resource $bz
+ * @alias fflush
+ */
 function bzflush($bz): bool {}
 
-/** @param resource $bz */
+/**
+ * @param resource $bz
+ * @alias fclose
+ */
 function bzclose($bz): bool {}
 
 /** @param resource $bz */
diff --git a/ext/ftp/ftp.stub.php b/ext/ftp/ftp.stub.php
@@ -113,7 +113,10 @@ function ftp_site($ftp, string $cmd): bool {}
 /** @param resource $ftp */
 function ftp_close($ftp): bool {}
 
-/** @param resource $ftp */
+/**
+ * @param resource $ftp
+ * @alias ftp_close
+ */
 function ftp_quit($ftp): bool {}
 
 /** @param resource $ftp */
diff --git a/ext/gmp/gmp.stub.php b/ext/gmp/gmp.stub.php
@@ -53,6 +53,7 @@ function gmp_div_r($a, $b, int $round = GMP_ROUND_ZERO): GMP|false {}
 /**
  * @param GMP|int|bool|string $a
  * @param GMP|int|bool|string $b
+ * @alias gmp_div_q
  */
 function gmp_div($a, $b, int $round = GMP_ROUND_ZERO): GMP|false {}
 
diff --git a/ext/imap/php_imap.stub.php b/ext/imap/php_imap.stub.php
@@ -27,6 +27,7 @@ function imap_headers($stream_id): array|false {}
 /** @param resource $stream_id */
 function imap_headerinfo($stream_id, int $msg_no, int $from_length = 0, int $subject_length = 0, string $default_host = UNKNOWN): stdClass|false {}
 
+/** @alias imap_headerinfo */
 function imap_header($stream_id, int $msg_no, int $from_length = 0, int $subject_length = 0, string $default_host = UNKNOWN): stdClass|false {}
 
 function imap_rfc822_parse_headers(string $headers, string $default_host = 'UNKNOWN'): \stdClass {}
@@ -38,7 +39,10 @@ function imap_rfc822_parse_adrlist(string $address_string, string $default_host)
 /** @param resource $stream_id */
 function imap_body($stream_id, int $msg_no, int $options = 0): string|false {}
 
-/** @param resource $stream_id */
+/**
+ * @param resource $stream_id
+ * @alias imap_body
+ */
 function imap_fetchtext($stream_id, int $msg_no, int $options = 0): string|false {}
 
 /**
@@ -91,10 +95,16 @@ function imap_check($stream_id): stdClass|false {}
 /** @param resource $stream_id */
 function imap_listscan($stream_id, string $ref, string $pattern, string $content): array|false {}
 
-/** @param resource $stream_id */
+/**
+ * @param resource $stream_id
+ * @alias imap_listscan
+ */
 function imap_scan($stream_id, string $ref, string $pattern, string $content): array|false {}
 
-/** @param resource $stream_id */
+/**
+ * @param resource $stream_id
+ * @alias imap_listscan
+ */
 function imap_scanmailbox($stream_id, string $ref, string $pattern, string $content): array|false {}
 
 /** @param resource $stream_id */
@@ -108,13 +118,19 @@ function imap_mail_compose(array $envelope, array $body): string|false {}
 /** @param resource $stream_id */
 function imap_createmailbox($stream_id, string $mailbox): bool {}
 
-/** @param resource $stream_id */
+/**
+ * @param resource $stream_id
+ * @alias imap_createmailbox
+ */
 function imap_create($stream_id, string $mailbox): bool {}
 
 /** @param resource $stream_id */
 function imap_renamemailbox($stream_id, string $old_name, string $new_name): bool {}
 
-/** @param resource $stream_id */
+/**
+ * @param resource $stream_id
+ * @alias imap_renamemailbox
+ */
 function imap_rename($stream_id, string $old_name, string $new_name): bool {}
 
 /** @param resource $stream_id */
@@ -170,13 +186,19 @@ function imap_msgno($stream_id, int $unique_msg_id): int|false {}
 /** @param resource $stream_id */
 function imap_list($stream_id, string $ref, string $pattern): array|false {}
 
-/** @param resource $stream_id */
+/**
+ * @param resource $stream_id
+ * @alias imap_list
+ */
 function imap_listmailbox($stream_id, string $ref, string $pattern): array|false {}
 
 /** @param resource $stream_id */
 function imap_lsub($stream_id, string $ref, string $pattern): array|false {}
 
-/** @param resource $stream_id */
+/**
+ * @param resource $stream_id
+ * @alias imap_lsub
+ */
 function imap_listsubscribed($stream_id, string $ref, string $pattern): array|false {}
 
 /** @param resource $stream_id */
diff --git a/ext/ldap/ldap.stub.php b/ext/ldap/ldap.stub.php
@@ -13,7 +13,10 @@ function ldap_connect(string $hostname = UNKNOWN, int $port = 389) {}
 /** @param resource $link_identifier */
 function ldap_unbind($link_identifier): bool {}
 
-/** @param resource $link_identifier */
+/**
+ * @param resource $link_identifier
+ * @alias ldap_unbind
+ */
 function ldap_close($link_identifier): bool {}
 
 /** @param resource $link_identifier */
@@ -111,6 +114,7 @@ function ldap_get_values_len($link_identifier, $result_entry_identifier, string
 /**
  * @param resource $link_identifier
  * @param resource $result_entry_identifier
+ * @alias ldap_get_values_len
  */
 function ldap_get_values($link_identifier, $result_entry_identifier, string $attribute): array|false {}
 
@@ -157,7 +161,10 @@ function ldap_mod_add_ext($link_identifier, string $dn, array $entry, array $ser
 /** @param resource $link_identifier */
 function ldap_mod_replace($link_identifier, string $dn, array $entry, array $servercontrols = []): bool {}
 
-/** @param resource $link_identifier */
+/**
+ * @param resource $link_identifier
+ * @alias ldap_mod_replace
+ */
 function ldap_modify($link_identifier, string $dn, array $entry, array $servercontrols = []): bool {}
 
 /**
diff --git a/ext/mysqli/mysqli.stub.php b/ext/mysqli/mysqli.stub.php
@@ -321,6 +321,7 @@ function mysqli_error_list(mysqli $mysql_link): array {}
 
 function mysqli_stmt_execute(mysqli_stmt $mysql_stmt): bool {}
 
+/** @alias mysqli_stmt_execute */
 function mysqli_execute(mysqli_stmt $mysql_stmt): bool {}
 
 function mysqli_fetch_field(mysqli_result $mysql_result): object|false {}
@@ -513,7 +514,11 @@ function mysqli_warning_count(mysqli $mysql_link): int {}
 
 function mysqli_refresh(mysqli $mysqli_link, int $options): bool {}
 
+/** @alias mysqli_real_escape_string */
 function mysqli_escape_string(mysqli $mysqli_link, string $string_to_escape): string {}
 
-/** @param mixed $value */
+/**
+ * @param mixed $value
+ * @alias mysqli_options
+ */
 function mysqli_set_opt(mysqli $mysqli_link, int $option, $value): bool {}
diff --git a/ext/odbc/odbc.stub.php b/ext/odbc/odbc.stub.php
@@ -34,6 +34,7 @@ function odbc_exec($connection_id, string $query, int $flags = UNKNOWN) {}
 /**
  * @param resource $connection_id
  * @return resource|false
+ * @alias odbc_exec
  */
 function odbc_do($connection_id, string $query, int $flags = UNKNOWN) {}
 
@@ -92,7 +93,10 @@ function odbc_field_type($result_id, int $field_number): string|false {}
 /** @param resource $result_id */
 function odbc_field_len($result_id, int $field_number): int|false {}
 
-/** @param resource $result_id */
+/**
+ * @param resource $result_id
+ * @alias odbc_field_len
+ */
 function odbc_field_precision($result_id, int $field_number): int|false {}
 
 /** @param resource $result_id */
diff --git a/ext/openssl/openssl.stub.php b/ext/openssl/openssl.stub.php
@@ -77,13 +77,17 @@ function openssl_pkey_get_public($cert) {}
 /**
  * @param resource|string|array $cert
  * @return resource|false
+ * @alias openssl_pkey_get_public
  */
 function openssl_get_publickey($cert) {}
 
 /** @param resource $key */
 function openssl_pkey_free($key): void {}
 
-/** @param resource $key */
+/**
+ * @param resource $key
+ * @alias openssl_pkey_free
+ */
 function openssl_free_key($key): void {}
 
 /**
@@ -95,6 +99,7 @@ function openssl_pkey_get_private($key, string $passphrase = UNKNOWN) {}
 /**
  * @param resource|string|array $key
  * @return resource|false
+ * @alias openssl_pkey_get_private
  */
 function openssl_get_privatekey($key, string $passphrase = UNKNOWN) {}
 
diff --git a/ext/pcntl/pcntl.stub.php b/ext/pcntl/pcntl.stub.php
@@ -50,6 +50,7 @@ function pcntl_alarm(int $seconds): int {}
 
 function pcntl_get_last_error(): int {}
 
+/** @alias pcntl_get_last_error */
 function pcntl_errno(): int {}
 
 #ifdef HAVE_GETPRIORITY
diff --git a/ext/posix/posix.stub.php b/ext/posix/posix.stub.php
@@ -93,6 +93,7 @@ function posix_setrlimit(int $resource, int $softlimit, int $hardlimit): bool {}
 
 function posix_get_last_error(): int {}
 
+/** @alias posix_get_last_error */
 function posix_errno(): int {}
 
 function posix_strerror(int $errno): string {}
diff --git a/ext/session/session.stub.php b/ext/session/session.stub.php
@@ -34,6 +34,7 @@ function session_status(): int {}
 
 function session_register_shutdown(): void {}
 
+/** @alias session_write_close */
 function session_commit(): bool {}
 
 function session_set_save_handler($open, $close = null, $read = null, $write = null, $destroy = null, $gc = null, $create_sid = null, $validate_sid = null, $update_timestamp = null): bool {}
diff --git a/ext/snmp/snmp.stub.php b/ext/snmp/snmp.stub.php
@@ -12,7 +12,10 @@ function snmpwalk(string $host, string $community, $object_id, int $timeout = UN
 /** @param array|string $object_id */
 function snmprealwalk(string $host, string $community, $object_id, int $timeout = UNKNOWN, int $retries = UNKNOWN): array|bool {}
 
-/** @param array|string $object_id */
+/**
+ * @param array|string $object_id
+ * @alias snmprealwalk
+ */
 function snmpwalkoid(string $host, string $community, $object_id, int $timeout = UNKNOWN, int $retries = UNKNOWN): array|bool {}
 
 /**
@@ -30,6 +33,7 @@ function snmp_set_enum_print(int $enum_print): bool {}
 
 function snmp_set_oid_output_format(int $oid_format): bool {}
 
+/** @alias snmp_set_oid_output_format */
 function snmp_set_oid_numeric_print(int $oid_format): bool {}
 
 /** @param array|string $object_id */
diff --git a/ext/sockets/sockets.stub.php b/ext/sockets/sockets.stub.php
@@ -61,13 +61,19 @@ function socket_sendto($socket, string $buf, int $len, int $flags, string $addr,
 /** @param resource $socket */
 function socket_get_option($socket, int $level, int $optname): array|int|false {}
 
-/** @param resource $socket */
+/**
+ * @param resource $socket
+ * @alias socket_get_option
+ */
 function socket_getopt($socket, int $level, int $optname): array|int|false {}
 
 /** @param resource $socket */
 function socket_set_option($socket, int $level, int $optname, $optval): bool {}
 
-/** @param resource $socket */
+/**
+ * @param resource $socket
+ * @alias socket_set_option
+ */
 function socket_setopt($socket, int $level, int $optname, $optval): bool {}
 
 #ifdef HAVE_SOCKETPAIR
diff --git a/ext/sodium/libsodium.stub.php b/ext/sodium/libsodium.stub.php
@@ -182,4 +182,5 @@ function sodium_bin2base64(string $string, int $id): string {}
 function sodium_base642bin(string $string, int $id, string $ignore  = ""): string {}
 #endif
 
+/** @alias sodium_crypto_box_publickey_from_secretkey */
 function sodium_crypto_scalarmult_base(string $key): string {}
diff --git a/ext/zlib/zlib.stub.php b/ext/zlib/zlib.stub.php
@@ -27,37 +27,70 @@ function gzdecode(string $data, int $max_decoded_len = 0): string|false {}
 
 function gzuncompress(string $data, int $max_decoded_len = 0): string|false {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fwrite
+ */
 function gzwrite($fp, string $str, int $length = UNKNOWN): int|false {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fwrite
+ */
 function gzputs($fp, string $str, int $length = UNKNOWN): int|false {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias rewind
+ */
 function gzrewind($fp): bool {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fclose
+ */
 function gzclose($fp): bool {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias feof
+ */
 function gzeof($fp): bool {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fgetc
+ */
 function gzgetc($fp): string|false {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fpassthru
+ */
 function gzpassthru($fp): int {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fseek
+ */
 function gzseek($fp, int $offset, int $whence = SEEK_SET): int {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias ftell
+ */
 function gztell($fp): int|false {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fread
+ */
 function gzread($fp, int $length): string|false {}
 
-/** @param resource $fp */
+/**
+ * @param resource $fp
+ * @alias fgets
+ */
 function gzgets($fp, int $length = 1024): string|false {}
 
 /** @return resource|false */
