diff --git a/doc/langref.html.in b/doc/langref.html.in
index b1768e8bbd..5c6943c9f4 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -421,8 +421,7 @@
       {#code|unattached_doc-comment.zig#}
 
       <p>
-      Doc comments can be interleaved with normal comments. Currently, when producing
-      the package documentation, normal comments are merged with doc comments.
+      Doc comments can be interleaved with normal comments, which are ignored.
       </p>
       {#header_close#}
       {#header_open|Top-Level Doc Comments#}