From f3443f41b017518e08cfef9323862055e37787a9 Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Wed, 27 Oct 2010 08:12:02 -0600 Subject: [PATCH] build: use shorter file names for 'make dist' * docs/api_extension/{0013,0014}*.patch: Rename to shorter files. * docs/api_extension.html.in: Reflect rename. --- docs/api_extension.html.in | 35 ++++++++++--------- ...add-to-xml.patch => 0001-add-to-xml.patch} | 0 ...PI.patch => 0002-add-new-public-API.patch} | 0 ... => 0003-define-internal-driver-API.patch} | 0 ...h => 0004-implement-the-public-APIs.patch} | 0 ... 0005-implement-the-remote-protocol.patch} | 0 ...e-old-API-trivially-wrap-to-new-API.patch} | 0 ...ort.patch => 0007-add-virsh-support.patch} | 0 ...w-xml.patch => 0008-support-new-xml.patch} | 0 ...09-support-all-flags-in-test-driver.patch} | 0 ...e-vcpu-support-in-qemu-command-line.patch} | 0 ...omplete-vcpu-support-in-qemu-driver.patch} | 0 ...ve-vcpu-support-in-xen-command-line.patch} | 0 ...013-improve-getting-xen-vcpu-counts.patch} | 0 ...014-improve-setting-xen-vcpu-counts.patch} | 0 ....patch => 0015-remove-dead-xen-code.patch} | 0 16 files changed, 18 insertions(+), 17 deletions(-) rename docs/api_extension/{0001-Step-1-of-15-add-to-xml.patch => 0001-add-to-xml.patch} (100%) rename docs/api_extension/{0002-Step-2-of-15-add-new-public-API.patch => 0002-add-new-public-API.patch} (100%) rename docs/api_extension/{0003-Step-3-of-15-define-internal-driver-API.patch => 0003-define-internal-driver-API.patch} (100%) rename docs/api_extension/{0004-Step-4-of-15-implement-the-public-APIs.patch => 0004-implement-the-public-APIs.patch} (100%) rename docs/api_extension/{0005-Step-5-of-15-implement-the-remote-protocol.patch => 0005-implement-the-remote-protocol.patch} (100%) rename docs/api_extension/{0006-Step-6-of-15-make-old-API-trivially-wrap-to-new-API.patch => 0006-make-old-API-trivially-wrap-to-new-API.patch} (100%) rename docs/api_extension/{0007-Step-7-of-15-add-virsh-support.patch => 0007-add-virsh-support.patch} (100%) rename docs/api_extension/{0008-Step-8-of-15-support-new-xml.patch => 0008-support-new-xml.patch} (100%) rename docs/api_extension/{0009-Step-9-of-15-support-all-flags-in-test-driver.patch => 0009-support-all-flags-in-test-driver.patch} (100%) rename docs/api_extension/{0010-Step-10-of-15-improve-vcpu-support-in-qemu-command-line.patch => 0010-improve-vcpu-support-in-qemu-command-line.patch} (100%) rename docs/api_extension/{0011-Step-11-of-15-complete-vcpu-support-in-qemu-driver.patch => 0011-complete-vcpu-support-in-qemu-driver.patch} (100%) rename docs/api_extension/{0012-Step-12-of-15-improve-vcpu-support-in-xen-command-line.patch => 0012-improve-vcpu-support-in-xen-command-line.patch} (100%) rename docs/api_extension/{0013-Step-13-of-15-improve-support-for-getting-xen-vcpu-counts.patch => 0013-improve-getting-xen-vcpu-counts.patch} (100%) rename docs/api_extension/{0014-Step-14-of-15-improve-support-for-setting-xen-vcpu-counts.patch => 0014-improve-setting-xen-vcpu-counts.patch} (100%) rename docs/api_extension/{0015-Step-15-of-15-remove-dead-xen-code.patch => 0015-remove-dead-xen-code.patch} (100%) diff --git a/docs/api_extension.html.in b/docs/api_extension.html.in index 6a99cd98dd..8d74752aa9 100644 --- a/docs/api_extension.html.in +++ b/docs/api_extension.html.in @@ -11,7 +11,8 @@

This document walks you through the process of implementing a new API in libvirt. It uses as an example the addition of an API for - separating maximum from current vcpu usage of a domain. + separating maximum from current vcpu usage of a domain, over + the course of a fifteen-patch series. Remember that new API consists of any new public functions, as well as the addition of flags or extensions of XML used by existing functions. The example in this document adds both new @@ -134,8 +135,8 @@ rework it as you go through the process of implementing it.

