From 5410701eff76c5427a913151cc4227e4bb0a2000 Mon Sep 17 00:00:00 2001
From: Markus Reiter <me@reitermark.us>
Date: Wed, 26 Aug 2020 03:06:19 +0200
Subject: [PATCH] Document `OS::Mac` and `OS::Linux`.

---
 Library/Homebrew/os/linux.rb | 4 +++-
 Library/Homebrew/os/mac.rb   | 1 +
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/Library/Homebrew/os/linux.rb b/Library/Homebrew/os/linux.rb
index da4b9d7acd..1e3cb24fa8 100644
--- a/Library/Homebrew/os/linux.rb
+++ b/Library/Homebrew/os/linux.rb
@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module OS
+  # Helper module for querying system information on Linux.
   module Linux
     module_function
 
@@ -21,7 +22,7 @@ module OS
     end
   end
 
-  # Define OS::Mac on Linux for formula API compatibility.
+  # rubocop:disable Style/Documentation
   module Mac
     module_function
 
@@ -77,4 +78,5 @@ module OS
       end
     end
   end
+  # rubocop:enable Style/Documentation
 end
diff --git a/Library/Homebrew/os/mac.rb b/Library/Homebrew/os/mac.rb
index b44a47bcc4..8e9d0d33f3 100644
--- a/Library/Homebrew/os/mac.rb
+++ b/Library/Homebrew/os/mac.rb
@@ -7,6 +7,7 @@ require "os/mac/sdk"
 require "os/mac/keg"
 
 module OS
+  # Helper module for querying system information on macOS.
   module Mac
     module_function