TODOs.txt updated, we need a solution here, too...
authorRoland Häder <roland@mxchange.org>
Fri, 31 Jul 2009 18:36:42 +0000 (18:36 +0000)
committerRoland Häder <roland@mxchange.org>
Fri, 31 Jul 2009 18:36:42 +0000 (18:36 +0000)
docs/TODOs.txt

index 6e63d6af421ec7b8e2a8c124451a4ae873a7ee4a..74af583a5a2c551f5510817b3c9131158562bfa8 100644 (file)
@@ -1,4 +1,4 @@
-### WARNING: THIS FILE IS AUTO-GENERATED BY ./todo-builder.sh ###
+### WARNING: THIS FILE IS AUTO-GENERATED BY todo-builder.sh ###
 ### DO NOT EDIT THIS FILE. ###
 ./application/admin/main/actions/web/class_WebAdminLoginWelcomeAction.php:54:   * @todo        Maybe we need to do something later here
 ./application/admin/main/actions/web/class_WebAdminLoginWelcomeAction.php:66:   * @todo        0% done
 ### DO NOT EDIT THIS FILE. ###
 ./application/admin/main/actions/web/class_WebAdminLoginWelcomeAction.php:54:   * @todo        Maybe we need to do something later here
 ./application/admin/main/actions/web/class_WebAdminLoginWelcomeAction.php:66:   * @todo        0% done
@@ -6,7 +6,12 @@
 ./application/admin/main/login/class_AdminUserLogin.php:67:     * @todo        We need to add something here which will make more than one
 ./application/admin/main/login/class_AdminUserLogin.php:68:     * @todo        guest logins, users who are online but based on the same
 ./application/admin/main/login/class_AdminUserLogin.php:69:     * @todo        user account.
 ./application/admin/main/login/class_AdminUserLogin.php:67:     * @todo        We need to add something here which will make more than one
 ./application/admin/main/login/class_AdminUserLogin.php:68:     * @todo        guest logins, users who are online but based on the same
 ./application/admin/main/login/class_AdminUserLogin.php:69:     * @todo        user account.
-./application/selector/class_ApplicationSelector.php:256:       * @todo        Finish handling all applications here
+./application/install/main/actions/class_BaseInstallAction.php:42:      * @todo        0% done
+./application/install/main/actions/class_BaseInstallAction.php:54:      * @todo        Add some filters here
+./application/install/main/commands/web/failed/class_WebInstallFailedCommand.php:58:    * @todo        0% done
+./application/install/main/controller/web/class_WebInstallFailedController.php:40:      * @todo        Add some filters to this controller
+./application/install/main/filter/class_BaseInstallFilter.php:42:       * @todo        0%
+./application/selector/class_ApplicationSelector.php:255:       * @todo        Finish handling all applications here
 ./application/ship-simu/main/actions/class_BaseShipSimuAction.php:42:   * @todo        0% done
 ./application/ship-simu/main/actions/class_BaseShipSimuAction.php:54:   * @todo        Add some filters here
 ./application/ship-simu/main/actions/ship-simu/class_ShipSimuLoginAction.php:54:        * @todo        Maybe we need to do something later here
 ./application/ship-simu/main/actions/class_BaseShipSimuAction.php:42:   * @todo        0% done
 ./application/ship-simu/main/actions/class_BaseShipSimuAction.php:54:   * @todo        Add some filters here
 ./application/ship-simu/main/actions/ship-simu/class_ShipSimuLoginAction.php:54:        * @todo        Maybe we need to do something later here
@@ -43,7 +48,6 @@
 ./application/ship-simu/main/filter/government/class_ShipSimuGovernmentPaysStartupHelpFilter.php:54:    * @todo        0% done
 ./application/ship-simu/main/filter/government/class_ShipSimuGovernmentPaysTrainingFilter.php:54:       * @todo        0% done
 ./application/ship-simu/main/filter/validator/class_RefillRequestValidatorFilter.php:54:        * @todo        Maybe we need to added some more generic tests on the request here?
 ./application/ship-simu/main/filter/government/class_ShipSimuGovernmentPaysStartupHelpFilter.php:54:    * @todo        0% done
 ./application/ship-simu/main/filter/government/class_ShipSimuGovernmentPaysTrainingFilter.php:54:       * @todo        0% done
 ./application/ship-simu/main/filter/validator/class_RefillRequestValidatorFilter.php:54:        * @todo        Maybe we need to added some more generic tests on the request here?
