diff --git a/doc/FAQ.txt b/doc/FAQ.txt
index 253d60e2e7eead355aa3cd30a2f712a1130a0266..e0b442f692772f3d0e60648a3595411ecdaf4808 100644 (file)
--- a/doc/FAQ.txt
+++ b/doc/FAQ.txt
+===========
Roundup FAQ
+===========
- '$Date: 2002-02-14 08:50:14 $'
+:Version: $Revision: 1.11 $
- NOTE: This is just a grabbag, most of this should go into documentation.
+NOTE: This is just a grabbag, most of this should go into documentation.
-Changing HTML layout
+.. contents::
- Note changes to the files in html take place immediatly without
- restart, even when running roundup-server.
-
- Displaying whole messages not only the summary
-
- Modify instance/html/msg.index change::
-
- <td><display call="plain('summary')"></td>
-
- to::
-
- <td><pre><display call="plain('content')"></pre></td>
-
- displays the whole message not only the first line and 'pre'
- prevents the browser from reformatting.
-
- Getting the nosy list picker instead of textfield.
-
- In classic template there is plenty of space below the text field.
- So one could modify instance/html/issue.item to use it.
-
- At the file top set 'border=1' to see cell boundaries, then
- replace::
-
- <td class="form-text"><display call="field('nosy',size=20)"></td>
-
- by::
-
- <td rowspan=5 class="form-text"><display call="menu('nosy',height=10)"></td>
-
- and remove the last cell in the next four rows, either by deleting a cell
- or by reducing colspan.
-
- Want to see the issue id (the number) on the issue item display
-
- The number is really a central information and not an internal one.
-
- In file INSTANCE/html/issue.item displays the creator, so one could add
- the number to it.::
-
- <td class="form-text"><display call="reldate('creation', pretty=1)">
- (<display call="plain('creator')">)</td>
-
- to see::
-
- <td class="form-text"><display call="reldate('creation', pretty=1)">
- (issue<display call="plain('id')"> by <display call="plain('creator')">)</td>
Installation
+------------
- Living without a mailserver.
-
- Remove the nosy reactor, means delete the file 'INSTANCE/detectors/nosyreactor.py'.
-
- Rights issues (MISSING)
-
- Different jobs run under different users.
-
- * Standalone roundup-server is started by whome ?
+Living without a mailserver.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- * Running cgi under apache.
+Remove the nosy reactor, means delete the tracker file
+'detectors/nosyreactor.py'.
- * roundup-mailgw called via .forward from MTA, or running a cron job
- fetching via pop.
+Rights issues (MISSING)
+~~~~~~~~~~~~~~~~~~~~~~~
-Troubleshooting
+Different jobs run under different users.
- mailgw bouncing
+* Standalone roundup-server is started by whome ?
- messages are bouncing with the following error message.::
+* Running cgi under apache.
- Command died with status 1:
- "/usr/local/bin/python /usr/local/bin/roundup-mailgw /home/roundup".
- Command output: Traceback (most recent call last):
- File "/usr/local/bin/roundup-mailgw", line 178, in ? sys.exit(main(sys.argv))
- File "/usr/local/bin/roundup-mailgw", line 153, in main db =
- instance.open('admin') AttributeError: '_roundup_instance_1' module
- has no attribute 'open'
+* roundup-mailgw called via .forward from MTA, or running a cron job
+ fetching via pop.
-
- Happens when roundup-mailgw is called by a user that doesn't have
- read/execute permissions to the instance_home directory and sub
- directories.
- An easy way to test whether it's a permissions problem, or some other mail
- server configuration problem is to cat an email-formatted text file
- directly to the roundup-mailgw script as the roundup user.::
+-----------------
- cat issue.txt | /usr/local/bin/roundup-mailgw /home/roundup
+Back to `Table of Contents`_
- If that doesn't raise any errors, the problem is the permissions of the
- MTA.
+.. _`Table of Contents`: index.html