This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: How are RFEs handled?


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

/ Jeff Biss <jeff@marco-inc.com> was heard to say:
| I have submitted an RFE (655526:  funcprototype enhancement) in
| SourceForge but see no action, either pro or con on it. I am working
| with the DocBook on an open source project's documentation effort and
| need some enhancement to the existing DocBook to account for function
| prototypes used in the OpenBeOS API.
|
| How are RFEs handled? Is there something I need to do? I am far from
| an XML expert but tried to be as thorough as I could.

Mike's summary describes the process. We get to them as fast as we can.

| I know everyone is busy and don't want to sound pushy but I would like
| to tell my team what to expect of the process. There is no way to
| handle my current situation, as I see it, at this time.

I just added the following suggestion to your RFE.

Would the following change also satisfy your needs?

funcprototype ::=
(modifier*, funcdef,
 (void|varargs|paramdef+),
modifier*)

That would be consistent with the methodsynopsis element. I suppose we
could even make it

funcprototype ::=
(modifier*, funcdef,
 (void|varargs|paramdef+),
exceptionname*, modifier*)

Though perhaps that begins to beg the question as to whether
funcprototype is even necessary anymore. Perhaps it should be removed
alltogether in favor of methodsynopsis.

Does that suit your needs? (Do BeOS API functions through exceptions?
Are they properly methods on BeOS objects, or are they really just
part of a function library, not that the distinction is necessarily
deep or clear.)

                                        Be seeing you,
                                          norm

- -- 
Norman Walsh <ndw@nwalsh.com>      | The trip doesn't exist that can
http://www.oasis-open.org/docbook/ | set you beyond the reach of
Chair, DocBook Technical Committee | cravings, fits of temper, or
                                   | fears. If it did, the human race
                                   | would be off there in a
                                   | body.--Seneca
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>

iD8DBQE+LTSfOyltUcwYWjsRAmKvAKCSNiRXmSanDQcqJ6gAYrN1jZzBigCfTnSd
MKwXIRq9G0scXWZB0/1MTZw=
=RpDZ
-----END PGP SIGNATURE-----


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]