Introduction

In an effort to keep our grimoires as up to date as possible, we have setup a system of software update announcements utilizing Sourceforge and Freshmeat. This document outlines the details and procedures.

Overview

We have setup an account on both Sourceforge and Freshmeat and subscribed to them all projects that are both available on that service and are in our grimoires. Many of the spells in our grimoires are not represented on either of the services and require special attention. The notifications that are sent from Sourceforge and Freshmeat are sent to the SM-Spell-Submit e-mail list for all who are subscribed there to see and act upon. This helps facilitate quicker updates to our spells when the software developers update their software.

What can you as a Grimoire Guru do to help? If you have taken on a section to maintain, you will also need to maintain the subscriptions to Sourceforge and Freshmeat. If you are a General Guru, you can help maintain the subscriptions on Sourceforge and Freshmeat and/or maintain spells by subscribing to and monitoring the SM-Spell-Submit e-mail list.

The process of maintaining a subscription is as follows: Search Sourceforge for the project as we have it listed in our grimoires. If it is found there, add it the monitor list. If not, proceed to the next step. Search Freshmeat for the project as we have it listed in our grimoires. If it is found there, subscribe to product announcements. If not, proceed to the next step. Check the project's or author's home page and see if there is an announce mail list (or something similar) provided there. If not, the project needs to be manually watched.

Usually (but not always), if there is an announce list on the project's home site, they have a Sourceforge and/or a Freshmeat listing as well, and if there are no listings on Sourceforge and Freshmeat, there are none on the project's home site either.

Details

Section Guru

Subscribe to the SM-Spell-Submit e-mail list (you may choose to use your section e-mail address). For each unique $SOURCE in each spell in the section you maintain, check Sourceforge for a project listing. If one exists, subscribe to it in the following manner:

• Login to Sourceforge using the pre-defined Source Mage user name and password:

• Click on the "Login via SSL" link

• Fill in the "Login Name:" and "Password:" fields (you may obtain that information from any of the team leaders)

• Please, do NOT check the "Remember Me" check box (you may check or uncheck the "Stay in SSL mode after login" box at your discretion)

• Click on the "Login with SSL" button

• On the project's Summary page, and for each package we have in our grimoires, click on the icon of the envelope ().

• You should get a red confirmation message that reads: "Package is now being monitored"

If there is no listing on Sourceforge, then check Freshmeat for a project listing (for each unique $SOURCE in each spell in the section you maintain). If one exists, subscribe to it in the following manner:

• Login to Freshmeat using the pre-defined Source Mage user name and password:

• On the right-hand side of the home page is a login area, or there is a login link at the top of most (or all) of the pages.

• Fill in the "Username:" and "Password:" fields (you may obtain that information from any of the team leaders)

• Please, do NOT check the "Remember Me" check box.

• Click on the "Login" button.

• Click on the "Subscribe to new releases" link toward the bottom of the project page.

• Put a check into each branch to subscribe to and click on the "update dependencies" button.

If there is no listing on Freshmeat, then check the project's home site, based on the $WEB_SITE variable, for an announce mail list or similar (also, for each unique $SOURCE in each spell in the section you maintain). If one exists, subscribe to it in the manner they describe, using the e-mail address of sm-spell-submit AT lists DOT ibiblio DOT org.

General Guru

Unmaintained Sections

Subscribe to the SM-Spell-Submit e-mail list. Go through each of the spells in an unmaintained section as described above to get that section in the update notification loop.

New Spells

Subscribe to the SM-Spell-Submit e-mail list. When adding a new spell, follow the above directions for a Section Guru, so that the new package will be monitored from the start.

Spell Maintenance

Subscribe to the SM-Spell-Submit e-mail list. When an announcement comes through the e-mail list of an updated software package, check to see if the section is actively maintianed.

• If the section is NOT actively maintained, update the spell in the appropriate grimorie(s) normally.

• If the section IS actively maintained, you have three options:

• Contact the section maintainer asking that person if they mind if you update the spell.

• File a bug in Bugzilla with a patch attached for the section maintainer to apply (and optionally [since they should receive a copy of the bug] notifying the maintainer).

• Ignore the announcement and fix one of the existing bugs in Bugzilla instead.

A new Web page based on listing.html will be created (at some point in the future) to help maintain and monitor this information.