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,
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.)
*** Bug 496970 has been marked as a duplicate of this bug. ***
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
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
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
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.