-./application/ship-simu/main/filter/verifier/class_BirthdayVerifierFilter.php:54:       * @todo        0% done
 ./application/ship-simu/main/government/class_SimplifiedGovernment.php:10: * @todo             Find an interface for governments
 ./application/ship-simu/main/login/class_ShipSimuUserLogin.php:67:      * @todo        We need to add something here which will make more than one
 ./application/ship-simu/main/login/class_ShipSimuUserLogin.php:68:      * @todo        guest logins, users who are online but based on the same
 ./application/ship-simu/main/government/class_SimplifiedGovernment.php:10: * @todo             Find an interface for governments
 ./application/ship-simu/main/login/class_ShipSimuUserLogin.php:67:      * @todo        We need to add something here which will make more than one
 ./application/ship-simu/main/login/class_ShipSimuUserLogin.php:68:      * @todo        guest logins, users who are online but based on the same
@@ -57,7 +61,6 @@
 ./application/ship-simu/main/wrapper/class_CompanyDatabaseWrapper.php:108:      * @todo        Find an interface suitable for all types of companies
 ./application/ship-simu/main/wrapper/class_CompanyDatabaseWrapper.php:118:      * @todo        Find an interface suitable for all types of companies
 ./application/ship-simu/main/wrapper/class_CompanyDatabaseWrapper.php:49:       * @todo        Find an interface which is suitable for all companies
 ./application/ship-simu/main/wrapper/class_CompanyDatabaseWrapper.php:108:      * @todo        Find an interface suitable for all types of companies
 ./application/ship-simu/main/wrapper/class_CompanyDatabaseWrapper.php:118:      * @todo        Find an interface suitable for all types of companies
 ./application/ship-simu/main/wrapper/class_CompanyDatabaseWrapper.php:49:       * @todo        Find an interface which is suitable for all companies
-./inc/classes/exceptions/database/wrapper/class_WrapperUserNameNotFoundException.php:10: * @todo               This class is no longer used
 ./inc/classes/exceptions/io/class_FileNotFoundException.php:10: * @todo                Rename this class to FileIoException
 ./inc/classes/exceptions/main/class_ClassNotFoundException.php:10: * @todo             Rename this class to NoClassException
 ./inc/classes/exceptions/main/class_ConfigEntryNotFoundException.php:10: * @todo               Rename this class to NoFoundEntryException
 ./inc/classes/exceptions/io/class_FileNotFoundException.php:10: * @todo                Rename this class to FileIoException
 ./inc/classes/exceptions/main/class_ClassNotFoundException.php:10: * @todo             Rename this class to NoClassException
 ./inc/classes/exceptions/main/class_ConfigEntryNotFoundException.php:10: * @todo               Rename this class to NoFoundEntryException
 ./inc/classes/exceptions/main/class_GetterNotFoundException.php:10: * @todo            This class is no longer needed!
 ./inc/classes/exceptions/main/class_NoArrayCreatedException.php:10: * @todo            This class is no longer needed
 ./inc/classes/exceptions/main/class_NoArrayException.php:10: * @todo           Is this exception still needed?
 ./inc/classes/exceptions/main/class_GetterNotFoundException.php:10: * @todo            This class is no longer needed!
 ./inc/classes/exceptions/main/class_NoArrayCreatedException.php:10: * @todo            This class is no longer needed
 ./inc/classes/exceptions/main/class_NoArrayException.php:10: * @todo           Is this exception still needed?
