You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@activemq.apache.org by "Tarjei Huse (JIRA)" <ji...@apache.org> on 2009/12/30 09:49:40 UTC

[jira] Created: (AMQ-2554) ActiveMq - protobuf code needs a spot of documentation

ActiveMq - protobuf code needs a spot of documentation
------------------------------------------------------

                 Key: AMQ-2554
                 URL: https://issues.apache.org/activemq/browse/AMQ-2554
             Project: ActiveMQ
          Issue Type: Improvement
    Affects Versions: 5.3.0
         Environment: activemq-protobuf
            Reporter: Tarjei Huse
            Priority: Minor


Hi, 

I am now testing out the new protobuf functionality which looks great. Good work!

The only complaint I have is that there is _no_ documentation for it.

Based on my experience I would like to suggest a short tutorial in the package description that describes:

* code generation (may be skipped for my part - I just used the maven plugin)
* serialize / unserialize
* The difference between framed and framed serialization methods. 



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


[jira] Updated: (AMQ-2554) ActiveMq - protobuf code needs a spot of documentation

Posted by "Bruce Snyder (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/activemq/browse/AMQ-2554?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bruce Snyder updated AMQ-2554:
------------------------------

    Fix Version/s: 5.5.0
                       (was: 5.4.1)

> ActiveMq - protobuf code needs a spot of documentation
> ------------------------------------------------------
>
>                 Key: AMQ-2554
>                 URL: https://issues.apache.org/activemq/browse/AMQ-2554
>             Project: ActiveMQ
>          Issue Type: Improvement
>    Affects Versions: 5.3.0
>         Environment: activemq-protobuf
>            Reporter: Tarjei Huse
>            Priority: Minor
>             Fix For: 5.5.0
>
>
> Hi, 
> I am now testing out the new protobuf functionality which looks great. Good work!
> The only complaint I have is that there is _no_ documentation for it.
> Based on my experience I would like to suggest a short tutorial in the package description that describes:
> * code generation (may be skipped for my part - I just used the maven plugin)
> * serialize / unserialize
> * The difference between framed and framed serialization methods. 

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


[jira] Commented: (AMQ-2554) ActiveMq - protobuf code needs a spot of documentation

Posted by "Tarjei Huse (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/activemq/browse/AMQ-2554?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=57816#action_57816 ] 

Tarjei Huse commented on AMQ-2554:
----------------------------------

Chirino helped me a bit on the #activemq channel: 
:43 < chirino> yeah.. it's to help separate different pb objects on 1 stream.
16:43 < chirino> if you write the unframe pb objects on a stream.. the receiver can't tell where 1 ends and the other begins.
16:44 < chirino> and he ends up creating 1 object with all the fields 'updated'
16:44 < chirino> which is kinda of a feature of pb.
16:44 < chirino> make sense?
16:44 < tarjei> yes. 
16:45 < tarjei> It was what I thought it was - after some researching into protobuf. 
16:45 < tarjei> do you mind if I attach this to the bug? Just so that if someone else comes along they will find it?
16:46 < chirino> it's fine :)
16:46 < chirino> if you have questions along the way write them down. attach them to the issue
16:47 < chirino> they could form the basis of a doco or faq for it.
16:47 < chirino> oh.. and doc contributions are accepted!
16:47 -!- westmaas [~gabe@74.205.24.231] has joined #activemq
16:48 < chirino> last time I checked, the c protobuf impl does not frame stuff at all.
16:48 < tarjei> yep, that is correct
16:48 < chirino> it's up to the app to sort out framing in a stream.


> ActiveMq - protobuf code needs a spot of documentation
> ------------------------------------------------------
>
>                 Key: AMQ-2554
>                 URL: https://issues.apache.org/activemq/browse/AMQ-2554
>             Project: ActiveMQ
>          Issue Type: Improvement
>    Affects Versions: 5.3.0
>         Environment: activemq-protobuf
>            Reporter: Tarjei Huse
>            Priority: Minor
>
> Hi, 
> I am now testing out the new protobuf functionality which looks great. Good work!
> The only complaint I have is that there is _no_ documentation for it.
> Based on my experience I would like to suggest a short tutorial in the package description that describes:
> * code generation (may be skipped for my part - I just used the maven plugin)
> * serialize / unserialize
> * The difference between framed and framed serialization methods. 

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