integrate rascal reference manual and library docs

[jurgenvinju]

• trunk
• split the implementation of the tutor from the content of the courses: moved the implementation to org.rascalmpl.tutor moved the courses data to org.rascalmpl.courses introduced tutor:/// and courses:/// schemes to reach Rascal source code and tutor data respectively renamed and moved all internal references to the old folders in the experimental part of the library
• added missing files
• added missing files
• fixes of locations
• forgot to add?
• added more info to boolean explanations
• Add 'location' annotation to JavaADT, respective documentation update
• Update src/org/rascalmpl/courses/Rascal/Declarations/SyntaxDefinition/Symbol/Symbol.concept
• Update src/org/rascalmpl/courses/Rascal/Declarations/SyntaxDefinition/Symbol/Symbol.html
• Update src/org/rascalmpl/courses/Rascal/Declarations/SyntaxDefinition/Symbol/Symbol.concept
• Update src/org/rascalmpl/courses/Rascal/Declarations/SyntaxDefinition/Symbol/Symbol.html
• fixed typo
• added documentation about when a priority filter works, depending on the recursive positions of the parent and child productions
• • improved doc of assoc and prio
• added note about transitive closure
• Update the JavaADT documentation with the recent changes to AstNode
• Fixes in RascalTutor and Courses
• Fixes to Courses
• Fixed more inconsistencies in the course files.
• Added missing documentation
• Version of courses that can be released
• Fixed issue with missing image.
• merged master into this branch
• Added documentation for the unicode changes
• Fixed some @doc errors.
• Modified @doc info in IO library files
• merge
• Added documentation for node subscription.
• Added documentation for subscription on nodes.
• Adding to documentation.
• Documentation for subscription on node and string added
• Documented composition on Map.
• New tutor files for map composition and string subscription.
• issue #110: updating copyrights 2009–2011 to 2009–2013
• Started documenting slicing.
• Working on documentation.
• Documented precision functions
• Made the binding resolution on Rascal JDT AstNode optional: the respective documentation update.
• Added documentation for slicing.
• Implemented,tested and documented slicing assignment on nodes
• Made terminology in Tutor for slice more uniform.
• Adapted the description of Range to refer to slices
• Written documentation for ListRelation.
• Regenerated Rascal course with better treatement of links in error messages.
• Slowly adapting the Tutor pages to new features and libraries.
• Updating tutor for splicing.
• fixed sort documentation
• regenerated courses
• updated tutor
• left-over of tutor regeneration.
• removed option for ClassResourceInputOutput to write. Now it is called ClassResourceInput. This code was dodgy and only working under certain circumstances with second level eclipse. The use case we needed it for was the tutor courses. These are now made writeable by proving -Drascal.courses=/path/to/courses on the commandline for starting Rascal or the second level Eclipse. That is a low-tech but robust solution
• small fixes
• working on documentation
• recompile
• trying to get m3 into docs
• regenerated
• regenerated
• fixed bug (hopefully) with tutor
• regenerated doc
• regenerated
• added new schemes especially for pointing to source code of libraries for recompiling the tutor. They have to be set using -D options. regenerated courses using these new schemes
• fixed jdt doc
• fixed many issues in documentation and tried to add relevant stuff to m3 documentation
• docs
• regenerated docs
• documented createM3 with an example
• sigh
• regenerated documentation and fixed some strange error in the java concept
• Fixed a number of issues in the tutor caused by Rascal language evolution.
• fixed sentence
• fixed documentation on index function in ListRelation. fixed current AST problem in doImport function for the online debugger
• replaced use of jetty by inline tinyhttpd server, then recoded the Tutor server using the util::Webserver module based on tinyhttpd. The documentation was regenerated to test and the differences can be explained by random query generation. the same amount of warnings are generated as before.
• updated some docs
• fixed issues with standard library documentation
• recompiled course and fixed some issues
• recompiled course Rascal
• fixing warnings and errors in documentation
• fixed warnings and errors in documentation
• fixed classpath and some fixes in documentation
• recompiler docu
• fixed a few warnings
• fixed documentation after fixing bug
• parser generator works again in context of tutor, so regenerating documentation with syntax definitions
• recompiled parsing example
• fixed ambiguous reference
• forgot to add globals for tutor to previous commits
• recompiled courses
• fixed some stuff and found a bug in TypeConstrained patterns while writing a doc example
• regenerated documentation, fixed a number of static errors
• bumped version to 0.7.1, see cwi-swat/rascal#253
• regenerated for now good reason other than random questions
• fixed documentation of resources module
• fixed two typos in a method name and fixed a null pointer exception in the call back timer for Figure
• added initial documentation for reified types
• fix #37 with a cherry test case on top
• Fixed type in Annotation.concept (#946)
• Fixed some errors in concept markup
• First rough data conversion of Rascal course
• Snapshot of converted documentation
• Temporary commit of generated files
• Improving/converting concept2 files
• Added .Index info
• Generated adoc + html files
• Regenerated adoc
• Regenerated html
• Improved documentation on outermost and innermost, since it continues on a match instead of a changed resulting value
• New html files
• Regenerated html
• Regenerated adoc+html
• Removed all generated adoc files
• Copied concept2 files to concept files
• Minor fixes to concepts
• (Re)moved html files
• Major reorganization/split of courses
• Fixing content
• Improved many concept files
• Improved course contents
• Removed dead generated html files
• Removed more old stuff
• Fixed path issues
• Add a pitfall explanation for overloaded funcs
• Garbage collection
• Fixed issue with local toc (table-of-contents) in remote module
• fixed bug in course compiler
• marked annotations deprecated
• minor edits
• re-organized pattern matching documentation by flattening it a bit, matches better with the real semantics
• visit stub for statements
• reference fix
• updated documentation on concrete syntax
• fixed issues in concept files
• fixed problem in concept page and also bug in example implementation of transitive closure
• fixed reference
• fixed references
• fixed reference
• removed broken implementation of closure
• fixed references and avoid use of alias in compiled repl
• fixed issues in concept files
• fixed typo
• fixed confusion in literal pattern match documentation
• fixed typo
• Fixed non relative image path probloem
• our visit statement is not comparable to OO visit design pattern. ours tackles recursion and while the visitor design pattern is to factor out dynamic dispatch. removed confusig remark.
• trying to fix parse tree documentation
• minor doc issues
• Fixing DrAmbiguity import
• removed dead warning
• Typo
• explained for loop better. fixes #1456
• fixing links
• Some minor documentation improvements, mainly in the 'Recipes' section.
• a single course will not produce a single .md file
• renamed extension of all concept files to .md
• updated link syntax in documentation files to docusaurus and new tutor ((Notation))
• new link syntax supported and fixed some issues in both documentation (ambiguous links) and the compiler
• disambiguating links
• converted image references
• working on image linking/asset management
• fixing broken links
• converted more links to new syntax
• added (((TOC))) feature to replace asciidoctors loctoc feature
• added TOC feature. not done. also rewrote asciidoctor nested lists syntax
• replaced asciidoctor source notation with markdown backquotes notation
• fixed minor issues in the docs
• fixing links and fixed false complaint about failing code in case of static ambiguity warning
• minor fixes
• converted tables as good as possible. expect issues with headers
• Revert "converted tables as good as possible. expect issues with headers"
• reconverted tables to default first line as header. that happens more often than not.
• removed all the italics markup inside backquotes because that is not supported
• replaces instances of superscript by subscript
• converted missing cases of unsupported markup inside backquotes
• some course fix/cleanup
• minor fixes
• fixing all Libraries links and moving pictures to md5 names instead of uuid for stability
• fixed a lot of links
• fixed some more links
• factored indexer out of Compiler and introduced modular indices, and fixed some manual stuff
• tutor compiler seems feature complete. time for manual stuff
• some reporting tricks to help go through the last 300 errors
• translated all normal http links from asciidoctor to markdown
• added some pitfalls and benefits
• fixed more documentation errors
• documented usage of keyword parameters to functions and constructors
• down to 225 errors
• fixes due to breaking API in util::Benchmark plus a lot of minor links
• moved keywords and title meta-data to meta-data sections
• moved .Details to detail: metadata
• replaced the last asciidoctor syntax remnants. .Synopsis is now #### Synopsis
• fixing broken links
• added link resolution for the current course to solve ambiguity
• fixed a whole lot of links
• fixed syntax of YAML headers
• fixed details section YAML
• lots of fixes. now wrestling with YAML
• added lots and lots of quotes
• removed double quotes
• fixed more YAML stuff
• another escape
• escaped true and false and some generated titles
• only 91 errors left
• lots of minor fixes
• more minor fixes
• moved Test course out of the source folder and fixed links and code examples here and there
• assets are copied again
• replaced hard asciidoctor includes by specific Rascal includes with parser and test/tag removal feature
• fixing missing image links or removed
• Fix escaping of special chars in keywords
• fixed small things, coding standard things in the old demos, added more examples, updated code examples which could now be done with new features
• tweaking the link semantics until it works
• documented ADT declarations
• re-implemented the indexer to sanitize it and generate links to index.md files
• added more examples
• fixed some todos
• revived unicode implementation of subscripts, temporarily
• fixes in subscripts
• reconstructed the operators table
• fixed wrong comments
• side bar positions for top-level courses
• fixed all broken wikipedia links
• documentation
• fixed to missed loctoc::s
• fixed broken link
• removed all instances of the word "simply"
• fixed example in While doc
• many small fixes
• fixed syntax sections of all statements and added missing information about jump labels for break, continue and fail
• fixed strongly out-of-date documentation for list matching. special cases for list types were removed a long time ago
• fixed node pattern syntax and added missing matching semantics for keyword fields
• fixed bugs in type constrained doc
• worked on syntax documentation for all patterns and updated documentation where outdated
• fixed comprehension doc
• more fixes
• better layout for syntax
• documented extend language feature
• fixed some issues with out-of-date documentation and imprecision
• fixed a link
• fixed a lot of broken/oldstyle links
• documented tests more explicitly
• fixed maven-plugin version and added missing file
• moved error courses to inside language reference
• fixed some old list syntax
• change links with dependency on moved courses to urls
• moved demo folder of library to documentation in rascal-website
• fixed broken link in documentation; have to think about how to solve this for future cases
• applied fixes from PR rascal-website/#13 by @aanastasiou
• Augmented the Program 'lema' with the basic information surrounding the definition of a valid Rascal program, such as comment syntax and entry point function (main()) variants. This is a first pass, the lema needs more editing
• FInalised the Declarations/Program entry
• Corrected the use of rascal.jar (it should be rascal-shell-stable.jar)
• bumped rascal-maven-plugin for bugfixes in the tutor that make it possible to re-compile the docs. the new feature is that the docs include syntax definitions now
• minor changes and fixes
• added png to the source
• several issues popped-up after we found hard links in the docs to locations in the website courses
• removed rascal unpack

[jurgenvinju]

So I merged the history of the Rascal manual into this project. There are dozens and dozens of issues to fix now regarding the locations of demonstration input and output. This will take a while, hence the branch.