-./inc/classes/exceptions/template/class_ViewHelperNotFoundException.php:10: * @todo            Rename this class to NoViewHelperException
-./inc/classes/main/class_BaseFrameworkSystem.php:216:   * @todo        This is old code. Do we still need this old lost code?
-./inc/classes/main/class_BaseFrameworkSystem.php:318:   * @todo        SearchableResult and UpdateableResult shall have a super interface to use here
+./inc/classes/main/class_BaseFrameworkSystem.php:1100:  * @todo        Write a logging mechanism for productive mode
+./inc/classes/main/class_BaseFrameworkSystem.php:1114:                 // @TODO Finish this part!
+./inc/classes/main/class_BaseFrameworkSystem.php:198:   * @todo        This is old code. Do we still need this old lost code?
+./inc/classes/main/class_BaseFrameworkSystem.php:301:   * @todo        SearchableResult and UpdateableResult shall have a super interface to use here
 ./inc/classes/main/commands/web/class_WebLoginAreaCommand.php:64:       * @todo        Add some stuff here: Some personal data, app/game related data
 ./inc/classes/main/commands/web/class_WebLoginAreaCommand.php:64:       * @todo        Add some stuff here: Some personal data, app/game related data
+./inc/classes/main/console/class_ConsoleTools.php:41:   * @todo        We should connect this to a caching class to cache DNS requests
+./inc/classes/main/console/class_ConsoleTools.php:54:          // @TODO Here should the cacher be implemented
+./inc/classes/main/controller/console/class_ConsoleDefaultController.php:10: * @todo           This controller shall still provide some headlines for sidebars
 ./inc/classes/main/controller/login/class_WebLoginAreaController.php:40:        * @todo        Add some morer filters to this controller
 ./inc/classes/main/controller/web/class_WebConfirmController.php:40:    * @todo        Add some filters to this controller
 ./inc/classes/main/controller/web/class_WebDefaultController.php:10: * @todo           This controller shall still provide some headlines for sidebars
 ./inc/classes/main/controller/login/class_WebLoginAreaController.php:40:        * @todo        Add some morer filters to this controller
 ./inc/classes/main/controller/web/class_WebConfirmController.php:40:    * @todo        Add some filters to this controller
 ./inc/classes/main/controller/web/class_WebDefaultController.php:10: * @todo           This controller shall still provide some headlines for sidebars
 ./inc/classes/main/controller/web/class_WebStatusController.php:10: * @todo            This controller shall still provide some headlines for sidebars
 ./inc/classes/main/criteria/search/class_SearchCriteria.php:114:        * @todo        Find a nice casting here. (int) allows until and including 32766.
 ./inc/classes/main/criteria/search/class_SearchCriteria.php:94:         * @todo        Find a nice casting here. (int) allows until and including 32766.
 ./inc/classes/main/controller/web/class_WebStatusController.php:10: * @todo            This controller shall still provide some headlines for sidebars
 ./inc/classes/main/criteria/search/class_SearchCriteria.php:114:        * @todo        Find a nice casting here. (int) allows until and including 32766.
 ./inc/classes/main/criteria/search/class_SearchCriteria.php:94:         * @todo        Find a nice casting here. (int) allows until and including 32766.
-./inc/classes/main/database/databases/class_LocalFileDatabase.php:347:  * @todo        Do some checks on the database directory and files here
+./inc/classes/main/database/databases/class_LocalFileDatabase.php:349:  * @todo        Do some checks on the database directory and files here
 ./inc/classes/main/discovery/payment/class_LocalPaymentDiscovery.php:86:        * @todo        0% done
 ./inc/classes/main/filter/change/class_EmailChangeFilter.php:54:        * @todo        Implement email change of the user here. HINT: Use the User class!
 ./inc/classes/main/filter/change/class_PasswordChangeFilter.php:55:     * @todo        Finished updating user password hash here. HINT: Use the User class again.
 ./inc/classes/main/filter/news/class_NewsProcessFilter.php:55:  * @todo        Unfinished stub, add functionality here
 ./inc/classes/main/filter/payment/class_PaymentDiscoveryFilter.php:97:  * @todo        0% done
 ./inc/classes/main/filter/update/class_UserUpdateFilter.php:55:         * @todo        Add more user updates here
 ./inc/classes/main/discovery/payment/class_LocalPaymentDiscovery.php:86:        * @todo        0% done
 ./inc/classes/main/filter/change/class_EmailChangeFilter.php:54:        * @todo        Implement email change of the user here. HINT: Use the User class!
 ./inc/classes/main/filter/change/class_PasswordChangeFilter.php:55:     * @todo        Finished updating user password hash here. HINT: Use the User class again.
 ./inc/classes/main/filter/news/class_NewsProcessFilter.php:55:  * @todo        Unfinished stub, add functionality here
 ./inc/classes/main/filter/payment/class_PaymentDiscoveryFilter.php:97:  * @todo        0% done
 ./inc/classes/main/filter/update/class_UserUpdateFilter.php:55:         * @todo        Add more user updates here
