blob: ded4dbe3941ab01b14fcad61a27e37953446d2f8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
{
{-# OPTIONS -w #-}
-- The above warning supression flag is a temporary kludge.
-- While working on this module you are encouraged to remove it and fix
-- any warnings in the module. See
-- http://hackage.haskell.org/trac/ghc/wiki/Commentary/CodingStyle#Warnings
-- for details
module HaddockParse (parseHaddockParagraphs, parseHaddockString) where
import {-# SOURCE #-} HaddockLex
import HsSyn
import RdrName
}
%tokentype { Token }
%token '/' { TokSpecial '/' }
'@' { TokSpecial '@' }
'[' { TokDefStart }
']' { TokDefEnd }
DQUO { TokSpecial '\"' }
URL { TokURL $$ }
ANAME { TokAName $$ }
'-' { TokBullet }
'(n)' { TokNumber }
'>..' { TokBirdTrack $$ }
IDENT { TokIdent $$ }
PARA { TokPara }
STRING { TokString $$ }
%monad { Either String }
%name parseHaddockParagraphs doc
%name parseHaddockString seq
%%
doc :: { HsDoc RdrName }
: apara PARA doc { docAppend $1 $3 }
| PARA doc { $2 }
| apara { $1 }
| {- empty -} { DocEmpty }
apara :: { HsDoc RdrName }
: ulpara { DocUnorderedList [$1] }
| olpara { DocOrderedList [$1] }
| defpara { DocDefList [$1] }
| para { $1 }
ulpara :: { HsDoc RdrName }
: '-' para { $2 }
olpara :: { HsDoc RdrName }
: '(n)' para { $2 }
defpara :: { (HsDoc RdrName, HsDoc RdrName) }
: '[' seq ']' seq { ($2, $4) }
para :: { HsDoc RdrName }
: seq { docParagraph $1 }
| codepara { DocCodeBlock $1 }
codepara :: { HsDoc RdrName }
: '>..' codepara { docAppend (DocString $1) $2 }
| '>..' { DocString $1 }
seq :: { HsDoc RdrName }
: elem seq { docAppend $1 $2 }
| elem { $1 }
elem :: { HsDoc RdrName }
: elem1 { $1 }
| '@' seq1 '@' { DocMonospaced $2 }
seq1 :: { HsDoc RdrName }
: PARA seq1 { docAppend (DocString "\n") $2 }
| elem1 seq1 { docAppend $1 $2 }
| elem1 { $1 }
elem1 :: { HsDoc RdrName }
: STRING { DocString $1 }
| '/' strings '/' { DocEmphasis (DocString $2) }
| URL { DocURL $1 }
| ANAME { DocAName $1 }
| IDENT { DocIdentifier $1 }
| DQUO strings DQUO { DocModule $2 }
strings :: { String }
: STRING { $1 }
| STRING strings { $1 ++ $2 }
{
happyError :: [Token] -> Either String a
happyError toks =
-- Left ("parse error in doc string: " ++ show (take 3 toks))
Left ("parse error in doc string")
-- Either monad (we can't use MonadError because GHC < 5.00 has
-- an older incompatible version).
instance Monad (Either String) where
return = Right
Left l >>= _ = Left l
Right r >>= k = k r
fail msg = Left msg
}
|
