[Flang] Fix path strings in CreateFIRLangRef.py

[DylanFleming-arm]

Summary

In D129186, CreateFIRLangRef.py was created to help fix
formatting problems with FIRLangRef.md.

However, due to an error while rebasing, the last edit was lost,
as such the current path variables are Unix-style.

This patch addresses what was discussed in the previous patch and
now uses os.path.join instead.

[Leporacanthicus]

flang/docs/FIR/CreateFIRLangRef.py

6

This comment seems to imply that the path should be "../", but it isn't. Is the comment or the paths incorect? :)

[DylanFleming-arm]

Ah, I meant it as from the binary working directory, as this file exists in both src and bin, and is copied over at build time, before being ran.
The comment itself is probably not needed, but without it, 'Dialect/FIRLangref.md' might seem like a non-existant file.

[DylanFleming-arm]

Updated comment to better explain where the paths are relative to.

[DylanFleming-arm]

Fixed typo 'exectued' to 'executed'

[Leporacanthicus]

LGTM

flang/docs/FIR/CreateFIRLangRef.py

 # This script combines FIRLangRef_Header.md with the auto-generated Dialect/FIRLangRef.md
-# for the purpose of creating an introduction header/paragraph for FIRLangRef.html
+# for the purpose of creating an introduction header/paragraph for FIRLangRef.html.
 
-# These paths are relative from the build directroy, not source, as that's where this tool is exectued.
-header_path = 'Source/FIR/FIRLangRef_Header.md'
-docs_path   = 'Dialect/FIRLangRef.md'
-output_path = 'Source/FIRLangRef.md'
+import os
+
+# These paths are relative to flang/docs in the build directory, not source, as that's where this tool is executed.
+HEADER_PATH = os.path.join('Source', 'FIR', 'FIRLangRef_Header.md')
+DOCS_PATH   = os.path.join('Dialect', 'FIRLangRef.md')
+OUTPUT_PATH = os.path.join('Source', 'FIRLangRef.md')
 
 # 1. Writes line 1 from docs to output, (comment line that the file is autogenerated)
 # 2. Adds a new line
 # 3. Writes the entire header to the output file
 # 4. Writes the remainder of docs to the output file
-with open(output_path, 'w') as output:
-    with open(header_path, 'r') as header, open(docs_path, 'r') as docs:
+with open(OUTPUT_PATH, 'w') as output:
+    with open(HEADER_PATH, 'r') as header, open(DOCS_PATH, 'r') as docs:
         output.write(docs.readline())
         output.write("\n")
         output.write(header.read())
         output.write(docs.read())