30 lines
685 B
Ruby
30 lines
685 B
Ruby
|
# frozen_string_literal: true
|
||
|
|
|
||
|
|
require "rake"
|
||
|
|
|
||
|
|
begin
|
||
|
|
require "yard"
|
||
|
|
require "yard/rake/yardoc_task"
|
||
|
|
|
||
|
|
namespace :doc do
|
||
|
|
desc "Generate Yardoc documentation"
|
||
|
|
YARD::Rake::YardocTask.new do |yardoc|
|
||
|
|
yardoc.name = "yard"
|
||
|
|
yardoc.options = ["--verbose", "--markup", "markdown"]
|
||
|
|
yardoc.files = FileList[
|
||
|
|
"lib/**/*.rb", "ext/**/*.c",
|
||
|
|
"README.md", "CHANGELOG.md", "LICENSE.txt"
|
||
|
|
].exclude(/idna/)
|
||
|
|
end
|
||
|
|
end
|
||
|
|
|
||
|
|
task "clobber" => ["doc:clobber_yard"]
|
||
|
|
|
||
|
|
desc "Alias to doc:yard"
|
||
|
|
task "doc" => "doc:yard"
|
||
|
|
rescue LoadError
|
||
|
|
# If yard isn't available, it's not the end of the world
|
||
|
|
desc "Alias to doc:rdoc"
|
||
|
|
task "doc" => "doc:rdoc"
|
||
|
|
end
|