344731 - Update documentation minimum versions automatically

Status: RESOLVED FIXED

(Bugzilla :: Documentation, enhancement)

Description

[Colin Ogilvie [:cso]]

People occasioanlly (usually?) change minimum versions of various perl modules, but never update them in the documentation. 

Thanks to Bugzilla::Install::Requirements, the documentation can now generate the list automagically.

Comment 1

[Colin Ogilvie [:cso]]

Attachment: Patch v1

Comment 2

[Max Kanat-Alexander]

Comment on attachment 229299 [details] [diff] [review]
Patch v1

Yeah, looks right to me, although I know almost nothing about Docbook.

However, you did add the <?xml> thing at the top of Bugzilla-Guide.xml--is that really a part of this bug?

Comment 3

[Colin Ogilvie [:cso]]

(In reply to comment #2)
> However, you did add the <?xml> thing at the top of Bugzilla-Guide.xml--is that
> really a part of this bug?

Not especially, it doesn't hurt though.

Comment 4

[Colin Ogilvie [:cso]]

Note to self: havingp -> having in the comments.

Comment 5

[Frédéric Buclin]

Comment on attachment 229299 [details] [diff] [review]
Patch v1

>Index: makedocs.pl

>+open(ENTITIES, '>xml/bugzilla.ent') or die('Could not open xml/bugzilla.ent: ' . $!);

I prefer the 3-arguments notation: open(ENTITIES, '>', 'xml/bugzilla.ent')

Comment 6

[Colin Ogilvie [:cso]]

(In reply to comment #5)
> >+open(ENTITIES, '>xml/bugzilla.ent') or die('Could not open xml/bugzilla.ent: ' . $!);
> 
> I prefer the 3-arguments notation: open(ENTITIES, '>', 'xml/bugzilla.ent')

The codebase is already incosnsitent on this already - although there are more with the 3 argument way.

Checking in docs/makedocs.pl;
/cvsroot/mozilla/webtools/bugzilla/docs/makedocs.pl,v  <--  makedocs.pl
new revision: 1.11; previous revision: 1.10
done
Checking in docs/xml/Bugzilla-Guide.xml;
/cvsroot/mozilla/webtools/bugzilla/docs/xml/Bugzilla-Guide.xml,v  <--  Bugzilla-Guide.xml
new revision: 1.67; previous revision: 1.66
done