[QPID-3067] Example structure is misleading (c++ examples)

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 0.8
• Fix Version/s: 0.9
• Component/s: C++ Client, C++ Examples
• Assignee: Gordon Sim
• Reporter: Ted Ross
• Created: 17/Feb/11 17:26
• Updated: 29/Jul/13 19:05
• Resolved: 01/Mar/11 17:03

Description

The structure of the examples directory (as installed) is the following:

direct
failover
fanout
messaging
pub-sub
qmf-console
request-response
tradedemo
verify
verify_all
xml-exchange

This structure hides the fact that there are two APIs, an old one and a new, recommended API. The uninitiated are not going to figure out that they should be looking in the "messaging" directory for the most relevant examples.

I'd like to suggest that we rearrange these directories such that all old-API examples are under a single subdirectory called "old-api" or similar.

Issue Links

• breaks: QPID-3097 Adapt installer to rearranged C++ examples
• relates to: QPID-3118 cpp/examples/CMakeLists.txt tries to install non-existant files
• relates to: QPID-3135 cpp/bld-winsdk.ps1 tries to install non-existant files