Что означает комментарий Haskell, начинающийся с `{- |` вообще?
Я вижу многострочные комментарии Haskell, которые иногда начинаются с {- |, а не только {-.
Значит ли ведущий символ канала внутри комментария означает что-то по соглашению?
Ответ 1
В начале комментария | находится синтаксис Haddock, который начинает аннотацию документации. Пример из документации Haddock:
-- |The 'square' function squares an integer.
square :: Int -> Int
square x = x * x
Далее также говорится
"- |" синтаксис начинает аннотацию документации, которая применяется к следующему объявлению в исходном файле. Обратите внимание, что аннотация - это просто комментарий в Haskell - он будет игнорироваться компилятором Haskell.