[flang-commits] [flang] [flang][docs] Add an FAQ about an executable stack (PR #171241)

[Yusuke MINATO via flang-commits]

================
@@ -0,0 +1,47 @@
+<!--===- docs/FAQ.md
+
+   Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+   See https://llvm.org/LICENSE.txt for license information.
+   SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+
+-->
+
+<!-- TODO: remove this after adding this page to ToC -->
+```{eval-rst}
+:orphan:
+```
+
+# Frequently Asked Questions (FAQ)
+
+```{contents}
+---
+local:
+---
+```
+
+## Driver
+
+### Why do I get a warning or error about an executable stack?
----------------
yus3710-fj wrote:

> This is very much a suggestion. There is nothing wrong with explicitly saying 'warning or error'.

Thank you for your suggestion, but I received the following warning even though the generated link works correctly. (Please note that LLVM treats warnings as errors by default when generating documentation.)

```
/path/to/tools/flang/docs/SourceHtml/FortranStandardsSupport.md:98: WARNING: local id not found in doc 'FAQ': 'why-do-i-get-a-warning-error-about-an-executable-stack' [myst.xref_missing]
```

I could avoid this by adding a label like `(faq-execstack)=` to the header. However, this would be inconvenient when viewing the documentation on GitHub.

https://github.com/llvm/llvm-project/pull/171241