Bug 546786 - missing docs and perl-Text-Quoted, perl-Text-WikiFormat deps
Summary: missing docs and perl-Text-Quoted, perl-Text-WikiFormat deps
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: rt3
Version: rawhide
Hardware: All
OS: Linux
low
medium
Target Milestone: ---
Assignee: Ralf Corsepius
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
: 496970 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-12-11 23:00 UTC by Dale Bewley
Modified: 2010-01-02 03:27 UTC (History)
4 users (show)

Fixed In Version: 3.8.2-13.fc11
Clone Of:
Environment:
Last Closed: 2010-01-02 03:27:51 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

Description Dale Bewley 2009-12-11 23:00:21 UTC
Description of problem:
rt3-3.8.6-1.fc13.src.rpm is missing docs such as UPGRADING.mysql which is required reading for some users who have been upgrading through many releases of Fedora and RT.

Also missing are deps for:
* perl-Text-Quoted: no obvious problem except nasty log messages
* perl-Text-WikiFormat: required for wiki type custom fields

Version-Release number of selected component (if applicable):
3.8.6-1.fc13

How reproducible:


Steps to Reproduce:
0. Begin with machine recently upgraded from F9 and RT 3.6.x to F11.
1. install fc13 rpm from rawhide
2. mock rebuild -r fedora-11-x86_64
3. install on f11 machine
4. upgrade database
  rt-setup-database --dba root --prompt-for-dba-password \
   --datadir /etc/rt3/upgrade ---action upgrade
5. Create wikitext area custom field

Actual results:

1. Httpd fails to restart with this error:

[Wed Dec 09 04:29:54 2009] [error] RT since version 3.8 has new schema for MySQL versions after 4.1.0\nFollow instructions in the UPGRADING.mysql file. at /usr/sbin/webmux.pl line 116, <DATA> line 276.\nCompilation failed in require at (eval 2) line 1, <DATA> line 276.\n
[Wed Dec 09 04:29:54 2009] [error] Can't load Perl file: /usr/sbin/webmux.pl for server foo.bar:0, exiting...

RT 3.8.2 did not enforce this migration, but 3.8.6 obviously does. UPGRADING.mysql explains how to proceed, but is missing from the RPM.

2. Errors produced in /var/log/messages due to missing perl-Text-Quoted

RT: Text::Quoted failed: Can't locate Text/Quoted.pm in @INC (@INC contains: /usr/local/lib/rt3/lib /usr/local/lib/rt3/plugins/RT-Extension-ExtractCustomFieldValues/lib /usr/lib/perl5/vendor_perl/5.10.0 /usr/local/lib64/perl5/site_perl/5.10.0/x86_64-linux-thread-multi /usr/local/lib/perl5/site_perl/5.10.0 /usr/lib64/perl5/vendor_perl/5.10.0/x86_64-linux-thread-multi /usr/lib/perl5/vendor_perl /usr/lib64/perl5/5.10.0/x86_64-linux-thread-multi /usr/lib/perl5/5.10.0 /usr/lib/perl5/site_perl . /etc/httpd) at /usr/share/rt3/html/Ticket/Elements/ShowTransactionAttachments line 209.#012#012Stack:#012 [/usr/share/rt3/html/Ticket/Elements/ShowTransactionAttachments:209]#012 [/usr/share/rt3/html/Ticket/Elements/ShowTransaction:73]#012 [/usr/share/rt3/html/Ticket/Elements/ShowHistory:114]#012 [/usr/share/rt3/html/Ticket/Display.html:71]#012 [/usr/lib/perl5/vendor_perl/5.10.0/RT/Interface/Web.pm:320]#012 [/usr/lib/perl5/vendor_perl/5.10.0/RT/Interface/Web.pm:224]#012 [/usr/share/rt3/html/autohandler:53] (/usr/share/rt3/html/Ticket/Elements/ShowTransactionAttachments:210)

3. Errors produced due to missing perl-Text-WikiFormat

Expected results:

Full documentation in RPM, and no errors.

Additional info:
Above is for an F11 machine, but to illustrate that's not relevant:

[dlbewley@x183 ~]$ mock -r fedora-rawhide-x86_64 rt3-3.8.6-1.fc13.src.rpm 

[dlbewley@x183 ~]$ rpm -qp --requires /var/lib/mock/fedora-rawhide-x86_64/result/rt3-3.8.6-1.fc13.noarch.rpm |grep Text
perl(GD::Text)  
perl(HTML::FormatText)  
perl(Pod::PlainText)  
perl(Text::ParseWords)  
perl(Text::Template)  
perl(Text::Wrapper)  


Here is a spec patch to resolve above:

[dlbewley@x183 SPECS]$ diff -u rt3-3.8.6.spec rt3.spec
--- rt3-3.8.6.spec	2009-12-04 07:04:25.000000000 -0800
+++ rt3.spec	2009-12-11 14:58:46.000000000 -0800
@@ -178,6 +178,8 @@
 Requires: perl(Tree::Simple)
 Requires: perl(URI::URL)
 Requires: perl(XML::RSS)
+Requires: perl(Text::Quoted)
+Requires: perl(Text::WikiFormat)
 
 # rpm fails to add these:
 Provides: perl(RT::Shredder::Exceptions)
