erbtex 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6aa6baa55cd84b872ced3ccdd4a2935e5805ae29
-  data.tar.gz: d5c069096815028c9eb786d1cd3920ad5fbe6116
+  metadata.gz: ba2d024e5db40939058098d4ee6cc9c3efa58c19
+  data.tar.gz: da8fc247a17a3e51ae2e8fa75a2f75eded1ace51
 SHA512:
-  metadata.gz: eab55ecc60a34f11a6bdcd93d70ae8daf6a1c75443534e1913a7ac7495f45a80bed2291dacc8f4129ceef40349c9c7b6291f35d33ed9c8dd77d6ef942f81ca00
-  data.tar.gz: 65c04c3b86a0a694e2e064716844908271b7ad569a0a067d4bfc9c853da367d1d81a20edc58ee273b7ee0fd438eec5563401c8288c249df244074a646edc1311
+  metadata.gz: 2bd38f093f3703bf0c1c55b3a649044d776aa68b7ef6243ebcea344e4eaa4cdab0b2b872ac62bf94f910028c92019ede620467084d54c43fedfe43d824c45c7f
+  data.tar.gz: e44d3414536cb37057be45e48d28f7c7a599f8732ed8a5ee1db803e5e7e35ae08805b1b6f73e675c650edc5d2c962b485826e163111aed8d774dc695f27da4c7

data/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_BIN: .bundle/bin

data/.gitignore

@@ -4,6 +4,9 @@
 *.out
 *.pdf
 *.gem
+*.synctex.gz
 etc
 auto
-/.bundle/config
+/.bundle/bin
+*.fdb_latexmk
+*.fls

data/Gemfile.lock

@@ -1,25 +1,61 @@
 PATH
   remote: .
   specs:
-    erbtex (0.2.0)
+    erbtex (0.3.0)
       erubis
 
 GEM
   remote: https://rubygems.org/
   specs:
-    byebug (3.1.2)
+    byebug (3.5.1)
       columnize (~> 0.8)
       debugger-linecache (~> 1.2)
-    columnize (0.8.9)
+      slop (~> 3.6)
+    coderay (1.1.2)
+    columnize (0.9.0)
     debugger-linecache (1.2.0)
+    diff-lcs (1.2.5)
     erubis (2.7.0)
+    method_source (0.9.0)
+    minitest (5.5.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    pry-byebug (3.0.1)
+      byebug (~> 3.4)
+      pry (~> 0.10)
+    pry-doc (0.11.1)
+      pry (~> 0.9)
+      yard (~> 0.9)
     rake (10.3.2)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.1)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    slop (3.6.0)
+    yard (0.9.12)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   bundler
-  byebug
   erbtex!
+  minitest
+  pry
+  pry-byebug
+  pry-doc
   rake
+  rspec
+
+BUNDLED WITH
+   1.16.0

data/README.org

