activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Lionel Cons (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (APLO-304) Inconsistent documentation wrt connector buffer size options
Date Tue, 12 Mar 2013 07:01:16 GMT

    [ https://issues.apache.org/jira/browse/APLO-304?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13599784#comment-13599784
] 

Lionel Cons commented on APLO-304:
----------------------------------

This looks much clearer now, thanks.

IMHO, it would make sense to change the buffer size option descriptions from "Sets the size
of the internal socket receive|send buffer" to "Sets the initial size of the internal socket
receive|send buffer".

The paragraph after the example should also be changed to explain that the buffers may grow
or shrink if they are being auto-tuned.

BTW, this same paragraph should start with "Note that &amp; was used to separate the option
values instead of just & since" instead of "Note that & was used to separate the option
values instead of just & since" ;-)
                
> Inconsistent documentation wrt connector buffer size options
> ------------------------------------------------------------
>
>                 Key: APLO-304
>                 URL: https://issues.apache.org/jira/browse/APLO-304
>             Project: ActiveMQ Apollo
>          Issue Type: Bug
>         Environment: 99-trunk-SNAPSHOT
>            Reporter: Lionel Cons
>
> The user manual has a "connectors" section describing the receive_buffer_size and send_buffer_size
options:
> http://activemq.apache.org/apollo/versions/99-trunk-SNAPSHOT/website/documentation/user-manual.html#Connectors
> They are described via "A connector element can be configured with the following attributes"
so one would expect to use:
> <connector id="tcp" bind="tcp://0.0.0.0:61613" receive_buffer_size="1024">
> but later in the manual we see:
> <connector id="tcp" bind="tcp://0.0.0.0:61613?receive_buffer_size=1024&amp;max_read_rate=65536"/>
> So, what is the correct way to specify these options: as eponymous attributes? as part
of the bind attribute URL? both?

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message