geoff@apache.org wrote:
> geoff 2004/05/11 20:45:03
>
> Modified: src/docs/2.0/api/APR Socket.pod
> Log:
> reword a bit. nothing major...
>
> Revision Changes Path
> 1.4 +5 -5 modperl-docs/src/docs/2.0/api/APR/Socket.pod
>
> Index: Socket.pod
> ===================================================================
> RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Socket.pod,v
> retrieving revision 1.3
> retrieving revision 1.4
> diff -u -r1.3 -r1.4
> --- Socket.pod 8 May 2004 01:29:26 -0000 1.3
> +++ Socket.pod 12 May 2004 03:45:03 -0000 1.4
> @@ -366,11 +366,11 @@
>
> C<APR::Socket> also provides auto-generated perl interface for a few
> other methods which aren't tested at the moment and therefore their
> -API is a subject to change. These methods will be added later as a
> -need arises. If you need any of these methods please contact L<the
> -mod_perl development mailing list|maillist::dev>, present your case,
> -showing us some sample code and we will take care of adding the new
> -method.
> +API is a subject to change. These methods will be finalized later as a
> +need arises. If you want to rely on any of the following methods
> +please contact the L<the mod_perl development mailing list|maillist::dev>
> +so we can help eachother take the steps necessary to shift the method
^^^^^^^^^
----------------------/ :)
> +to an officially supported API.
You don't want to explicitly say that the API may not stay the way it is now?
I think most people will ignore that soft suggestion to contact the list
unless you tell them that unless they explicitly ask at the list the API may
change any time in the future without a further notice (american consumerism
:) It's clear to us what finalization means, but most likely unclear to users.
So I see no harm in telling exactly what does it mean.
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
> geoff 2004/05/11 20:45:03
>
> Modified: src/docs/2.0/api/APR Socket.pod
> Log:
> reword a bit. nothing major...
>
> Revision Changes Path
> 1.4 +5 -5 modperl-docs/src/docs/2.0/api/APR/Socket.pod
>
> Index: Socket.pod
> ===================================================================
> RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Socket.pod,v
> retrieving revision 1.3
> retrieving revision 1.4
> diff -u -r1.3 -r1.4
> --- Socket.pod 8 May 2004 01:29:26 -0000 1.3
> +++ Socket.pod 12 May 2004 03:45:03 -0000 1.4
> @@ -366,11 +366,11 @@
>
> C<APR::Socket> also provides auto-generated perl interface for a few
> other methods which aren't tested at the moment and therefore their
> -API is a subject to change. These methods will be added later as a
> -need arises. If you need any of these methods please contact L<the
> -mod_perl development mailing list|maillist::dev>, present your case,
> -showing us some sample code and we will take care of adding the new
> -method.
> +API is a subject to change. These methods will be finalized later as a
> +need arises. If you want to rely on any of the following methods
> +please contact the L<the mod_perl development mailing list|maillist::dev>
> +so we can help eachother take the steps necessary to shift the method
^^^^^^^^^
----------------------/ :)
> +to an officially supported API.
You don't want to explicitly say that the API may not stay the way it is now?
I think most people will ignore that soft suggestion to contact the list
unless you tell them that unless they explicitly ask at the list the API may
change any time in the future without a further notice (american consumerism
:) It's clear to us what finalization means, but most likely unclear to users.
So I see no harm in telling exactly what does it mean.
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org