You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@activemq.apache.org by "ASF GitHub Bot (JIRA)" <ji...@apache.org> on 2016/04/13 17:55:25 UTC

[jira] [Commented] (ARTEMIS-476) Instructions for running examples are triplicated and confusing in one instance

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

ASF GitHub Bot commented on ARTEMIS-476:
----------------------------------------

GitHub user jbertram opened a pull request:

    https://github.com/apache/activemq-artemis/pull/460

    ARTEMIS-476 example fixes/docs

    

You can merge this pull request into a Git repository by running:

    $ git pull https://github.com/jbertram/activemq-artemis ARTEMIS-476

Alternatively you can review and apply these changes as the patch at:

    https://github.com/apache/activemq-artemis/pull/460.patch

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #460
    
----
commit c17f41dac7a30ed85df281ea2218c1d7fb0f14f9
Author: jbertram <jb...@apache.org>
Date:   2016-04-11T19:20:19Z

    ARTEMIS-476 example fixes/docs

----


> Instructions for running examples are triplicated and confusing in one instance
> -------------------------------------------------------------------------------
>
>                 Key: ARTEMIS-476
>                 URL: https://issues.apache.org/jira/browse/ARTEMIS-476
>             Project: ActiveMQ Artemis
>          Issue Type: Bug
>          Components: Broker
>    Affects Versions: 1.3.0
>            Reporter: Jiri Danek
>            Assignee: Justin Bertram
>   Original Estimate: 0.5h
>  Remaining Estimate: 0.5h
>
> Instructions for running examples are given in three different places
>  1) File https://github.com/apache/activemq-artemis/blob/master/docs/user-manual/en/examples.md says
>  2) README at https://github.com/apache/activemq-artemis/blob/master/README.md#examples says
>  3) Another README at https://github.com/apache/activemq-artemis/blob/master/examples/README.md
> My qualms:
> Document 2 is the briefest of them all and quite honestly rather confusing. (the NB sentence at the end).
> Document 2 states, that `mvn verify` will run all examples, while both other documents say that to run all examples, one has to execute `mvn -Pexamples` verify. This is an inconsistency.
> Document 3 says that I need to set the -Xmx option only when I want to run all examples in a batch, with -Pexamples profile. I think that since each example is stopped before another is started, this advice is meaningless. What would make sense is to set this option before running any example, either single one or in batch. Document 1 does not mention -Xmx at all.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)