-./inc/classes/main/filter/verifier/class_AccountPasswordVerifierFilter.php:56:  * @todo        Rewrite handling of different password fields
+./inc/classes/main/filter/verifier/class_AccountPasswordVerifierFilter.php:57:  * @todo        Rewrite handling of different password fields
 ./inc/classes/main/helper/class_BaseHelper.php:175:     * @todo        Rewrite this method using a helper class for filtering data
 ./inc/classes/main/helper/web/class_BaseWebHelper.php:151:      * @todo        Implement check if rules have been changed
 ./inc/classes/main/helper/web/forms/class_WebFormHelper.php:102:        * @todo        Add some unique PIN here to bypass problems with some browser and/or extensions
 ./inc/classes/main/helper/web/forms/class_WebFormHelper.php:621:        * @todo        Add checking if sub option is already added
 ./inc/classes/main/helper/web/forms/class_WebFormHelper.php:649:        * @todo        Add checking if sub option is already added
 ./inc/classes/main/helper/class_BaseHelper.php:175:     * @todo        Rewrite this method using a helper class for filtering data
 ./inc/classes/main/helper/web/class_BaseWebHelper.php:151:      * @todo        Implement check if rules have been changed
 ./inc/classes/main/helper/web/forms/class_WebFormHelper.php:102:        * @todo        Add some unique PIN here to bypass problems with some browser and/or extensions
 ./inc/classes/main/helper/web/forms/class_WebFormHelper.php:621:        * @todo        Add checking if sub option is already added
 ./inc/classes/main/helper/web/forms/class_WebFormHelper.php:649:        * @todo        Add checking if sub option is already added
-./inc/classes/main/helper/web/links/class_WebLinkHelper.php:137:        * @todo        Completely unimplemented
+./inc/classes/main/helper/web/links/class_WebLinkHelper.php:191:        * @todo        Completely unimplemented
 ./inc/classes/main/images/class_BaseImage.php:160:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:170:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:180:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:160:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:170:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:180:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:238:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:249:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:259:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:238:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:249:      * @todo        Find something usefull for this method.
 ./inc/classes/main/images/class_BaseImage.php:259:      * @todo        Find something usefull for this method.
+./inc/classes/main/io/class_FileIoStream.php:78:        * @todo        This method needs heavy rewrite
 ./inc/classes/main/mailer/debug/class_DebugMailer.php:124:      * @todo        0% done
 ./inc/classes/main/mailer/debug/class_DebugMailer.php:124:      * @todo        0% done
+./inc/classes/main/output/class_ConsoleOutput.php:61:          // @TODO Need to rewrite this to $requestInstance->addHeader()
+./inc/classes/main/output/class_WebOutput.php:55:                      // @TODO Need to rewrite this to $requestInstance->addHeader()
 ./inc/classes/main/points/class_UserPoints.php:107:                    // @TODO Load points here
 ./inc/classes/main/points/class_UserPoints.php:85:      * @todo        Finish loading part of points
 ./inc/classes/main/points/class_UserPoints.php:107:                    // @TODO Load points here
 ./inc/classes/main/points/class_UserPoints.php:85:      * @todo        Finish loading part of points
