Bug#33612166 DOXYGEN: UPGRADE TO VERSION 1.9.3 [no-close]

Upgrade Doxygen.in to doxygen version 1.9.2,
as an intermediate step towards doxygen 1.9.3

Fix misc warnings reported by doxygen 1.9.3

Change-Id: Ia9282040e5671b3b5c19047bdc33b4b57e72ec75

Author: marcalff

Doxyfile.in

@@ -1,4 +1,4 @@
-/* Copyright (c) 2020, 2021, Oracle and/or its affiliates.
+/* Copyright (c) 2020, 2022, Oracle and/or its affiliates.
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License, version 2.0,
@@ -32,9 +32,7 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301  USA */
   that states exception type and message. On any other thrown value it just
   reports general error.
 
-  @param funcname Name of the function where the error occures.
-
-  @retval returns nothing.
+  @param funcname Name of the function where the error occurs.
 */
 void mysql_components_handle_std_exception(const char *funcname) {
   try {

components/libminchassis/component_common.cc

@@ -1,4 +1,4 @@
-/* Copyright (c) 2016, 2021, Oracle and/or its affiliates.
+/* Copyright (c) 2016, 2022, Oracle and/or its affiliates.
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License, version 2.0,
@@ -511,14 +511,6 @@ DEFINE_BOOL_METHOD(mysql_dynamic_loader_imp::iterator_create,
   return true;
 }
 
-/**
-  Releases Component iterator. Releases read lock on dynamic loader.
-
-  @param iterator Component iterator handle.
-  @return Status of performed operation
-  @retval false success
-  @retval true failure
-*/
 DEFINE_METHOD(void, mysql_dynamic_loader_imp::iterator_release,
               (my_h_component_iterator iterator)) {
   try {

components/libminchassis/dynamic_loader.cc

@@ -1,4 +1,4 @@
-/* Copyright (c) 2016, 2021, Oracle and/or its affiliates.
+/* Copyright (c) 2016, 2022, Oracle and/or its affiliates.
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License, version 2.0,
@@ -144,9 +144,6 @@ class mysql_dynamic_loader_imp {
     Releases Component iterator. Releases read lock on dynamic loader.
 
     @param iterator Component iterator handle.
-    @return Status of performed operation
-    @retval false success
-    @retval true failure
   */
   static DEFINE_METHOD(void, iterator_release,
                        (my_h_component_iterator iterator));

components/libminchassis/dynamic_loader_imp.h

@@ -1,4 +1,4 @@
-/* Copyright (c) 2017, 2021, Oracle and/or its affiliates.
+/* Copyright (c) 2017, 2022, Oracle and/or its affiliates.
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License, version 2.0,
@@ -559,9 +559,6 @@ DEFINE_BOOL_METHOD(mysql_registry_imp::iterator_create,
   Releases Service implementations iterator. Releases read lock on registry.
 
   @param iterator Service Implementation iterator handle.
-  @return Status of performed operation
-  @retval false success
-  @retval true failure
 */
 DEFINE_METHOD(void, mysql_registry_imp::iterator_release,
               (my_h_service_iterator iterator)) {

components/libminchassis/registry.cc

@@ -1,4 +1,4 @@
-/* Copyright (c) 2016, 2021, Oracle and/or its affiliates.
+/* Copyright (c) 2016, 2022, Oracle and/or its affiliates.
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License, version 2.0,
@@ -250,9 +250,6 @@ class mysql_registry_imp {
     Releases Service implementations iterator. Releases read lock on registry.
 
     @param iterator Service Implementation iterator handle.
-    @return Status of performed operation
-    @retval false success
-    @retval true failure
   */
   static DEFINE_METHOD(void, iterator_release,
                        (my_h_service_iterator iterator));

components/libminchassis/registry_imp.h

@@ -139,8 +139,6 @@ bool fido_prepare_assert::sign_challenge() {
 
   @param [out] challenge_res     buffer to signed challenge
   @param [out] challenge_res_len length of signed challenge
-
-  @retval void
 */
 void fido_prepare_assert::get_signed_challenge(unsigned char **challenge_res,
                                                size_t &challenge_res_len) {
@@ -162,8 +160,6 @@ void fido_prepare_assert::get_signed_challenge(unsigned char **challenge_res,
 
   @param [in] scramble   buffer holding random salt
   @param [in] len        length of salt
-
-  @retval void
 */
 void fido_prepare_assert::set_scramble(unsigned char *scramble, size_t len) {
   fido_assert_set_clientdata_hash(m_assert, scramble, len);
@@ -174,8 +170,6 @@ void fido_prepare_assert::set_scramble(unsigned char *scramble, size_t len) {
 
   @param [in] cred   buffer holding credential ID
   @param [in] len    length of credential ID
-
-  @retval void
 */
 void fido_prepare_assert::set_cred_id(unsigned char *cred, size_t len) {
   fido_assert_allow_cred(m_assert, cred, len);
@@ -185,8 +179,6 @@ void fido_prepare_assert::set_cred_id(unsigned char *cred, size_t len) {
   Method to set the relying party name or id.
 
   @param [in] rp_id   buffer holding relying party name
-
-  @retval void
 */
 void fido_prepare_assert::set_rp_id(const char *rp_id) {
   fido_assert_set_rp(m_assert, rp_id);

libmysql/authentication_fido/fido_assertion.cc

@@ -1,4 +1,4 @@
-/* Copyright (c) 2021, Oracle and/or its affiliates.
+/* Copyright (c) 2021, 2022, Oracle and/or its affiliates.
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License, version 2.0,
@@ -228,8 +228,6 @@ bool fido_make_cred::make_challenge_response(
 
   @param [in] scramble   buffer holding random salt
   @param [in] len        length of salt
-
-  @retval void
 */
 void fido_make_cred::set_scramble(unsigned char *scramble, size_t len) {
   fido_cred_set_clientdata_hash(m_cred, scramble, len);
@@ -239,8 +237,6 @@ void fido_make_cred::set_scramble(unsigned char *scramble, size_t len) {
   Set method to set user name.
 
   @param [in] user   buffer holding user name
-
-  @retval void
 */
 void fido_make_cred::set_user(string user) {
   fido_cred_set_user(m_cred,
@@ -252,17 +248,13 @@ void fido_make_cred::set_user(string user) {
   Method to set the algorithm type
 
   @param [in] type   algorithm type
-
-  @retval void
 */
 void fido_make_cred::set_type(int type) { fido_cred_set_type(m_cred, type); }
 
 /**
   Method to set the relying party name or id
 
   @param [in] rp_id   buffer holding relying party name
-
-  @retval void
 */
 void fido_make_cred::set_rp_id(string rp_id) {
   fido_cred_set_rp(m_cred, rp_id.c_str(), nullptr);

libmysql/authentication_fido/fido_registration.cc

@@ -1237,7 +1237,7 @@
         </li>
       </ul>
 
-      Ignore this guidline if your intent is to test lettercase
+      Ignore this guideline if your intent is to test lettercase
       processing for SQL statements, of course.
 
       Use lowercase for @ref PAGE_MYSQLTEST "mysqltest" commands
@@ -1254,8 +1254,8 @@
     <li>
       Break a long SQL statement into multiple lines to make it more
       readable. This means that you will need to write it using a
-      “<b>;</b>” delimiter at the end of the statement rather than
-      using “<b>`--`</b>” at the beginning because the latter style
+      <b>";"</b> delimiter at the end of the statement rather than
+      using <b>"--"</b> at the beginning because the latter style
       works only for single-line statements.
     </li>
 

mysql-test/mysql-test-run.dox

@@ -1,4 +1,4 @@
-/* Copyright (c) 2019, 2021, Oracle and/or its affiliates.
+/* Copyright (c) 2019, 2022, Oracle and/or its affiliates.
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License, version 2.0,
@@ -57,8 +57,6 @@ enum_compression_algorithm get_compression_algorithm(std::string name) {
 
   @param       name    comma separated list of compression algorithm names
   @param[out]  list    list containing algorithm names
-
-  @retval void
 */
 void parse_compression_algorithms_list(std::string name,
                                        std::vector<std::string> &list) {