Bug#184406: marked as done (RFP: rtfm -- Request Tracker FAQ Manager)
Your message dated Mon, 10 Nov 2003 18:03:49 -0500
with message-id <E1AJL4X-0006G4email@example.com>
and subject line Bug#184406: fixed in rtfm 2.0.1-1
has caused the attached Bug report to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Debian bug tracking system administrator
(administrator, Debian Bugs database)
Received: (at submit) by bugs.debian.org; 12 Mar 2003 02:58:52 +0000
>From firstname.lastname@example.org Tue Mar 11 20:58:52 2003
Received: from (retina.ranzco.edu) [220.127.116.11]
by master.debian.org with smtp (Exim 3.12 1 (Debian))
id 18swSB-0005Pd-00; Tue, 11 Mar 2003 20:58:51 -0600
Received: (qmail 12442 invoked from network); 12 Mar 2003 02:58:49 -0000
Received: from unknown (HELO aos.net.au) (10.2.32.212)
by 18.104.22.168 with SMTP; 12 Mar 2003 02:58:49 -0000
Date: Wed, 12 Mar 2003 14:02:15 +1100
From: Sam Johnston <email@example.com>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.2; en-US; rv:1.2.1) Gecko/20021130
X-Accept-Language: en-us, en
Subject: RFP: rtfm -- Request Tracker FAQ Manager
Content-Type: text/plain; charset=us-ascii; format=flowed
X-Spam-Status: No, hits=-1.5 required=4.0
Version: N/Ap reported 2003-03-12
RTFM (The RT FAQ Manager) is a tool for maintaining an organizational
knowledgebase. Out of the box, it integrates with RT3 (Also available from
0) Download from
1) Install RT 3.0.x [or 2.1.8x for the moment ]
2) Once RT 3.0 appears to be happily installed, cd into the directory you
unpacked RTFM into.
3) Edit RTFM's Makefile to point to your RT 3 instance
4) make sure that mysql or pgsql's commandline tool is in your path
5) Type "make install"
6) stop and start your web server
Staff users should be now have a new "RTFM" menu item RT's top level menu.
As an administrator, you should go create some "Classes" of articles in
Classes are equivalent to RT's queues. Unlike RTFM 1.0, RTFM 2.0 doesn't
single "body" section for each article. Everything is a custom field (except
for name, summary and some other basic metadata). So, you need to go create
some custom fields. You've got five choices. "SelectSingle" and
"SelectMultiple" let you pick one or many choices from a list respectively.
"FreeformSingle" and "FreeformMultiple" let you hand-enter one or many
text. "TextSingle" is what you want for the "Body" of articles. Once you've
created your custom fields, go into your classes and click on "Custom
and add the Custom Fields you want to each class.
Grant some ACLs to your users and start creating articles.
Of course, RTFM integrates with RT. You can extract the body of a
an article. Within RT, you should now see an "Extract to article" button in
the upper right hand corner of RT's UI when working with tickets. When you
click that button, RTFM will ask you which Class to create your new
Once you click on a class name, the Ticket's transactions will be displayed,
along with a set of select boxes. For each transaction, you can pick which
TextSingle that transaction should be extracted to. From there on in,
regular article creation. And the integration doesn't stop there! When
replying to or commenting on tickets, there's a new UI widget that lets you
search for and include RTFM articles in your reply. (They're editable, of
Development of RTFM 2.0 has been sponsored by RIPE NCC and DynDNS.org
You probably want to discuss rtfm on firstname.lastname@example.org at this point.
(Send mail to email@example.com to subscribe)
Best Practical Solutions, LLC
-- http://www.bestpractical.com/rt -- Trouble Ticketing. Free.
Received: (at 184406-close) by bugs.debian.org; 10 Nov 2003 23:08:28 +0000
>From firstname.lastname@example.org Mon Nov 10 17:08:23 2003
Received: from auric.debian.org [22.214.171.124]
by master.debian.org with esmtp (Exim 3.35 1 (Debian))
id 1AJL8v-0001er-00; Mon, 10 Nov 2003 17:08:21 -0600
Received: from dsilvers by auric.debian.org with local (Exim 3.35 1 (Debian))
id 1AJL4X-0006G4-00; Mon, 10 Nov 2003 18:03:49 -0500
From: Sam Johnston <email@example.com>
X-Katie: lisa $Revision: 1.25 $
Subject: Bug#184406: fixed in rtfm 2.0.1-1
Sender: Daniel Silverstone <firstname.lastname@example.org>
Date: Mon, 10 Nov 2003 18:03:49 -0500
We believe that the bug you reported is fixed in the latest version of
rtfm, which is due to be installed in the Debian FTP archive:
A summary of the changes between this version and the previous one is
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to email@example.com,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
Sam Johnston <firstname.lastname@example.org> (supplier of updated rtfm package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing email@example.com)
-----BEGIN PGP SIGNED MESSAGE-----
Date: Fri, 7 Nov 2003 10:02:23 +1100
Architecture: source all
Maintainer: Sam Johnston <firstname.lastname@example.org>
Changed-By: Sam Johnston <email@example.com>
rtfm - RT FAQ Manager
rtfm (2.0.1-1) unstable; urgency=low
* Initial Release. Closes: #184406.
e8fe32136f53a6001e4212884f8244ee 547 misc optional rtfm_2.0.1-1.dsc
955a5f0f240252b8c97deb8074445fa3 80905 misc optional rtfm_2.0.1.orig.tar.gz
15c953760dc9681533a8296a529c4759 3668 misc optional rtfm_2.0.1-1.diff.gz
281f1bf2b12f29eb6f5d86f03e815bbb 69224 misc optional rtfm_2.0.1-1_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)
-----END PGP SIGNATURE-----