panini 1.1.0 → 1.1.1

data/README.rdoc

@@ -54,6 +54,17 @@ Here's how the grammar from above is defined:
   n_a.add_production(['a'])             # A -> 'a'
   n_b.add_production(['b'])             # A -> 'b'
 
+=== Start Symbols
+
+In order to derive sentences, the grammar needs a start symbol.  Any nonterminal in the grammar can be used as the start symbol.  If a start symbol is not explicitly set, then the first nonterminal added to the grammar is used. 
+
+  grammar = Panini::Grammar.new
+
+  nt_0 = grammar.add_nonterminal
+  nt_1 = grammar.add_nonterminal
+
+  grammar.start = nt_1
+
 === Derivators
 
 Derivators are objects that take a Panini::Grammar and then apply the rules to generate a sentence.  Creating the sentences

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.1.1

data/lib/grammar.rb

@@ -8,10 +8,14 @@ module Panini
       @nonterminals = []
     end
 
-    # Returns the grammar's start symbol. This will always be the first
-    # nonterminal added to the grammar.
+    # Returns the grammar's start symbol. This will be the first
+    # nonterminal added to the grammar if it hasn't been specified.
     def start
-      @nonterminals[0]
+      @start ||= @nonterminals[0]
+    end
+
+    def start=(start)
+      @start = start
     end
 
     # Add a nonterminal to the grammar.

data/panini.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "panini"
-  s.version = "1.1.0"
+  s.version = "1.1.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["mjbellantoni"]

data/spec/grammar_spec.rb

@@ -52,8 +52,19 @@ describe "Grammar#start" do
     end
   end
 
-  it "returns the first nonterminal" do
-    @g.start.should == @nonterminals[0]
+  context "when a start symbol is not specified" do
+    it "returns the first nonterminal" do
+      @g.start.should == @nonterminals[0]
+    end    
+  end
+
+  context "when a start symbol is specified" do
+    before(:each) do
+      @g.start = @nonterminals[1]
+    end
+    it "returns that nonterminal" do
+      @g.start.should == @nonterminals[1]
+    end    
   end
 
 end

metadata

@@ -2,7 +2,7 @@
 name: panini
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors: 
 - mjbellantoni
@@ -105,7 +105,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: -1665720431960213425
+      hash: 3016262755013279233
       segments: 
       - 0
       version: "0"