Re: [1/2] trafficserver git commit: [TS-3153]: Add documentation for new API TSSslAdvertiseProtocolSet

[James Peach <jp...@apache.org>]

Why didn't this go through API review?

https://cwiki.apache.org/confluence/display/TS/API+Review+Process

> On Nov 17, 2014, at 1:27 PM, sudheerv@apache.org wrote:
> 
> Repository: trafficserver
> Updated Branches:
>  refs/heads/master be70f1cab -> f7d8f1b54
> 
> 
> [TS-3153]: Add documentation for new API TSSslAdvertiseProtocolSet
> 
> 
> Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
> Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/f19eba3c
> Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/f19eba3c
> Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/f19eba3c
> 
> Branch: refs/heads/master
> Commit: f19eba3ca70159af1ced63cc987b4a2508c570ba
> Parents: 1b35859
> Author: Sudheer Vinukonda <su...@yahoo-inc.com>
> Authored: Mon Nov 17 21:26:24 2014 +0000
> Committer: Sudheer Vinukonda <su...@yahoo-inc.com>
> Committed: Mon Nov 17 21:26:24 2014 +0000
> 
> ----------------------------------------------------------------------
> .../api/TSSslAdvertiseProtocolSet.en.rst        | 32 ++++++++++++++++++++
> 1 file changed, 32 insertions(+)
> ----------------------------------------------------------------------
> 
> 
> http://git-wip-us.apache.org/repos/asf/trafficserver/blob/f19eba3c/doc/reference/api/TSSslAdvertiseProtocolSet.en.rst
> ----------------------------------------------------------------------
> diff --git a/doc/reference/api/TSSslAdvertiseProtocolSet.en.rst b/doc/reference/api/TSSslAdvertiseProtocolSet.en.rst
> new file mode 100644
> index 0000000..7684242
> --- /dev/null
> +++ b/doc/reference/api/TSSslAdvertiseProtocolSet.en.rst
> @@ -0,0 +1,32 @@
> +.. Licensed to the Apache Software Foundation (ASF) under one or more
> +   contributor license agreements.  See the NOTICE file distributed
> +   with this work for additional information regarding copyright
> +   ownership.  The ASF licenses this file to you under the Apache
> +   License, Version 2.0 (the "License"); you may not use this file
> +   except in compliance with the License.  You may obtain a copy of
> +   the License at
> +
> +      http://www.apache.org/licenses/LICENSE-2.0
> +
> +   Unless required by applicable law or agreed to in writing, software
> +   distributed under the License is distributed on an "AS IS" BASIS,
> +   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
> +   implied.  See the License for the specific language governing
> +   permissions and limitations under the License.
> +
> +
> +TSSslAdvertiseProtocolSet
> +============
> +
> +Synopsis
> +--------
> +
> +`#include <ts/ts.h>`
> +
> +.. c:function:: TSReturnCode TSSslAdvertiseProtocolSet(TSVConn sslp, const unsigned char ** list, unsigned int count);
> +
> +Description
> +-----------
> +
> +   Modifies the NPN advertisement list for a given SSL connection with :arg:`list`. If :arg:`count` is 0, sets the NPN advertisement list to the default registered protocol list for the end point. Note that, the plugin that uses this API owns the :arg:`list` and is responsible for making sure it points to a valid memory.
> +
>