[Haskell-cafe] GSoC Project Proposal: Markdown support for Haddock
MigMit
miguelimo38 at yandex.ru
Mon Apr 8 21:08:13 CEST 2013
Отправлено с iPad
08.04.2013, в 21:44, Evan Laforge <qdunkan at gmail.com> написал(а):
> Can't we just add some features to haddock?
No, we can't. At the very least we should FIX haddock before adding features.
> There are a lot of ways
> to improve haddock a lot, and no one is doing them, so my impression
> is that haddock doesn't really have active maintainers. Adding a
> whole new backend seems risky, unless it results in new maintainers
> joining.
>
> For my personal bikeshed contribution, I would like to see haddock
> move in the way of fewer markup characters and rules, not more. Since
> haddock is not "statically checked", the only way to find out if I put
> in an error is to run haddock and then visually inspect the output,
> unless of course it was a syntax error, in which case the error
> message is often not very good. I can easily haddock individual files
> since I have a custom build system, but I imagine cabal users would
> have to haddock the entire project every time. I regularly see
> haddock errors in released packages so I'm not the only one.
>
> There are lots of ways to improve haddock a lot. For example, better
> parse error messages. Make ""s smarter so they don't try to link
> things that are obviously not modules. Or complain if it's not a
> module. Or better, get rid of them entirely and use single quotes for
> that. And make single quotes work for non-imported symbols.
> Incremental support for cabal. Perhaps even deprecate @ and use ' for
> that too.
>
> One thing I think HTML got right is that there are only two characters
> that need to be quoted. Of course that's at the cost of all the
> markup being wordy, but the more you move in the markup-style DWIM the
> more little rules you have to remember.
>
>
> On Thu, Apr 4, 2013 at 6:00 PM, Johan Tibell <johan.tibell at gmail.com> wrote:
>>> Would it be too much to ask that a notation be used which has
>>> a formal syntax and a formal semantics?
>>
>> We will document our superset, sure. That's what others did as well.
>> The point is using Markdown as the shared base.
>>
>> _______________________________________________
>> Haskell-Cafe mailing list
>> Haskell-Cafe at haskell.org
>> http://www.haskell.org/mailman/listinfo/haskell-cafe
>
> _______________________________________________
> Haskell-Cafe mailing list
> Haskell-Cafe at haskell.org
> http://www.haskell.org/mailman/listinfo/haskell-cafe
More information about the Haskell-Cafe
mailing list