[jira] Updated: (ZOOKEEPER-263) document connection host:port as comma separated list in forrest docs

["Patrick Hunt (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/ZOOKEEPER-263?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Patrick Hunt updated ZOOKEEPER-263:
-----------------------------------

    Attachment: ZOOKEEPER-263.patch

Updated documentation to better reflect host connection string syntax/semantics. 

> document connection host:port as comma separated list in forrest docs
> ---------------------------------------------------------------------
>
>                 Key: ZOOKEEPER-263
>                 URL: https://issues.apache.org/jira/browse/ZOOKEEPER-263
>             Project: Zookeeper
>          Issue Type: Improvement
>          Components: c client, documentation, java client
>    Affects Versions: 3.0.0, 3.0.1
>            Reporter: Patrick Hunt
>            Priority: Minor
>             Fix For: 3.1.0
>
>         Attachments: ZOOKEEPER-263.patch
>
>
> The java API docs talk about the host:port comma separated list, however the forrest docs don't mention this. it's confusing for users, they don't know that the connection string can be a list of host:port comma separated. We should mention in the programmer guide, perhaps even in the overview/started (mention in passing and reference the prog guide for full detail).
> Also the java doc should be updated, right now we have a "see also" in the short constructor, to make it more explicit we should copy/paste the docs.
> The c client should also be updated to detail that it's a comma separated list of host:port (similar to java). Right host we just say "host", need to be more explicit as to the format of the string.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.