[flang-commits] [flang] [flang] flang manpage overhaul (PR #144948)

[Paul Osmialowski via flang-commits]

================
@@ -1,22 +1,61 @@
-Flang Manual Page (In Progress)
-==================================================
-
-.. note::
-    This man page is under development.
-
-For full documentation, please see the online HTML docs:
-
-https://flang.llvm.org/docs/
-
-..  
-  The placeholder text "FlangCommandLineReference" below should eventually be replaced with the actual man page contents.  
-
-----
-
-Flang Command Line Reference
-----------------------------
+flang - the Fortran compiler
+============================
+
+SYNOPSIS
+--------
+
+:program:`flang` [*options*] *filename ...*
+
+DESCRIPTION
+-----------
+
+:program:`flang` is a Fortran compiler which encompasses preprocessing, parsing,
----------------
pawosm-arm wrote:

I've added this introductory phrase. As for the rest, note that my goal here was to maintain the parity with clang's manpage, e.g., it does not offer any examples, assuming the reader can derive what they need from the Synopsis section and from the list of available Options. Also I doubt typical Fortran programmers read manpages, they usually read books.


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