Permalink
Browse files

2007-01-31 Laurent Sansonetti <lsansonetti@apple.com>

  * extconf.rb,
    bin/rdoc-osa,
    data/rubyosa/rdoc_html.rb,
    post-install.rb:
  - Better RDoc generation (removed the Files frame, references to the generated
    dummy Ruby file and source code, changed the default HTML title) ;
  - Make sure the rdoc-osa tool and the new template are properly installed in 
    the right locations by 'make install'.


git-svn-id: http://rubyosa.rubyforge.org/svn/trunk@155 0d7f026f-1217-0410-b43a-e108cceea134
  • Loading branch information...
lrz committed Jan 31, 2007
1 parent 2503b83 commit 9e654f3071bac15a786e2aa54ba33b6ca77cbf58
Showing with 764 additions and 4 deletions.
  1. +9 −0 ChangeLog
  2. +13 −4 bin/rdoc-osa
  3. +696 −0 data/rubyosa/rdoc_html.rb
  4. +7 −0 extconf.rb
  5. +39 −0 post-install.rb
View
@@ -1,5 +1,14 @@
2007-01-31 Laurent Sansonetti <lsansonetti@apple.com>
+ * extconf.rb,
+ bin/rdoc-osa,
+ data/rubyosa/rdoc_html.rb,
+ post-install.rb:
+ - Better RDoc generation (removed the Files frame, references to the generated
+ dummy Ruby file and source code, changed the default HTML title) ;
+ - Make sure the rdoc-osa tool and the new template are properly installed in
+ the right locations by 'make install'.
+
* src/rbosa.c:
Make sure we send events with the user-can-interact flag set on.
View
@@ -1,8 +1,8 @@
#!/usr/bin/env ruby
-# RDoc frontend for RubyOSA. Generate API referene documentation for the
+# RDoc frontend for RubyOSA. Generate API reference documentation for the
# given application, based on the descriptions in the sdef(5).
#
-# Copyright (c) 2006-2007, Apple Computer, Inc. All rights reserved.
+# Copyright (c) 2006-2007, Apple Inc. All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
@@ -12,7 +12,7 @@
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
-# 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of
+# 3. Neither the name of Apple Inc. ("Apple") nor the names of
# its contributors may be used to endorse or promote products derived
# from this software without specific prior written permission.
#
@@ -30,6 +30,7 @@
require 'rbosa'
require 'tmpdir'
+require 'rbconfig'
def usage
STDERR.puts <<-EOS
@@ -140,9 +141,17 @@ module OSA; end
module #{mod.name}; end
EOS
+rdoc_flags = ''
+template = File.join(Config.datadir('rubyosa'), 'rdoc_html.rb')
+if File.exists?(template)
+ rdoc_flags << " --template '#{template}' "
+end
+rdoc_flags << " --title '#{app.name} RubyOSA API' "
+rdoc_flags << ARGV[2..-1].join(' ')
+
path = unique_tmp_path(app.name, '.rb')
File.open(path, 'w') { |io| io.puts fake_ruby_src }
-line = "rdoc #{ARGV[2..-1].join(' ')} \"#{path}\""
+line = "rdoc #{rdoc_flags} \"#{path}\""
unless system(line)
STDERR.puts "Error when executing `#{line}' : #{$?}"
exit 1
Oops, something went wrong.

0 comments on commit 9e654f3

Please sign in to comment.