From 1ca8399b0d1380f0aa0f7a97e2296dde7e0832e4 Mon Sep 17 00:00:00 2001
From: Alexander McCord <11488393+alexmccord@users.noreply.github.com>
Date: Wed, 8 May 2024 15:48:07 -0700
Subject: [PATCH] Update attributes for functions RFC with more reasons against
 comments (#33)

Why not use comments? This is why.
---
 docs/syntax-attributes-functions.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/syntax-attributes-functions.md b/docs/syntax-attributes-functions.md
index 7220583..0c48fe8 100644
--- a/docs/syntax-attributes-functions.md
+++ b/docs/syntax-attributes-functions.md
@@ -87,4 +87,10 @@ Other potential syntaxes that were considered include a Rust-style syntax (`#[at
 
 - Comments being used to control language features and flow means that tooling and users must care about them, which is antithetical to how comments are traditionally used
 
+- Attribute-as-comments would naturally conflict with the language in a lot of weird ways and would just cause a lot of problems:
+```lua
+local f = --!native function() end
+print(f)
+```
+
 As proposed, attributes would only be applicable on functions at first. They could instead be added to the entire language at once, which would facilitate widespread adoption immediately. However, that is a lot more work, and most of the potential uses for attributes are on functions, so it makes sense to begin with them.