@@ -0,0 +1,137 @@
+* ErbTeX: Ruby pre-processing for TeX and LaTeX Documents
+
+** Description
+
+~erbtex~ is a ruby gem that provides a command line program that pre-processes
+TeX and LaTeX source files with ruby's erubis and then passes the resulting file
+along to a real TeX program.
+
+** Installation
+
+Install ~erbtex~ with:
+
+#+BEGIN_SRC sh
+  gem install erbtex
+#+END_SRC
+
+** Usage
+
+After the gem is installed, ~erbtex~ is placed in your PATH. ~erbtex~ recognizes
+only one command-line option, --invoke=<tex_program>, which specifies what TeX
+variant will process the TeX file after erubis has pre-proceesed the input file.
+By default, ~erubis~ uses ~pdflatex~ if no --invoke option is given.
+
+~Erbtex~ will then read the input file and execute any ruby code between the
+special delimiters `{:` and `:}` instead of the erubis default of `<% %>`. The
+brace-colon form of delimiters is less disruptive of syntax highlighting than
+the default delimiters, which get confused with TeX and LaTeX comments. Any text
+not between the delimiters is passed through untouched to the TeX program.
+
+If the opening delimiter has an ~=~ appended to it, the delimited ruby
+expression is converted into a string (with ruby's ~.to_s~ method) and inserted
+in-place into the TeX manuscript at that point. For example, the text ~{:=
+"Hello, world".reverse :}~ places the string ~'dlrow ,olleH'~ at that point in
+the TeX file.
+
+Without the `=` the ruby code is simply executed. You can use these, for
+example, to ~require~ ruby libraries or to embed loops into the file.
+
+Loops started in one ruby fragment can be continued or terminated in a later
+fragment, and variables defined in one fragment in one fragment are visible in
+later fragments according to Ruby's usual scoping rules. The result is that you
+can use the ruby programming language to greatly increase the computational
+capabilities of a normal TeX or LaTeX.
+
+The resulting output is then processed as a normal TeX file.
+
+** Example
+
+For example, the following LaTeX file will produce a table of square
+roots when run through erbtex.  It uses a ruby iterator to supply the
+rows of the table, a feat that would tedious at best with bare TeX or
+LaTeX.
+
+#+BEGIN_SRC latex
+  \documentclass{article}
+  \usepackage[mathbf]{euler}
+  \usepackage{longtable}
+
+  \begin{document}
+      \begin{longtable}[c]{r|r}
+  \hline\hline
+  \multicolumn{1}{c|}{\mathversion{bold}$x$}&
+  \multicolumn{1}{c}{\mathversion{bold}\rule{0pt}{12pt}$\sqrt{x}$}\\
+  \hline\hline
+  \endhead
+  \hline\hline
+  \endfoot
+  % The following line starts a ruby enumerator loop but does not
+  % produce any output, since the delimiters are {: :}.
+  {: 0.upto(100).each do |x| :}
+  % But the following two lines produce output since the opening delimiter is
+  % '{:='. Both call the sprintf method in ruby via the percent operator, and the
+  % second line calls ruby's Math module to compute the square root. Notice that
+  % the '%' inside the delimiters does not have the effect of commenting out
+  % the following text. It is interpreted as a ruby '%' operator.
+
+    {:= "\\mathversion{bold}$%0.4f$" % x :}&
+    {:= "$%0.8f$" % Math.sqrt(x) :}\\
+  {: end :}
+  \end{longtable}
+  \end{document}
+#+END_SRC
+
+With the above in file `roots.tex`, running `$ erbtex roots.tex` at the command
+line will generate a `PDF` file with a nicely typeset table of square roots.
+
+As a by-product, the pre-processed file ~roots.etx~ is left in the same
+directory, so you can see what the effect of the erbtex fragments were. This is
+often very handy when you are trying to debug the document; otherwise, feel free
+to delete it. Here, for example is a portion of the `roots.etx` file generated
+by the foregoing:
+
+#+BEGIN_SRC latex
+    \begin{document}
+      \begin{longtable}[c]{r|r}
+      \hline\hline
+      \multicolumn{1}{c|}{\mathversion{bold}$x$}&
+      \multicolumn{1}{c}{\mathversion{bold}\rule{0pt}{12pt}$\sqrt{x}$}\\
+      \hline\hline
+      \endhead
+      \hline\hline
+      \endfoot
+      \mathversion{bold}$0.0000$&
+      $0.00000000$\\
+      \mathversion{bold}$1.0000$&
+      $1.00000000$\\
+      \mathversion{bold}$2.0000$&
+      $1.41421356$\\
+      \mathversion{bold}$3.0000$&
+      $1.73205081$\\
+      \mathversion{bold}$4.0000$&
+      $2.00000000$\\
+      \mathversion{bold}$5.0000$&
+      $2.23606798$\\
+      \mathversion{bold}$6.0000$&
+      $2.44948974$\\
+      \mathversion{bold}$7.0000$&
+      $2.64575131$\\
+      \mathversion{bold}$8.0000$&
+      $2.82842712$\\
+      \mathversion{bold}$9.0000$&
+      $3.00000000$\\
+      \mathversion{bold}$10.0000$&
+      $3.16227766$\\
+      \mathversion{bold}$11.0000$&
+      $3.31662479$\\
+      \mathversion{bold}$12.0000$&
+      $3.46410162$\\
+      \mathversion{bold}$13.0000$&
+      $3.60555128$\\
+      \mathversion{bold}$14.0000$&
+      #+END_SRC
+
+And many more lines like it.
+
+The examples directory installed with the erbtex gem has a few more
+examples.

data/Rakefile

@@ -1,15 +1,12 @@
-require 'rake/testtask'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rdoc/task'
 
-require 'bundler'
-Bundler::GemHelper.install_tasks
-
-task :default => :test
-desc "Run all the unit tests"
-task :test do
-  Dir.foreach('test') do |t|
-    next if t == 'test_helper.rb'
-    next if t =~ /^\.\.?/
-    cmd = "ruby -I 'test' -C 'test' #{t}"
-    system cmd
-  end
+RDoc::Task.new do |rdoc|
+  rdoc.main = 'README.rdoc'
+  rdoc.rdoc_files.include('README.rdoc', 'lib')
 end
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/erbtex

@@ -1,49 +1,8 @@
 #! /usr/bin/env ruby
 
-verbose = true
-
-# This adds our lib subdirectory to the ruby load path
-$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
-
-# This adds our RUBYLIB env to ruby load path
-if ENV['RUBYLIB']
-  STDERR.puts "ENV['RUBYLIB']:" if verbose
-  ENV['RUBYLIB'].split(':').each do |p|
-    $LOAD_PATH.unshift p
-    STDERR.puts "\t#{p}" if verbose
-  end
-else
-  STDERR.puts "ENV['RUBYLIB'] is EMPTY" if verbose
-end
-
 require 'erbtex'
 
-progname = File.basename($0)
-commandline = progname
-ARGV.each do |a|
-  if a =~ /\s/
-    a = "'" + a + "'"
-  end
-  commandline += " #{a}"
+module ErbTeX
+  cl = CommandLine.new(ARGV)
+  exit ErbTeX.run(cl).exitstatus
 end
-
-if verbose
-  STDERR.puts "Program name: #{progname}"
-  STDERR.puts "Command line: #{commandline}"
-  STDERR.puts "Ruby Load path:"
-  $:.each do |p|
-    STDERR.puts "\t#{p}"
-  end
-  STDERR.puts 'ARGV:'
-  ARGV.each do |a|
-    STDERR.puts "\t#{a}"
-  end
-  STDERR.puts 'PATH:'
-  ENV['PATH'].split(':').each do |p|
-    STDERR.puts "\t#{p}"
-  end
-  STDERR.puts "Executable: "
-  STDERR.puts ErbTeX.find_executable($0)
-end
-
-ErbTeX.run(commandline)

data/erbtex.gemspec

@@ -7,8 +7,8 @@ Gem::Specification.new do |gem|
   gem.version = ErbTeX::VERSION
   gem.platform = Gem::Platform::RUBY
   gem.date = %q{2012-05-13}
-  gem.homepage = ""
-  gem.authors = ["Daniel E. Doherty"]
+  gem.homepage = ''
+  gem.authors = ['Daniel E. Doherty']
   gem.email = %q{ded-erbtex@ddoherty.net}
   gem.summary = %q{Preprocesses TeX and LaTeX files with erubis for ruby.}
   gem.description = %q{Create a local link called pdflatex to erbtex and it will
@@ -17,13 +17,17 @@ Gem::Specification.new do |gem|
                      automated TeX and LaTeX documents.}
 
   gem.files         = `git ls-files`.split("\n")
-  gem.files.delete_if {|f| f =~ /(log|etc|aux|etx|pdf|gem)$/}
+  gem.files.delete_if { |f| f =~ /\.(log|etc|aux|etx|pdf|gem|tmp)$/ }
   gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  gem.require_paths = ["lib"]
+  gem.require_paths = ['lib']
 
-  gem.add_dependency "erubis"
+  gem.add_dependency 'erubis'
   gem.add_development_dependency 'rake'
-  gem.add_development_dependency "bundler"
-  gem.add_development_dependency "byebug"
+  gem.add_development_dependency 'bundler'
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'minitest'
+  gem.add_development_dependency 'pry'
+  gem.add_development_dependency 'pry-doc'
+  gem.add_development_dependency 'pry-byebug'
 end

data/examples/TrigTable.tex

@@ -10,9 +10,9 @@
 \usepackage{fancyhdr}
 \pagestyle{fancy}
 \renewcommand{\headrulewidth}{0pt}
-\rhead{\large\mathversion{bold}$\firstmark$}
-\rfoot{\large\mathversion{bold}$\botmark$}
-\lhead{}
+\setlength{\headheight}{14.0pt}
+\lhead{\large\mathversion{bold}$\firstmark$}
+\rhead{\large\mathversion{bold}$\botmark$}
 
 \begin{document}
 

data/examples/TrigTable2.tex

@@ -9,10 +9,10 @@
 %% flipping pages.
 \usepackage{fancyhdr}
 \pagestyle{fancy}
+\setlength{\headheight}{14.0pt}
 \renewcommand{\headrulewidth}{0pt}
-\rhead{\large\mathversion{bold}\firstmark}
-\rfoot{\large\mathversion{bold}\botmark}
-\lhead{}
+\lhead{\large\mathversion{bold}\firstmark}
+\rhead{\large\mathversion{bold}\botmark}
 
 \begin{document}
 
@@ -30,6 +30,8 @@
     end
 :}
 
