diff --git a/nasmlib/readnum.c b/nasmlib/readnum.c
index 2f4400695..f5969602d 100644
--- a/nasmlib/readnum.c
+++ b/nasmlib/readnum.c
@@ -52,7 +52,8 @@ void warn_dollar_hex(void)
      *!    warns that the \c{$} prefix for hexadecimal numbers is
      *!    deprecated, due to the syntactic conflict with \c{$} used
      *!    as a symbol escape prefix. This syntax may be disabled by
-     *!    default in a future version of NASM.
+     *!    default in a future version of NASM. Replace \c{$} with \c{0x}
+     *!    to ensure compatibility with future versions.
      */
     nasm_warn(WARN_NUMBER_DEPRECATED_HEX,
               "$ prefix for hexadecimal is deprecated");