textpow 0.10.1 → 1.3.0

data/spec/textpow_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe Textpow do
+  before do
+    Textpow.send(:class_variable_set, "@@syntax", {})
+  end
+
+  it "has a version" do
+    Textpow::Version =~ /^\d\.\d\.\d$/
+  end
+
+  it "has syntax files named after their scopeName" do
+    Dir["#{Textpow.syntax_path}/*"].each do |file|
+      next if File.directory?(file)
+      (YAML.load_file(file)['scopeName'] + '.syntax').should == File.basename(file)
+    end
+  end
+
+  describe "syntax" do
+    it "finds syntax by path" do
+      Textpow.syntax('lib/textpow/syntax/source.ruby.syntax').name.should == 'Ruby'
+    end
+
+    it "finds a syntax by scopeName" do
+      Textpow.syntax('source.ruby').name.should == 'Ruby'
+    end
+
+    it "caches found syntax" do
+      Textpow.syntax('ruby').name.should == 'Ruby'
+      Dir.should_not_receive(:glob)
+      Textpow.syntax('ruby').name.should == 'Ruby'
+    end
+
+    it "finds a syntax by name parts" do
+      Textpow.syntax('ruby').name.should == 'Ruby'
+    end
+
+    it "returns the found syntax for mixed case" do
+      Textpow.syntax('RuBy').name.should == 'Ruby'
+    end
+
+    it "returns nil for unfound syntax" do
+      Textpow.syntax('buby').should == nil
+    end
+
+    it "does not find directories" do
+      Textpow.syntax('lib').should == nil
+    end
+
+    it "caches nil for unfound syntax" do
+      Dir.should_receive(:glob).and_return []
+      Textpow.syntax('buby').should == nil
+      Dir.should_not_receive(:glob)
+      Textpow.syntax('buby').should == nil
+    end
+  end
+end

data/textpow.gemspec

@@ -0,0 +1,19 @@
+$LOAD_PATH.push File.expand_path("../lib", __FILE__)
+require "textpow/version"
+
+Gem::Specification.new do |s|
+  s.name                  = "textpow"
+  s.version               = Textpow::Version
+  s.authors               = ["Dizan Vasquez", "Spox", "Chris Hoffman", "Michael Grosser"]
+  s.email                 = ["michael@grosser.it"]
+  s.homepage              = "http://github.com/grosser/textpow"
+  s.summary               = "A library for parsing TextMate bundles"
+  s.description           = s.summary
+  s.license               = "MIT"
+
+  s.files         = `git ls-files`.split("\n")
+  s.executables = ["plist2yaml", "plist2syntax"]
+  s.rdoc_options = ["--main", "README.rdoc"]
+
+  s.add_dependency "plist", '>=3.0.1'
+end

metadata

