Comments: document cgo //export directive

Change-Id: I2d755ce042cc710294592044f8a7b3bf857507a0 Reviewed-on: https://go-review.googlesource.com/c/wiki/+/636935 Reviewed-by: Ian Lance Taylor <[email protected]> Commit-Queue: Ian Lance Taylor <[email protected]> Auto-Submit: Ian Lance Taylor <[email protected]>
golang · Dec 16, 2024 · 069c493 · 069c493
1 parent 7d2f6b3
commit 069c493
Showing 1 changed file with 11 additions and 0 deletions.
diff --git a/Comments.md b/Comments.md
@@ -174,6 +174,17 @@ describe the behavior of some C functions.
 For full details see the [cgo
 documentation](https://pkg.go.dev/cmd/cgo).
 
+#### cgo export
+
+In a file that uses cgo, a `//export` directive may be used to make a
+Go function visible to C code.
+The syntax is `//export CName` in a comment that appears before the Go
+function `GoName`.
+This will arrange matters such that a C call to the function `CName`
+will actually call the Go function `GoName`.
+For more details see the [cgo
+documentation](https://pkg.go.dev/cmd/cgo#hdr-C_references_to_Go).
+
 #### cgo compiler directives
 
 The cgo tool generates Go code, and that generated code uses some