Add happy's website (haskell-infra#226)

* initial import

darcs-hash:1cf09fa53d9f9c581d2a0276c8d013aafe801133

* 1.16 updates

darcs-hash:dccdb4bc9f55a10a4fde271ae562edcd7ee90869

* fix release date

darcs-hash:fb5bb7683445260993d2ff9615d5845438a4fb7d

* use PDF for 1.16, not PS

darcs-hash:b5ce21e0ce404baf29c8d2a97b068ba301f96897

* fix RPM links

darcs-hash:d5fff0ef741159c85f94d04d535ac95f7e444fa4

* fix link to Windows bin

darcs-hash:c692f1472b98fb28104953168b1f4025402805af

* 1.17 updates

darcs-hash:1de11294204d00b9649c63c89cf869070e6bee94

* fix win32 zip link

darcs-hash:be536f93f84a73fb5f6870559fb9c7b450440648

* Fix windows distribution link

darcs-hash:3e3107d0d4351cfcdc8020726e49819449176b9b

* update to 1.18

darcs-hash:ed7010e090d9b29422a0821bb3f28b04e1c5b315

* update for 1.18.5

Ignore-this: 5b8d6b12a13405f6f643fd4ae3757588

darcs-hash:f9d00931b54f839bb26cbdc3d5290b1da3d4967a

* Add uncommitted files from the Happy website

Ignore-this: fde1d132b1cd62fc3b5434fc9673e5d52d0566a4a442c11a2e9c5e460bb203d8b3552a2fa0324e21

darcs-hash:03ea48f880aa7ad49c902df38819a3d4c4bcd6f4

* Add files that didn't get ported over for some reason

* Happy is no longer handled specially

* Add happy to the builder

Thanks @tomjaguarpaw

* Get Happy.gif from main happy repo

* Remove `site/happy/doc_OLD`

Keeping in history is enough

* Remove `site/happy/doc/html-OLD`

Keeping in history is enough

* Remove site/happy/.{current-hash,darcs-boring}

Don't need these metadata files.

* happy: Some cleaning up of the web page

* Removed unversioned docs

We have converted to reST and readthedocs.io.

* Remove extra copy of change log

Repo's is enough

* Link current readthedocs.io documentation

* Happy: Update repo references

Co-authored-by: simonmar <simonmar@microsoft.com>
Co-authored-by: Simon Marlow <marlowsd@gmail.com>
Co-authored-by: Tikhon Jelvis <tikhon@jelv.is>

README.md

