From f2ebbf8fee1933fbc53a6507bf70590891fbc8bf Mon Sep 17 00:00:00 2001 From: grammarware Date: Thu, 8 Jul 2010 09:12:36 +0000 Subject: [PATCH] structuring online material; distributing cross-cutting issues properly between directories git-svn-id: https://slps.svn.sourceforge.net/svnroot/slps@805 ab42f6e0-554d-0410-b580-99e487e6eeb2 --- .../related.xsd => shared/xsd/links.xsd | 11 +- shared/xsl/links2html.xslt | 52 +++++++ shared/xsl/zoo2xhtml.xslt | 2 +- topics/java/related/Makefile | 7 - topics/java/related/links2html.xslt | 60 -------- www/Makefile | 16 +- www/{ => _dev}/Makefile.c.zoo | 6 +- www/{ => _dev}/Makefile.cpp.zoo | 4 +- www/{ => _dev}/Makefile.csharp.zoo | 22 +-- www/{ => _dev}/Makefile.java.zoo | 10 +- www/{ => _dev}/config.zoo | 0 .../related.xml => www/_dev/java-grammars.xml | 44 +++--- www/index.html | 145 +++++++++--------- www/{zoo/zoo.css => slps.css} | 2 +- www/zoo/index.html | 4 +- 15 files changed, 185 insertions(+), 200 deletions(-) rename topics/java/related/related.xsd => shared/xsd/links.xsd (70%) create mode 100644 shared/xsl/links2html.xslt delete mode 100644 topics/java/related/Makefile delete mode 100644 topics/java/related/links2html.xslt rename www/{ => _dev}/Makefile.c.zoo (72%) rename www/{ => _dev}/Makefile.cpp.zoo (80%) rename www/{ => _dev}/Makefile.csharp.zoo (72%) rename www/{ => _dev}/Makefile.java.zoo (66%) rename www/{ => _dev}/config.zoo (100%) rename topics/java/related/related.xml => www/_dev/java-grammars.xml (85%) rename www/{zoo/zoo.css => slps.css} (93%) diff --git a/topics/java/related/related.xsd b/shared/xsd/links.xsd similarity index 70% rename from topics/java/related/related.xsd rename to shared/xsd/links.xsd index 8755ebad..3e450ab0 100644 --- a/topics/java/related/related.xsd +++ b/shared/xsd/links.xsd @@ -16,15 +16,7 @@ - - - - - - - - - + @@ -34,6 +26,7 @@ + diff --git a/shared/xsl/links2html.xslt b/shared/xsl/links2html.xslt new file mode 100644 index 00000000..9580cfba --- /dev/null +++ b/shared/xsl/links2html.xslt @@ -0,0 +1,52 @@ + + + + + + + + <xsl:value-of select="@name"/> + + + + + +

+ +

+ +

+
    + +
