[commit: ghc] ghc-8.2: user-guide: Fix :since: annotation of -pie and add documentation for -fPIE (a2883ef)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : ghc-8.2
Link       : http://ghc.haskell.org/trac/ghc/changeset/a2883ef3a7fc4ccb82a51ff09b69b0e2f667d516/ghc

>---------------------------------------------------------------

commit a2883ef3a7fc4ccb82a51ff09b69b0e2f667d516
Author: Ben Gamari <ben at smart-cactus.org>
Date:   Mon Oct 2 18:02:40 2017 -0400

    user-guide: Fix :since: annotation of -pie and add documentation for -fPIE
    
    [skip ci]
    
    (cherry picked from commit d5e60de307874432f42aa7fea2460e6901c057e1)


>---------------------------------------------------------------

a2883ef3a7fc4ccb82a51ff09b69b0e2f667d516
 docs/users_guide/phases.rst | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/users_guide/phases.rst b/docs/users_guide/phases.rst
index 5be93f8..d9a59ab 100644
--- a/docs/users_guide/phases.rst
+++ b/docs/users_guide/phases.rst
@@ -458,6 +458,16 @@ Options affecting code generation
     Windows, position-independent code is never used so the flag is a
     no-op on that platform.
 
+.. ghc-flag:: -fPIE
+    :shortdesc: Generate code for a position-independent executable (where available)
+    :type: dynamic
+    :category: codegen
+
+    Generate code in such a way to be linkable into a position-independent
+    executable This currently works on Linux x86 and x86-64. On Windows,
+    position-independent code is never used so the flag is a no-op on that
+    platform. To link the final executable use :ghc-flag:`-pie`.
+
 .. ghc-flag:: -dynamic
     :noindex:
 
@@ -883,7 +893,7 @@ for example).
     :type: dynamic
     :category: linking
 
-    :since: 8.2.1
+    :since: 8.2.2
 
     This instructs the linker to produce a position-independent executable.
     This flag is only valid while producing executables and all object code
@@ -900,4 +910,4 @@ for example).
     loaded into the address space of another Haskell process.
 
     Also, you may need to use the :ghc-flags:`-rdynamic` flag to ensure that
-    that symbols are not dropped from your PIE object.
+    that symbols are not dropped from your PIE objects.