Item1050: improving the doc for how to set up / understand extensions…

… repositories

git-svn-id: http://svn.foswiki.org/branches/Release01x00@3381 0b4bb1d4-4e5a-0410-9cc4-b2b747904278

core/lib/Foswiki.spec

@@ -1278,28 +1278,27 @@ $Foswiki::cfg{PluginsOrder} = 'TWikiCompatibilityPlugin,SpreadSheetPlugin';
 # **STRING 80 EXPERT**
 # <b>Extensions Repositories Search List</b><br />
 # Foswiki extension repositories are just Foswiki webs that are organised in the
-# same way as the Plugins web on Foswiki.org. The 'Find more extensions' link
+# same way as the Extensions web on Foswiki.org. The 'Find more extensions' link
 # above searches these repositories for installable extensions. To set up an
 # extensions repository:
 # <ol>
 # <li>Create a Foswiki web to contain the repository</li>
 # <li>Copy the <tt>FastReport</tt> page from <a href="http://foswiki.org/Extensions/FastReport?raw=on">Foswiki:Extensions.FastReport</a> to your new web</li>
 # <li> Set the <tt>WEBFORMS</tt> variable in WebPreferences to <tt>PackageForm</tt></li>
 # </ol>
-# The page for each extension must have the Foswiki form <tt>PackageForm</tt>,
+# The page for each extension must have the <tt>PackageForm</tt> (copy from Foswiki.org),
 # and should have the packaged extension attached as a <tt>zip</tt> and/or
 # <tt>tgz</tt> file.
 # <p />
-# This setting is a semicolon-separated list of repository specifications, each in the format: <i>name=(listurl,puburl)</i>.
-# For Extensions with the same name in both repositories, the one in the last repository will be chosen, so foswiki should be last for maximum compatibility.
+# The search list is a semicolon-separated list of repository specifications, each in the format: <i>name=(listurl,puburl)</i>
 # where:
 # <ul>
 # <li><em>name</em> is the symbolic name of the repository e.g. Foswiki.org</li>
 # <li><em>listurl</em> is the root of a view URL</li>
 # <li><em>puburl</em> is the root of a download URL</li>
 # </ul>
 # For example,<code>
-# twiki.org=(http://twiki.org/cgi-bin/view/Plugins/,http://twiki.org/p/pub/Plugins/);
-# foswiki.org=(http://foswiki.org/Extensions/,http://foswiki.org/pub/Extensions/);</code><p />
+# twiki.org=(http://twiki.org/cgi-bin/view/Plugins/,http://twiki.org/p/pub/Plugins/);foswiki.org=(http://foswiki.org/Extensions/,http://foswiki.org/pub/Extensions/);</code><p />
+# For Extensions with the same name in more than one repository, the <strong>last</strong> matching repository in the list will be chosen, so Foswiki.org should always be last in the list for maximum compatibility.
 $Foswiki::cfg{ExtensionsRepositories} = 'Foswiki.org=(http://foswiki.org/Extensions/,http://foswiki.org/pub/Extensions/)';
 1;