to post messages and comments.

@ndtimofeev:

В догонку к #2864255. Частично проблема решается явным экспортом полученных переменных. Теперь документация содержит те же символы что и загруженный модуль. Проблема в том, что я пытаюсь scrap my boilerplate и тут такой удар от классика.

@ndtimofeev:

Ну я так не играю. Я могу изобразить топ-левел биндинг с паттернматчингом, но haddock не умеет генерировать документацию^Wупоминания переменных созданных в этом паттерне, что сводит полезность вышеперечисленного на нет. Если в топ левеле объявить биндинг вида (var1, var2) = ('c', True), то в документации будет упомянут только var1.

@ndtimofeev:

Если явным образом запретить экспорт конструктора типа, но разрешить экспорт селекторов, то они будут изображены в документации как функции. Почти. Для селектора t из типа data T = T { t :: forall m. Monad m => m Int } констрейнты будут перечислены после аргумента T и с явным forall'ом. Можно это как-то пофиксить (кроме как написать алиасы)?

@qrilka:

хотел в хаддок тикет написать, а Trac мне в ответ "OperationalError: disk I/O error"...

@segfault:

А где у нас можно найти пакет с документацией и примерами кода в поле synopsis кабал файла?
У меня тут пакет, а корневого модуля у него нет (библиотека). Решил доку в описание пакета сунуть, как в линзах сделано. Но фигурные скобки в блоках кода пропадают. Решение не гуглится.

@qnikst:

а хаддок билдит же либу чтобы сгенерить документацию, т.е. документация с ffi либой на хакадже не сгенерится и надо самому заливать?

@qnikst:

data Foo = Foo !a !b

как тут добавить хаддок комментарий к a и b?

@qnikst:

а что там у хаддока с поддержой utf, если умеет, то как?

@segfault:

а можно хаддоком добавить исходник функции в документацию ? некоторые функции такие короткие, что информативнее исходник, чем объяснение зачем она нужна.

@PineappleZombie:

Ой, радость то какая — хаддок уникоду научился

@qrilka:

А никто не подскажет как лечить "could not find link destinations for:" для генерации хаддоков с ссылками на зависимые пакеты, или хэкидж сам всё перелинкует?

@PineappleZombie:

В разметку хаддока можно включать картинки. Но через жопу: <<url>> добавляет картинку, а та кодируется с помощью en.wikipedia.org . Работает, но глаза вытекают. Другого способа вставлять формулы я не знаю.