From 8101539c0ae1bcc755cf8da75e80a8ea30e39c0f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Emilio=20Cobos=20=C3=81lvarez?= <emilio@crisal.io>
Date: Sun, 13 Jan 2019 21:42:38 +0100
Subject: [PATCH] style: Document a few more macros.

---
 components/style/gecko/regen_atoms.py            | 1 +
 components/style/gecko_string_cache/namespace.rs | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/components/style/gecko/regen_atoms.py b/components/style/gecko/regen_atoms.py
index dfc2252aa89..b6f68fceb7d 100755
--- a/components/style/gecko/regen_atoms.py
+++ b/components/style/gecko/regen_atoms.py
@@ -130,6 +130,7 @@ RULE_TEMPLATE = '''
 '''[1:]
 
 MACRO_TEMPLATE = '''
+/// Returns a static atom by passing the literal string it represents.
 #[macro_export]
 macro_rules! atom {{
 {body}\
diff --git a/components/style/gecko_string_cache/namespace.rs b/components/style/gecko_string_cache/namespace.rs
index 4aa4accaf1d..725e1da2169 100644
--- a/components/style/gecko_string_cache/namespace.rs
+++ b/components/style/gecko_string_cache/namespace.rs
@@ -11,6 +11,8 @@ use std::borrow::Borrow;
 use std::fmt;
 use std::ops::Deref;
 
+/// In Gecko namespaces are just regular atoms, so this is a simple macro to
+/// forward one macro to the other.
 #[macro_export]
 macro_rules! ns {
     () => {