+
+ + + + + +
  • + + + + + + + + + ( + + + , + + + ) — + + , + +

    + +

    +
    • +     +     diff --git a/shared/xsl/zoo2xhtml.xslt b/shared/xsl/zoo2xhtml.xslt index a70e6c79..618b7775 100644 --- a/shared/xsl/zoo2xhtml.xslt +++ b/shared/xsl/zoo2xhtml.xslt @@ -11,7 +11,7 @@ - +

    Software Language Processing Suite
    diff --git a/topics/java/related/Makefile b/topics/java/related/Makefile deleted file mode 100644 index bc10e452..00000000 --- a/topics/java/related/Makefile +++ /dev/null @@ -1,7 +0,0 @@ -build: - xmllint --noout --schema related.xsd related.xml - xsltproc links2html.xslt related.xml | python ../../../shared/python/closemeta.py > related.html - -clean: - rm -f related.html - diff --git a/topics/java/related/links2html.xslt b/topics/java/related/links2html.xslt deleted file mode 100644 index 466f7059..00000000 --- a/topics/java/related/links2html.xslt +++ /dev/null @@ -1,60 +0,0 @@ - - - - - - - - Link repository - - - -

    Link repository

    - -

    - -

    -
      - -
    -
    -     - - -     - - -
  • - - - - - - - - - ( - - - , - - - ) — JLS - - , - -

    - -

    -
    • -     - -     diff --git a/www/Makefile b/www/Makefile index 98a1ecb1..4750c83d 100644 --- a/www/Makefile +++ b/www/Makefile @@ -4,14 +4,18 @@ upload: scp index.html rlaemmel,slps@web.sourceforge.net:htdocs sync: - rsync -avz --exclude=".svn" --exclude="Makefile" --exclude="*.zoo" * sspider,slps@web.sourceforge.net:htdocs + rsync -avz --exclude=".svn" --exclude="Makefile" --exclude="_dev" * sspider,slps@web.sourceforge.net:htdocs clean: rm -f *~ zoo/*/* build: - make -f Makefile.c.zoo - make -f Makefile.cpp.zoo - make -f Makefile.csharp.zoo - make -f Makefile.java.zoo - xsltproc --stringparam date `date +"%d/%m/%Y"` ../shared/xsl/zoo2xhtml.xslt config.zoo > zoo/index.html + make -f _dev/Makefile.c.zoo + make -f _dev/Makefile.cpp.zoo + make -f _dev/Makefile.csharp.zoo + make -f _dev/Makefile.java.zoo + xsltproc --stringparam date `date +"%d/%m/%Y"` ../shared/xsl/zoo2xhtml.xslt _dev/config.zoo > zoo/index.html + xsltproc ../shared/xsl/links2html.xslt _dev/java-grammars.xml | python ../shared/python/closemeta.py > zoo/java/links.html + +test: + xmllint --noout --schema ../shared/xsd/links.xsd _dev/java-grammars.xml diff --git a/www/Makefile.c.zoo b/www/_dev/Makefile.c.zoo similarity index 72% rename from www/Makefile.c.zoo rename to www/_dev/Makefile.c.zoo index 248f99d1..1a1beddb 100644 --- a/www/Makefile.c.zoo +++ b/www/_dev/Makefile.c.zoo @@ -1,7 +1,7 @@ all: - make iso-9899-1999 -f Makefile.c.zoo - make iso-9899-tc2 -f Makefile.c.zoo - make iso-9899-tc3 -f Makefile.c.zoo + make iso-9899-1999 -f _dev/Makefile.c.zoo + make iso-9899-tc2 -f _dev/Makefile.c.zoo + make iso-9899-tc3 -f _dev/Makefile.c.zoo %: cp ../topics/grammars/c/$*/extracted-grammar.bgf zoo/c/$*.bgf diff --git a/www/Makefile.cpp.zoo b/www/_dev/Makefile.cpp.zoo similarity index 80% rename from www/Makefile.cpp.zoo rename to www/_dev/Makefile.cpp.zoo index 08d31e45..ac4bb151 100644 --- a/www/Makefile.cpp.zoo +++ b/www/_dev/Makefile.cpp.zoo @@ -1,6 +1,6 @@ all: - make iso-14882-1998 -f Makefile.cpp.zoo - make iso-n2723 -f Makefile.cpp.zoo + make iso-14882-1998 -f _dev/Makefile.cpp.zoo + make iso-n2723 -f _dev/Makefile.cpp.zoo %: cp ../topics/grammars/cpp/$*/extracted-grammar.bgf zoo/cpp/$*.bgf diff --git a/www/Makefile.csharp.zoo b/www/_dev/Makefile.csharp.zoo similarity index 72% rename from www/Makefile.csharp.zoo rename to www/_dev/Makefile.csharp.zoo index f703c945..70e48603 100644 --- a/www/Makefile.csharp.zoo +++ b/www/_dev/Makefile.csharp.zoo @@ -1,15 +1,15 @@ all: - make ecma-334-1 -f Makefile.csharp.zoo - make ecma-334-2 -f Makefile.csharp.zoo - make ecma-334-3 -f Makefile.csharp.zoo - make ecma-334-4 -f Makefile.csharp.zoo - make iso-23270-2003-extracted -f Makefile.csharp.zoo - make iso-23270-2003-recovered -f Makefile.csharp.zoo - make iso-23270-2006 -f Makefile.csharp.zoo - make msft-ls-1.0 -f Makefile.csharp.zoo - make msft-ls-1.2 -f Makefile.csharp.zoo - make msft-ls-3.0 -f Makefile.csharp.zoo - make msft-ls-4.0 -f Makefile.csharp.zoo + make ecma-334-1 -f _dev/Makefile.csharp.zoo + make ecma-334-2 -f _dev/Makefile.csharp.zoo + make ecma-334-3 -f _dev/Makefile.csharp.zoo + make ecma-334-4 -f _dev/Makefile.csharp.zoo + make iso-23270-2003-extracted -f _dev/Makefile.csharp.zoo + make iso-23270-2003-recovered -f _dev/Makefile.csharp.zoo + make iso-23270-2006 -f _dev/Makefile.csharp.zoo + make msft-ls-1.0 -f _dev/Makefile.csharp.zoo + make msft-ls-1.2 -f _dev/Makefile.csharp.zoo + make msft-ls-3.0 -f _dev/Makefile.csharp.zoo + make msft-ls-4.0 -f _dev/Makefile.csharp.zoo %: cp ../topics/grammars/csharp/$*/extracted-grammar.bgf zoo/csharp/$*.bgf diff --git a/www/Makefile.java.zoo b/www/_dev/Makefile.java.zoo similarity index 66% rename from www/Makefile.java.zoo rename to www/_dev/Makefile.java.zoo index aad1a7c4..5009941a 100644 --- a/www/Makefile.java.zoo +++ b/www/_dev/Makefile.java.zoo @@ -1,13 +1,13 @@ all: - make 1.jls -f Makefile.java.zoo - make 2.jls -f Makefile.java.zoo - make 3.jls -f Makefile.java.zoo + make 1.jls -f _dev/Makefile.java.zoo + make 2.jls -f _dev/Makefile.java.zoo + make 3.jls -f _dev/Makefile.java.zoo %.jls: cp ../topics/grammars/java/jls$*/extracted-implementable-grammar.bgf zoo/java/jls$*-impl.bgf - make jls$*-impl.formats -f Makefile.java.zoo + make jls$*-impl.formats -f _dev/Makefile.java.zoo cp ../topics/grammars/java/jls$*/extracted-readable-grammar.bgf zoo/java/jls$*-read.bgf - make jls$*-read.formats -f Makefile.java.zoo + make jls$*-read.formats -f _dev/Makefile.java.zoo %.formats: ../shared/tools/bgf2html zoo/java/$*.bgf zoo/java/$*.html diff --git a/www/config.zoo b/www/_dev/config.zoo similarity index 100% rename from www/config.zoo rename to www/_dev/config.zoo diff --git a/topics/java/related/related.xml b/www/_dev/java-grammars.xml similarity index 85% rename from topics/java/related/related.xml rename to www/_dev/java-grammars.xml index 4f2baf17..e6fa629e 100644 --- a/topics/java/related/related.xml +++ b/www/_dev/java-grammars.xml @@ -1,5 +1,5 @@ - + Originals @@ -8,10 +8,10 @@ Bill Joy Guy Steele http://java.sun.com/docs/books/jls/first_edition/html/19.doc.html - 1 + JLS1
    HTML or PDF
    - The original JLS1. The link points to app1 grammar source. + The original JLS1. The link points to impl1 grammar source.     @@ -21,10 +21,10 @@ Guy Steele Gilad Bracha http://java.sun.com/docs/books/jls/second_edition/html/syntax.doc.html - 2 + JLS2
    HTML or PDF
    - The original JLS2. The link points to app2 grammar source. + The original JLS2. The link points to impl2 grammar source.     @@ -34,10 +34,10 @@ Guy Steele Gilad Bracha http://java.sun.com/docs/books/jls/third_edition/html/syntax.html - 3 + JLS3
    HTML or PDF
    - The original JLS3. The link points to app3 grammar source. + The original JLS3. The link points to impl3 grammar source.     @@ -47,7 +47,7 @@ Java Language Grammar Richard J. Botting http://www.csci.csusb.edu/dick/samples/java.syntax.html - 1 + JLS1
    XBNF
    The grammar is in the author's XBNF format that we don't have an extractor in the SLPS yet. @@ -59,7 +59,7 @@ Sosuke Kaneko Kouji Yamauchi http://www.cad.mse.kyutech.ac.jp/people/zhou/dj/doc/revisedJavaGrammar.html - 1 + JLS1
    original HTML
    A part of the project called DJ (Declarative Java). @@ -70,7 +70,7 @@ Dmitri Bronnikov Bill McKeeman http://www.cs.dartmouth.edu/~mckeeman/cs118/notation/java11.html - 1 + JLS1
    YACC
    Contains some updates to Java 1.1 (which is covered by Arnold/Gosling book, not by any JLS). @@ -86,7 +86,7 @@ Terence Parr Scott Stanchfield http://www.antlr.org/grammar/java - 2 + JLS2
    ANTLR
    The grammar corresponds to Java 3, which is a bit more than JLS2. @@ -97,7 +97,7 @@ The Java JLS2 Grammar Gaute Lykkenborg http://www.lykkenborg.no/java/grammar/JLS2.html - 2 + JLS2
    browsable; ISO EBNF
    Very fancy heavily hyperlinked and coloured HTML. @@ -112,7 +112,7 @@ The Java JLS3 Grammar Gaute Lykkenborg http://www.lykkenborg.no/java/grammar/JLS3.html - 3 + JLS3
    browsable; ISO EBNF
    Very fancy heavily hyperlinked and coloured HTML. @@ -124,7 +124,7 @@ Java 1.5 grammar for ANTLR v3 that builds trees Dieter Habelitz http://www.antlr.org/grammar/1207932239307/Java1_5Grammars - 3 + JLS3
    ANTLR
    Not derived from other ANTLR Java grammars, relation to JLS unknown. @@ -134,7 +134,7 @@ Java 1.5 grammar for ANTLR v3 Terence Parr http://www.antlr.org/grammar/1152141644268/Java.g - 3 + JLS3
    ANTLR
    Claimed to be 'derived from spec', 'very clean' and 'pretty fast'. @@ -144,7 +144,7 @@ Java 5 (aka 1.5) grammar update Michael Studman http://www.antlr.org/grammar/1090713067533/index.html - 3 + JLS3
    ANTLR
    One of the most used ANTLR Java grammars, an update to the 1.3 grammar by Lilley/Mitchell/Parr/Stanchfield. @@ -154,7 +154,7 @@ yet another java 1.5 grammar Michael Stahl http://www.antlr.org/grammar/1093454600181/java15-grammar.zip - 3 + JLS3
    ANTLR
    Developed independently from the one by Michael Studman. @@ -164,7 +164,7 @@ Updated Java 1.5 Grammar Scott Wisniewski http://www.antlr.org/grammar/1109874324096/java1.5.zip - 3 + JLS3
    ANTLR
    Claimed to be based on Studman's one, but with 'better conformance to the Java Language Specification'. @@ -174,7 +174,7 @@ Java 1.5 + Java preprocessor Luca Colombi http://www.antlr.org/grammar/1147455993609/Java5.zip - 3 + JLS3
    ANTLR
    Based on the one by Wisniewski, but @@ -186,7 +186,7 @@ Java 1.5 Syntax (corrected) Richard Bosworth http://www.cmis.brighton.ac.uk/staff/rnb/bosware/javaSyntax/syntaxV2.html - 3 + JLS3
    original HTML
    This is the only grammar that claims to fix all errors and still not go beyond that. @@ -197,10 +197,10 @@ Bug ID: 6442525 Syntax specification (section 18) is inconsistent with other sections Richard Bosworth http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6442525 - 3 + JLS3
    plain text
    - Even that the title claims to spot differences between app3 and doc3 grammars, some of the + Even that the title claims to spot differences between impl3 and read3 grammars, some of the issues being reported say that both are incorrect. diff --git a/www/index.html b/www/index.html index 18d96fa0..0f47e56b 100644 --- a/www/index.html +++ b/www/index.html @@ -1,68 +1,80 @@ - - -Software Language Processing Suite - - - - -

    Software Language Processing Suite

    - -SourceForge.net Logo - -

    Mission

    - -

    The project facilitates exposition and comparison of approaches and -techniques on language processing in a way that is relevant for CS -students, teachers, scientists, and practitioners.

    - -

    - -

    - -

    Links

    - - - -

    - -

    - -

    FAQ

    - -
    - -
    What's the layout of the suite?
    - -
    The topics directory holds all the language processing samples + + + + + + Software Language Processing Suite + + + +

    + Software Language Processing Suite +
    + + SourceForge.net Logo + +

    +

    Mission

    +

    + The project facilitates exposition and comparison of approaches and + techniques on language processing in a way that is relevant for CS + students, teachers, scientists, and practitioners. +

    +
    +

    Pages

    + +

    Links

    + +
    +

    FAQ

    +
    +
    What's the layout of the suite?
    +
    The topics directory holds all the language processing samples (aka themes, topics, etc.). Typically, subdirectories of each topic directory group different "implementations" (aka alternative approaches, possibly with differing complementary capabilities). The typical contributor will operate in the directory of one topic, perhaps only in the directory of one implementation. For instance, the -"fl" topic (fl -- Factorial Language) comprises different +"fl" topic (fl — Factorial Language) comprises different implementations of the fl language that cover components such as parser, pretty printer, evaluator, type checker, and optimizer. There are different implementations for Java, Haskell, Prolog, and various language processing technologies. A topic may also hold a "shared" subdirectory that is meant to hold resources that are reused across -the different implementations. Next to the topics container, -there are also the following directories: www -- SLPS web -content; shared -- SLPS libraries and infrastructure not -currently assigned to a topic; tools -- executable files (such +the different implementations. Next to the topics container, +there are also the following directories: www — SLPS web +content; shared — SLPS libraries and infrastructure not +currently assigned to a topic; tools — executable files (such as scripts) to cover recurring actions in working with SLPS -topics.
    - -

    - -

    How to use (install, build, run) the suite?
    - -
    There is no useful way of building or running the suite as a +topics.
    +
    How to use (install, build, run) the suite?
    +
    There is no useful way of building or running the suite as a whole. The different implementations are provided by different people and rely quite intrinsically on specific libraries and tools that may require specific effort to get an implementation to work. As a general @@ -72,27 +84,18 @@

    FAQ

    this end. The colllective build and testing of an entire topic (with several implementations) is often not practical because it would just require too many third-party libraries and tools to be set up in a -challenging manner.
    - -

    - -

    How to become a contributor?
    - -
    Contributors are more than welcome. If you want to become a proper +challenging manner.
    +
    How to become a contributor?
    +
    Contributors are more than welcome. If you want to become a proper contributor (with svn access), please submit a short request to the slps-contributors mailing list or use SourceForge functionality. Clearly, you need a SourceForge account to be a contributor. This project uses the BSD license. If you merely want to discuss issues with existing examples or just offer a quick fix or the sketch of a new example, then please consider using one of the mailing -lists identified above.
    - -
    - -

    - -

    - +lists identified above.
    +
    +
    - + - + diff --git a/www/zoo/zoo.css b/www/slps.css similarity index 93% rename from www/zoo/zoo.css rename to www/slps.css index 30c7533e..0e5b8060 100644 --- a/www/zoo/zoo.css +++ b/www/slps.css @@ -10,7 +10,7 @@ br {clear: both;} ul.linklist li span,.links {text-align:center; font-family: "Courier New", Courier, mono; font-weight: bold;} ul.linklist li span a, .links a {text-decoration: none;} a:hover {text-decoration: underline;} -body{background-color:#9C9; color:#033;} +body{color:#033;} a:link{color:#039;} a:visited{color:#006;} ul li {list-style:disc;} diff --git a/www/zoo/index.html b/www/zoo/index.html index e065db9e..120effbb 100644 --- a/www/zoo/index.html +++ b/www/zoo/index.html @@ -2,7 +2,7 @@ Software Language Processing Suite — Grammar Zoo -

    +

    Software Language Processing Suite

    Grammar Zoo @@ -706,5 +706,5 @@ [Slides]
    -[SLPS]Last updated: 28/06/2010
    XHTML 1.0CSS 2.1 +[SLPS]Last updated: 08/07/2010
    XHTML 1.0CSS 2.1