[Git][ghc/ghc][master] Use "module" instead of "library" when applicable in base haddocks
Marge Bot (@marge-bot)
gitlab at gitlab.haskell.org
Wed Mar 6 18:41:04 UTC 2024
Marge Bot pushed to branch master at Glasgow Haskell Compiler / GHC
Commits:
c4b13113 by Hécate Moonlight at 2024-03-06T13:40:17-05:00
Use "module" instead of "library" when applicable in base haddocks
- - - - -
15 changed files:
- libraries/base/src/Control/Concurrent.hs
- libraries/base/src/Control/Monad.hs
- libraries/base/src/Control/Monad/ST.hs
- libraries/base/src/Control/Monad/ST/Safe.hs
- libraries/base/src/Control/Monad/ST/Unsafe.hs
- libraries/base/src/Data/Version.hs
- libraries/base/src/GHC/IO/Encoding/UTF16.hs
- libraries/base/src/GHC/TypeNats.hs
- libraries/base/src/System/Console/GetOpt.hs
- libraries/base/src/System/IO.hs
- libraries/base/src/System/Mem/Weak.hs
- libraries/base/src/System/Posix/Internals.hs
- libraries/base/src/Text/ParserCombinators/ReadP.hs
- libraries/base/src/Text/ParserCombinators/ReadPrec.hs
- libraries/base/src/Text/Read.hs
Changes:
=====================================
libraries/base/src/Control/Concurrent.hs
=====================================
@@ -147,7 +147,7 @@ by using 'forkOS' instead of 'forkIO'.
Haskell threads can communicate via 'MVar's, a kind of synchronised
mutable variable (see "Control.Concurrent.MVar"). Several common
concurrency abstractions can be built from 'MVar's, and these are
-provided by the "Control.Concurrent" library.
+provided by the "Control.Concurrent" module.
In GHC, threads may also communicate via exceptions.
-}
@@ -384,7 +384,7 @@ foreign import ccall safe "fdReady"
multiple Haskell threads can be involved in external calls
simultaneously.
- The "System.IO" library manages multiplexing in its own way. On
+ The "System.IO" module manages multiplexing in its own way. On
Windows systems it uses @safe@ foreign calls to ensure that
threads doing I\/O operations don't block the whole runtime,
whereas on Unix systems all the currently blocked I\/O requests
@@ -401,7 +401,7 @@ foreign import ccall safe "fdReady"
If you don't use the @-threaded@ option, then the runtime does
not make use of multiple OS threads. Foreign calls will block
all other running Haskell threads until the call returns. The
- "System.IO" library still does multiplexing, so there can be multiple
+ "System.IO" module still does multiplexing, so there can be multiple
threads doing I\/O, and this is handled internally by the runtime using
@select at .
-}
=====================================
libraries/base/src/Control/Monad.hs
=====================================
@@ -65,7 +65,7 @@ import GHC.Internal.Control.Monad
{- $naming
-The functions in this library use the following naming conventions:
+The functions in this module use the following naming conventions:
* A postfix \'@M@\' always stands for a function in the Kleisli category:
The monad type constructor @m@ is added to function results
=====================================
libraries/base/src/Control/Monad/ST.hs
=====================================
@@ -10,7 +10,7 @@
-- Stability : stable
-- Portability : non-portable (requires universal quantification for runST)
--
--- This library provides support for /strict/ state threads, as
+-- This module provides support for /strict/ state threads, as
-- described in the PLDI \'94 paper by John Launchbury and Simon Peyton
-- Jones /Lazy Functional State Threads/.
--
=====================================
libraries/base/src/Control/Monad/ST/Safe.hs
=====================================
@@ -10,7 +10,7 @@
-- Stability : stable
-- Portability : non-portable (requires universal quantification for runST)
--
--- This library provides support for /strict/ state threads, as
+-- This module provides support for /strict/ state threads, as
-- described in the PLDI \'94 paper by John Launchbury and Simon Peyton
-- Jones /Lazy Functional State Threads/.
--
=====================================
libraries/base/src/Control/Monad/ST/Unsafe.hs
=====================================
@@ -10,7 +10,7 @@
-- Stability : stable
-- Portability : non-portable (requires universal quantification for runST)
--
--- This library provides support for /strict/ state threads, as
+-- This module provides support for /strict/ state threads, as
-- described in the PLDI \'94 paper by John Launchbury and Simon Peyton
-- Jones /Lazy Functional State Threads/.
--
=====================================
libraries/base/src/Data/Version.hs
=====================================
@@ -9,7 +9,7 @@
-- Stability : stable
-- Portability : non-portable (local universal quantification in ReadP)
--
--- A general library for representation and manipulation of versions.
+-- A general API for representation and manipulation of versions.
--
-- Versioning schemes are many and varied, so the version
-- representation provided by this library is intended to be a
=====================================
libraries/base/src/GHC/IO/Encoding/UTF16.hs
=====================================
@@ -32,4 +32,4 @@ module GHC.IO.Encoding.UTF16
utf16le_encode
) where
-import GHC.Internal.IO.Encoding.UTF16
\ No newline at end of file
+import GHC.Internal.IO.Encoding.UTF16
=====================================
libraries/base/src/GHC/TypeNats.hs
=====================================
@@ -7,7 +7,7 @@
-- |
-- This module is an internal GHC module. It declares the constants used
-- in the implementation of type-level natural numbers. The programmer interface
--- for working with type-level naturals should be defined in a separate library.
+-- for working with type-level naturals should be defined in a separate module.
--
-- @since 4.10.0.0
--
=====================================
libraries/base/src/System/Console/GetOpt.hs
=====================================
@@ -10,7 +10,7 @@
-- Stability : stable
-- Portability : portable
--
--- This library provides facilities for parsing the command-line options
+-- This module provides facilities for parsing the command-line options
-- in a standalone program. It is essentially a Haskell port of the GNU
-- @getopt@ library.
--
=====================================
libraries/base/src/System/IO.hs
=====================================
@@ -10,7 +10,7 @@
-- Stability : stable
-- Portability : portable
--
--- The standard IO library.
+-- The standard IO API.
--
module System.IO
=====================================
libraries/base/src/System/Mem/Weak.hs
=====================================
@@ -32,7 +32,7 @@
-- alive for ever. One way to solve this is to purge the table
-- occasionally, by deleting entries whose keys have died.
--
--- The weak pointers in this library
+-- The weak pointers in this module
-- support another approach, called /finalization/.
-- When the key referred to by a weak pointer dies, the storage manager
-- arranges to run a programmer-specified finalizer. In the case of memo
@@ -43,7 +43,7 @@
-- key\/value pair might itself contain a pointer to the key.
-- So the memo table keeps the value alive, which keeps the key alive,
-- even though there may be no other references to the key so both should
--- die. The weak pointers in this library provide a slight
+-- die. The weak pointers in this module provide a slight
-- generalisation of the basic weak-pointer idea, in which each
-- weak pointer actually contains both a key and a value.
--
=====================================
libraries/base/src/System/Posix/Internals.hs
=====================================
@@ -17,7 +17,7 @@
-- bound, e.g., @base < 4.X@ rather than @base < 5@, because the interface can
-- change rapidly without much warning.
--
--- This library is built on *every* platform, including Win32.
+-- This module is built on *every* platform, including Win32.
--
-- Non-POSIX compliant in order to support the following features:
-- * S_ISSOCK (no sockets in POSIX)
=====================================
libraries/base/src/Text/ParserCombinators/ReadP.hs
=====================================
@@ -10,7 +10,7 @@
-- Stability : provisional
-- Portability : non-portable (local universal quantification)
--
--- This is a library of parser combinators, originally written by Koen Claessen.
+-- This is a module of parser combinators, originally written by Koen Claessen.
-- It parses all alternatives in parallel, so it never keeps hold of
-- the beginning of the input string, a common source of space leaks with
-- other parsers. The @('+++')@ choice combinator is genuinely commutative;
@@ -60,4 +60,4 @@ module Text.ParserCombinators.ReadP
-- $properties
) where
-import GHC.Internal.Text.ParserCombinators.ReadP
\ No newline at end of file
+import GHC.Internal.Text.ParserCombinators.ReadP
=====================================
libraries/base/src/Text/ParserCombinators/ReadPrec.hs
=====================================
@@ -10,7 +10,7 @@
-- Stability : provisional
-- Portability : non-portable (uses Text.ParserCombinators.ReadP)
--
--- This library defines parser combinators for precedence parsing.
+-- This module defines parser combinators for precedence parsing.
module Text.ParserCombinators.ReadPrec
(ReadPrec,
@@ -37,4 +37,4 @@ module Text.ParserCombinators.ReadPrec
readS_to_Prec
) where
-import GHC.Internal.Text.ParserCombinators.ReadPrec
\ No newline at end of file
+import GHC.Internal.Text.ParserCombinators.ReadPrec
=====================================
libraries/base/src/Text/Read.hs
=====================================
@@ -12,7 +12,7 @@
--
-- Converting strings to values.
--
--- The "Text.Read" library is the canonical library to import for
+-- The "Text.Read" module is the canonical place to import for
-- 'Read'-class facilities. For GHC only, it offers an extended and much
-- improved 'Read' class, which constitutes a proposed alternative to the
-- Haskell 2010 'Read'. In particular, writing parsers is easier, and
View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/commit/c4b131133e4cee35d2140eedfcf3b4e573a43a8a
--
View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/commit/c4b131133e4cee35d2140eedfcf3b4e573a43a8a
You're receiving this email because of your account on gitlab.haskell.org.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/ghc-commits/attachments/20240306/dcca71a5/attachment-0001.html>
More information about the ghc-commits
mailing list