WARNING - OLD ARCHIVES

This is an archived copy of the Xen.org mailing list, which we have preserved to ensure that existing links to archives are not broken. The live archive, which contains the latest emails, can be found at http://lists.xen.org/
   
 
 
Xen 
 
Home Products Support Community News
 
   
 

xen-api

[Xen-API] [PATCH 2 of 2] Suggested change to the deprecation policy

To: xen-api@xxxxxxxxxxxxxxxxxxx
Subject: [Xen-API] [PATCH 2 of 2] Suggested change to the deprecation policy
From: Jonathan Davies <jonathan.davies@xxxxxxxxxx>
Date: Mon, 19 Apr 2010 09:01:50 +0100
Delivery-date: Mon, 19 Apr 2010 01:02:43 -0700
Envelope-to: www-data@xxxxxxxxxxxxxxxxxxx
In-reply-to: <patchbomb.1271664108@dusk>
List-help: <mailto:xen-api-request@lists.xensource.com?subject=help>
List-id: Discussion of API issues surrounding Xen <xen-api.lists.xensource.com>
List-post: <mailto:xen-api@lists.xensource.com>
List-subscribe: <http://lists.xensource.com/mailman/listinfo/xen-api>, <mailto:xen-api-request@lists.xensource.com?subject=subscribe>
List-unsubscribe: <http://lists.xensource.com/mailman/listinfo/xen-api>, <mailto:xen-api-request@lists.xensource.com?subject=unsubscribe>
Sender: xen-api-bounces@xxxxxxxxxxxxxxxxxxx
# HG changeset patch
# User Jonathan Davies <jonathan.davies@xxxxxxxxxx>
# Date 1271664010 -3600
# Node ID ffa1996911197f2677893932ef79fd8c2151ac24
# Parent  6b5fa1fa0edd1201116abd130a3ba1a4ea6a4804
Suggested change to the deprecation policy.

Signed-off-by: Jonathan Davies <jonathan.davies@xxxxxxxxxx>

diff -r 6b5fa1fa0edd -r ffa199691119 docs/evolution/main.tex
--- a/docs/evolution/main.tex   Mon Apr 19 09:00:09 2010 +0100
+++ b/docs/evolution/main.tex   Mon Apr 19 09:00:10 2010 +0100
@@ -48,7 +48,9 @@
 \end{verbatim}
 where \texttt{<release>} identifies a major release of the software.
 
-\item Every release must be accompanied by a {\em deprecation statement} which 
lists all fields and messages marked as deprecated in the release. Next to each 
deprecated item should be an explanation of how to modify a client to avoid 
using the deprecated field or message.
+\item Every release must be accompanied by a {\em deprecation statement} which 
lists all fields and messages marked as deprecated in the release.
+Newly deprecated fields and messages should be clearly highlighted.
+Next to each deprecated item should be an explanation of how to modify a 
client to avoid using the deprecated field or message.
 
 \item The deprecation statement shall be prominently displayed in the XenAPI 
html documentation.
 

Attachment: xen-api.hg-2.patch
Description: Text Data

_______________________________________________
xen-api mailing list
xen-api@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/mailman/listinfo/xen-api
<Prev in Thread] Current Thread [Next in Thread>