椭圆形语言弃用策略
文档版本:1.0日期:2009年4月2日
定义
当一个椭圆形语言构造被标记为不赞成使用变得强烈气馁,可能在以后的版本删除。
原因
- 安全问题。
- 语言的一致性(元素命名、行为等)。
- 过时了:新技术和方法使当前的语言构造过时了。
弃用策略
- 所有现有的构造(元素、属性、模式类型、枚举值等)必须经过一个弃用阶段之前被移除。
- 弃用阶段的持续时间将会发布。
- 语言结构仍将处于废弃状态至少一个版本。在此期间弃用构造将标记使用一个机器可读的旗帜。
日期不应该决定一个项目的弃用状态的持续时间。因为一些语言特性更复杂的比其他人受到的影响不以为然的结构因语言而异。
- 所有废弃结构将伴随着一个消息解释理由弃用和一个指针替换(如果适用),以及版本的椭圆形构造成为弃用。
- 发布之前,弃用和删除结构将通过电子邮件和公布张贴在椭圆形的网站。
弃用的过程
- 构造是椭圆形开发人员提名弃用通过电子邮件列表。
- 待讨论和协议,元素将被选为弃用状态的下一个版本。
- 待讨论和协议,该元素将被删除从适当的模式在被弃用的持续时间至少一个小版本。
弃用检测
椭圆形普通模式将包括一个“deprecated_info”元素,定义一个结构,它将用于标记方案定义构造弃用。
deprecated_info元素:
- 版本:版本的椭圆形弃用。
- 原因:一个解释为什么这是弃用和可能的替代品。
- 备注:关于元素的额外信息弃用状态。
这个元素将会实现在< xsd: appinfo >容器内部的一种语言构造。它将伴随着一个Schematron规则将报告警告使用过时元素在验证。
例子
< xsd: element name = " fileauditedpermissions_test " substitutionGroup = " oval-def:测试" > < xsd: annotation > < !——注释——> < xsd: annotation > < xsd: appinfo > <椭圆形:deprecated_info > <椭圆形:版本> 5.5 < /椭圆形:版本> <椭圆形:原因>取代filesaudtiedpermissions_better_test > /椭圆形:原因> <椭圆形:评论>没有结合Win32 API > /椭圆形:评论> < /椭圆形:deprecated_info > <原理图:模式id = " foo_pattern " > <原理图:规则上下文= " win-def: fileauditedpermissions_test " > <原理图:报告>弃用元素:<原理图:是选择= " name ()" / > < /原理图:报告> < /原理图:规则> < /原理图:模式> < / xsd: appinfo > < !元素定义——> < / xsd: element >
页面最后更新:2009年5月6日
