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

[Tarun Prabhu 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?
----------------
tarunprabhu wrote:

> ```
> /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 have run into this problem when building documentation for another project as well. I could not find the root cause there either and ended up adding an explicit `(label)=`. It may be inconvient when reading it on Github, but I think that is a secondary concern.

I have added @DavidSpickett as a reviewer. Perhaps he knows a bit more about this.


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