97496 - (bz-2.16-relnotes) 2.16 Release Notes Bug

Status: RESOLVED FIXED

(Bugzilla :: Bugzilla-General, defect, P1)

Description

[Matthew Tuck [:CodeMachine]]

2.16 Release Notes.

Please enter only changes from the 2.14 release notes in docs/rel_notes.txt.

I expect all significant fixes, problems and outstanding problems to be
documented in the release notes.

Comment 1

[Jacob Steenhagen]

Bug 97721 is kinda important (had to up the min. version for perl)

Comment 2

[Bradley Baetz (:bbaetz)]

someone should diff checksetup.pl. I know we require TT (2.06), and Text::Wrap,
too, at least

Also, if you have v1.0.1 of Chart::Base, we don't detect the version correctly,
and claim taht its not installed (and theres aperl warning, too). zach says that
this isn't our bug; its a bug in that version of Chart::Base. It shoiuld be
documented in the relnotes.

Comment 3

[Matthew Tuck [:CodeMachine]]

Need to document general procedure for customising templates and basic pointers
to TT language.

Do we need to document procedures for making the web server look for index.cgi
when the root is specified?

Comment 4

[Matthew Tuck [:CodeMachine]]

Release note bug #96101 if we don't fix it.

Comment 5

[Matthew Tuck [:CodeMachine]]

Document use of processmail rescanall in particular in relation to bug #104589,
bug #106377.

Comment 6

[Matthew Tuck [:CodeMachine]]

I have just checked in an update, which is mostly structural rather than high in
new content.  Given the nature of documentation, I will check in release notes
without review and save the review until just before release.

Comment 7

[Tobias Burnus]

The current version of docs/rel_notes (1.6 2002/02/17 04:25:51
matty%chariot.net.au) contains in "Outstanding Issues"/Email notification a
pointer to bug 50159 which has the status "FIXED". I suggest to link to bug
37765 instead/additionally.

Comment 8

[Dave Miller [:justdave]]

bug 120537 introduces a change to the .htaccess file for the data/webdot
directory.  Since checksetup.pl won't overwrite an existing .htaccess file,
you'll have to delete your existing data/webdot/.htaccess file (or move it out
of the way) and let checksetup.pl generate a new one for you.

Comment 9

[Bradley Baetz (:bbaetz)]

the buglist and show_bug templatisation breaks mozbot, and probably any other
code which tries to parse results.

There is a patch on bug 115642 to use xml/rdf output for this.

Comment 10

[David D. Kilzer (ddk)]

Bug 135666 fixed Windows NT recognition in enter_bug.cgi.

Bug 92763 added Windows XP support and recognition in
enter_bug.cgi.  Instructions on how to add Windows XP to a
current installation should be noted in the release notes.
(Basically, you modify localconfig to add "Windows XP" to the
@opsys variable, then rerun ./checksetup.pl.)

Comment 11

[GavinS]

There is talk in bug#103778 about recommending the Template Toolkit XS Stash to
be enabled by default -- is this still the case? 

And if so, I'm guessing that should be in the release notes somewhere...

Comment 12

[Bradley Baetz (:bbaetz)]

Its on by default in TT versions which we support, and we'll probably end up
reuriing 2.07 once that is released.

Comment 13

[Bradley Baetz (:bbaetz)]

We need to document the fact that the TT XS module _should_ be enabled for
speed, but that its buggy on perl 5.005_02 at least. I think _03 worked, though.

There was discussion on having the next bz version require perl 5.6. If we do
decide that, we should relnote it, but regardless, the minimum supported version
should be 5.005_03, because thats all the majority of developers can test on.

Comment 14

[Matthew Tuck [:CodeMachine]]

Release notes updated with all the above, although in a few places ??? still
appears until I can seek out the appropriate information.

Comment 15

[Kevin Brannen]

In the Installation section (3.2.15), it says:
=====
   Assuming your web server runs as user "apache", and Bugzilla is
   installed in "/usr/local/bugzilla", here's one way to run
   checksetup.pl as the web server user. As root, for the second run of
   checksetup.pl, do this:

bash# chown -R apache:apache /usr/local/bugzilla
bash# su - apache
bash# cd /usr/local/bugzilla
bash# ./checksetup.pl
=====

However, this doesn't work for me.  After a few minutes I found that my "apache"
user had "/bin/false" as the login shell (as a security feature), so the "su -
apache" failed and it went downhill from there.  The fix was very simple, just
change the login shell to bash, do the commands, then change the login shell
back.  This seems to be the default for RedHat, so I expect it to bite others
too.  I feel this needs to be mentioned in the docs near these commands.

Comment 16

[Dave Miller [:justdave]]

That's not part of the release notes... that's in the main documentation.  Can
you file a bug for that in the Documentation component under Bugzilla?  Thanks.

Comment 17

[Kevin Brannen]

Doh!  Sorry, missed that "Release" part.  See bug #143116.

Comment 18

[Andreas Franke (gone)]

"There is a known bug that causes you to not get bugmail with certain email
settings. The patch in bug 146261 may fix this."

Comment 19

[Matthew Tuck [:CodeMachine]]

Need to document the movement of the HTML template parameters over to HTML
templates.

Comment 20

[Gervase Markham [:gerv]]

OK, we just bounced off zarro boogs. Who's writing the release notes? :-)

Gerv

Comment 21

[Gervase Markham [:gerv]]

OK, I just checked the release notes against the comments in this bug. They seem
to incorporate all the issues. (I don't think the text-based release notes are
scaling well, but that's Another Bug.) 

Unless MattyT or anyone else wants to leap in to plug gaping holes, I say we
ship this sucker. Dave, if you agree, close this bug and let's go :-)

Gerv

Comment 22

[Dave Miller [:justdave]]

I don't see any gaping holes off-hand.  It looks like Matty has it pretty
up-to-date already.  Resolving.