From 895b10ad020a788566c6e35431d07e6121e38c87 Mon Sep 17 00:00:00 2001
From: Aaron Patterson <tenderlove@ruby-lang.org>
Date: Thu, 17 Dec 2020 13:25:35 -0800
Subject: [PATCH] Add documentation about GC.compact

[Misc #16443][ruby-core:96395]
---
 gc.rb | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/gc.rb b/gc.rb
index 4e0faaf00d..8a00b406ce 100644
--- a/gc.rb
+++ b/gc.rb
@@ -198,6 +198,17 @@ module GC
     Primitive.gc_compact_stats
   end
 
+  #  call-seq:
+  #     GC.compact
+  #
+  # This function compacts objects together in Ruby's heap.  It eliminates
+  # unused space (or fragmentation) in the heap by moving objects in to that
+  # unused space.  This function returns a hash which contains statistics about
+  # which objects were moved.  See `GC.latest_gc_info` for details about
+  # compaction statistics.
+  #
+  # This method is implementation specific and not expected to be implemented
+  # in any implementation besides MRI.
   def self.compact
     Primitive.gc_compact
   end