В догонку к #2864255. Частично проблема решается явным экспортом полученных переменных. Теперь документация содержит те же символы что и загруженный модуль. Проблема в том, что я пытаюсь scrap my boilerplate и тут такой удар от классика.
Ну я так не играю. Я могу изобразить топ-левел биндинг с паттернматчингом, но haddock не умеет генерировать документацию^Wупоминания переменных созданных в этом паттерне, что сводит полезность вышеперечисленного на нет. Если в топ левеле объявить биндинг вида (var1, var2) = ('c', True), то в документации будет упомянут только var1.
Если явным образом запретить экспорт конструктора типа, но разрешить экспорт селекторов, то они будут изображены в документации как функции. Почти. Для селектора t из типа data T = T { t :: forall m. Monad m => m Int } констрейнты будут перечислены после аргумента T и с явным forall'ом. Можно это как-то пофиксить (кроме как написать алиасы)?
хотел в хаддок тикет написать, а Trac мне в ответ "OperationalError: disk I/O error"...
А где у нас можно найти пакет с документацией и примерами кода в поле synopsis кабал файла?
У меня тут пакет, а корневого модуля у него нет (библиотека). Решил доку в описание пакета сунуть, как в линзах сделано. Но фигурные скобки в блоках кода пропадают. Решение не гуглится.
У меня тут пакет, а корневого модуля у него нет (библиотека). Решил доку в описание пакета сунуть, как в линзах сделано. Но фигурные скобки в блоках кода пропадают. Решение не гуглится.
а хаддок билдит же либу чтобы сгенерить документацию, т.е. документация с ffi либой на хакадже не сгенерится и надо самому заливать?
data Foo = Foo !a !b
как тут добавить хаддок комментарий к a и b?
как тут добавить хаддок комментарий к a и b?
а что там у хаддока с поддержой utf, если умеет, то как?
а можно хаддоком добавить исходник функции в документацию ? некоторые функции такие короткие, что информативнее исходник, чем объяснение зачем она нужна.
Ой, радость то какая — хаддок уникоду научился
А никто не подскажет как лечить "could not find link destinations for:" для генерации хаддоков с ссылками на зависимые пакеты, или хэкидж сам всё перелинкует?
В разметку хаддока можно включать картинки. Но через жопу: <<url>> добавляет картинку, а та кодируется с помощью en.wikipedia.org . Работает, но глаза вытекают. Другого способа вставлять формулы я не знаю.