fixed issue2550730: FAQ has broken link to Zope book. Reported and fixed by John...

[roundup.git] / doc / FAQ.txt

diff --git a/doc/FAQ.txt b/doc/FAQ.txt
index dbdbeb5de4dcf3b411929317d1421175e9b1974e..8a8d9e2cc7cc8ad0cb3bcce820bd9abce01f7e38 100644 (file)
--- a/doc/FAQ.txt
+++ b/doc/FAQ.txt
@@ -2,8 +2,6 @@
 Roundup FAQ
 ===========
 
-:Version: $Revision: 1.23 $
-
 .. contents::
 
 
@@ -98,8 +96,18 @@ following should be useful as a starting template::
 How do I run Roundup through SSL (HTTPS)?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You should proxy through apache and use its SSL service. See the previous
-question on how to proxy through apache.
+The preferred way of using SSL is to proxy through apache and use its
+SSL service. See the previous question on how to proxy through apache.
+
+The standalone roundup-server now also has SSL support which is still
+considered experimental. For details refer to the documentation of
+roundup server, in particular to the generated configuration file
+generated with ::
+
+    roundup-server --save-config
+
+that describes the needed option in detail. With the standalone server
+now XMLRPC over SSL works, too.
 
 
 Roundup runs very slowly on my XP machine when accessed from the Internet
@@ -109,7 +117,7 @@ The issue is probably related to host name resolution for the client
 performing the request. You can turn off the resolution of the names
 when it's so slow like this. To do so, edit the module
 roundup/scripts/roundup_server.py around line 77 to add the following
-to the RoundupRequestHandler class:
+to the RoundupRequestHandler class::
 
      def address_string(self):
          return self.client_address[0]
@@ -126,7 +134,7 @@ This is based upon the template markup language in Zope called, oddly
 enough "Zope Page Templates". There's documentation in the Roundup
 customisation_ documentation. For more information have a look at:
 
-   http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/ 
+   http://docs.zope.org/zope2/zope2book/
 
 specifically chapter 10 "Using Zope Page Templates" and chapter 14 "Advanced
 Page Templates".
@@ -135,7 +143,8 @@ Page Templates".
 But I just want a select/option list for ....
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Really easy... edit ``html/issue.item``. For 'nosy', change line 53 from::
+Really easy... edit ``html/issue.item.html``. For ``nosy``, change the line
+(around line 69) from::
 
   <span tal:replace="structure context/nosy/field" />
 
@@ -143,11 +152,7 @@ to::
 
   <span tal:replace="structure context/nosy/menu" />
 
-For 'assigned to', change line 61 from::
-
-  <td tal:content="structure context/assignedto/field">assignedto menu</td>
-
-to::
+For ``assigned to``, this is already done around line 77::
 
   <td tal:content="structure context/assignedto/menu">assignedto menu</td>
 
@@ -158,7 +163,7 @@ Great! But now the select/option list is too big
 
 Thats a little harder (but only a little ;^)
 
-Again, edit ``html/issue.item``. For nosy, change line 53 from:
+Again, edit ``html/issue.item``. For nosy, change line (around line 69) from::
 
   <span tal:replace="structure context/nosy/field" />
 
@@ -185,6 +190,12 @@ I keep getting logged out
 Make sure that the ``tracker`` -> ``web`` setting in your tracker's
 config.ini is set to the URL of the tracker.
 
+I'm getting infinite redirects in the browser
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A wrong value for the ``tracker`` -> ``web`` setting may also result in
+infinite redirects, see http://issues.roundup-tracker.org/issue2537286
+
 
 How is sorting performed, and why does it seem to fail sometimes?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -204,10 +215,5 @@ Note that if an "order" property is defined on a Class that is used for
 sorting, all items of that Class *must* have a value against the "order"
 property, or sorting will result in random ordering.
 
------------------
-
-Back to `Table of Contents`_
-
-.. _`Table of Contents`: index.html
 .. _`customisation`: customizing.html