langref: Clear up terminology used for top-level doc comments

This commit is contained in:
Sage Hane
2026-04-17 16:12:10 +09:00
committed by Andrew Kelley
parent 9b177a7d21
commit f0649e7709
2 changed files with 4 additions and 4 deletions
+1 -1
View File
@@ -429,7 +429,7 @@
{#header_open|Top-Level Doc Comments#}
<p>
A top-level doc comment is one that begins with two slashes and an exclamation
point: {#syntax#}//!{#endsyntax#}; it documents the current module.
point: {#syntax#}//!{#endsyntax#}; it documents the current source file.
</p>
<p>
It is a compile error if a top-level doc comment is not placed at the start
+2 -2
View File
@@ -3,8 +3,8 @@
//! depend on libc, but will use functions from it if available.
const S = struct {
//! Top level comments are allowed inside a container other than a module,
//! but it is not very useful. Currently, when producing the package
//! Top level comments are allowed inside containers other than source
//! files, but it is not very useful. Currently, when producing the package
//! documentation, these comments are ignored.
};