diff --git a/doc/docs.md b/doc/docs.md
index 7bfbc32cee..6e12c909e8 100644
--- a/doc/docs.md
+++ b/doc/docs.md
@@ -193,7 +193,7 @@ println('hello world')
 ## Running a project folder with several files
 
 Suppose you have a folder with several .v files in it, where one of them
-contains your `main()` function, and the other files have other helper 
+contains your `main()` function, and the other files have other helper
 functions. They may be organized by topic, but still *not yet* structured
 enough to be their own separate reusable modules, and you want to compile
 them all into one program.
@@ -221,7 +221,7 @@ If you want to keep it, use `v -keepc run .` instead, or just compile
 manually with `v .` .
 
 NB: any V compiler flags should be passed *before* the `run` command.
-Everything after the source file/folder, will be passed to the program 
+Everything after the source file/folder, will be passed to the program
 as is - it will not be processed by V.
 
 ## Comments
@@ -4021,6 +4021,10 @@ function/struct/enum declaration and applies only to the following declaration.
 fn old_function() {
 }
 
+// It can also display a custom deprecation message
+[deprecated: 'use new_function() instead']
+fn legacy_function() {}
+
 // This function's calls will be inlined.
 [inline]
 fn inlined_function() {