ruby-vpi 18.0.2 → 19.0.0

data/Rakefile

@@ -26,7 +26,7 @@ task :default => :build
   PROJECT_SSH_URL  = "snk@rubyforge.org:/var/www/gforge-projects/#{PROJECT_ID}"
 
   load 'doc/history.rb'
-  head             = @history.first
+  head = @history.first
   PROJECT_VERSION  = head['Version']
   PROJECT_BIRTHDAY = head['Date']
 
@@ -147,23 +147,16 @@ task :default => :build
 
 # distribution
 
-  desc "Prepare for distribution."
-  task :dist => ['ext', 'ref', :doc] do |t|
-    cd 'ext' do
-      sh 'rake swig'
-    end
-  end
-
   desc 'Publish documentation to website.'
-  task :web => [:web_ref, :web_doc]
+  task :web => ['ref/web', 'doc/web']
 
   desc "Publish reference documentation."
-  task :web_ref => 'ref' do |t|
+  task 'ref/web' => 'ref' do |t|
     upload PROJECT_SSH_URL, *t.prerequisites
   end
 
   desc "Publish user documentation."
-  task :web_doc => 'doc' do |t|
+  task 'doc/web' => 'doc' do |t|
     upload PROJECT_SSH_URL, *t.prerequisites
   end
 
@@ -197,7 +190,7 @@ task :default => :build
 # packaging
 
   desc "Generate release packages."
-  task :release => [:clobber, :dist] do
+  task :release => [:ref, :doc] do
     sh 'rake package'
   end
 
@@ -214,6 +207,7 @@ task :default => :build
     s.add_dependency 'rcov',       '>= 0.7.0'
     s.add_dependency 'xx'           # needed by rcov
     s.add_dependency 'ruby-debug', '>= 0.5.2'
+    s.add_dependency 'ruby-prof'
 
     s.requirements << "POSIX threads library"
     s.requirements << "C language compiler"
@@ -234,12 +228,12 @@ task :default => :build
   desc "Configures the gem during installation."
   task :gem_config_inst do |t|
     # make documentation available to gem_server
-      gemDir  = File.dirname(__FILE__)
-      gemName = File.basename(gemDir)
-      docDir  = File.join('..', '..', 'doc', gemName)
+    gemDir  = File.dirname(__FILE__)
+    gemName = File.basename(gemDir)
+    docDir  = File.join('..', '..', 'doc', gemName)
 
-      mkdir_p docDir
-      ln_s gemDir, File.join(docDir, 'rdoc')
+    mkdir_p docDir
+    ln_s gemDir, File.join(docDir, 'rdoc')
   end
 
 
@@ -250,9 +244,11 @@ task :default => :build
     # ensures that current sources are tested instead of the installed gem
     ENV['RUBYLIB'] = PROJECT_LIBS
 
-    FileList['samp/**/*.rake'].each do |runner|
+    sim = ENV['SIMULATOR'] || 'cver'
+
+    FileList['examples/**/*.rake'].each do |runner|
       cd File.dirname(runner) do
-        sh 'rake', '-f', File.basename(runner), ENV['SIMULATOR'] || 'cver'
+        sh 'rake', '-f', File.basename(runner), sim
       end
     end
   end

data/bin/generate/proto.rb

@@ -1,13 +1,18 @@
-# Ruby prototype of the design under test's Verilog implementation.
-def feign!
-  if <%= aModuleInfo.clock_port.name rescue "YOUR_CLOCK_SIGNAL_HERE" %>.posedge?
-    # discard old outputs
-    <% aModuleInfo.output_ports.each do |port| %>
-      <%= port.name %>.x!
-    <% end %>
+always do
+  wait until <%= aModuleInfo.clock_port.name rescue "YOUR_CLOCK_SIGNAL_HERE" %>.posedge?
 
-    # process new inputs
+  # discard old outputs
+  <% aModuleInfo.output_ports.each do |port| %>
+    <%= port.name %>.x!
+  <% end %>
 
-    # produce new outputs
-  end
+  # process new inputs
+  <% aModuleInfo.input_ports.each do |port| %>
+    # some_interesting_process( <%= port.name %> )
+  <% end %>
+
+  # produce new outputs
+  <% aModuleInfo.output_ports.each do |port| %>
+    # <%= port.name %> = some interesting output
+  <% end %>
 end

data/bin/ruby-vpi

@@ -1,3 +1,5 @@
+#!/usr/bin/env ruby
+#
 # This is a front-end for tools provided by Ruby-VPI.
 #
 # Usage:

data/doc/README

@@ -2,10 +2,8 @@ The *.doc files in this directory are plain-text files!
 
 To transform them into XHTML, you need the following software:
 
-  Rake:     http://docs.rubyrake.org/
-
-  RedCloth: http://whytheluckystiff.net/ruby/redcloth/
-
-  Coderay:  http://coderay.rubychan.de/
+* Rake:     http://docs.rubyrake.org/
+* RedCloth: http://whytheluckystiff.net/ruby/redcloth/
+* Coderay:  http://coderay.rubychan.de/
 
 Once you have the above software, simply run the "rake" command.

data/doc/Rakefile

@@ -10,9 +10,9 @@ $: << File.join(File.dirname(__FILE__), '..', 'lib')
 require 'ruby-vpi'
 include RubyVPI
 
-HISTORY_URL = WEBSITE_URL + "/history.html"
-RSS_URL = WEBSITE_URL + '/rss.xml'
-RSS_INFO = "RSS feed for this project."
+HISTORY_URL = PROJECT_URL + "/doc/history.html"
+RSS_URL     = PROJECT_URL + '/doc/rss.xml'
+RSS_INFO    = "RSS feed for this project."
 
 require 'ruby-vpi/erb'
 include ERB::Util

data/doc/common.css

@@ -1,108 +1,43 @@
-body {
-  margin: 0;
-  background-color: snow;
-  line-height: 160%;
-}
-
-#body {
-  margin-left: auto;
-  margin-right: auto;
-  max-width: 37em;
+@import 'spacing.css';
 