@@ -1,86 +1,264 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: textpow
-version: !ruby/object:Gem::Version 
-  version: 0.10.1
+version: !ruby/object:Gem::Version
+  version: 1.3.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Dizan Vasquez
+- Spox
+- Chris Hoffman
+- Michael Grosser
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2008-02-20 00:00:00 +01:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: oniguruma
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.1.0
-    version: 
-- !ruby/object:Gem::Dependency 
+date: 2012-08-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: plist
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 3.0.0
-    version: 
-description: A library for parsing TextMate[http://macromates.com/] bundles.
-email: dichodaemon@gmail.com
-executables: 
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+description: A library for parsing TextMate bundles
+email:
+- michael@grosser.it
+executables:
 - plist2yaml
 - plist2syntax
 extensions: []
-
-extra_rdoc_files: 
-- History.txt
-- Manifest.txt
-- README.txt
-files: 
-- bin/plist2yaml
+extra_rdoc_files: []
+files:
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- History.rdoc
+- MIT-LICENSE.txt
+- README.rdoc
+- Rakefile
 - bin/plist2syntax
+- bin/plist2yaml
+- examples/benchmark_js.rb
+- examples/jquery.js
 - lib/textpow.rb
-- lib/textpow
-- lib/textpow/syntax.rb
-- lib/textpow/score_manager.rb
 - lib/textpow/debug_processor.rb
-- mm/manual.mm
-- test/test_textpow.rb
-- History.txt
-- Rakefile
-- Manifest.txt
-- README.txt
-has_rdoc: true
-homepage: http://textpow.rubyforge.org
+- lib/textpow/recording_processor.rb
+- lib/textpow/score_manager.rb
+- lib/textpow/syntax.rb
+- lib/textpow/syntax/broken/markdown.syntax
+- lib/textpow/syntax/broken/php.syntax
+- lib/textpow/syntax/buggy/nemerle.syntax
+- lib/textpow/syntax/old/YAML.yaml
+- lib/textpow/syntax/old/txt2tags.yaml
+- lib/textpow/syntax/source.actionscript.syntax
+- lib/textpow/syntax/source.active4d.library.syntax
+- lib/textpow/syntax/source.active4d.syntax
+- lib/textpow/syntax/source.ada.syntax
+- lib/textpow/syntax/source.antlr.syntax
+- lib/textpow/syntax/source.apache-config.mod_perl.syntax
+- lib/textpow/syntax/source.apache-config.syntax
+- lib/textpow/syntax/source.applescript.syntax
+- lib/textpow/syntax/source.asp.syntax
+- lib/textpow/syntax/source.asp.vb.net.syntax
+- lib/textpow/syntax/source.c++.qt.syntax
+- lib/textpow/syntax/source.c++.syntax
+- lib/textpow/syntax/source.c-sharp.syntax
+- lib/textpow/syntax/source.c.ragel.syntax
+- lib/textpow/syntax/source.c.syntax
+- lib/textpow/syntax/source.camlp4.ocaml.syntax
+- lib/textpow/syntax/source.cm.syntax
+- lib/textpow/syntax/source.coffee.syntax
+- lib/textpow/syntax/source.context-free.syntax
+- lib/textpow/syntax/source.css.beta.syntax
+- lib/textpow/syntax/source.css.syntax
+- lib/textpow/syntax/source.d.syntax
+- lib/textpow/syntax/source.diff.syntax
+- lib/textpow/syntax/source.dot.syntax
+- lib/textpow/syntax/source.dylan.syntax
+- lib/textpow/syntax/source.eiffel.syntax
+- lib/textpow/syntax/source.erlang.syntax
+- lib/textpow/syntax/source.fortran.syntax
+- lib/textpow/syntax/source.fscript.syntax
+- lib/textpow/syntax/source.fxscript.syntax
+- lib/textpow/syntax/source.gri.syntax
+- lib/textpow/syntax/source.groovy.groovy.syntax
+- lib/textpow/syntax/source.haskell.syntax
+- lib/textpow/syntax/source.icalendar.syntax
+- lib/textpow/syntax/source.inform.syntax
+- lib/textpow/syntax/source.ini.syntax
+- lib/textpow/syntax/source.io.syntax
+- lib/textpow/syntax/source.java-props.syntax
+- lib/textpow/syntax/source.java.syntax
+- lib/textpow/syntax/source.js.greasemonkey.syntax
+- lib/textpow/syntax/source.js.jquery.syntax
+- lib/textpow/syntax/source.js.mootools.syntax
+- lib/textpow/syntax/source.js.prototype.bracketed.syntax
+- lib/textpow/syntax/source.js.prototype.syntax
+- lib/textpow/syntax/source.js.syntax
+- lib/textpow/syntax/source.js.yui.syntax
+- lib/textpow/syntax/source.json.syntax
+- lib/textpow/syntax/source.lex.syntax
+- lib/textpow/syntax/source.lighttpd-config.syntax
+- lib/textpow/syntax/source.lilypond.syntax
+- lib/textpow/syntax/source.lisp.syntax
+- lib/textpow/syntax/source.logo.syntax
+- lib/textpow/syntax/source.logtalk.syntax
+- lib/textpow/syntax/source.lua.syntax
+- lib/textpow/syntax/source.makefile.syntax
+- lib/textpow/syntax/source.matlab.syntax
+- lib/textpow/syntax/source.mel.syntax
+- lib/textpow/syntax/source.mips.syntax
+- lib/textpow/syntax/source.ml.syntax
+- lib/textpow/syntax/source.modula-3.syntax
+- lib/textpow/syntax/source.nant-build.syntax
+- lib/textpow/syntax/source.objc++.syntax
+- lib/textpow/syntax/source.objc.syntax
+- lib/textpow/syntax/source.ocaml.syntax
+- lib/textpow/syntax/source.ocamllex.syntax
+- lib/textpow/syntax/source.ocamlyacc.syntax
+- lib/textpow/syntax/source.open-gl.syntax
+- lib/textpow/syntax/source.pascal.syntax
+- lib/textpow/syntax/source.pascal.vectorscript.syntax
+- lib/textpow/syntax/source.perl.syntax
+- lib/textpow/syntax/source.php.cake.syntax
+- lib/textpow/syntax/source.plist.tm-grammar.syntax
+- lib/textpow/syntax/source.postscript.syntax
+- lib/textpow/syntax/source.processing.syntax
+- lib/textpow/syntax/source.prolog.syntax
+- lib/textpow/syntax/source.python.django.syntax
+- lib/textpow/syntax/source.python.syntax
+- lib/textpow/syntax/source.qmake.syntax
+- lib/textpow/syntax/source.quake-config.syntax
+- lib/textpow/syntax/source.r-console.syntax
+- lib/textpow/syntax/source.r.syntax
+- lib/textpow/syntax/source.regexp.oniguruma.syntax
+- lib/textpow/syntax/source.regexp.python.syntax
+- lib/textpow/syntax/source.regexp.syntax
+- lib/textpow/syntax/source.remind.syntax
+- lib/textpow/syntax/source.rez.syntax
+- lib/textpow/syntax/source.ruby.experimental.syntax
+- lib/textpow/syntax/source.ruby.rails.syntax
+- lib/textpow/syntax/source.ruby.syntax
+- lib/textpow/syntax/source.s5.syntax
+- lib/textpow/syntax/source.sass.syntax
+- lib/textpow/syntax/source.scheme.syntax
+- lib/textpow/syntax/source.scilab.syntax
+- lib/textpow/syntax/source.scss.syntax
+- lib/textpow/syntax/source.shell.syntax
+- lib/textpow/syntax/source.slate.syntax
+- lib/textpow/syntax/source.smarty.syntax
+- lib/textpow/syntax/source.sql.ruby.syntax
+- lib/textpow/syntax/source.sql.syntax
+- lib/textpow/syntax/source.ssh-config.syntax
+- lib/textpow/syntax/source.strings.syntax
+- lib/textpow/syntax/source.swig.syntax
+- lib/textpow/syntax/source.tcl.macports.syntax
+- lib/textpow/syntax/source.tcl.syntax
+- lib/textpow/syntax/source.yaml.syntax
+- lib/textpow/syntax/text.active4d-ini.syntax
+- lib/textpow/syntax/text.bbcode.syntax
+- lib/textpow/syntax/text.bibtex.syntax
+- lib/textpow/syntax/text.blog.html.syntax
+- lib/textpow/syntax/text.blog.markdown.syntax
+- lib/textpow/syntax/text.blog.syntax
+- lib/textpow/syntax/text.blog.textile.syntax
+- lib/textpow/syntax/text.gtdalt.syntax
+- lib/textpow/syntax/text.haml.syntax
+- lib/textpow/syntax/text.html.asp.net.syntax
+- lib/textpow/syntax/text.html.asp.syntax
+- lib/textpow/syntax/text.html.basic.syntax
+- lib/textpow/syntax/text.html.cfm.syntax
+- lib/textpow/syntax/text.html.django.syntax
+- lib/textpow/syntax/text.html.dokuwiki.syntax
+- lib/textpow/syntax/text.html.doxygen.syntax
+- lib/textpow/syntax/text.html.markdown.multimarkdown.syntax
+- lib/textpow/syntax/text.html.mason.syntax
+- lib/textpow/syntax/text.html.mediawiki.syntax
+- lib/textpow/syntax/text.html.mt.syntax
+- lib/textpow/syntax/text.html.ruby.syntax
+- lib/textpow/syntax/text.html.strict.active4d.syntax
+- lib/textpow/syntax/text.html.tcl.syntax
+- lib/textpow/syntax/text.html.textile.syntax
+- lib/textpow/syntax/text.html.tt.syntax
+- lib/textpow/syntax/text.html.twiki.syntax
+- lib/textpow/syntax/text.html.xhtml.1-strict.syntax
+- lib/textpow/syntax/text.log.latex.syntax
+- lib/textpow/syntax/text.mail.markdown.syntax
+- lib/textpow/syntax/text.man.syntax
+- lib/textpow/syntax/text.moinmoin.syntax
+- lib/textpow/syntax/text.plain.gtd.syntax
+- lib/textpow/syntax/text.plain.release-notes.syntax
+- lib/textpow/syntax/text.plain.syntax
+- lib/textpow/syntax/text.plist.syntax
+- lib/textpow/syntax/text.pmwiki.syntax
+- lib/textpow/syntax/text.restructuredtext.syntax
+- lib/textpow/syntax/text.setext.syntax
+- lib/textpow/syntax/text.subversion-commit.syntax
+- lib/textpow/syntax/text.tabular.csv.syntax
+- lib/textpow/syntax/text.tabular.tsv.syntax
+- lib/textpow/syntax/text.tex.latex.beamer.syntax
+- lib/textpow/syntax/text.tex.latex.haskell.syntax
+- lib/textpow/syntax/text.tex.latex.memoir.syntax
+- lib/textpow/syntax/text.tex.latex.rd.syntax
+- lib/textpow/syntax/text.tex.latex.sweave.syntax
+- lib/textpow/syntax/text.tex.latex.syntax
+- lib/textpow/syntax/text.tex.math.syntax
+- lib/textpow/syntax/text.tex.syntax
+- lib/textpow/syntax/text.txt2tags.syntax
+- lib/textpow/syntax/text.xml.apple-dist.syntax
+- lib/textpow/syntax/text.xml.strict.syntax
+- lib/textpow/syntax/text.xml.syntax
+- lib/textpow/syntax/text.xml.xsl.syntax
+- lib/textpow/version.rb
+- spec/fixtures/objeck.plist
+- spec/fixtures/utf8.txt
+- spec/spec_helper.rb
+- spec/textpow/score_manager_spec.rb
+- spec/textpow/syntax_files_spec.rb
+- spec/textpow/syntax_spec.rb
+- spec/textpow_spec.rb
+- textpow.gemspec
+homepage: http://github.com/grosser/textpow
+licenses:
+- MIT
 post_install_message: 
-rdoc_options: 
+rdoc_options:
 - --main
-- README.txt
-require_paths: 
+- README.rdoc
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1600551724538838794
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1600551724538838794
 requirements: []
-
-rubyforge_project: textpow
-rubygems_version: 1.0.1
+rubyforge_project: 
+rubygems_version: 1.8.24
 signing_key: 
-specification_version: 2
-summary: An engine for parsing Textmate bundles
-test_files: 
-- test/test_textpow.rb
+specification_version: 3
+summary: A library for parsing TextMate bundles
+test_files: []

data/Manifest.txt

@@ -1,13 +0,0 @@
-bin/plist2yaml
-bin/plist2syntax
-lib/textpow.rb
-lib/textpow
-lib/textpow/syntax.rb
-lib/textpow/score_manager.rb
-lib/textpow/debug_processor.rb
-mm/manual.mm
-test/test_textpow.rb
-History.txt
-Rakefile
-Manifest.txt
-README.txt

data/mm/manual.mm

@@ -1,266 +0,0 @@
-~ Textpow ~
-~~ A Library for Processing TextMate Bundles ~~
-
-#Introduction# | index
-
-= What is Textpow? =
-Textpow is a library to parse and process 
-[Textmate http://macromates.com] bundles. Although created created for their
-use in a word processor, these bundles have many other uses. For example, we
-have used them to create a syntax highligting 
-[utility http://ultraviolet.rubyforge.org] and also the markup rendering 
-[engine http://mama.rubyforge.org] used to render this
-documentation.
-
-= Requirements =
-
-* [Oniguruma http://www.geocities.jp/kosako3/oniguruma/] regular expression library (/>= 4.x.x/)
-* [Oniguruma for Ruby http://www.geocities.jp/kosako3/oniguruma/] ruby bindings for oniguruma (/>= 1.1.x/)
-
-= Installation =
-
-If you have [rubygems http://docs.rubygems.org/] installation is straightforward by typing 
-(as root if needed):
-
---------hl shell-unix-generic,,false------
-gem install -r textpow --include-dependencies
-------------------------------------------
-
-If you prefer to get the sources, the last stable version may be
-downloaded [here http://rubyforge.org/frs/?group_id=3513].
-
-= Status =
-
-The current version of Textpow (0.9.0) is able to parse syntax (/tmLanguage/, /tmSyntax/)
-and theme (/tmTheme/) files.
-
-#Use#
-
-= Syntax files and text parsing =
-
-The idea of parsing is to process some /input text/ using the rules defined in 
-a /syntax [file > syntax_files]/ (which are discussed in detail in Textmate 
-[documentation http://macromates.com/textmate/manual/language_grammars#language_grammars]).
-The text is parsed line by line, and, events are sent to a /[processor > processors]/
-according to how the text matches the syntax file.
-
--------dot parsing_overview, Overview of the parsing process.----------
-digraph G {
-   node [fontname=Helvetica, fontsize=10];
-   edge [fontname=Helvetica, style=dashed, fontsize=10, decorate=true, fontcolor="#0066aa"];
-   center=true; 
-   {
-      rank=same;
-      node [shape=invhouse, style="filled", color="#333399", fillcolor="#6666cc", fontcolor="white"];
-      syntax_file[label="Syntax file"];
-      text[label="Input text"];
-   }
-   {     
-      node [shape=box, style="filled", color="#993333", fillcolor="#cc6666", fontcolor="white"]
-      syntax_object[label="SyntaxNode"];
-      processor[label="Processor", shape=box];
-   }
-   parse [label="", style=invis, fontsize=0,height=0,width=0,shape=none];
-   rank=same{syntax_object; parse};
-   
-   syntax_file -> syntax_object [label="  SyntaxNode#load"];
-   syntax_object -> parse [arrowhead=none];
-   text -> parse [arrowhead=none];
-   parse -> processor [label="  SyntaxNode#parse"];
-
-}
------------------------------------------------------------------------
-
-= For the impatient =
-
-Parsing a file using Textpow is as easy as 1-2-3!
-
-1.  Load the Syntax File:
-
-    ---hl ruby,,false---
-    require 'textpow'
-    syntax = Textpow::SyntaxNode.load("ruby.tmSyntax")
-    -------------
-
-2. Initialize a processor:
-    ---hl ruby,,false---
-    processor = Textpow::DebugProcessor.new
-    -------------
-
-3. Parse some text:
-    ---hl ruby,,false---
-    syntax.parse( text,  processor )
-    -------------
-
-= The gory details =
-
-
-== Syntax files == | syntax_files
-At the heart of syntax parsing are ..., well, syntax files. Lets see for instance
-the example syntax that appears in textmate's 
-[documentation http://macromates.com/textmate/manual/language_grammars#language_grammars]:
-
-
----------hl property_list---------
- {  scopeName = 'source.untitled';
-    fileTypes = ( txt );
-    foldingStartMarker = '\{\s*$';
-    foldingStopMarker = '^\s*\}';
-    patterns = (
-       {  name = 'keyword.control.untitled';
-          match = '\b(if|while|for|return)\b';
-       },
-       {  name = 'string.quoted.double.untitled';
-          begin = '"';
-          end = '"';
-          patterns = ( 
-             {  name = 'constant.character.escape.untitled';
-                match = '\\.';
-             }
-          );
-       },
-    );
- }
-----------------------------------
-
-But Textpow is not able to parse text pfiles. However, in practice this is not a problem,
-since it is possible to convert both text and binary pfiles to an XML format. Indeed, all 
-the syntaxes in the Textmate syntax [repository http://macromates.com/svn/Bundles/trunk/Bundles/]
-are in XML format:
-
----------hl xml---------
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-   <key>scopeName</key>
-   <string>source.untitled</string>
-   <key>fileTypes</key>
-   <array>
-      <string>txt</string>
-   </array>
-   <key>foldingStartMarker</key>
-   <string>\{\s*$</string>
-   <key>foldingStopMarker</key>
-   <string>^\s*\}</string>
-   <key>patterns</key>
-   <array>
-      <dict>
-         <key>name</key>
-         <string>keyword.control.untitled</string>
-         <key>match</key>
-         <string>\b(if|while|for|return)\b</string>
-      </dict>
-      <dict>
-         <key>name</key>
-         <string>string.quoted.double.untitled</string>
-         <key>begin</key>
-         <string>"</string>
-         <key>end</key>
-         <string>"</string>
-         <key>patterns</key>
-         <array>
-            <dict>
-               <key>name</key>
-               <string>constant.character.escape.untitled</string>
-               <key>match</key>
-               <string>\\.</string>
-            </dict>
-         </array>
-      </dict>
-   </array>
-</dict>
-------------------------
-
-Of course, most people find XML both ugly and cumbersome. Fortunately, it is 
-also possible to store syntax files in YAML format, which is much easier to 
-read:
-
--------------hl yaml---------------
---- 
-fileTypes: 
-- txt
-scopeName: source.untitled
-foldingStartMarker: \{\s*$
-foldingStopMarker: ^\s*\}
-patterns:
-- name: keyword.control.untitled
-  match: \b(if|while|for|return)\b
-- name: string.quoted.double.untitled
-  begin: '"'
-  end: '"'
-  patterns:
-  - name: constant.character.escape.untitled
-    match: \\.
------------------------------------
-
-== Processors == | processors
-
-Until now we have talked about the parsing process without explaining what
-it is exactly. Basically, parsing consists in reading text from a string or
-file and applying tags to parts of the text according to what has been
-specified in the [syntax file > syntax_files].
-
-In textpow, the process takes place line by line, from the beginning to the
-end and from left to right for every line. As the text is parsed, events are
-sent to a /processor/ object when a tag is open or closed and so on. 
-A processor is any object which implements one or more of the following
-methods:
-
-------------hl ruby--------------
-class Processor
-   def open_tag name, position
-   end
-      
-   def close_tag name, position
-   end
-      
-   def new_line line
-   end
-      
-   def start_parsing name
-   end
-   
-   def end_parsing name
-   end
-end
----------------------------------
-
-* `open_tag`. Is called when a new tag is opened, it receives the tag's name and
-    its position (relative to the current line).
-* `close_tag`. The same that `open_tag`, but it is called when a tag is closed.
-* `new_line`. Is called every time that a new line is processed, it receives the
-    line's contents.
-* `start_parsing`. Is called once at the beginning of the parsing process. It 
-    receives the scope name for the syntax being used.
-* `end_parsing`. Is called once after all the input text has been parsed. It 
-    receives the scope name for the syntax being used.
-
-Textpow ensures that the methods are called in parsing order, thus, 
-for example, if there are two subsequent calls to `open_tag`, the first
-having `name="text.string", position=10` and the second having 
-`name="markup.string", position=10`, it should be understood that the
-`"markup.string"` tag is /inside/ the `"text.string"` tag.
-
-# Links #
-
-
-= Rubyforge project page =
-
-* [Textpow http://rubyforge.org/projects/textpow].
-
-= Documentation =
-
-* [Textmate documentation http://macromates.com/textmate/manual/].
-* [YAML cookbook http://yaml4r.sourceforge.net/cookbook/].
-
-= Requirements =
-
-* [Oniguruma http://www.geocities.jp/kosako3/oniguruma/].
-* [Oniguruma for ruby http://rubyforge.org/projects/oniguruma/].
-* [Ruby plist parsing library http://rubyforge.org/projects/plist].
-
-= Projects using Textpow =
-
-* [Ultraviolet Syntax Highlighting Engine http://ultraviolet.rubyforge.org/].
-* [Macaronic markup engine http://mama.rubyforge.org/].