Author: tross
Date: Thu Jan 6 19:37:55 2011
New Revision: 1056031
URL: http://svn.apache.org/viewvc?rev=1056031&view=rev
Log:
Added outline for QMF content in docbook.
Added:
qpid/trunk/qpid/doc/book/src/QmfBook.xml
qpid/trunk/qpid/doc/book/src/QmfIntroduction.xml
Modified:
qpid/trunk/qpid/doc/book/Makefile
Modified: qpid/trunk/qpid/doc/book/Makefile
URL:
http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/Makefile?rev=1056031&r1=1056030&r2=1056031&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/Makefile (original)
+++ qpid/trunk/qpid/doc/book/Makefile Thu Jan 6 19:37:55 2011
@@ -35,6 +35,8 @@ java: build/AMQP-Messaging-Broker-Java-B
programming: build/Programming-In-Apache-Qpid
+qmf: build/QmfBook
+
build/AMQP-Messaging-Broker-CPP-Book:
./build-book.sh AMQP-Messaging-Broker-CPP-Book
@@ -44,5 +46,8 @@ build/AMQP-Messaging-Broker-Java-Book:
build/Programming-In-Apache-Qpid:
./build-book.sh Programming-In-Apache-Qpid
+build/QmfBook: src/QmfBook.xml src/QmfIntroduction.xml
+ ./build-book.sh QmfBook
+
clean:
rm -rf build
Added: qpid/trunk/qpid/doc/book/src/QmfBook.xml
URL:
http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/QmfBook.xml?rev=1056031&view=auto
==============================================================================
--- qpid/trunk/qpid/doc/book/src/QmfBook.xml (added)
+++ qpid/trunk/qpid/doc/book/src/QmfBook.xml Thu Jan 6 19:37:55 2011
@@ -0,0 +1,101 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ -->
+
+<book id="qmf-book">
+ <title>QMF - The Qpid Management Framework</title>
+ <subtitle>Object and Service-Oriented Management Leveraging the Capabilities
of Qpid Messaging</subtitle>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="QmfIntroduction.xml"/>
+
+ <!-- As these chapters are fleshed out, move them into separate include
files for easier text management -->
+ <chapter><title>QMF Architecture</title>
+ <section><title>Components: Agents and Consoles</title>
+ </section>
+ <section><title>QMF Domains</title>
+ </section>
+ <section><title>Data: Objects, Methods, Events, and Schemata</title>
+ </section>
+ <section><title>Agent Discovery</title>
+ </section>
+ <section><title>Data Access: Queries and Subscriptions</title>
+ </section>
+ </chapter>
+
+ <chapter><title>QMF Schema Definition</title>
+ <section><title>Packages, Objects, and Events</title>
+ </section>
+ <section><title>Data Types</title>
+ </section>
+ <section><title>Programmatic Schema Definition</title>
+ </section>
+ <section><title>XML Schema Definition</title>
+ </section>
+ </chapter>
+
+ <chapter><title>How to Write an Agent</title>
+ </chapter>
+
+ <chapter><title>How to Write a Console</title>
+ </chapter>
+
+ <chapter><title>QMF Queries</title>
+ </chapter>
+
+ <chapter><title>API Reference</title>
+ <section><title>C++ API</title>
+ </section>
+ <section><title>Python API</title>
+ </section>
+ <section><title>Ruby API</title>
+ </section>
+<!--
+ <section><title>.NET API</title>
+ </section>
+ <section><title>Java API</title>
+ </section>
+-->
+ </chapter>
+
+ <chapter><title>Scale: Large QMF Networks</title>
+ </chapter>
+
+ <chapter><title>Security</title>
+ </chapter>
+
+ <chapter><title>The QMF Protocol</title>
+ <section><title>Message Headers</title>
+ </section>
+ <section><title>Addressing</title>
+ </section>
+ <section><title>Message Protocol</title>
+ </section>
+ <section><title>Message Body Details</title>
+ </section>
+ </chapter>
+
+ <chapter><title>Using QMF Messages to Manage the Qpid Broker</title>
+ </chapter>
+
+</book>
Added: qpid/trunk/qpid/doc/book/src/QmfIntroduction.xml
URL:
http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/QmfIntroduction.xml?rev=1056031&view=auto
==============================================================================
--- qpid/trunk/qpid/doc/book/src/QmfIntroduction.xml (added)
+++ qpid/trunk/qpid/doc/book/src/QmfIntroduction.xml Thu Jan 6 19:37:55 2011
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+-->
+
+<chapter>
+<title>Introduction</title>
+
+<para>
+QMF enhances Qpid Messaging by providing a layer of functionality that makes
it easy to implement common management patterns
+using messaging as the basis for communication. QMF consists of three primary
parts:
+</para>
+
+<itemizedlist>
+ <listitem><para>
+A protocol definition defines conventions for the use of message addresses,
message headers, and structured message bodies.
+ </para></listitem>
+
+ <listitem><para>
+A core QMF engine provides a C++ API and an implementation of a set of
protocol handlers for QMF message communication.
+ </para></listitem>
+
+ <listitem><para>
+Bindings are provided that wrap the C++ API for use in other languages such as
Python, Ruby, and .NET.
+ </para></listitem>
+</itemizedlist>
+
+</chapter>
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:[email protected]