<html>
<!-- ***** BEGIN LICENSE BLOCK *****
   - Version: MPL 1.1/GPL 2.0/LGPL 2.1
   -
   - The contents of this file are subject to the Mozilla Public License Version
   - 1.1 (the "License"); you may not use this file except in compliance with
   - the License. You may obtain a copy of the License at
   - http://www.mozilla.org/MPL/
   -
   - Software distributed under the License is distributed on an "AS IS" basis,
   - WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
   - for the specific language governing rights and limitations under the
   - License.
   -
   - The Original Code is the Update Notifier.
   -
   - The Initial Developer of the Original Code is
   - Netscape Communications Corporation.
   - Portions created by the Initial Developer are Copyright (C) 2002
   - the Initial Developer. All Rights Reserved.
   -
   - Contributor(s):
   -   Samir Gehani <sgehani@netscape.com> (Original Author)
   -
   - Alternatively, the contents of this file may be used under the terms of
   - either the GNU General Public License Version 2 or later (the "GPL"), or
   - the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
   - in which case the provisions of the GPL or the LGPL are applicable instead
   - of those above. If you wish to allow use of your version of this file only
   - under the terms of either the GPL or the LGPL, and not to allow others to
   - use your version of this file under the terms of the MPL, indicate your
   - decision by deleting the provisions above and replace them with the notice
   - and other provisions required by the LGPL or the GPL. If you do not delete
   - the provisions above, a recipient may use your version of this file under
   - the terms of any one of the MPL, the GPL or the LGPL.
   -
   - ***** END LICENSE BLOCK ***** -->

<body>
<span class="LXRSHORTDESC">
<h1>
Update Notifications
</h1>
</span>

<span class="LXRLONGDESC">
<h2>
The updates.rdf datasource
</h2>
The updates.rdf datasource is an RDF file containing information about the latest updates available for the client.  It can be stored remotely.  
</span>

<h3>
The updates.rdf preference
</h3>
The updates.rdf datasource is stored in a localized pref in communicator-region's region.properties file.  The datasource pref is <code>update_notifications.provider.0.datasource</code>.  See the update notifications specification at: <a href="http://www.mozilla.org/xpapps/updates/spec.html">http://www.mozilla.org/xpapps/updates/spec.html</a>.

<h3>
The updates.rdf format
</h3>
This RDF file stores the product name, the latest version available, the regsitry name (as registered in the mozilla version registry), and the URL to take users to if a new update has been detected and users wish to get it. The update notification module looks for this information rooted at the <code>urn:updates:latest</code> node.<p>

An example of the updates.rdf file follows:
<xmp>
<?xml version="1.0"?>
<RDF:RDF xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:NC="http://home.netscape.com/NC-rdf#">

  <RDF:Description about="urn:updates:latest">
    <NC:registryName>Browser</NC:registryName>
    <NC:version>1.0.0.0</NC:version>
    <NC:URL>http://home.netscape.com/computing/download/index.html</NC:URL>
    <NC:productName>Mozilla</NC:productName>
  </RDF:Description>

</RDF:RDF>
</xmp>

<hr>
Contact: <a href="mailto:sgehani@netscape.com">sgehani@netscape.com</a>
</body>
</html>