diff --git a/amdis/AMDiS.hpp b/amdis/AMDiS.hpp
index b4ab3319d951e779826ae1d33441ceb8669493c2..6f9a0440938225b0ba8d8a731662e19c01d42e7f 100644
--- a/amdis/AMDiS.hpp
+++ b/amdis/AMDiS.hpp
@@ -15,7 +15,8 @@ namespace AMDiS
 {
   /// Initialized the Environment for MPI.
   /**
-   * NOTE: deprecated
+   * \deprecated
+   *
    * Use \ref Environment at the beginning of the main() instead:
    *
    *   int main(int argc, char** argv) {
@@ -24,17 +25,19 @@ namespace AMDiS
    *   }
    *
    **/
-  inline void [[deprecated]] init(int& argc, char**& argv, std::string const& initFileName = "")
+  [[deprecated("Use Environment at the beginning of main() instead")]]
+  inline void init(int& argc, char**& argv, std::string const& initFileName = "")
   {
     static Environment env(argc, argv, initFileName);
   }
 
   /// Closes the MPI environment
   /**
-   * NOTE: deprecated
+   * \deprecated
    *
    * The \ref Environment is closed automatically on destruction.
    **/
-  inline void [[deprecated]] finalize() { /* no nothing */ }
+  [[deprecated("Use Environment at the beginning of main() instead")]]
+  inline void finalize() { /* no nothing */ }
 
 } // end namespace AMDiS