[PHP-DOC] Re: DocBook skeletons.
by Sean Coates other posts by this author
Nov 27 2006 8:41AM messages near this date
[PHP-DOC] cvs: phpdoc /en/docweb main.ent
|
[PHP-DOC] cvs: phpdoc /en/reference/uodbc/functions odbc-autocommit.xml odbc-binmode.xml odbc-close-all.xml odbc-close.xml odbc-columnprivileges.xml odbc-columns.xml odbc-commit.xml odbc-connect.xml odbc-cursor.xml odbc-data-source.xml odbc-do.xml odbc-error.xml odbc-errormsg.xml odbc-exec.xml odbc-execute.xml odbc-fetch-into.xml odbc-fetch-row.xml odbc-field-len.xml odbc-field-name.xml odbc-field-num.xml odbc-field-precision.xml odbc-field-scale.xml odbc-field-type.xml odbc-foreignkeys.xml odbc-free-result.xml odbc-gettypeinfo.xml odbc-longreadlen.xml odbc-next-result.xml odbc-num-fields.xml odbc-num-rows.xml odbc-pconnect.xml odbc-prepare.xml odbc-primarykeys.xml odbc-procedurecolumns.xml odbc-procedures.xml odbc-result-all.xml odbc-result.xml odbc-rollback.xml odbc-setoption.xml odbc-specialcolumns.xml odbc-statistics.xml odbc-tableprivileges.xml odbc-tables.xml
Hi,
Replying to the list--it's a list question.
> I'm in the process of converting the UODBC extension dox to the new style.
>
> I have a 2 quick questions on the templates.
>
> 1 - In http://wiki.phpdoc.info/DocSkel/IniDotXml, should the tgroup
> cols value be 4 and not 3?
Yes, I think so.
> 2 - In http://wiki.phpdoc.info/DocSkel/ConstantsDotXml, it is
> sometimes useful to know the constant value. Is this what the
> <simplepara> tag is for?
The <simpara> block is for a description of the constant. I don't think
that the value should ever be documented--the whole point of the
constant is to create an easy-to-use abstraction.
> As I'm just starting on this, I don't want to make a whole load of
> changes just to find that they are wrong later on.
>
> Either a reply to this or comments on the appropriate pages would be
> great for me!
Good luck. (-:
If I'm wrong, hopefully someone else will chime in.
S
|