@@ -120,7 +120,6 @@ Some of the others are
 | [`arrows/`](https://www.haskell.org/arrows/) | | Ross Patterson | |
 | [`communities/`](https://www.haskell.org/communities/) | | | [Details](#details-communities) |
 | [`definition/`](https://www.haskell.org/definition/) | | Haskell Prime committee | [Details](#details-definition) |
-| [`happy/`](https://www.haskell.org/happy/) | | Happy maintainers | [Details](#details-happy) |
 | [`haskell-workshop/`](https://www.haskell.org/haskell-workshop/) | | Haskell Symposium organisers | [Details](#details-haskell-workshop) |
 | [`hugs/`](https://www.haskell.org/hugs/) | | | [Details](#details-hugs) |
 | [`nhc98/`](https://www.haskell.org/nhc98/) | | York Functional Programming Group | [Details](#details-nhc98) |
@@ -160,11 +159,6 @@ Some of the others are
 * <a name="details-haddock"></a>
   `haddock/`
 
-* <a name="details-happy"></a>
-  `happy/`
-
-  See also <https://github.com/haskell-infra/www.haskell.org/issues/183>
-
 * <a name="details-haskell-workshop"></a>
   `haskell-workshop/`
 

builder/site.hs

@@ -35,6 +35,10 @@ main = mkContext >>= \ctx -> hakyllWith configuration $ do
   match "img/*" $ do
     route   idRoute
     compile copyFileCompiler
+
+  match "happy/**" $ do
+    route   idRoute
+    compile copyFileCompiler
 
   match "alex/**" $ do
     route   idRoute

site/happy/doc-1.11/html/docbook.css

@@ -0,0 +1,20 @@
+.BOOK .TITLE          { text-align: center }
+.BOOK .SUBTITLE       { text-align: center }
+.BOOK .CORPAUTHOR     { text-align: center }
+.BOOK .AUTHOR         { text-align: center }
+.BOOK .AFFILIATION    { text-align: center }
+.BOOK .EDITEDBY       { text-align: center }
+.BOOK .EDITOR         { text-align: center }
+.BOOK .GRAPHIC        { text-align: center }
+
+.ARTICLE .TITLE          { text-align: center }
+.ARTICLE .SUBTITLE       { text-align: center }
+.ARTICLE .CORPAUTHOR     { text-align: center }
+.ARTICLE .AUTHOR         { text-align: center }
+.ARTICLE .AFFILIATION    { text-align: center }
+.ARTICLE .EDITEDBY       { text-align: center }
+.ARTICLE .EDITOR         { text-align: center }
+.ARTICLE .GRAPHIC        { text-align: center }
+.ARTICLE .ABSTRACT       { margin-left: 0.5in;
+                           margin-right: 0.5in;
+                           font-style: italic }

site/happy/doc-1.11/html/happy-introduction.html

@@ -0,0 +1,312 @@
+<HTML
+><HEAD
+><TITLE
+>Introduction</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+REL="HOME"
+TITLE="Happy User Guide"
+HREF="happy.html"><LINK
+REL="PREVIOUS"
+TITLE="Happy User Guide"
+HREF="happy.html"><LINK
+REL="NEXT"
+TITLE="Reporting Bugs"
+HREF="sec-reporting-bugs.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Happy User Guide</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="happy.html"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="sec-reporting-bugs.html"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="HAPPY-INTRODUCTION"
+>Chapter 1. Introduction</A
+></H1
+><DIV
+CLASS="TOC"
+><DL
+><DT
+><B
+>Table of Contents</B
+></DT
+><DT
+>1.1. <A
+HREF="happy-introduction.html#SEC-COMPATIBILITY"
+>Compatibility</A
+></DT
+><DT
+>1.2. <A
+HREF="sec-reporting-bugs.html"
+>Reporting Bugs</A
+></DT
+><DT
+>1.3. <A
+HREF="sec-license.html"
+>License</A
+></DT
+><DT
+>1.4. <A
+HREF="sec-obtaining.html"
+>Obtaining <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+></A
+></DT
+></DL
+></DIV
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> is a parser generator
+    system for Haskell, similar to the tool
+    <SPAN
+CLASS="APPLICATION"
+>yacc</SPAN
+> for C.  Like
+    <SPAN
+CLASS="APPLICATION"
+>yacc</SPAN
+>, it takes a file containing an
+    annotated BNF specification of a grammar and produces a Haskell
+    module containing a parser for the grammar. </P
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> is flexible; unlike
+    <SPAN
+CLASS="APPLICATION"
+>yacc</SPAN
+>, you can have several
+    <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> parsers in the same program, and
+    each parser may have multiple entry points.
+    <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> can work in conjunction with a
+    lexical analyser supplied by the user (either hand-written or
+    generated by another program), or it can parse a stream of
+    characters directly (but this isn't practical in most cases).  In
+    a future version we hope to include a lexical analyser generator
+    with <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> as a single package. </P
+><P
+> Parsers generated by <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> are
+    fast; generally faster than an equivalent parser written using
+    parsing combinators or similar tools.  Furthermore, any future
+    improvements made to <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> will benefit
+    an existing grammar, without need for a rewrite. </P
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> is sufficiently powerful
+    to parse Haskell itself - there's a freely available Haskell
+    parser written using <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> which can be
+    obtained from <A
+HREF="http://www.pms.informatik.uni-muenchen.de/mitarbeiter/panne/haskell_libs/hsparser.html"
+TARGET="_top"
+>    The <TT
+CLASS="LITERAL"
+>hsparser</TT
+> Page</A
+>, and included with versions of
+    GHC from 5.00 onwards.</P
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> can currently generate
+    four types of parser from a given grammar, the intention being
+    that we can experiment with different kinds of functional code to
+    see which is the best, and compiler writers can use the different
+    types of parser to tune their compilers.  The types of parser
+    supported are: </P
+><P
+></P
+><OL
+TYPE="1"
+><LI
+><A
+NAME="ITEM-DEFAULT-BACKEND"
+></A
+><P
+>`standard' Haskell 98
+      (should work with any compiler that compiles Haskell
+      98).</P
+></LI
+><LI
+><P
+>standard Haskell using arrays
+
+
+      (this is not the default because we have
+      found this generates slower parsers than <A
+HREF="happy-introduction.html#ITEM-DEFAULT-BACKEND"
+>1</A
+>).</P
+></LI
+><LI
+><P
+>Haskell with GHC (Glasgow Haskell) extensions.
+      This is a slightly faster option than <A
+HREF="happy-introduction.html#ITEM-DEFAULT-BACKEND"
+>1</A
+> for Glasgow Haskell
+      users.</P
+></LI
+><LI
+><P
+>GHC Haskell with string-encoded arrays.  This is the
+	fastest/smallest option for GHC users.  If you're using GHC,
+	the optimum flag settings are <TT
+CLASS="LITERAL"
+>-agc</TT
+> (see
+	<A
+HREF="sec-invoking.html"
+>Chapter 3</A
+>).</P
+></LI
+></OL
+><P
+>Happy can also generate parsers which will dump debugging
+    information at run time, showing state transitions and the input
+    tokens to the parser.</P
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="SEC-COMPATIBILITY"
+>1.1. Compatibility</A
+></H1
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> is written in Glasgow Haskell.  This
+      means that (for the time being), you need GHC to compile it.
+      Any version of GHC &#62;= 3.02 should work.</P
+><P
+> Remember: parsers produced using
+      <SPAN
+CLASS="APPLICATION"
+>Happy</SPAN
+> should compile without
+      difficulty under any Haskell 98 complier or interpreter.</P
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="happy.html"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="happy.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="sec-reporting-bugs.html"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Happy User Guide</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Reporting Bugs</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>