+./inc/classes/main/request/console/class_ConsoleRequest.php:115:               // @TODO There are no cookies on console
+./inc/classes/main/request/console/class_ConsoleRequest.php:55:         * @todo        Needs to be implemented
+./inc/classes/main/resolver/controller/class_BaseControllerResolver.php:137:                   // @TODO Maybe we need to log this?
 ./inc/classes/main/response/http/class_HttpResponse.php:77:     * @todo        Encryption of cookie data not yet supported.
 ./inc/classes/main/response/http/class_HttpResponse.php:78:     * @todo        Why are these parameters conflicting?
 ./inc/classes/main/response/http/class_HttpResponse.php:79:     * @todo        If the return statement is removed and setcookie() commented out,
 ./inc/classes/main/response/http/class_HttpResponse.php:77:     * @todo        Encryption of cookie data not yet supported.
 ./inc/classes/main/response/http/class_HttpResponse.php:78:     * @todo        Why are these parameters conflicting?
 ./inc/classes/main/response/http/class_HttpResponse.php:79:     * @todo        If the return statement is removed and setcookie() commented out,
 ./inc/classes/main/result/class_DatabaseResult.php:383:4        * @todo        Find a caching way without modifying the result array
 ./inc/classes/main/rng/class_RandomNumberGenerator.php:154:     * @todo        I had a better random number generator here but now it is somewhere lost :(
 ./inc/classes/main/rng/class_RandomNumberGenerator.php:87:      * @todo        Add site key for stronger salt!
 ./inc/classes/main/result/class_DatabaseResult.php:383:4        * @todo        Find a caching way without modifying the result array
 ./inc/classes/main/rng/class_RandomNumberGenerator.php:154:     * @todo        I had a better random number generator here but now it is somewhere lost :(
 ./inc/classes/main/rng/class_RandomNumberGenerator.php:87:      * @todo        Add site key for stronger salt!
-./inc/classes/main/template/class_BaseTemplateEngine.php:1274:                 // @TODO We need to find a fallback solution here
-./inc/classes/main/template/class_BaseTemplateEngine.php:769:   * @todo        Unfinished work or don't die here.
-./inc/classes/main/template/class_BaseTemplateEngine.php:940:   * @todo        Make this code some nicer...
-./inc/classes/main/template/image/class_ImageTemplateEngine.php:205:    * @todo        Find something usefull with this!
-./inc/classes/main/template/image/class_ImageTemplateEngine.php:225:    * @todo        Add cache creation here
-./inc/classes/main/template/mail/class_MailTemplateEngine.php:224:      * @todo        Add cache creation here
-./inc/classes/main/template/mail/class_MailTemplateEngine.php:234:      * @todo        Should we call back the mailer class here?
-./inc/classes/main/template/mail/class_MailTemplateEngine.php:315:      * @todo        0% done
-./inc/classes/main/user/class_BaseUser.php:310:         * @todo        Try to make this method more generic so we can move it in BaseFrameworkSystem
+./inc/classes/main/template/class_BaseTemplateEngine.php:1307:                 // @TODO We need to find a fallback solution here
+./inc/classes/main/template/class_BaseTemplateEngine.php:814:   * @todo        Unfinished work or don't die here.
+./inc/classes/main/template/class_BaseTemplateEngine.php:831:                          // @TODO Non-string found so we need some deeper analysis...
+./inc/classes/main/template/class_BaseTemplateEngine.php:908:                  // @TODO Old behaviour, will become obsolete!
+./inc/classes/main/template/class_BaseTemplateEngine.php:911:                  // @TODO Yet another old way
+./inc/classes/main/template/class_BaseTemplateEngine.php:985:   * @todo        Make this code some nicer...
+./inc/classes/main/template/image/class_ImageTemplateEngine.php:229:    * @todo        Find something usefull with this!
+./inc/classes/main/template/image/class_ImageTemplateEngine.php:249:    * @todo        Add cache creation here
+./inc/classes/main/template/mail/class_MailTemplateEngine.php:234:      * @todo        Add cache creation here
+./inc/classes/main/template/mail/class_MailTemplateEngine.php:244:      * @todo        Should we call back the mailer class here?
+./inc/classes/main/template/mail/class_MailTemplateEngine.php:325:      * @todo        0% done
+./inc/classes/main/user/class_BaseUser.php:309:         * @todo        Try to make this method more generic so we can move it in BaseFrameworkSystem
 ./inc/classes/main/user/class_BaseUser.php:84:  * @todo        Find a way of casting here. "(int)" might destroy the user id > 32766
 ./inc/classes/main/user/member/class_Member.php:84:     * @todo        Add more ways over creating user classes
 ./inc/classes/main/user/class_BaseUser.php:84:  * @todo        Find a way of casting here. "(int)" might destroy the user id > 32766
 ./inc/classes/main/user/member/class_Member.php:84:     * @todo        Add more ways over creating user classes
-./inc/loader/class_ClassLoader.php:239:                        /* @todo: Do not die here. */
+./inc/classes/middleware/debug/class_DebugMiddleware.php:109:                  // @TODO Initialization phase
+./inc/database.php:49:// @TODO Rewrite this
+./inc/hooks.php:26:// @TODO This makes the core depending on the SPL. But it should be installed anyway.
+./inc/language.php:31:// @TODO Rewrite this
+./inc/loader/class_ClassLoader.php:238:         * @todo        Rewrite your apps to scanClassPath()
+./inc/loader/class_ClassLoader.php:279:                        /* @todo: Do not die here. */
 ### ### DEPRECATION FOLLOWS: ### ###
 ./application/ship-simu/main/personell/class_SimulatorPersonell.php:121:        * @deprecated
 ./application/ship-simu/main/personell/class_SimulatorPersonell.php:323:        * @deprecated
 ./inc/classes/exceptions/container/class_ContainerItemIsNoArrayException.php:10: * @deprecated
 ./inc/classes/exceptions/container/class_ContainerItemIsNullException.php:10: * @deprecated
 ./inc/classes/exceptions/container/class_ContainerMaybeDamagedException.php:10: * @deprecated
 ### ### DEPRECATION FOLLOWS: ### ###
 ./application/ship-simu/main/personell/class_SimulatorPersonell.php:121:        * @deprecated
 ./application/ship-simu/main/personell/class_SimulatorPersonell.php:323:        * @deprecated
 ./inc/classes/exceptions/container/class_ContainerItemIsNoArrayException.php:10: * @deprecated
 ./inc/classes/exceptions/container/class_ContainerItemIsNullException.php:10: * @deprecated
 ./inc/classes/exceptions/container/class_ContainerMaybeDamagedException.php:10: * @deprecated
-./inc/classes/exceptions/database/wrapper/class_WrapperUserNameNotFoundException.php:11: * @deprecated
+./inc/classes/exceptions/database/general/class_DatabaseUpdateSupportException.php:10: * @deprecated
 ./inc/classes/exceptions/io/class_FileNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_ClassNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_ConfigEntryNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/io/class_FileNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_ClassNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_ConfigEntryNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_GetterNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_MissingMethodException.php:10: * @deprecated
 ./inc/classes/exceptions/main/class_NoArrayCreatedException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_GetterNotFoundException.php:11: * @deprecated
 ./inc/classes/exceptions/main/class_MissingMethodException.php:10: * @deprecated
 ./inc/classes/exceptions/main/class_NoArrayCreatedException.php:11: * @deprecated
-./inc/classes/exceptions/main/class_NoObjectException.php:10: * @deprecated
-./inc/classes/exceptions/template/class_ViewHelperNotFoundException.php:11: * @deprecated
-./inc/classes/main/class_BaseFrameworkSystem.php:610:   * @deprecated
-./inc/classes/main/class_BaseFrameworkSystem.php:621:   * @deprecated
-./inc/classes/main/template/class_BaseTemplateEngine.php:1088:  * @deprecated
+./inc/classes/main/template/class_BaseTemplateEngine.php:1135:  * @deprecated
+./inc/loader/class_ClassLoader.php:237:         * @deprecated