/usr/local/bin/diffoscope --jquery http://code.jquery.com/jquery-2.2.4.min.js --html-dir /tank/diffoscope/hs-alex-3.1.4 /usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build1/All/hs-alex-3.1.4.txz /usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build2/All/hs-alex-3.1.4.txz

/usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build1/All/hs-alex-3.1.4.txz vs.

/usr/local/poudriere/data/packages/e24a8cae34360705d022f17584bb6b4507b8eb89-build2/All/hs-alex-3.1.4.txz ¶

hs-alex-3.1.4.txz-content ¶

+MANIFEST ¶

/usr/local/share/doc/cabal/ghc-7.10.2/alex-3.1.4/html/alex-files.html ¶

/usr/local/share/doc/cabal/ghc-7.10.2/alex-3.1.4/html/api.html ¶

/usr/local/share/doc/cabal/ghc-7.10.2/alex-3.1.4/html/index.html ¶

/usr/local/share/doc/cabal/ghc-7.10.2/alex-3.1.4/html/introduction.html ¶

/usr/local/share/doc/cabal/ghc-7.10.2/alex-3.1.4/html/wrappers.html ¶

Offset 1, 1 lines modified		Offset 1, 1 lines modified
1	{"name":"hs-alex","origin":"devel/hs-alex","version":"3.1.4","comment":"Tool·for·generating·lexical·analysers·in·Haskell","maintainer":"haskell@FreeBSD.org","www":"http://www.haskell.org/alex/","abi":"FreeBSD:11:amd64","arch":"freebsd:11:x86:64","prefix":"/usr/local","flatsize":819460,"licenselogic":"single","licenses":["BSD3CLAUSE"],"desc":"Alex·is·a·tool·for·generating·lexical·analysers·in·Haskell.··It·takes·a\ndescription·of·tokens·based·on·regular·expressions·and·generates·a\nHaskell·module·containing·code·for·scanning·text·efficiently.··It·is\nsimilar·to·the·tool·lex·or·flex·for·C/C++.\n\nWWW:·http://www.haskell.org/alex/","deps":{"gmp":{"origin":"math/gmp","version":"5.1.3_3"},"ghc":{"origin":"lang/ghc","version":"7.10.2"},"hs-QuickCheck":{"origin":"devel/hs-QuickCheck","version":"2.8.1"},"gcc":{"origin":"lang/gcc","version":"4.8.5_2"}},"categories":["devel","haskell"],"shlibs_required":["libHSarray-0.5.1.0-E0sTtauuKsGDLZoT7lTbgZ-ghc7.10.2.so","libHSfilepath-1.4.0.0-KsGE6pHE5eZHSN90ZVax6A-ghc7.10.2.so",·✂	1	{"name":"hs-alex","origin":"devel/hs-alex","version":"3.1.4","comment":"Tool·for·generating·lexical·analysers·in·Haskell","maintainer":"haskell@FreeBSD.org","www":"http://www.haskell.org/alex/","abi":"FreeBSD:11:amd64","arch":"freebsd:11:x86:64","prefix":"/usr/local","flatsize":819460,"licenselogic":"single","licenses":["BSD3CLAUSE"],"desc":"Alex·is·a·tool·for·generating·lexical·analysers·in·Haskell.··It·takes·a\ndescription·of·tokens·based·on·regular·expressions·and·generates·a\nHaskell·module·containing·code·for·scanning·text·efficiently.··It·is\nsimilar·to·the·tool·lex·or·flex·for·C/C++.\n\nWWW:·http://www.haskell.org/alex/","deps":{"gmp":{"origin":"math/gmp","version":"5.1.3_3"},"ghc":{"origin":"lang/ghc","version":"7.10.2"},"hs-QuickCheck":{"origin":"devel/hs-QuickCheck","version":"2.8.1"},"gcc":{"origin":"lang/gcc","version":"4.8.5_2"}},"categories":["devel","haskell"],"shlibs_required":["libHSarray-0.5.1.0-E0sTtauuKsGDLZoT7lTbgZ-ghc7.10.2.so","libHSfilepath-1.4.0.0-KsGE6pHE5eZHSN90ZVax6A-ghc7.10.2.so",·✂

Offset 1, 8 lines modified		Offset 1, 8 lines modified
1	<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>Chapter 5. The·Interface·to·an·Alex-generated·lexer</title><link·rel="stylesheet"·type="text/css"·href="fptools.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><link·rel="home"·href="index.html"·title="Alex·User·Guide"><link·rel="up"·href="index.html"·title="Alex·User·Guide"><link·rel="prev"·href="charsets.html"·title="4.2. Syntax·of·character·sets"><link·rel="next"·href="basic-api.html"·title="5.2. Basic·interface"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·class="navheader"><table·width="100%"·summary="Navigation·header"><tr><th·colspan="3"·align="center">Chapter 5. The·Interface·to·an·Alex-generated·lexer</th></tr><tr><td·width="20%"·align="left"><a·accesskey="p"·href="charsets.html">Prev</a> </td><th·width="60%"·align="center"> </th><td·width="20%"·align="right"> <a·accesskey="n"·href="basic-api.html">Next</a></td></tr></table><hr></div><div·cl·✂	1	<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>Chapter 5. The·Interface·to·an·Alex-generated·lexer</title><link·rel="stylesheet"·type="text/css"·href="fptools.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><link·rel="home"·href="index.html"·title="Alex·User·Guide"><link·rel="up"·href="index.html"·title="Alex·User·Guide"><link·rel="prev"·href="charsets.html"·title="4.2. Syntax·of·character·sets"><link·rel="next"·href="basic-api.html"·title="5.2. Basic·interface"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·class="navheader"><table·width="100%"·summary="Navigation·header"><tr><th·colspan="3"·align="center">Chapter 5. The·Interface·to·an·Alex-generated·lexer</th></tr><tr><td·width="20%"·align="left"><a·accesskey="p"·href="charsets.html">Prev</a> </td><th·width="60%"·align="center"> </th><td·width="20%"·align="right"> <a·accesskey="n"·href="basic-api.html">Next</a></td></tr></table><hr></div><div·cl·✂
2	····Alex·lexer·in·my·program?"</p><p>Alex·provides·for·a·great·deal·of·flexibility·in·how·the	2	····Alex·lexer·in·my·program?"</p><p>Alex·provides·for·a·great·deal·of·flexibility·in·how·the
3	····lexer·is·exposed·to·the·rest·of·the·program.··For·instance,	3	····lexer·is·exposed·to·the·rest·of·the·program.··For·instance,
4	····there's·no·need·to·parse·a·<code·class="literal">String</code>·directly·if	4	····there's·no·need·to·parse·a·<code·class="literal">String</code>·directly·if
5	····you·have·some·special·character-buffer·operations·that·avoid·the	5	····you·have·some·special·character-buffer·operations·that·avoid·the
6	····overheads·of·ordinary·Haskell·<code·class="literal">String</code>s.··You	6	····overheads·of·ordinary·Haskell·<code·class="literal">String</code>s.··You
7	····might·want·Alex·to·keep·track·of·the·line·and·column·number·in·the	7	····might·want·Alex·to·keep·track·of·the·line·and·column·number·in·the
8	····input·text,·or·you·might·wish·to·do·it·yourself·(perhaps·you·use·a	8	····input·text,·or·you·might·wish·to·do·it·yourself·(perhaps·you·use·a

Offset 1, 4 lines modified		Offset 1, 4 lines modified
1	<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>Alex·User·Guide</title><link·rel="stylesheet"·type="text/css"·href="fptools.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="Alex·is·a·tool·for·generating·lexical·analysers·in·Haskell,·given·a·description·of·the·tokens·to·be·recognised·in·the·form·of·regular·expressions.·It·is·similar·to·the·tool·lex·or·flex·for·C/C++."><link·rel="home"·href="index.html"·title="Alex·User·Guide"><link·rel="next"·href="about.html"·title="Chapter 1. About·Alex"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·class="navheader"><table·width="100%"·summary="Navigation·header"><tr><th·colspan="3"·align="center">Alex·User·Guide</th></tr><tr><td·width="20%"·align="left"> </td><th·width="60%"·align="center"> </th><td·width="20%"·align="right"> <a·accesskey="n"·href="about.html">Next</a></td></tr></table><hr></div><div·class="book"·title="Alex·User·✂	1	<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>Alex·User·Guide</title><link·rel="stylesheet"·type="text/css"·href="fptools.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="Alex·is·a·tool·for·generating·lexical·analysers·in·Haskell,·given·a·description·of·the·tokens·to·be·recognised·in·the·form·of·regular·expressions.·It·is·similar·to·the·tool·lex·or·flex·for·C/C++."><link·rel="home"·href="index.html"·title="Alex·User·Guide"><link·rel="next"·href="about.html"·title="Chapter 1. About·Alex"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·class="navheader"><table·width="100%"·summary="Navigation·header"><tr><th·colspan="3"·align="center">Alex·User·Guide</th></tr><tr><td·width="20%"·align="left"> </td><th·width="60%"·align="center"> </th><td·width="20%"·align="right"> <a·accesskey="n"·href="about.html">Next</a></td></tr></table><hr></div><div·class="book"·title="Alex·User·✂
2	······Haskell,·given·a·description·of·the·tokens·to·be·recognised·in	2	······Haskell,·given·a·description·of·the·tokens·to·be·recognised·in
3	······the·form·of·regular·expressions.··It·is·similar·to·the·tool	3	······the·form·of·regular·expressions.··It·is·similar·to·the·tool
4	······<span·class="quote">“<span·class="quote">lex</span>”</span>·or·<span·class="quote">“<span·class="quote">flex</span>”</span>·for·C/C++.</p></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="about.html">1.·About·Alex</a></span></dt><dd><dl><dt><span·class="section"><a·href="about.html#relnotes-30">1.1.·Release·Notes·for·version·3.0</a></span></dt><dt><span·class="section"><a·href="relnotes-22.html">1.2.·Release·Notes·for·version·2.2</a></span></dt><dt><span·class="section"><a·href="relnotes-210.html">1.3.·Release·Notes·for·version·2.1.0</a></span></dt><dt><span·class="section"><a·href="relnotes-20.html">1.4.·Release·Notes·for·version·2.0</a></span></dt><dd><dl><dt><span·class="section"><a·href="relnotes-20.html#changes-syntax">1.4.1.·Syntax·changes</a></span></dt><dt><span·class="section"><a·href="relnotes-20.html#changes-files">1.4.2.·Changes·in·the·form·of·an·Alex·file</a></span></dt><dt><span·class="section"><a·href·✂	4	······<span·class="quote">“<span·class="quote">lex</span>”</span>·or·<span·class="quote">“<span·class="quote">flex</span>”</span>·for·C/C++.</p></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="about.html">1.·About·Alex</a></span></dt><dd><dl><dt><span·class="section"><a·href="about.html#relnotes-30">1.1.·Release·Notes·for·version·3.0</a></span></dt><dt><span·class="section"><a·href="relnotes-22.html">1.2.·Release·Notes·for·version·2.2</a></span></dt><dt><span·class="section"><a·href="relnotes-210.html">1.3.·Release·Notes·for·version·2.1.0</a></span></dt><dt><span·class="section"><a·href="relnotes-20.html">1.4.·Release·Notes·for·version·2.0</a></span></dt><dd><dl><dt><span·class="section"><a·href="relnotes-20.html#changes-syntax">1.4.1.·Syntax·changes</a></span></dt><dt><span·class="section"><a·href="relnotes-20.html#changes-files">1.4.2.·Changes·in·the·form·of·an·Alex·file</a></span></dt><dt><span·class="section"><a·href·✂

Offset 2, 15 lines modified		Offset 2, 15 lines modified
2	······extended·form·of·BNF,·where·optional·phrases·are·enclosed·in	2	······extended·form·of·BNF,·where·optional·phrases·are·enclosed·in
3	······square·brackets·(<code·class="literal">[·...·]</code>),·and·phrases·which	3	······square·brackets·(<code·class="literal">[·...·]</code>),·and·phrases·which
4	······may·be·repeated·zero·or·more·times·are·enclosed·in·braces	4	······may·be·repeated·zero·or·more·times·are·enclosed·in·braces
5	······(<code·class="literal">{·...·}</code>).··Literal·text·is·enclosed·in	5	······(<code·class="literal">{·...·}</code>).··Literal·text·is·enclosed·in
6	······single·quotes.</p><p>An·Alex·lexical·specification·is·normally·placed·in·a·file	6	······single·quotes.</p><p>An·Alex·lexical·specification·is·normally·placed·in·a·file
7	········with·a·<code·class="literal">.x</code>·extension.··Alex·source·files·are	7	········with·a·<code·class="literal">.x</code>·extension.··Alex·source·files·are
8	········encoded·in·UTF-8,·just·like·Haskell·source	8	········encoded·in·UTF-8,·just·like·Haskell·source
9	········files<sup>[<a·name="idp632~~67640~~"·href="#ftn.idp632~~67640~~"·class="footnote">2</a>]</sup>.	9	········files<sup>[<a·name="idp63234872"·href="#ftn.idp63234872"·class="footnote">2</a>]</sup>.
10	······</p><p>The·overall·layout·of·an·Alex·file·is:</p><pre·class="programlisting">alex·:=·[·@code·]·[·wrapper·]·{·macrodef·}·@id·':-'·{·rule·}·[·@code·]</pre><p>The·file·begins·and·ends·with·optional·code·fragments.	10	······</p><p>The·overall·layout·of·an·Alex·file·is:</p><pre·class="programlisting">alex·:=·[·@code·]·[·wrapper·]·{·macrodef·}·@id·':-'·{·rule·}·[·@code·]</pre><p>The·file·begins·and·ends·with·optional·code·fragments.
11	······These·code·fragments·are·copied·verbatim·into·the·generated	11	······These·code·fragments·are·copied·verbatim·into·the·generated
12	······source·file.</p><p>At·the·top·of·the·file,·the·code·fragment·is·normally·used	12	······source·file.</p><p>At·the·top·of·the·file,·the·code·fragment·is·normally·used
13	······to·declare·the·module·name·and·some·imports,·and·that·is·all·it	13	······to·declare·the·module·name·and·some·imports,·and·that·is·all·it
14	······should·do:·don't·declare·any·functions·or·types·in·the·top·code	14	······should·do:·don't·declare·any·functions·or·types·in·the·top·code
15	······fragment,·because·Alex·may·need·to·inject·some·imports·of·its	15	······fragment,·because·Alex·may·need·to·inject·some·imports·of·its
16	······own·into·the·generated·lexer·code,·and·it·does·this·by·adding	16	······own·into·the·generated·lexer·code,·and·it·does·this·by·adding
Offset 130, 9 lines modified		Offset 130, 9 lines modified
130	» ··in.··In·order·to·actually·use·it·as·a·state,·you·must·have	130	» ··in.··In·order·to·actually·use·it·as·a·state,·you·must·have
131	» ··some·way·for·the·token·actions·to·specify·new·start·codes·-	131	» ··some·way·for·the·token·actions·to·specify·new·start·codes·-
132	» ··<a·class="xref"·href="api.html"·title="Chapter 5. The·Interface·to·an·Alex-generated·lexer">Chapter 5,·<i>The·Interface·to·an·Alex-generated·lexer</i></a>·describes·some·ways·this·can·be·done.	132	» ··<a·class="xref"·href="api.html"·title="Chapter 5. The·Interface·to·an·Alex-generated·lexer">Chapter 5,·<i>The·Interface·to·an·Alex-generated·lexer</i></a>·describes·some·ways·this·can·be·done.
133	» ··In·some·applications,·it·might·be·necessary·to·keep·a	133	» ··In·some·applications,·it·might·be·necessary·to·keep·a
134	» ··<span·class="emphasis"><em>stack</em></span>·of·start·codes,·where·at·the·end	134	» ··<span·class="emphasis"><em>stack</em></span>·of·start·codes,·where·at·the·end
135	» ··of·a·state·we·pop·the·stack·and·resume·parsing·in·the	135	» ··of·a·state·we·pop·the·stack·and·resume·parsing·in·the
136	» ··previous·state.··If·you·want·this·functionality,·you·have·to	136	» ··previous·state.··If·you·want·this·functionality,·you·have·to
137	» ··program·it·yourself.</p></div></div><div·class="footnotes"><br><hr·width="100"·align="left"><div·class="footnote"><p><sup>[<a·id="ftn.idp632~~67640~~"·href="#idp632~~67640~~"·class="para">2</a>]·</sup>Strictly·speaking,·GHC·source	137	» ··program·it·yourself.</p></div></div><div·class="footnotes"><br><hr·width="100"·align="left"><div·class="footnote"><p><sup>[<a·id="ftn.idp63234872"·href="#idp63234872"·class="para">2</a>]·</sup>Strictly·speaking,·GHC·source
138	········files.</p></div></div></div><div·class="navfooter"><hr><table·width="100%"·summary="Navigation·footer"><tr><td·width="40%"·align="left"><a·accesskey="p"·href="syntax.html">Prev</a> </td><td·width="20%"·align="center"><a·accesskey="u"·href="syntax.html">Up</a></td><td·width="40%"·align="right"> <a·accesskey="n"·href="regexps.html">Next</a></td></tr><tr><td·width="40%"·align="left"·valign="top">Chapter 3. Alex·Files </td><td·width="20%"·align="center"><a·accesskey="h"·href="index.html">Home</a></td><td·width="40%"·align="right"·valign="top"> Chapter 4. Regular·Expression</td></tr></table></div></body></html>	138	········files.</p></div></div></div><div·class="navfooter"><hr><table·width="100%"·summary="Navigation·footer"><tr><td·width="40%"·align="left"><a·accesskey="p"·href="syntax.html">Prev</a> </td><td·width="20%"·align="center"><a·accesskey="u"·href="syntax.html">Up</a></td><td·width="40%"·align="right"> <a·accesskey="n"·href="regexps.html">Next</a></td></tr><tr><td·width="40%"·align="left"·valign="top">Chapter 3. Alex·Files </td><td·width="20%"·align="center"><a·accesskey="h"·href="index.html">Home</a></td><td·width="40%"·align="right"·valign="top"> Chapter 4. Regular·Expression</td></tr></table></div></body></html>

Offset 68, 18 lines modified		Offset 68, 18 lines modified
68	····<code·class="literal">main</code>·function·that·we·can·use·for·testing·it;	68	····<code·class="literal">main</code>·function·that·we·can·use·for·testing·it;
69	····the·<code·class="literal">main</code>·function·just·tokenises·the·input·and	69	····the·<code·class="literal">main</code>·function·just·tokenises·the·input·and
70	····prints·the·results·to·standard·output.</p><p>Alex·has·kindly·provided·the·following·function·which·we·can	70	····prints·the·results·to·standard·output.</p><p>Alex·has·kindly·provided·the·following·function·which·we·can
71	····use·to·invoke·the·scanner:</p><pre·class="programlisting">alexScanTokens·::·String·->·[Token]</pre><p>Alex·arranges·for·the·input·stream·to·be·tokenised,·each·of	71	····use·to·invoke·the·scanner:</p><pre·class="programlisting">alexScanTokens·::·String·->·[Token]</pre><p>Alex·arranges·for·the·input·stream·to·be·tokenised,·each·of
72	····the·action·functions·to·be·passed·the·appropriate	72	····the·action·functions·to·be·passed·the·appropriate
73	····<code·class="literal">String</code>,·and·a·list·of·<code·class="literal">Token</code>s	73	····<code·class="literal">String</code>,·and·a·list·of·<code·class="literal">Token</code>s
74	····returned·as·the·result.··If·the·input·stream·is·lazy,·the·output	74	····returned·as·the·result.··If·the·input·stream·is·lazy,·the·output
75	····stream·will·also·be·produced·lazily<sup>[<a·name="idp632~~53944~~"·href="#ftn.idp632~~53944~~"·class="footnote">1</a>]</sup>.</p><p>We·have·demonstrated·the·simplest·form·of·scanner·here,	75	····stream·will·also·be·produced·lazily<sup>[<a·name="idp63221176"·href="#ftn.idp63221176"·class="footnote">1</a>]</sup>.</p><p>We·have·demonstrated·the·simplest·form·of·scanner·here,
76	····which·was·selected·by·the·<code·class="literal">%wrapper·"basic"</code>·line	76	····which·was·selected·by·the·<code·class="literal">%wrapper·"basic"</code>·line
77	····near·the·top·of·the·file.··In·general,·actions·do·not·have·to·have	77	····near·the·top·of·the·file.··In·general,·actions·do·not·have·to·have
78	····type·<code·class="literal">String->Token</code>,·and·there's·no·requirement	78	····type·<code·class="literal">String->Token</code>,·and·there's·no·requirement
79	····for·the·scanner·to·return·a·list·of·tokens.</p><p>With·this·specification·in·the·file	79	····for·the·scanner·to·return·a·list·of·tokens.</p><p>With·this·specification·in·the·file
80	····<code·class="literal">Tokens.x</code>,·Alex·can·be·used·to·generate	80	····<code·class="literal">Tokens.x</code>,·Alex·can·be·used·to·generate
81	····<code·class="literal">Tokens.hs</code>:</p><pre·class="screen">$·alex·Tokens.x</pre><p>If·the·module·needed·to·be·placed·in·different·file,	81	····<code·class="literal">Tokens.hs</code>:</p><pre·class="screen">$·alex·Tokens.x</pre><p>If·the·module·needed·to·be·placed·in·different·file,
82	····<code·class="literal">Main.hs</code>·for·example,·then·the·output·filename	82	····<code·class="literal">Main.hs</code>·for·example,·then·the·output·filename
83	····can·be·specified·using·the·<code·class="option">-o</code>·option:</p><pre·class="screen">$·alex·Tokens.x·-o·Main.hs</pre><p>The·resulting·module·is·Haskell 98·compatible.··It·can·also	83	····can·be·specified·using·the·<code·class="option">-o</code>·option:</p><pre·class="screen">$·alex·Tokens.x·-o·Main.hs</pre><p>The·resulting·module·is·Haskell 98·compatible.··It·can·also
84	····be·readily·used·with·a·<a·class="ulink"·href="http://www.haskell.org/happy/"·target="_top">Happy</a>·parser.</p><div·class="footnotes"><br><hr·width="100"·align="left"><div·class="footnote"><p><sup>[<a·id="ftn.idp632~~53944~~"·href="#idp632~~53944~~"·class="para">1</a>]·</sup>that·is,·unless·you	84	····be·readily·used·with·a·<a·class="ulink"·href="http://www.haskell.org/happy/"·target="_top">Happy</a>·parser.</p><div·class="footnotes"><br><hr·width="100"·align="left"><div·class="footnote"><p><sup>[<a·id="ftn.idp63221176"·href="#idp63221176"·class="para">1</a>]·</sup>that·is,·unless·you
85	····have·any·patterns·that·require·a·long·lookahead.</p></div></div></div><div·class="navfooter"><hr><table·width="100%"·summary="Navigation·footer"><tr><td·width="40%"·align="left"><a·accesskey="p"·href="license.html">Prev</a> </td><td·width="20%"·align="center"> </td><td·width="40%"·align="right"> <a·accesskey="n"·href="syntax.html">Next</a></td></tr><tr><td·width="40%"·align="left"·valign="top">1.6. License </td><td·width="20%"·align="center"><a·accesskey="h"·href="index.html">Home</a></td><td·width="40%"·align="right"·valign="top"> Chapter 3. Alex·Files</td></tr></table></div></body></html>	85	····have·any·patterns·that·require·a·long·lookahead.</p></div></div></div><div·class="navfooter"><hr><table·width="100%"·summary="Navigation·footer"><tr><td·width="40%"·align="left"><a·accesskey="p"·href="license.html">Prev</a> </td><td·width="20%"·align="center"> </td><td·width="40%"·align="right"> <a·accesskey="n"·href="syntax.html">Next</a></td></tr><tr><td·width="40%"·align="left"·valign="top">1.6. License </td><td·width="20%"·align="center"><a·accesskey="h"·href="index.html">Home</a></td><td·width="40%"·align="right"·valign="top"> Chapter 3. Alex·Files</td></tr></table></div></body></html>

Offset 1, 11 lines modified		Offset 1, 11 lines modified
1	<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>5.3. Wrappers</title><link·rel="stylesheet"·type="text/css"·href="fptools.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><link·rel="home"·href="index.html"·title="Alex·User·Guide"><link·rel="up"·href="api.html"·title="Chapter 5. The·Interface·to·an·Alex-generated·lexer"><link·rel="prev"·href="basic-api.html"·title="5.2. Basic·interface"><link·rel="next"·href="invoking.html"·title="Chapter 6. Invoking·Alex"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·class="navheader"><table·width="100%"·summary="Navigation·header"><tr><th·colspan="3"·align="center">5.3. Wrappers</th></tr><tr><td·width="20%"·align="left"><a·accesskey="p"·href="basic-api.html">Prev</a> </td><th·width="60%"·align="center">Chapter 5. The·Interface·to·an·Alex-generated·lexer</th><td·width="20%"·align="right"> <a·accesskey="n"·href="invoking.html">Next</a></td></tr></table><hr></div><div·✂	1	<html><head><meta·http-equiv="Content-Type"·content="text/html;·charset=ISO-8859-1"><title>5.3. Wrappers</title><link·rel="stylesheet"·type="text/css"·href="fptools.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><link·rel="home"·href="index.html"·title="Alex·User·Guide"><link·rel="up"·href="api.html"·title="Chapter 5. The·Interface·to·an·Alex-generated·lexer"><link·rel="prev"·href="basic-api.html"·title="5.2. Basic·interface"><link·rel="next"·href="invoking.html"·title="Chapter 6. Invoking·Alex"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·class="navheader"><table·width="100%"·summary="Navigation·header"><tr><th·colspan="3"·align="center">5.3. Wrappers</th></tr><tr><td·width="20%"·align="left"><a·accesskey="p"·href="basic-api.html">Prev</a> </td><th·width="60%"·align="center">Chapter 5. The·Interface·to·an·Alex-generated·lexer</th><td·width="20%"·align="right"> <a·accesskey="n"·href="invoking.html">Next</a></td></tr></table><hr></div><div·✂
2	······declaration·in·your·file:</p><pre·class="programlisting">%wrapper·"<em·class="replaceable"><code>name</code></em>"</pre><p>where·<em·class="replaceable"><code>name</code></em>·is·the·name·of·the	2	······declaration·in·your·file:</p><pre·class="programlisting">%wrapper·"<em·class="replaceable"><code>name</code></em>"</pre><p>where·<em·class="replaceable"><code>name</code></em>·is·the·name·of·the
3	······wrapper,·eg.·<code·class="literal">basic</code>.··The·following·sections	3	······wrapper,·eg.·<code·class="literal">basic</code>.··The·following·sections
4	······describe·each·of·the·wrappers·that·come·with·Alex.</p><div·class="section"·title='5.3.1. The·"basic"·wrapper'><div·class="titlepage"><div><div><h3·class="title"><a·name="idp63~~428152~~"></a>5.3.1. The·"basic"·wrapper</h3></div></div></div><p>The·basic·wrapper·is·a·good·way·to·obtain·a·function·of	4	······describe·each·of·the·wrappers·that·come·with·Alex.</p><div·class="section"·title='5.3.1. The·"basic"·wrapper'><div·class="titlepage"><div><div><h3·class="title"><a·name="idp63395384"></a>5.3.1. The·"basic"·wrapper</h3></div></div></div><p>The·basic·wrapper·is·a·good·way·to·obtain·a·function·of
5	» type·<code·class="literal">String·->·[token]</code>·from·a·lexer	5	» type·<code·class="literal">String·->·[token]</code>·from·a·lexer
6	» specification,·with·little·fuss.</p><p>It·provides·definitions·for	6	» specification,·with·little·fuss.</p><p>It·provides·definitions·for
7	········<code·class="literal">AlexInput</code>,·<code·class="literal">alexGetByte</code>	7	········<code·class="literal">AlexInput</code>,·<code·class="literal">alexGetByte</code>
8	» and·<code·class="literal">alexInputPrevChar</code>·that·are·suitable·for	8	» and·<code·class="literal">alexInputPrevChar</code>·that·are·suitable·for
9	» lexing·a·<code·class="literal">String</code>·input.··It·also·provides·a	9	» lexing·a·<code·class="literal">String</code>·input.··It·also·provides·a
10	» function·<code·class="literal">alexScanTokens</code>·which·takes·a	10	» function·<code·class="literal">alexScanTokens</code>·which·takes·a
11	» <code·class="literal">String</code>·input·and·returns·a·list·of·the	11	» <code·class="literal">String</code>·input·and·returns·a·list·of·the
Offset 35, 15 lines modified		Offset 35, 15 lines modified
35	················AlexSkip··inp'·len·····->·go·inp'	35	················AlexSkip··inp'·len·····->·go·inp'
36	················AlexToken·inp'·len·act·->·act·(take·len·str)·:·go·inp'	36	················AlexToken·inp'·len·act·->·act·(take·len·str)·:·go·inp'
37	</pre><p>The·type·signature·for·<code·class="literal">alexScanTokens</code>	37	</pre><p>The·type·signature·for·<code·class="literal">alexScanTokens</code>
38	········is·commented·out,·because·the·<code·class="literal">token</code>·type·is	38	········is·commented·out,·because·the·<code·class="literal">token</code>·type·is
39	········unknown.··All·of·the·actions·in·your·lexical·specification	39	········unknown.··All·of·the·actions·in·your·lexical·specification
40	········should·have·type:</p><pre·class="programlisting">{·...·}·::·String·->·token</pre><p>for·some·type·<code·class="literal">token</code>.</p><p>For·an·example·of·the·use·of·the·basic·wrapper,·see·the	40	········should·have·type:</p><pre·class="programlisting">{·...·}·::·String·->·token</pre><p>for·some·type·<code·class="literal">token</code>.</p><p>For·an·example·of·the·use·of·the·basic·wrapper,·see·the
41	········file·<code·class="literal">examples/Tokens.x</code>·in·the·Alex	41	········file·<code·class="literal">examples/Tokens.x</code>·in·the·Alex
42	» distribution.</p></div><div·class="section"·title='5.3.2. The·"posn"·wrapper'><div·class="titlepage"><div><div><h3·class="title"><a·name="idp634~~38776~~"></a>5.3.2. The·"posn"·wrapper</h3></div></div></div><p>The·posn·wrapper·provides·slightly·more·functionality	42	» distribution.</p></div><div·class="section"·title='5.3.2. The·"posn"·wrapper'><div·class="titlepage"><div><div><h3·class="title"><a·name="idp63406008"></a>5.3.2. The·"posn"·wrapper</h3></div></div></div><p>The·posn·wrapper·provides·slightly·more·functionality
43	» than·the·basic·wrapper:·it·keeps·track·of·line·and·column	43	» than·the·basic·wrapper:·it·keeps·track·of·line·and·column
44	» numbers·of·tokens·in·the·input·text.</p><p>The·posn·wrapper·provides·the·following,·in·addition·to	44	» numbers·of·tokens·in·the·input·text.</p><p>The·posn·wrapper·provides·the·following,·in·addition·to
45	» the·straightforward·definitions·of	45	» the·straightforward·definitions·of
46	» <code·class="literal">alexGetByte</code>·and	46	» <code·class="literal">alexGetByte</code>·and
47	» <code·class="literal">alexInputPrevChar</code>:</p><pre·class="programlisting">	47	» <code·class="literal">alexInputPrevChar</code>:</p><pre·class="programlisting">
48	data·AlexPosn·=·AlexPn·!Int··--·absolute·character·offset	48	data·AlexPosn·=·AlexPn·!Int··--·absolute·character·offset
49	·······················!Int··--·line·number	49	·······················!Int··--·line·number
Offset 61, 15 lines modified		Offset 61, 15 lines modified
61	················AlexEOF·->·[]	61	················AlexEOF·->·[]
62	················AlexError·((AlexPn·_·line·column),_,_,_)·->·error·$·"lexical·error·at·"·++·(show·line)·++·"·line,·"·++·(show·column)·++·"·column"	62	················AlexError·((AlexPn·_·line·column),_,_,_)·->·error·$·"lexical·error·at·"·++·(show·line)·++·"·line,·"·++·(show·column)·++·"·column"
63	················AlexSkip··inp'·len·····->·go·inp'	63	················AlexSkip··inp'·len·····->·go·inp'
64	················AlexToken·inp'·len·act·->·act·pos·(take·len·str)·:·go·inp'	64	················AlexToken·inp'·len·act·->·act·pos·(take·len·str)·:·go·inp'
65	</pre><p>The·types·of·the·token·actions·should·be:</p><pre·class="programlisting">{·...·}·::·AlexPosn·->·String·->·token</pre><p>For·an·example·using·the·<code·class="literal">posn</code>	65	</pre><p>The·types·of·the·token·actions·should·be:</p><pre·class="programlisting">{·...·}·::·AlexPosn·->·String·->·token</pre><p>For·an·example·using·the·<code·class="literal">posn</code>
66	» wrapper,·see·the·file	66	» wrapper,·see·the·file
67	» <code·class="literal">examples/Tokens_posn.x</code>·in·the·Alex	67	» <code·class="literal">examples/Tokens_posn.x</code>·in·the·Alex
68	» distribution.</p></div><div·class="section"·title='5.3.3. The·"monad"·wrapper'><div·class="titlepage"><div><div><h3·class="title"><a·name="idp634~~44152~~"></a>5.3.3. The·"monad"·wrapper</h3></div></div></div><p>The·<code·class="literal">monad</code>·wrapper·is·the·most	68	» distribution.</p></div><div·class="section"·title='5.3.3. The·"monad"·wrapper'><div·class="titlepage"><div><div><h3·class="title"><a·name="idp63411384"></a>5.3.3. The·"monad"·wrapper</h3></div></div></div><p>The·<code·class="literal">monad</code>·wrapper·is·the·most
69	» flexible·of·the·wrappers·provided·with·Alex.··It·includes·a	69	» flexible·of·the·wrappers·provided·with·Alex.··It·includes·a
70	» state·monad·which·keeps·track·of·the·current·input·and·text	70	» state·monad·which·keeps·track·of·the·current·input·and·text
71	» position,·and·the·startcode.··It·is·intended·to·be·a·template	71	» position,·and·the·startcode.··It·is·intended·to·be·a·template