Bug 380375: The local XML file './data/bugzilla-update.xml' cannot be created if…

docs/xml/administration.xml

@@ -1850,9 +1850,12 @@ Support: ENTRY, DEFAULT/MANDATORY, CANEDIT
         <literal>upgrade_notification</literal> parameter, see
         <xref linkend="parameters"/>. Administrators will see these
         notifications when they access the <filename>index.cgi</filename>
-        page, i.e. generally when logging in. Bugzilla will check once a
-        week for new releases, unless the parameter is set to
-        <quote>disabled</quote>.
+        page, i.e. generally when logging in. Bugzilla will check once per
+        day for new releases, unless the parameter is set to
+        <quote>disabled</quote>. If you are behind a proxy, you may have to set
+        the <literal>proxy_url</literal> parameter accordingly. If the proxy
+        requires authentication, use the
+        <literal>http://user:pass@proxy_url/</literal> syntax.
       </para>
     </section>
 

template/en/default/admin/params/core.html.tmpl

@@ -92,7 +92,8 @@
   proxy_url => "$terms.Bugzilla may have to access the web to get notifications about new " _
                "releases, see the <tt>upgrade_notification</tt> parameter. In case you are " _
                "behind a proxy, it may be necessary to enter its URL if the web server " _
-               "group cannot access the HTTP_PROXY environment variable.",
+               "group cannot access the HTTP_PROXY environment variable. If you have to " _
+               "authenticate, use the <code>http://user:pass@proxy_url/</code> syntax.",
 
   upgrade_notification => "<p>$terms.Bugzilla can inform you when a new release is available. " _
                           "The notification will appear on the $terms.Bugzilla homepage, " _

template/en/default/index.html.tmpl

@@ -80,7 +80,9 @@ function addSidebar() {
       <a href="editparams.cgi?section=core#upgrade_notification">notify you about new releases</a>.</p>
     [% ELSIF release.error == "cannot_download" %]
       <p>The local XML file '[% release.xml_file FILTER html %]' cannot be created.
-      Please make sure the web server can write in this directory.</p>
+      Please make sure the web server can write in this directory and that you can access
+      the web. If you are behind a proxy, set the
+      <a href="editparams.cgi?section=core#proxy_url">proxy_url</a> parameter correctly.</p>
     [% ELSIF release.error == "no_update" %]
       <p>The local XML file '[% release.xml_file FILTER html %]' cannot be updated.
       Please make sure the web server can edit this file.</p>