+\def\tstrut{\rule[-1pt]{0pt}{11pt}}
+
 %% Set up the longtable environment by specifying the header for
 %% each page and the footer.
 \begin{longtable}[c]{c|llllll}
@@ -63,7 +65,7 @@
 
 %% Treat the first line of the table, for an x value of 0 specially
 %% by giving exact answers in symbolic form.
-{:= "\\multicolumn{1}{c|}{{\\mathversion{bold}\\mark{%s}$0$}}" % d0.to_tex :}&
+{:= "\\multicolumn{1}{c|}{\\tstrut{\\mathversion{bold}\\mark{%s}$0$}}" % d0.to_tex :}&
 {:= "\\multicolumn{1}{c}{{$0$}}" :}&
 {:= "\\multicolumn{1}{c}{{$1$}}" :}&
 {:= "\\multicolumn{1}{c}{{$0$}}" :}&
@@ -84,7 +86,7 @@
 {:
 ## Here is where each line of the main body of the table is set.
 ## We use the digs function defined above to make sure that every
-## column as the same number of significant digits for the functions
+## column has the same number of significant digits for the functions
 ## that tend toward infinity.
 ##
 ## NB: I could write this comment as a LaTeX comment outside a code
@@ -94,7 +96,7 @@
 ## around 2MB.
 -:}
 \mark{{:= x.to_tex :}}