@@ -386,7 +388,8 @@
 
 %files
 %defattr(-,root,root,-)
-%doc COPYING README UPGRADING README.fedora
+%doc COPYING README README.fedora README.Oracle UPGRADING UPGRADING.mysql
+%doc docs
 %{_bindir}/*
 %{_sbindir}/*
 %exclude %{_sbindir}/rt-mailgate
@@ -431,6 +434,10 @@
 %{RT3_LIBDIR}/RT/Test*
 
 %changelog
+* Fri Dec 11 2009 Dale Bewley <dale> - 3.8.6-ucd.1
+- Include all docs found in tgz
+- Require perl-Text-Quoted, perl-Text-WikiFormat
+
 * Fri Dec 04 2009 Ralf Corsépius <corsepiu> - 3.8.6-1
 - Upstream update.
 - Remove rt-3.8.4-Makefile.diff, rt-3.8.4-test-dependencies.diff,

Comment 1 Ralf Corsepius 2009-12-14 06:49:50 UTC
Thanks for the report.

I am going to upgrade F13 to rt-3.8.7, and add UPGRADE.mysql and add R: perl(Text::Quoted), R: perl(Text::WikiFormat) for the F11, F12, F13 packages.
However, I am not going to add README.Oracle, because I consider Oracle to be unsupported/unsupportable (non-free closed source) in Fedora.

(changes, packages etc. should be available once Fedora's infrastructure will be up again.)

Comment 2 Ralf Corsepius 2009-12-14 08:11:14 UTC
*** Bug 496970 has been marked as a duplicate of this bug. ***

Comment 3 Dale Bewley 2009-12-14 18:14:40 UTC
I won't argue on the Oracle doc. You have a good point.

I think the guidelines are trying to say to exclude irrelevant
documentation, but the sentence has a bug in it
http://fedoraproject.org/wiki/Packaging/Guidelines#Documentation

There are several other RT architecture documents in the docs folder
of the tgz, however. I believe these could be very useful for some
users.

My inclination is to include too many docs, rather than too few.

rt3-3.8.7/COPYING
rt3-3.8.7/README
rt3-3.8.7/README.Oracle
rt3-3.8.7/README.fedora
rt3-3.8.7/UPGRADING
rt3-3.8.7/UPGRADING.mysql
rt3-3.8.7/docs/README.docs
rt3-3.8.7/docs/Security
rt3-3.8.7/docs/creating_external_custom_fields.pod
rt3-3.8.7/docs/design_docs/3.3-schema-redesign.txt
rt3-3.8.7/docs/design_docs/CARS
rt3-3.8.7/docs/design_docs/TransactionTypes.txt
rt3-3.8.7/docs/design_docs/acls
rt3-3.8.7/docs/design_docs/approval_notices
rt3-3.8.7/docs/design_docs/approval_template
rt3-3.8.7/docs/design_docs/cf_search
rt3-3.8.7/docs/design_docs/cli_spec
rt3-3.8.7/docs/design_docs/cvs_integration
rt3-3.8.7/docs/design_docs/delegation
rt3-3.8.7/docs/design_docs/evil_plans
rt3-3.8.7/docs/design_docs/gnupg_details_on_output_formats
rt3-3.8.7/docs/design_docs/groups_notes
rt3-3.8.7/docs/design_docs/link-definitions.txt
rt3-3.8.7/docs/design_docs/realflow.txt
rt3-3.8.7/docs/design_docs/recursive_group_membership_algorithm
rt3-3.8.7/docs/design_docs/rql_parser_machine.graphviz
rt3-3.8.7/docs/design_docs/rt-mvc
rt3-3.8.7/docs/design_docs/ruleset-workflow.txt
rt3-3.8.7/docs/design_docs/string-extraction-guide.txt
rt3-3.8.7/docs/design_docs/subscription-definitions.txt
rt3-3.8.7/docs/design_docs/ticket_templates
rt3-3.8.7/docs/design_docs/users
rt3-3.8.7/docs/extending_clickable_links.pod
rt3-3.8.7/docs/gnupg_integration.pod
rt3-3.8.7/docs/porting.windows
rt3-3.8.7/docs/queue_subject_tag.pod
rt3-3.8.7/docs/rt3-schema-relationships.dot
rt3-3.8.7/docs/templates.pod
rt3-3.8.7/docs/using_forms_widgets.pod

Comment 4 Fedora Update System 2009-12-15 04:09:31 UTC
rt3-3.8.2-13.fc11 has been submitted as an update for Fedora 11.
http://admin.fedoraproject.org/updates/rt3-3.8.2-13.fc11

Comment 5 Fedora Update System 2009-12-16 01:15:41 UTC
rt3-3.8.2-13.fc11 has been pushed to the Fedora 11 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update rt3'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/F11/FEDORA-2009-13204

Comment 6 Fedora Update System 2010-01-02 03:27:45 UTC
rt3-3.8.2-13.fc11 has been pushed to the Fedora 11 stable repository.  If problems still persist, please make note of it in this bug report.


Note You need to log in before you can comment on or make changes to this bug.