diff --git a/buffer.go b/buffer.go
index 88bafa6..e7007f3 100644
--- a/buffer.go
+++ b/buffer.go
@@ -100,6 +100,9 @@ func (b *Buffer) CopyFrom(src []byte) int {
 //
 //	buffer := NewBuffer(16)
 //	defer buffer.Close()
+//
+//	// same as:
+//	buffer.Free()
 func (b *Buffer) Close() error {
 	b.Free()
 	return nil
diff --git a/scope.go b/scope.go
index 2a9bbc9..c0d92a5 100644
--- a/scope.go
+++ b/scope.go
@@ -117,6 +117,9 @@ func (s *Scope) IsFreed() bool {
 //
 //	scope := NewScope()
 //	defer scope.Close()
+//
+//	// same as:
+//	scope.FreeAll()
 func (s *Scope) Close() error {
 	s.FreeAll()
 	return nil