-{:= "\\mathversion{bold}#{x.to_tex}" :}&
+\tstrut{:= "\\mathversion{bold}#{x.to_tex}" :}&
 {:= "$%0.8f$" % x.sin :}&
 {:= "$%0.8f$" % x.cos :}&
 {:= "$%0.*f$" % [ digs(tanx), tanx ] :}&
@@ -127,3 +129,5 @@
 %% End the table and document---this version comes to 649 pages!
 \end{longtable}
 \end{document}
+
+% Take /that/ Charles Babbage!

data/lib/erbtex/command_line.rb

@@ -4,136 +4,106 @@ module ErbTeX
   class NoInputFile < StandardError; end
 
   class CommandLine
-    attr_reader :command_line, :marked_command_line, :input_file
-    attr_reader :progname, :input_path, :output_dir, :run_dir
-
-    def initialize(command_line)
-      @command_line = command_line
-      @input_file = @marked_command_line = nil
-      @run_dir = Dir.pwd
-      find_output_dir
-      find_progname
-      find_input_file
-      find_input_path
-      mark_command_line
-    end
+    attr_reader :erbtex_name, :tex_program, :tex_options
+    attr_reader :tex_commands, :input_file
 
-    def find_progname
-      @progname = @command_line.split(' ')[0]
-    end
+    def initialize(argv)
+      # Note: argv will be the command line arguments after processing by the
+      # shell, so if we see things such as '&', '~', '\' in the args, these were
+      # quoted by the user on the command-line and need no special treatment
+      # here. For example, '~/junk' on the commandline will show up here as
+      # '/home/ded/junk'. If we see '~/junk', that means the user has quoted the
+      # ~ on the command line with something like '\~junk', so we should assume
+      # that the user wants to keep it that way. Likewise, an arg with spaces in
+      # it will have been quoted by the user to be seen as a single argument.
+      # When we output these for use by the shell in the system command, we
+      # should apply shellquote to everything so that the receiving shell sees
+      # the args in the same way.
 
