[DRE-commits] r5355 - in trunk/gemwatch: . views

[Antonio Terceiro]

Author: terceiro-guest
Date: 2010-05-16 17:36:32 +0000 (Sun, 16 May 2010)
New Revision: 5355

Modified:
   trunk/gemwatch/README.rst
   trunk/gemwatch/views/layout.haml
Log:
update README; add meta information to the layout



Modified: trunk/gemwatch/README.rst
===================================================================
--- trunk/gemwatch/README.rst	2010-05-16 17:09:54 UTC (rev 5354)
+++ trunk/gemwatch/README.rst	2010-05-16 17:36:32 UTC (rev 5355)
@@ -4,9 +4,22 @@
 Introduction
 ------------
 
-This application was designed to help Debian developers in tracking Ruby
-software released only as rubygems.
+gemwatch was designed to help Debian developers in tracking Ruby software
+released only as rubygems, and to convert them into a format that is (more)
+suitable for packaging according to the needs of Debian developers.
 
+Please see the following pages for more information, specially about why this
+is needed:
+
+* http://pkg-ruby-extras.alioth.debian.org/rubygems.html
+* http://pkg-ruby-extras.alioth.debian.org/upstream-devs.html
+
+There is a lot of Ruby developers that only release software as gems on
+http://rubygems.org/. gemwatch is an application to circumvent this practice:
+it provides Debian developers with a tool to follow the releases done in
+rubygems.org, and automatically converts ``.gem`` packages into ``.tar.gz``
+ones as expected for proper packaging work.
+
 Usage in Debian watch files
 ---------------------------
 
@@ -25,8 +38,8 @@
   mkdir mygem-0.1.0
   cd mygem-0.1.0
   wget ...../mygem-0.1.0.gem
-  tar xf mygem-0.1.0.gem
-  tar xzf data.tar.gz
+  tar xfm mygem-0.1.0.gem
+  tar xzfm data.tar.gz
   xcat metadata.gz > metadata.yml
   rm -f mygem-0.1.0.gem data.tar.gz metadata.gz
   cd ..
@@ -46,10 +59,17 @@
 ** ``http://mysite.com/cgi-bin/gemwatch``, where ``gemwatch`` is a symlink to gemwatch's ``cgi`` script
 ** ``http://mysite.com/gemwatch`` is a symlink (or an alias) to gemwatch's ``public`` directory.
 
+Deploying to alioth
+-------------------
+
+To deploy gemwatch to alioth, it is sufficient to run ``rake alioth`` under
+gemwatch root directory (the one containing the Rakefile).
+
 License
 -------
 
-Copyright © 2010, Antonio Terceiro <terceiro at softwarelivre.org>
+Copyright © 2010, Antonio Terceiro <terceiro at softwarelivre.org> and the Debian
+pkg-ruby-extras team <http://pkg-ruby-extras.alioth.debian.org/>.
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as published by

Modified: trunk/gemwatch/views/layout.haml
===================================================================
--- trunk/gemwatch/views/layout.haml	2010-05-16 17:09:54 UTC (rev 5354)
+++ trunk/gemwatch/views/layout.haml	2010-05-16 17:36:32 UTC (rev 5355)
@@ -16,9 +16,17 @@
         %a{ :href => app_url('/') } Gemwatch
         &mdash; a
         %a{ :href => "http://rubygems.org/"} rubygems.org
-        watching service
+        watching service.
+        %a{:href => 'http://svn.debian.org/viewsvn/pkg-ruby-extras/trunk/gemwatch/README.rst'} (README)
       %div
         Copyright &copy; 2010 - the
         %a{:href => "http://www.debian.org/"} Debian
-        %a{:href => "http://pkg-ruby-extras.alioth.debian.org/"} pkg-ruby-extras team
+        %a{:href => "http://pkg-ruby-extras.alioth.debian.org/"} pkg-ruby-extras team.
+      %div
+        gemwatch is free software, released under the
+        %a{:href => 'http://www.gnu.org/licenses/agpl.html'} GNU Affero General Public License.
+      %div
+        Source code is available from the
+        %a{:href => 'http://svn.debian.org/viewsvn/pkg-ruby-extras/trunk/gemwatch/'} subversion repository
+        (even though we like git more).