diff --git a/System/Posix/Fcntl.hsc b/System/Posix/Fcntl.hsc
index 2d8ef1286b913ba72b799ac7f5ba26cf7644add3..c78f36128611a5e7aa46b761e4a0915702448dd4 100644
--- a/System/Posix/Fcntl.hsc
+++ b/System/Posix/Fcntl.hsc
@@ -16,7 +16,7 @@
 --
 -- POSIX file control support
 --
--- /Since: 2.7.1.0/
+-- @since 2.7.1.0
 -----------------------------------------------------------------------------
 
 #include "HsUnix.h"
@@ -44,7 +44,7 @@ import GHC.IO.Exception ( unsupportedOperation )
 --
 -- For more details, see documentation of @posix_fadvise(2)@.
 --
--- /Since: 2.7.1.0/
+-- @since 2.7.1.0
 data Advice
   = AdviceNormal
   | AdviceRandom
@@ -61,7 +61,7 @@ data Advice
 --
 -- (use @#if HAVE_POSIX_FADVISE@ CPP guard to detect availability)
 --
--- /Since: 2.7.1.0/
+-- @since 2.7.1.0
 fileAdvise :: Fd -> FileOffset -> FileOffset -> Advice -> IO ()
 #if HAVE_POSIX_FADVISE
 fileAdvise fd off len adv = do
@@ -88,7 +88,7 @@ fileAdvise _ _ _ _ = return ()
 --
 -- (use @#if HAVE_POSIX_FALLOCATE@ CPP guard to detect availability).
 --
--- /Since: 2.7.1.0/
+-- @since 2.7.1.0
 fileAllocate :: Fd -> FileOffset -> FileOffset -> IO ()
 #if HAVE_POSIX_FALLOCATE
 fileAllocate fd off len = do
diff --git a/System/Posix/Files.hsc b/System/Posix/Files.hsc
index 7c637cc3ee40e6618275b57b4b3c6582e82e6286..bbda084feb2c1c76819f03fbda55ab3de5740eda 100644
--- a/System/Posix/Files.hsc
+++ b/System/Posix/Files.hsc
@@ -347,7 +347,7 @@ setFileTimes name atime mtime = do
 --
 -- Note: calls @utimensat@ or @utimes@.
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 setFileTimesHiRes :: FilePath -> POSIXTime -> POSIXTime -> IO ()
 #ifdef HAVE_UTIMENSAT
 setFileTimesHiRes name atime mtime =
@@ -368,7 +368,7 @@ setFileTimesHiRes name atime mtime =
 --
 -- Note: calls @utimensat@ or @lutimes@.
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 setSymbolicLinkTimesHiRes :: FilePath -> POSIXTime -> POSIXTime -> IO ()
 #if HAVE_UTIMENSAT
 setSymbolicLinkTimesHiRes name atime mtime =
@@ -402,7 +402,7 @@ touchFile name = do
 --
 -- Note: calls @lutimes@.
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 touchSymbolicLink :: FilePath -> IO ()
 #if HAVE_LUTIMES
 touchSymbolicLink name =
diff --git a/System/Posix/Files/Common.hsc b/System/Posix/Files/Common.hsc
index a1a427897887bb2266e36773d8fb668fb6c0cb94..cc594cc3bc567b2b67dea248c07cf11d16e7b36d 100644
--- a/System/Posix/Files/Common.hsc
+++ b/System/Posix/Files/Common.hsc
@@ -467,7 +467,7 @@ foreign import ccall unsafe "futimes"
 --
 -- Note: calls @futimens@ or @futimes@.
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 setFdTimesHiRes :: Fd -> POSIXTime -> POSIXTime -> IO ()
 #if HAVE_FUTIMENS
 setFdTimesHiRes (Fd fd) atime mtime =
@@ -488,7 +488,7 @@ setFdTimesHiRes =
 --
 -- Note: calls @futimes@.
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 touchFd :: Fd -> IO ()
 #if HAVE_FUTIMES
 touchFd (Fd fd) =
diff --git a/System/Posix/Process/Common.hsc b/System/Posix/Process/Common.hsc
index 59212e4308f0081e699200a2f4d767817d1c9d2b..7fb0823b8dfb7aa05b45ba311b428e796165fcfe 100644
--- a/System/Posix/Process/Common.hsc
+++ b/System/Posix/Process/Common.hsc
@@ -301,7 +301,7 @@ foreign import ccall "forkProcess" forkProcessPrim :: StablePtr (IO ()) -> IO CP
 
 -- | Variant of 'forkProcess' in the style of 'forkIOWithUnmask'.
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 forkProcessWithUnmask :: ((forall a . IO a -> IO a) -> IO ()) -> IO ProcessID
 forkProcessWithUnmask action = forkProcess (action unsafeUnmask)
 
diff --git a/System/Posix/Process/Internals.hs b/System/Posix/Process/Internals.hs
index 0bd99aef122223b9632b1442fab2c744cae4112a..ddafa101192e8cb8811d487b173834c41a3a8181 100644
--- a/System/Posix/Process/Internals.hs
+++ b/System/Posix/Process/Internals.hs
@@ -19,7 +19,7 @@ data ProcessStatus
                             -- signal, the @Bool@ is @True@ if a core
                             -- dump was produced
                             --
-                            -- /Since: 2.7.0.0/
+                            -- @since 2.7.0.0
    | Stopped Signal         -- ^ the process was stopped by a signal
    deriving (Eq, Ord, Show)
 
diff --git a/System/Posix/Signals.hsc b/System/Posix/Signals.hsc
index 971973ee567e0a9323c9f1a9b475c21868d381a6..f26765dc33bfc1b645d8f283552dc7cc3b53b541 100644
--- a/System/Posix/Signals.hsc
+++ b/System/Posix/Signals.hsc
@@ -310,13 +310,13 @@ data Handler = Default
              -- not yet: | Hold
              | Catch (IO ())
              | CatchOnce (IO ())
-             | CatchInfo (SignalInfo -> IO ())     -- ^ /Since: 2.7.0.0/
-             | CatchInfoOnce (SignalInfo -> IO ()) -- ^ /Since: 2.7.0.0/
+             | CatchInfo (SignalInfo -> IO ())     -- ^ @since 2.7.0.0
+             | CatchInfoOnce (SignalInfo -> IO ()) -- ^ @since 2.7.0.0
   deriving (Typeable)
 
 -- | Information about a received signal (derived from @siginfo_t@).
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 data SignalInfo = SignalInfo {
       siginfoSignal   :: Signal,
       siginfoError    :: Errno,
@@ -326,7 +326,7 @@ data SignalInfo = SignalInfo {
 -- | Information specific to a particular type of signal
 -- (derived from @siginfo_t@).
 --
--- /Since: 2.7.0.0/
+-- @since 2.7.0.0
 data SignalSpecificInfo
   = NoSignalSpecificInfo
   | SigChldInfo {
diff --git a/System/Posix/Unistd.hsc b/System/Posix/Unistd.hsc
index 84bd4729f574430be743ec2e0ddb13557f5cc1e0..ec0221638ce31bfac927ad0e0e4f5d1cdc6f78c6 100644
--- a/System/Posix/Unistd.hsc
+++ b/System/Posix/Unistd.hsc
@@ -227,7 +227,7 @@ foreign import ccall unsafe "sysconf"
 -- provide @fsync(2)@ (use @#if HAVE_FSYNC@ CPP guard to
 -- detect availability).
 --
--- /Since: 2.7.1.0/
+-- @since 2.7.1.0
 fileSynchronise :: Fd -> IO ()
 #if HAVE_FSYNC
 fileSynchronise fd = do
@@ -248,7 +248,7 @@ fileSynchronise _ = ioError (ioeSetLocation unsupportedOperation
 -- provide @fdatasync(2)@ (use @#if HAVE_FDATASYNC@ CPP guard to
 -- detect availability).
 --
--- /Since: 2.7.1.0/
+-- @since 2.7.1.0
 fileSynchroniseDataOnly :: Fd -> IO ()
 #if HAVE_FDATASYNC
 fileSynchroniseDataOnly fd = do