-    def find_output_dir
-      args = @command_line.split(' ')
-      # There is an -output-comment option, so -output-d is the shortest
-      # unambiguous way to write the -output-directory option.  It can use
-      # one or two dashes at the beginning, and the argument can be
-      # seaparated from it with an '=' or white space.
-      have_out_dir = false
-      out_dir = nil
-      args.each do |a|
-        if have_out_dir
-          # Found -output-directory on last pass without an equals sign
-          out_dir = a
-        end
-        if a =~ /^--?output-d(irectory)?=(\S+)/
-          out_dir = $2
-        elsif a =~ /^--?output-d(irectory)?$/
-          # Next arg is the out_dir
-          have_out_dir = true
-        end
-      end
-      if out_dir.nil?
-        if File.writable?(Dir.pwd)
-          @output_dir = Dir.pwd
-        else
-          @output_dir = File.expand_path(ENV['TEXMFOUTPUT'])
-        end
-      else
-        @output_dir = File.expand_path(out_dir)
+      @erbtex_name = File.basename($0)
+
+      # Find the tex_commands
+      @tex_commands = []
+      if argv.any? { |a| a =~ /\A\\/ }
+        # All args after first starting with '\' should be interpreted as TeX
+        # commands, even if they don't start with '\'
+        @tex_commands = argv.drop_while { |a| a !~ /\A\\/ }
+        first_tex_command_k = argv.size - @tex_commands.size
+        argv = argv[0..first_tex_command_k - 1]
       end
-    end
 
