Use proper doxygen markup to mark deprecations
diff --git a/library/cipher.c b/library/cipher.c
index 8c7452b..516fa00 100644
--- a/library/cipher.c
+++ b/library/cipher.c
@@ -165,7 +165,7 @@
     return( 0 );
 }
 
-/* Deprecated, redirects to cipher_free() */
+/* compatibility wrapper */
 int cipher_free_ctx( cipher_context_t *ctx )
 {
     cipher_free( ctx );
diff --git a/library/pbkdf2.c b/library/pbkdf2.c
index 54494ab..b4ef195 100644
--- a/library/pbkdf2.c
+++ b/library/pbkdf2.c
@@ -1,8 +1,7 @@
 /**
  * \file pbkdf2.c
  *
- * \brief Password-Based Key Derivation Function 2 (from PKCS#5)
- *        DEPRECATED: Use pkcs5.c instead
+ * \brief Compatibility wrappers for pkcs5.c
  *
  * \author Mathias Olsson <mathias@kompetensum.com>
  *