@@ -135,6 +135,10 @@ listField key c xs = listFieldWith key c (const xs)
135135
136136
137137--------------------------------------------------------------------------------
138+-- | Produces a new 'Context' which has list field 'key'. All fields from
139+-- 'c' are also accessible from the produced context.
140+-- Be careful when doing @listFieldWith k ca f <> cb@ as any fields in @ca@
141+-- will override fields in @cb@ with the same name.
138142listFieldWith
139143 :: String -> Context a -> (Item b -> Compiler [Item a]) -> Context b
140144listFieldWith key c f = field' key $ fmap (ListField c) . f