@@ -188,36 +188,50 @@ toThereTag Tag {..} = Tag {..}
188188
189189
190190-- | Test if a 'TheseTable' was constructed with 'thisTable'.
191+--
192+-- Corresponds to 'Data.These.Combinators.isThis'.
191193isThisTable :: TheseTable a b -> Expr Bool
192194isThisTable a = hasHereTable a &&. not_ (hasThereTable a)
193195
194196
195197-- | Test if a 'TheseTable' was constructed with 'thatTable'.
198+--
199+-- Corresponds to 'Data.These.Combinators.isThat'.
196200isThatTable :: TheseTable a b -> Expr Bool
197201isThatTable a = not_ (hasHereTable a) &&. hasThereTable a
198202
199203
200204-- | Test if a 'TheseTable' was constructed with 'thoseTable'.
205+--
206+-- Corresponds to 'Data.These.Combinators.isThese'.
201207isThoseTable :: TheseTable a b -> Expr Bool
202208isThoseTable a = hasHereTable a &&. hasThereTable a
203209
204210
205−-- | Test if the @a@ table of @TheseTable a b@ is present.
211+-- | Test if the @a@ side of @TheseTable a b@ is present.
212+--
213+-- Corresponds to 'Data.These.Combinators.hasHere'.
206214hasHereTable :: TheseTable a b -> Expr Bool
207215hasHereTable TheseTable {here} = isJustTable here
208216
209217
210218-- | Test if the @b@ table of @TheseTable a b@ is present.
219+--
220+-- Corresponds to 'Data.These.Combinators.hasThere'.
211221hasThereTable :: TheseTable a b -> Expr Bool
212222hasThereTable TheseTable {there} = isJustTable there
213223
214224
215225-- | Attempt to project out the @a@ table of a @TheseTable a b@.
226+--
227+-- Corresponds to 'Data.These.Combinators.justHere'.
216228justHereTable :: TheseTable a b -> MaybeTable a
217229justHereTable = here
218230
219231
220232-- | Attempt to project out the @b@ table of a @TheseTable a b@.
233+--
234+-- Corresponds to 'Data.These.Combinators.justThere'.
221235justThereTable :: TheseTable a b -> MaybeTable b
222236justThereTable = there
223237
@@ -237,7 +251,7 @@ thoseTable :: a -> b -> TheseTable a b
237251thoseTable a b = TheseTable (justTable a) (justTable b)
238252
239253
240−-- | Pattern match on a 'TheseTable'.
254+-- | Pattern match on a 'TheseTable'. Corresponds to 'these'.
241255theseTable :: Table Expr c
242256 => (a -> c) -> (b -> c) -> (a -> b -> c) -> TheseTable a b -> c
243257theseTable f g h TheseTable {here, there} =
@@ -252,9 +266,9 @@ theseTable f g h TheseTable {here, there} =
252266-- 'TableSchema'.
253267nameTheseTable :: ()
254268 => Name (Maybe MaybeTag)
255− -- ^ The name of the column to track the presence of 'thisTable'.
269+ -- ^ The name of the column to track the presence of the @a@ table.
256270 -> Name (Maybe MaybeTag)
257− -- ^ The name of the column to track the presence of 'thatTable'.
271+ -- ^ The name of the column to track the presence of the @b@ table.
258272 -> a
259273 -- ^ Names of the columns in the @a@ table.
260274 -> b