[DRE-commits] [rake] 08/11: build RDocs and install as separate package rake-doc

[Caitlin Matos]

This is an automated email from the git hooks/post-receive script.

cm-guest pushed a commit to branch master
in repository rake.

commit 5e87e2f0eeea30631b53afce293c17f7e6f8ea16
Author: Caitlin Matos <caitlin.matos at zoho.com>
Date:   Wed Aug 27 20:15:27 2014 -0400

    build RDocs and install as separate package rake-doc
    
    - new binary package rake-doc
    - build all RDoc documentation
    - register documentation with doc-base
    - remove embedded jquery, link to system jquery (requires bdep libjs-jquery)
    
    Git-Dch: Full
    Closes: #755845
---
 debian/control           | 20 ++++++++++++++++++++
 debian/rake-doc.doc-base |  8 ++++++++
 debian/rake-doc.docs     |  1 +
 debian/rake-doc.links    |  1 +
 debian/rake.docs         |  1 -
 debian/rules             | 13 +++++++++++++
 6 files changed, 43 insertions(+), 1 deletion(-)

diff --git a/debian/control b/debian/control
index e2640af..a31abf6 100644
--- a/debian/control
+++ b/debian/control
@@ -37,3 +37,23 @@ Description: ruby make-like utility
      projects as a single file. Projects that depend upon
      rake do not require that rake be installed on target
      systems.
+
+Package: rake-doc
+Architecture: all
+Section: doc
+Depends: ${misc:Depends}, libjs-jquery
+Description: ruby make-like utility (documentation)
+ Rake is a simple ruby build program with capabilities similar to make.
+ .
+ Rake has the following features:
+   * Rakefiles (rakes version of Makefiles) are completely defined in
+     standard Ruby syntax. No XML files to edit. No quirky Makefile
+     syntax to worry about (is that a tab or a space?)
+   * Users can specify tasks with prerequisites.
+   * Rake supports rule patterns to sythesize implicit tasks.
+   * Rake is lightweight. It can be distributed with other
+     projects as a single file. Projects that depend upon
+     rake do not require that rake be installed on target
+     systems.
+ .
+ This package includes the RDoc-generated documentation for Rake.
diff --git a/debian/rake-doc.doc-base b/debian/rake-doc.doc-base
new file mode 100644
index 0000000..a084dbf
--- /dev/null
+++ b/debian/rake-doc.doc-base
@@ -0,0 +1,8 @@
+Document: rake
+Title: Documentation for Rake, a Make-like build utility for Ruby 
+Author: Jim Weirich
+Section: Programming/Ruby
+
+Format: HTML
+Index: /usr/share/doc/rake-doc/html/index.html
+Files: /usr/share/doc/rake-doc/html/*.html
diff --git a/debian/rake-doc.docs b/debian/rake-doc.docs
new file mode 100644
index 0000000..1936cc1
--- /dev/null
+++ b/debian/rake-doc.docs
@@ -0,0 +1 @@
+html
diff --git a/debian/rake-doc.links b/debian/rake-doc.links
new file mode 100644
index 0000000..55dbcfa
--- /dev/null
+++ b/debian/rake-doc.links
@@ -0,0 +1 @@
+usr/share/javascript/jquery/jquery.js usr/share/doc/rake-doc/html/js/jquery.js
diff --git a/debian/rake.docs b/debian/rake.docs
index 49d9590..e475c53 100644
--- a/debian/rake.docs
+++ b/debian/rake.docs
@@ -1,2 +1 @@
 README.rdoc
-TODO
diff --git a/debian/rules b/debian/rules
index eb9d444..6ef2385 100755
--- a/debian/rules
+++ b/debian/rules
@@ -3,7 +3,20 @@
 %:
 	dh $@ --buildsystem=ruby --with ruby
 
+override_dh_auto_build:
+	dh_auto_build
+	rdoc \
+	    --op html \
+	    --main README.rdoc \
+	    --title=Rake \
+	    README.rdoc History.rdoc CONTRIBUTING.rdoc \
+	    doc/ lib/
+
+override_dh_installchangelogs:
+	dh_installchangelogs History.rdoc
+
 override_dh_clean:
+	$(RM) -r html
 	$(RM) test/data/dryrun/temp_main
 	$(RM) test/data/dryrun/temp_two
 	$(RM) -r test/data/file_creation_task/build/

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-ruby-extras/rake.git