How to Contribute Changes
to the PHP Driver
grantc@php.net
© Copyright Ingres Corporation 2008
Abstract
The first steps for those wanting to help any open
source project can be quite difficult. From reporting
bugs, submitting fixes or new functionality, this
presentation outlines the requirements for someone
looking to provide assistance with the Ingres PECL
extension.
© Copyright Ingres Corporation 2008
Facets of a project
Answering questions
Bug reporting/fixing
Documentation
Implementing features
Writing tests
© Copyright Ingres Corporation 2008
Answering Questions
comp.databases.ingres
– http://www.rationalcommerce.com/community.htm
Ingres Community Forums
– http://community.ingres.com/forums/viewforum.php?f=5
PECL-DEV
– http://pecl.php.net/support.php
© Copyright Ingres Corporation 2008
Bug Reporting
Identifying Problems
Report the bug
– http://pecl.php.net/bugs/report.php?package=ingres
Provide as much information as possible
– A short script that reproduces the problem.
– Ingres INI configuration settings
– A stack dump – if possible
© Copyright Ingres Corporation 2008
Documentation
Docs maintained via CVS
– cvs.php.net/phpdoc
DocBook format
– XSLTs used to generate HTML, PDF, CHM,...
Working on the documentation
– http://doc.php.net/php/dochowto/index.php
Ingres docs under
– en/reference/ingres-ii
© Copyright Ingres Corporation 2008
Documentation – Viewing Changes
make html
– Completely regenerates all PHP documentation
• Even for a small change
– As used by http://php.net/manual/en
Phd
– http://doc.php.net/wiki/phd
– Work in progress
– Does not re-generate all the documentation
© Copyright Ingres Corporation 2008
Implementing Changes
Driver code is C based
– plus some PHP, autoconf, XML and Jscript
2 programming APIs
– PHP - http://php.net/zend
– Ingres OpenAPI - http://docs.ingres.com/oapi
Code is licensed under PHP License 3.0
© Copyright Ingres Corporation 2008
Concurrent Versions System
Source control system for PHP
Windows
– CVSNT - http://www.cv