-    def find_input_file
-      # Remove the initial command from the command line
-      cmd = @command_line.split(/\s+/)[1..-1].join(' ')
-      cmd = cmd.gsub(/\s+--?[-a-zA-Z]+(=\S+)?/, ' ')
-      infile_re = %r{(\\input\s+)?(([-.~_/A-Za-z0-9]+)(\.[a-z]+)?)\s*$}
-      if cmd =~ infile_re
-        @input_file = "#{$2}"
-        if @input_file =~ /\.tex(\.erb)?$/
-          @input_file = @input_file
-        else
-          @input_file += ".tex"
-        end
-      elsif cmd =~ %r{(\\input\s+)?(["'])((?:\\?.)*?)\2} #"
-        # The re above captures single- or double-quoted strings with
-        # the insides in $3
-        @input_file = "#{$3}"
-        if @input_file !~ /\.tex$/
-          @input_file += ".tex#{$1}"
-        end
-      else
-        @input_file = nil
+      # Look for our --invoke=tex_command option
+      @tex_program = 'pdflatex'
+      if argv.any? { |a| a =~ /\A--invoke=(\w+)/ }
+        @tex_program = $1
+        argv.reject! { |a| a =~ /\A--invoke=(\w+)/ }
       end
-    end
 
-    def find_input_path
-      # If input_file is absolute, don't look further
-      if @input_file =~ /^\//
-        @input_path = @input_file
-      elsif @input_file.nil?
-        @input_path = nil
-      else
-        # The following cribbed from kpathsea.rb
-        @progname.untaint
-        @input_file.untaint
-        kpsewhich = "kpsewhich -progname=\"#{@progname}\" -format=\"tex\" \"#{@input_file}\""
-        lines = ""
-        IO.popen(kpsewhich) do |io|
-          lines = io.readlines
-        end
-        if $? == 0
-          @input_path = lines[0].chomp.untaint
-        else
-          raise NoInputFile, "Can't find #{@input_file} in TeX search path; try kpsewhich -format=tex #{@input_file}."
-        end
+      # The last argument, assuming it does not start with a '-' or '&', is
+      # assumed to be the name of the input_file.
+      if !argv.empty? && argv[-1] !~ /\A[-&]/
+        @input_file = CommandLine.expand_input_file(argv.pop)
       end
+
+      # What remains in argv should be the tex program's '-options', which
+      # should be passed through untouched. So, can form the full command line
+      # for tex_processing
+      @tex_options = argv.dup
     end
 
-    def new_command_line(new_progname, new_infile)
-      ncl = @marked_command_line.sub('^p^', new_progname)
-      # Quote the new_infile in case it has spaces
-      if new_infile
-        ncl = ncl.sub('^f^', "'#{new_infile}'")
-      end
-      ncl
+    def tex_command(tex_file = input_file)
+      "#{tex_program} " \
+      "#{tex_options.shelljoin} " \
+      "#{tex_commands.shelljoin} " \
+      "#{tex_file}"
+        .strip.squeeze(' ')
     end
 
-    def mark_command_line
-      # Replace input file with '^f^'
-      infile_re = %r{(\\input\s+)?(([-.~_/A-Za-z0-9]+)(\.[a-z]+)?)\s*$}
-      quoted_infile_re = %r{(\\input\s+)?(["'])((?:\\?.)*?)\2} #"
-      if @input_file.nil?
-        @marked_command_line = @command_line
-      elsif @command_line =~ infile_re
-        @marked_command_line = @command_line.sub(infile_re, "#{$1}^f^")
-      elsif @command_line =~ quoted_infile_re
-        @marked_command_line = @command_line.sub(quoted_infile_re, "#{$1}^f^")
+    # Return the name of the input file based on the name given in the command
+    # line. Try to find the right extension for the input file if none is given.
+    def self.expand_input_file(input_file)
+      full_ext = input_file[/\A(.*)(\.[\w.]+)\z/, 2]
+      if full_ext.nil? || full_ext.empty?
+        if File.exist?("#{input_file}.tex.erb")
+          "#{input_file}.tex.erb"
+        elsif File.exist?("#{input_file}.tex")
+          "#{input_file}.tex"
+        elsif File.exist?("#{input_file}.erb")
+          "#{input_file}.erb"
+        else
+          input_file
+        end
       else
-        @marked_command_line = @command_line
+        input_file
       end
-      # Replace progname with '^p^'
-      @marked_command_line = @marked_command_line.lstrip
-      @marked_command_line = @marked_command_line.sub(/\S+/, '^p^')
     end
   end
 end
 
 # NOTES:
-
 # The following text is from the Web2C documentation at
 # http://tug.org/texinfohtml/web2c.html#Output-file-location
 #
+# 4.1 TeX invocation
+#
+#   TeX, Metafont, and MetaPost process the command line (described here)
+#   and determine their memory dump (fmt) file in the same way (*note Memory
+#   dumps::).  Synopses:
+#
+#   tex [OPTION]... [TEXNAME[.tex]] [TEX-COMMANDS]
+#   tex [OPTION]... \FIRST-LINE
+#   tex [OPTION]... &FMT ARGS
+#
+#   TeX searches the usual places for the main input file TEXNAME (*note
+#   (kpathsea)Supported file formats::), extending TEXNAME with '.tex' if
+#   necessary.  To see all the relevant paths, set the environment variable
+#   'KPATHSEA_DEBUG' to '-1' before running the program.
+#
+#   After TEXNAME is read, TeX processes any remaining TEX-COMMANDS on
+#   the command line as regular TeX input.  Also, if the first non-option
+#   argument begins with a TeX escape character (usually '\'), TeX processes
+#   all non-option command-line arguments as a line of regular TeX input.
+
 # 3.4 Output file location
 #
 # All the programs generally follow the usual convention for output