mirror of
https://codeberg.org/ziglang/zig.git
synced 2026-04-26 13:01:34 +03:00
langref: Clear up terminology used for top-level doc comments
This commit is contained in:
+1
-1
@@ -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
|
||||
|
||||
@@ -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.
|
||||
};
|
||||
|
||||
|
||||
Reference in New Issue
Block a user