[commit: packages/unix] master: Add `changelog` file and `/Since: 2.7.0.0/` notes (23f35ae)

[git at git.haskell.org]

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

On branch  : master
Link       : http://git.haskell.org/packages/unix.git/commitdiff/23f35ae77c968d090b606eb8cc42003f10c5fbc0

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

commit 23f35ae77c968d090b606eb8cc42003f10c5fbc0
Author: Herbert Valerio Riedel <hvr at gnu.org>
Date:   Sat Oct 12 13:21:47 2013 +0200

    Add `changelog` file and `/Since: 2.7.0.0/` notes
    
    The changelog file will be shown on Hackage once it's included in the
    source tarball.
    
    Signed-off-by: Herbert Valerio Riedel <hvr at gnu.org>


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

23f35ae77c968d090b606eb8cc42003f10c5fbc0
 System/Posix/Files.hsc            |    6 ++++++
 System/Posix/Files/Common.hsc     |    4 ++++
 System/Posix/Process/Internals.hs |    2 ++
 System/Posix/Signals.hsc          |    8 ++++++--
 changelog                         |   41 +++++++++++++++++++++++++++++++++++++
 5 files changed, 59 insertions(+), 2 deletions(-)

diff --git a/System/Posix/Files.hsc b/System/Posix/Files.hsc
index 6709e3b..8268492 100644
--- a/System/Posix/Files.hsc
+++ b/System/Posix/Files.hsc
@@ -344,6 +344,8 @@ setFileTimes name atime mtime = do
 -- | Like 'setFileTimes' but timestamps can have sub-second resolution.
 --
 -- Note: calls @utimensat@ or @utimes at .
+--
+-- /Since: 2.7.0.0/
 setFileTimesHiRes :: FilePath -> POSIXTime -> POSIXTime -> IO ()
 #ifdef HAVE_UTIMENSAT
 setFileTimesHiRes name atime mtime =
@@ -363,6 +365,8 @@ setFileTimesHiRes name atime mtime =
 -- this function will raise an exception.
 --
 -- Note: calls @utimensat@ or @lutimes at .
+--
+-- /Since: 2.7.0.0/
 setSymbolicLinkTimesHiRes :: FilePath -> POSIXTime -> POSIXTime -> IO ()
 #if HAVE_UTIMENSAT
 setSymbolicLinkTimesHiRes name atime mtime =
@@ -395,6 +399,8 @@ touchFile name = do
 -- this function will raise an exception.
 --
 -- Note: calls @lutimes at .
+--
+-- /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 f296336..9ce2f1d 100644
--- a/System/Posix/Files/Common.hsc
+++ b/System/Posix/Files/Common.hsc
@@ -463,6 +463,8 @@ foreign import ccall unsafe "futimes"
 -- this function will raise an exception.
 --
 -- Note: calls @futimens@ or @futimes at .
+--
+-- /Since: 2.7.0.0/
 setFdTimesHiRes :: Fd -> POSIXTime -> POSIXTime -> IO ()
 #if HAVE_FUTIMENS
 setFdTimesHiRes (Fd fd) atime mtime =
@@ -482,6 +484,8 @@ setFdTimesHiRes =
 -- this function will raise an exception.
 --
 -- Note: calls @futimes at .
+--
+-- /Since: 2.7.0.0/
 touchFd :: Fd -> IO ()
 #if HAVE_FUTIMES
 touchFd (Fd fd) =
diff --git a/System/Posix/Process/Internals.hs b/System/Posix/Process/Internals.hs
index 8e4f451..bd3dd31 100644
--- a/System/Posix/Process/Internals.hs
+++ b/System/Posix/Process/Internals.hs
@@ -20,6 +20,8 @@ data ProcessStatus
    | Terminated Signal Bool -- ^ the process was terminated by a
                             -- signal, the @Bool@ is @True@ if a core
                             -- dump was produced
+                            --
+                            -- /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 16761b9..39de76b 100644
--- a/System/Posix/Signals.hsc
+++ b/System/Posix/Signals.hsc
@@ -314,11 +314,13 @@ data Handler = Default
 	     -- not yet: | Hold 
              | Catch (IO ())
              | CatchOnce (IO ())
-             | CatchInfo (SignalInfo -> IO ())
-             | CatchInfoOnce (SignalInfo -> IO ())
+             | 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/
 data SignalInfo = SignalInfo {
       siginfoSignal   :: Signal,
       siginfoError    :: Errno,
@@ -327,6 +329,8 @@ data SignalInfo = SignalInfo {
 
 -- | Information specific to a particular type of signal
 -- (derived from @siginfo_t@).
+--
+-- /Since: 2.7.0.0/
 data SignalSpecificInfo
   = NoSignalSpecificInfo
   | SigChldInfo {
diff --git a/changelog b/changelog
new file mode 100644
index 0000000..49ebc74
--- /dev/null
+++ b/changelog
@@ -0,0 +1,41 @@
+-*-changelog-*-
+
+2.7.0.0  Oct 2013
+
+        * Add new `Bool` flag to `ProcessStatus(Terminated)` constructor
+	indicating whether a core dump occured
+
+	* New functions in "System.Posix.Files(.ByteString)" for operating
+	on high resolution file timestamps:
+
+	 + `setFdTimesHiRes :: Fd -> POSIXTime -> POSIXTime -> IO ()`
+	 + `setFileTimesHiRes :: FilePath -> POSIXTime -> POSIXTime -> IO ()`
+	 + `setSymbolicLinkTimesHiRes :: FilePath -> POSIXTime -> POSIXTime -> IO ()`
+	 + `touchFd :: Fd -> IO ()`
+	 + `touchSymbolicLink :: FilePath -> IO ()`
+
+	* Export `SignalInfo(..)` and `SignalSpecificInfo(..)` as well as
+	the two `Handler` constructors `CatchInfo` and `CatchInfoOnce`
+	from "System.Posix.Signals".
+
+	* Don't export `seekDirStream` and `tellDirStream` if the
+	underlying `seekdir(3)`/`telldir(3)` system calls are not
+	available (as on Android).
+
+	* Fix library detection of `shm*` on openSUSE (#8350)
+
+	* Update package to `cabal-version >= 1.10` format
+
+2.6.0.1  Jan 2013
+
+        * Bundled with GHC 7.6.2
+        * Fix memory corruption issue in `putEnv`
+        * Use `pthread_kill(3)` instead of `raise(2)` on OS X too
+
+2.6.0.0  Sep 2012
+
+        * Bundled with GHC 7.6.1
+	* New functions `mkdtemp` and `mkstemps` in "System.Posix.Temp"
+	* New functions `setEnvironment` and `cleanEnv`
+	* New functions `accessTimeHiRes`, `modificationTimeHiRes`, and
+	`statusChangeTimeHiRes` for accessing high resolution timestamps