-

See 0001-Step-1-of-15-add-to-xml.patch - and 0002-Step-2-of-15-add-new-public-API.patch +

See 0001-add-to-xml.patch + and 0002-add-new-public-API.patch for example code.

Defining the internal API

@@ -165,7 +166,7 @@ provide a NULL stub for the new function.

-

See 0003-Step-3-of-15-define-internal-driver-API.patch

+

See 0003-define-internal-driver-API.patch

Implementing the public API

@@ -199,7 +200,7 @@

src/libvirt.c

-

See 0004-Step-4-of-15-implement-the-public-APIs.patch

+

See 0004-implement-the-public-APIs.patch

Implementing the remote protocol

@@ -211,7 +212,7 @@ regeneration of derived files, with further details below.

-

See 0005-Step-5-of-15-implement-the-remote-protocol.patch

+

See 0005-implement-the-remote-protocol.patch

Defining the wire protocol format

@@ -298,7 +299,7 @@ existing lines probably imply a backwards-incompatible API change.

-

See 0005-Step-5-of-15-implement-the-remote-protocol.patch

+

See 0005-implement-the-remote-protocol.patch

Use the new API internally

@@ -312,7 +313,7 @@ not necessary if the new API has no relation to existing API.

-

See 0006-Step-6-of-15-make-old-API-trivially-wrap-to-new-API.patch

+

See 0006-make-old-API-trivially-wrap-to-new-API.patch

Expose the new API in virsh

@@ -343,7 +344,7 @@ tools/virsh.pod

-

See 0007-Step-7-of-15-add-virsh-support.patch

+

See 0007-add-virsh-support.patch

Implement the driver methods

@@ -371,7 +372,7 @@ the same way as the older API wrappers.

-

See 0008-Step-8-of-15-support-new-xml.patch

+

See 0008-support-new-xml.patch

Implement driver handling

@@ -391,7 +392,7 @@ test driver in one patch:

-

See 0009-Step-9-of-15-support-all-flags-in-test-driver.patch

+

See 0009-support-all-flags-in-test-driver.patch

The qemu changes were easier to split into two phases, one for @@ -400,8 +401,8 @@ flags of the new API:

-

See 0010-Step-10-of-15-improve-vcpu-support-in-qemu-command-line.patch - and 0011-Step-11-of-15-complete-vcpu-support-in-qemu-driver.patch

+

See 0010-improve-vcpu-support-in-qemu-command-line.patch + and 0011-complete-vcpu-support-in-qemu-driver.patch

Finally, the example breaks the xen driver changes across four @@ -411,10 +412,10 @@ rendered dead by the new API.

-

See 0012-Step-12-of-15-improve-vcpu-support-in-xen-command-line.patch, - 0013-Step-13-of-15-improve-support-for-getting-xen-vcpu-counts.patch, - 0014-Step-14-of-15-improve-support-for-setting-xen-vcpu-counts.patch, - and 0015-Step-15-of-15-remove-dead-xen-code.patch

+

See 0012-improve-vcpu-support-in-xen-command-line.patch, + 0013-improve-getting-xen-vcpu-counts.patch, + 0014-improve-setting-xen-vcpu-counts.patch, + and 0015-remove-dead-xen-code.patch