-  background-color: white;
-  border-left: thick solid salmon;
-  border-right: thick solid salmon;
-  padding: 2em;
-}
-
-
-/* headings */
-
-h1, h2, h3, h4, h5, h6, th, .title {
-  font-family: serif;
-}
-
-h1, h2, h3, h4, h5, h6 {
-  font-weight: lighter;
-  padding-top: 3em;
-  border-bottom: thin solid silver;
+body {
+  line-height: 1.8em;
 }
 
 
-/* table of contents */
+/* tables */
 
-#toc-links,
-#site-links {
-  text-align: center;
-  border-bottom: thick solid salmon;
-  background-color: white;
-  padding: 1em;
+table {
+  background-color: white; /* otherwise it's transparent! */
 }
 
-#toc-links {
-  background-color: ivory;
+th, td {
+  padding: 0.5em;
+  border: thin solid silver;
 }
 
-#toc {
-  border-top: thick solid salmon;
-  background-color: white;
-  padding: 1em;
+th {
+  background-color: whitesmoke;
 }
 
 
 /* latex */
 
-.front_cover {
-  margin-bottom: 10em;
-}
-
 .front_cover h1,
 .front_cover h2,
 .front_cover h3,
 .front_cover h4,
 .front_cover h5,
 .front_cover h6 {
-  border: none;
   text-align: center;
 }
 
-.part,
-.chapter {
-  padding-top: 3em;
-  padding-bottom: 3em;
-}
-
-.part > .title,
-.chapter > .title {
-  border: none;
-  padding-bottom: 1em;
-}
-
-.part > .title {
-  border-bottom: thick solid salmon;
-}
-
-.paragraph > .title,
-.admonition .title {
-  font-family: serif;
-  font-size: larger;
-}
-
-.paragraph > .title {
-  padding-top: 1em;
-}
-
 
 /* admonitions */
 
 .admonition {
   border: thin solid seagreen;
   background-color: honeydew;
-  padding: 1em;
-  margin-top: 1em;
-  margin-bottom: 1em;
-
-  min-height: 150px;
 }
 
 .admonition .icon {
@@ -120,14 +55,10 @@ tt {
   background-color: floralwhite;
 }
 
-pre, blockquote .code {
-  padding: 1em;
+pre {
   line-height: normal;
-  overflow: auto;
   display: block;
-}
 
-pre {
   border: thin solid darkgray;
   background-color: whitesmoke;
 }
@@ -138,28 +69,7 @@ pre {
 }
 
 
-/* tables */
-
-table {
-  background-color: white; /* otherwise it's transparent! */
-}
-
-th, td {
-  padding: 1em;
-  border: thin solid silver;
-}
-
-th {
-  background-color: whitesmoke;
-}
-
-
-/* formal blocks; see http://www.sagehill.net/docbookxsl/FormalTitles.html */
-
-.formal {
-  padding-top: 1em;
-  padding-bottom: 1em;
-}
+/* formal blocks */
 
 .formal .title {
   display: block;
@@ -167,45 +77,23 @@ th {
   text-align: center
 }
 
-
-  /* center-align any tables and images */
-
-  .formal table, .formal img {
-    margin-left: auto;
-    margin-right: auto;
-  }
-
-  .formal img {
-    display: block;
-  }
-
-
-/* emphasis */
-
-body {
-  font-family: sans-serif;
+/* center-align any tables and images */
+.formal table, .formal img {
+  margin-left: auto;
+  margin-right: auto;
 }
-
-em, blockquote {
-  font-family: serif;
+.formal img {
+  display: block;
 }
 
-blockquote {
-  border-left: thick solid darkkhaki;
-  background: beige;
-}
 
-hr {
-  background-color: red;
-  border: none;
-}
 
-big {
-  font-size: larger;
-}
+/* emphasis */
 
-a:hover {
-  color: red;
+pre, code, .admonition {
+  border-radius: 1em;
+  -moz-border-radius: 1em;
+  -webkit-border-radius: 1em;
 }
 
 

data/doc/common.tpl

@@ -27,53 +27,64 @@
 <html>
   <head>
     <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
-    <link rel="stylesheet" type="text/css" href="common.css" media="screen" />
+    <link rel="stylesheet" type="text/css" href="screen.css" media="screen" />
     <link rel="stylesheet" type="text/css" href="print.css" media="print" />
+    <link rel="alternate stylesheet" type="text/css" href="print.css" title="Print Preview" />
     <link rel="alternate" type="application/rss+xml" href="<%= RSS_URL %>" title="<%= RSS_INFO %>" />
     <title><%= page_title %></title>
   </head>
   <body>
-    <div id="site-links">
-      <a href="readme.html">Home</a>
-      <%
-        Dir['*.doc'].each do |src|
-          name, ext = src.split('.', 2)
-          next if name == 'readme'
-      %>
-        &middot; <a href="<%= name %>.html"><%= name.capitalize %></a>
-      <% end %>
-      <hr style="display: none"/>
-    </div>
+    <div id="menu">
+      <h1>Site navigation</h1>
+      <ul id="site-links">
+        <li><a href="readme.html">Home</a></li>
+        <%
+          Dir['*.doc'].each do |src|
+            name, ext = src.split('.', 2)
+            next if name == 'readme'
+        %>
+          <li><a href="<%= name %>.html"><%= name.capitalize %></a></li>
+        <% end %>
+      </ul>
 
-  <% if insert_toc %>
-    <div id="toc-links">
-      <%=
-        links = listings.map do |x|
-          %{<a href="##{x.anchor}">#{x.name}</a>}
-        end
-        links.unshift %{<a href="#toc:contents">Contents</a>}
-        links.join ' &middot; '
-      %>
-    </div>
-  <% end %>
+      <% if insert_toc %>
+        <%
+          links = listings.map do |x|
+            %{<a href="##{x.anchor}">#{x.name}</a>}
+          end
 
-    <div id="body"><%= content %></div>
+          unless links.empty?
+        %>
+        <h1>Menu navigation</h1>
+        <ul id="toc-links">
+          <%=
+            links.unshift %{<a href="#toc-contents">Contents</a>}
+            links.map {|x| "<li>#{x}</li>"}.join
+          %>
+        </ul>
+        <% end %>
 
-  <% if insert_toc %>
-    <hr style="display: none"/>
-    <div id="toc">
-      <h1 id="toc:contents">Contents</h1>
-      <%= toc %>
+        <div id="toc">
+          <h1 id="toc-contents">Contents</h1>
+          <%= toc %>
 
-      <% listings.each do |x| %>
-        <h1 id="<%= x.anchor %>"><%= x.name %></h1>
-        <ol>
-        <% x.nodes.map do |node| %>
-          <%= %{<li><a href="##{node.anchor}" id="#{node.tocAnchor}">#{node.title.to_html}</a></li>} %>
-        <% end %>
-        </ol>
+          <% listings.each do |x| %>
+            <h1 id="<%= x.anchor %>"><%= x.name %></h1>
+            <ol>
+            <% x.nodes.map do |node| %>
+              <%= %{<li><a href="##{node.anchor}" id="#{node.tocAnchor}">#{node.title.to_html}</a></li>} %>
+            <% end %>
+            </ol>
+          <% end %>
+        </div>
       <% end %>
     </div>
-  <% end %>
+
+    <div id="body">
+      <%= content %>
+      <br/>
+      <hr/>
+      This website is maintained by Suraj N. Kurapati (SNK at GNA dot ORG). This particular webpage was last updated on <%= Time.now %>.
+    </div>
   </body>
 </html>

data/doc/figures/figures.dia

@@ -97,7 +97,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="8.5,96.15"/>
+            <dia:point val="8.5,96.1425"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -142,7 +142,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="24.1527,96.15"/>
+            <dia:point val="24.1527,96.1425"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -193,15 +193,15 @@
     </dia:object>
     <dia:object type="Standard - Text" version="1" id="O3">
       <dia:attribute name="obj_pos">
-        <dia:point val="13,95"/>
+        <dia:point val="14,95"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="13,94.4325;20.0175,95.435"/>
+        <dia:rectangle val="14,94.4404;19.2671,95.4316"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
           <dia:attribute name="string">
-            <dia:string>#Vpi::advance_time(Y)#</dia:string>
+            <dia:string>#advance_time(Y)#</dia:string>
           </dia:attribute>
           <dia:attribute name="font">
             <dia:font family="monospace" style="0" name="Courier"/>
@@ -210,7 +210,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="13,95"/>
+            <dia:point val="14,95"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#ff0000"/>
@@ -271,7 +271,7 @@
         <dia:point val="6,94"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="6,93.4325;11.0948,94.435"/>
+        <dia:rectangle val="6,93.4575;10.8345,94.3975"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -304,7 +304,7 @@
         <dia:point val="13,99"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="13,98.45;19.3273,99.4"/>
+        <dia:rectangle val="13,98.4575;19.047,99.3975"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -337,7 +337,7 @@
         <dia:point val="22,94"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="22,93.45;27.0773,94.4"/>
+        <dia:rectangle val="22,93.4575;26.8345,94.3975"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -425,7 +425,7 @@
               <dia:real val="0.80000000000000004"/>
             </dia:attribute>
             <dia:attribute name="pos">
-              <dia:point val="20.5,80.15"/>
+              <dia:point val="20.5,80.1425"/>
             </dia:attribute>
             <dia:attribute name="color">
               <dia:color val="#000000"/>
@@ -470,7 +470,7 @@
               <dia:real val="0.80000000000000004"/>
             </dia:attribute>
             <dia:attribute name="pos">
-              <dia:point val="27.6375,80.15"/>
+              <dia:point val="27.6375,80.1425"/>
             </dia:attribute>
             <dia:attribute name="color">
               <dia:color val="#000000"/>
@@ -530,7 +530,7 @@
           <dia:point val="16,77"/>
         </dia:attribute>
         <dia:attribute name="obj_bb">
-          <dia:rectangle val="16,76.45;18.15,78.2"/>
+          <dia:rectangle val="16,76.5288;18.0025,78.3988"/>
         </dia:attribute>
         <dia:attribute name="text">
           <dia:composite type="text">
@@ -621,7 +621,7 @@
               <dia:real val="0.80000000000000004"/>
             </dia:attribute>
             <dia:attribute name="pos">
-              <dia:point val="30.5,72.1"/>
+              <dia:point val="30.5,72.0925"/>
             </dia:attribute>
             <dia:attribute name="color">
               <dia:color val="#000000"/>
@@ -638,7 +638,7 @@
         <dia:point val="25,69"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="25,68.45;30.4055,70.2"/>
+        <dia:rectangle val="25,68.5288;30.1197,70.3988"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -772,7 +772,7 @@
               <dia:real val="0.80000000000000004"/>
             </dia:attribute>
             <dia:attribute name="pos">
-              <dia:point val="17.5,72.15"/>
+              <dia:point val="17.5,72.1425"/>
             </dia:attribute>
             <dia:attribute name="color">
               <dia:color val="#000000"/>
@@ -788,7 +788,7 @@
           <dia:point val="12,69"/>
         </dia:attribute>
         <dia:attribute name="obj_bb">
-          <dia:rectangle val="12,68.45;17.2617,70.2"/>
+          <dia:rectangle val="12,68.5288;16.971,70.3988"/>
         </dia:attribute>
         <dia:attribute name="text">
           <dia:composite type="text">
@@ -901,7 +901,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="29.5,53.1"/>
+            <dia:point val="29.5,53.0925"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -946,7 +946,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="21.5,53.15"/>
+            <dia:point val="21.5,53.1425"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -1089,7 +1089,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="25.5,57.15"/>
+            <dia:point val="25.5,57.1425"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>