From abe32dc345ce8f70c6ac13aeee5887e5bfb84ed2 Mon Sep 17 00:00:00 2001
From: pointer-to-bios <yyb1738487169@163.com>
Date: Sun, 31 Jul 2022 19:05:32 +0800
Subject: [PATCH] add version evolution rule

---
 README.md         | 52 +++++++++++++++++++++++++++++++++++++++++++++++
 includes/types.hh | 46 ++++++++++++++++++++++++++++++++++++++---
 2 files changed, 95 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 79689a0..1f2b40a 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,58 @@ BadOS项目的所有程序只有在BadWayland完成后，才能够正常测试
 7. BWLserver/display.hh
 8. BWLserver/display.cc
 
+## 版本演进
+
+### 1. Bad Wayland版本演进规则
+
+版本号共分为由一个点分开的两部分：
+
+1. 超级版本号
+2. 版本号
+
+#### 超级版本号
+
+超级版本号只在Bad Wayland标准有突破性发展的时候增加
+
+#### 版本号
+
+版本号首位在发布一个版本时增加，
+后面的位数（位数不限）表示功能开发完成
+或以前的版本有改动。
+
+#### 末尾字符串
+
+版本号没有改变时会有末尾字符串，连续多个版本没有改变版本号时
+需要按时间顺序列出本版本所有的末尾字符串。
+
+末尾字符串属于版本号的一部分。
+
+末尾字符串以'+'或'-'开头，
+连续两个'+'或'-'表示版本相比上个版本有重大改动。
+
+'+'表示相比上个版本内容增加了，'-'表示内容减少了，后加字符如下：
+
+* +/-ln: 增加了n个库；
+* +/-fn: 表示某库增加了n个函数；
+* +/-sn: 表示增加了n个数据结构。
+
+上列n若为1可省略。
+
+#### 项目开发阶段
+
+gama(γ):开发中
+beta(β):实验阶段
+alpha(α):正式发布
+
+### 2. Bad Wayland Server版本演进规则
+
+版本号共分为由一个点分开的两部分：
+
+1. Bad Wayland版本号；
+2. server发布版本更新的时间（UTC时间，精确到分钟）。
+
+项目开发阶段标记依然写在版本号之后。
+
 ## 加入我们
 
 * 关注我们的组织；
diff --git a/includes/types.hh b/includes/types.hh
index 06e7f9d..eeb1e0e 100644
--- a/includes/types.hh
+++ b/includes/types.hh
@@ -4,9 +4,49 @@
 #include <iostream>
 #include <vector>
 
-
-#define BWL_VERSION "0.01 beta"  //整个BadWayland的版本号
-#define BWLS_VERSION "0.01.202207311825 beta" // BadWayland服务器版本号
+/**
+ * @brief Bad Wayland版本演进规则
+ * 
+ * 版本号共分为由一个点分开的两部分：
+ * 1. 超级版本号
+ * 2. 版本号
+ * 
+ * ## 超级版本号
+ * 超级版本号只在Bad Wayland标准有突破性发展的时候增加
+ * 
+ * ## 版本号
+ * 版本号首位在发布一个版本时增加，
+ * 后面的位数（位数不限）表示功能开发完成
+ * 或以前的版本有改动。
+ * 
+ * ## 末尾字符串
+ * 版本号没有改变时会有末尾字符串，连续多个版本没有改变版本号时
+ * 需要按时间顺序列出本版本所有的末尾字符串。
+ * 末尾字符串属于版本号的一部分。
+ * 以'+'或'-'开头，
+ * 连续两个'+'或'-'表示版本相比上个版本有重大改动。
+ * '+'表示相比上个版本内容增加了，'-'表示内容减少了，后加字符如下：
+ * +/-ln: 增加了n个库；
+ * +/-fn: 表示某库增加了n个函数；
+ * +/-sn: 表示增加了n个数据结构。
+ * 上列n若为1可省略。
+ * 
+ * ## 项目开发阶段
+ * gama(γ):开发中
+ * beta(β):实验阶段
+ * alpha(α):正式发布
+ */
+#define BWL_VERSION "0.01 β"  //整个BadWayland的版本号
+/**
+ * @brief Bad Wayland Server版本演进规则
+ * 
+ * 版本号共分为由一个点分开的两部分：
+ * 1. Bad Wayland版本号；
+ * 2. server发布版本更新的时间（UTC时间，精确到分钟）。
+ * 
+ * 项目开发阶段标记依然写在版本号之后。
+ */
+#define BWLS_VERSION "0.01.202207311025 β" // BadWayland服务器版本号
 
 #ifdef __bwl_server //只有在服务器中这个变量有效
 extern std::string monitor_device;
-- 
GitLab