The exact details of the example code are probably uninteresting diff --git a/docs/api_extension/0001-Step-1-of-15-add-to-xml.patch b/docs/api_extension/0001-add-to-xml.patch similarity index 100% rename from docs/api_extension/0001-Step-1-of-15-add-to-xml.patch rename to docs/api_extension/0001-add-to-xml.patch diff --git a/docs/api_extension/0002-Step-2-of-15-add-new-public-API.patch b/docs/api_extension/0002-add-new-public-API.patch similarity index 100% rename from docs/api_extension/0002-Step-2-of-15-add-new-public-API.patch rename to docs/api_extension/0002-add-new-public-API.patch diff --git a/docs/api_extension/0003-Step-3-of-15-define-internal-driver-API.patch b/docs/api_extension/0003-define-internal-driver-API.patch similarity index 100% rename from docs/api_extension/0003-Step-3-of-15-define-internal-driver-API.patch rename to docs/api_extension/0003-define-internal-driver-API.patch diff --git a/docs/api_extension/0004-Step-4-of-15-implement-the-public-APIs.patch b/docs/api_extension/0004-implement-the-public-APIs.patch similarity index 100% rename from docs/api_extension/0004-Step-4-of-15-implement-the-public-APIs.patch rename to docs/api_extension/0004-implement-the-public-APIs.patch diff --git a/docs/api_extension/0005-Step-5-of-15-implement-the-remote-protocol.patch b/docs/api_extension/0005-implement-the-remote-protocol.patch similarity index 100% rename from docs/api_extension/0005-Step-5-of-15-implement-the-remote-protocol.patch rename to docs/api_extension/0005-implement-the-remote-protocol.patch diff --git a/docs/api_extension/0006-Step-6-of-15-make-old-API-trivially-wrap-to-new-API.patch b/docs/api_extension/0006-make-old-API-trivially-wrap-to-new-API.patch similarity index 100% rename from docs/api_extension/0006-Step-6-of-15-make-old-API-trivially-wrap-to-new-API.patch rename to docs/api_extension/0006-make-old-API-trivially-wrap-to-new-API.patch diff --git a/docs/api_extension/0007-Step-7-of-15-add-virsh-support.patch b/docs/api_extension/0007-add-virsh-support.patch similarity index 100% rename from docs/api_extension/0007-Step-7-of-15-add-virsh-support.patch rename to docs/api_extension/0007-add-virsh-support.patch diff --git a/docs/api_extension/0008-Step-8-of-15-support-new-xml.patch b/docs/api_extension/0008-support-new-xml.patch similarity index 100% rename from docs/api_extension/0008-Step-8-of-15-support-new-xml.patch rename to docs/api_extension/0008-support-new-xml.patch diff --git a/docs/api_extension/0009-Step-9-of-15-support-all-flags-in-test-driver.patch b/docs/api_extension/0009-support-all-flags-in-test-driver.patch similarity index 100% rename from docs/api_extension/0009-Step-9-of-15-support-all-flags-in-test-driver.patch rename to docs/api_extension/0009-support-all-flags-in-test-driver.patch diff --git a/docs/api_extension/0010-Step-10-of-15-improve-vcpu-support-in-qemu-command-line.patch b/docs/api_extension/0010-improve-vcpu-support-in-qemu-command-line.patch similarity index 100% rename from docs/api_extension/0010-Step-10-of-15-improve-vcpu-support-in-qemu-command-line.patch rename to docs/api_extension/0010-improve-vcpu-support-in-qemu-command-line.patch diff --git a/docs/api_extension/0011-Step-11-of-15-complete-vcpu-support-in-qemu-driver.patch b/docs/api_extension/0011-complete-vcpu-support-in-qemu-driver.patch similarity index 100% rename from docs/api_extension/0011-Step-11-of-15-complete-vcpu-support-in-qemu-driver.patch rename to docs/api_extension/0011-complete-vcpu-support-in-qemu-driver.patch diff --git a/docs/api_extension/0012-Step-12-of-15-improve-vcpu-support-in-xen-command-line.patch b/docs/api_extension/0012-improve-vcpu-support-in-xen-command-line.patch similarity index 100% rename from docs/api_extension/0012-Step-12-of-15-improve-vcpu-support-in-xen-command-line.patch rename to docs/api_extension/0012-improve-vcpu-support-in-xen-command-line.patch diff --git a/docs/api_extension/0013-Step-13-of-15-improve-support-for-getting-xen-vcpu-counts.patch b/docs/api_extension/0013-improve-getting-xen-vcpu-counts.patch similarity index 100% rename from docs/api_extension/0013-Step-13-of-15-improve-support-for-getting-xen-vcpu-counts.patch rename to docs/api_extension/0013-improve-getting-xen-vcpu-counts.patch diff --git a/docs/api_extension/0014-Step-14-of-15-improve-support-for-setting-xen-vcpu-counts.patch b/docs/api_extension/0014-improve-setting-xen-vcpu-counts.patch similarity index 100% rename from docs/api_extension/0014-Step-14-of-15-improve-support-for-setting-xen-vcpu-counts.patch rename to docs/api_extension/0014-improve-setting-xen-vcpu-counts.patch diff --git a/docs/api_extension/0015-Step-15-of-15-remove-dead-xen-code.patch b/docs/api_extension/0015-remove-dead-xen-code.patch similarity index 100% rename from docs/api_extension/0015-Step-15-of-15-remove-dead-xen-code.patch rename to docs/api_extension/0015-remove-dead-xen-code.patch