#!/usr/bin/env ruby #-- # =============================================================================== # Copyright (c) 2005, 2006 Christopher Kleckner # All rights reserved # # This file is part of the Rio library for ruby. # # Rio is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # Rio is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Rio; if not, write to the Free Software # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # =============================================================================== # # To create the documentation for Rio run the command # ruby build_doc.rb # from the distribution directory. #++ $:.unshift 'lib' require 'rio' module DFLT RDOC_DIR = rio('doc/rdoc') end puts "Rio interactive RDoc installer." rdoc_dir = rio(?-).print!("Where shall I build the rdoc documentation[#{DFLT::RDOC_DIR}]: ").chomp.gets.strip rdoc_dir = DFLT::RDOC_DIR if rdoc_dir.empty? rdoc_dir = rio(rdoc_dir) puts "Building the Rio RDoc documentation in '#{rdoc_dir}'" RDOC_OPTIONS = ['--line-numbers', '-m RIO::Doc::SYNOPSIS',"--op #{rdoc_dir}", "-T doc/generators/template/html/rio"] rdoc_files = [ rio('README'), rio('lib/rio.rb'), rio('lib/rio/')['kernel.rb','constructor.rb'], rio('lib/rio/doc')['*.rb'], rio('lib/rio/if').skipfiles('yaml.rb').files['*.rb'], ] cmd = sprintf("rdoc %s %s",RDOC_OPTIONS.join(' '),rdoc_files.join(' ')) rio(?-,cmd) > ?- docindex = (rdoc_dir/'index.html').abs.to_url msg = "Please point your browser at '#{docindex}'" lin = ">" + ">" * (msg.length+2) + ">" puts puts lin puts "> " + msg + " >" puts lin