add warnings xy.h

Mikachu2333 · Mikachu2333 · commit 0edaf81769b0 · 2025-08-17T18:10:59.000+08:00
diff --git a/lib/xy.h b/lib/xy.h
@@ -975,7 +975,8 @@ xy_dir_exist (const char *path)
  * @details 1. 删除路径左右两边多出来的空白符
  *          2. 将 `~/` 转换为绝对路径
  *
- * @warning 开头结尾的 `/` 或 `\\` 均不会删除，拼接路径时需要确认
+ * @warning 1. 开头结尾的 `/` 或 `\\` 均不会删除，拼接路径时需要确认
+ *          2. 在 Windows 上传入 `~` 将不会返回 HOME 目录，而是返回 `.`
  */
 static char *
 xy_normalize_path (const char *path)
@@ -1005,6 +1006,10 @@ xy_normalize_path (const char *path)
 }
 
 
+/**
+ * @warning 如果传入的路径以 `\` 或者 `/` 结尾，本函数将直接去除斜杠
+ *          并且不会进一步处理为传入路径的父目录
+ */
 static char *
 xy_parent_dir (const char *path)
 {

Original file line number	Diff line number	Diff line change
`@@ -975,7 +975,8 @@ xy_dir_exist (const char *path)`
`975`	`975`	`* @details 1. 删除路径左右两边多出来的空白符`
`976`	`976`	* 2. 将 `~/` 转换为绝对路径
`977`	`977`	`*`
`978`		- * @warning 开头结尾的 `/` 或 `\\` 均不会删除，拼接路径时需要确认
	`978`	+ * @warning 1. 开头结尾的 `/` 或 `\\` 均不会删除，拼接路径时需要确认
	`979`	+ * 2. 在 Windows 上传入 `~` 将不会返回 HOME 目录，而是返回 `.`
`979`	`980`	`*/`
`980`	`981`	`static char *`
`981`	`982`	`xy_normalize_path (const char *path)`
`@@ -1005,6 +1006,10 @@ xy_normalize_path (const char *path)`
`1005`	`1006`	`}`
`1006`	`1007`
`1007`	`1008`
	`1009`	`+/**`
	`1010`	+ * @warning 如果传入的路径以 `\` 或者 `/` 结尾，本函数将直接去除斜杠
	`1011`	`+ * 并且不会进一步处理为传入路径的父目录`
	`1012`	`+ */`
`1008`	`1013`	`static char *`
`1009`	`1014`	`xy_parent_dir (const char *path)`
`1010`	`1015`	`{`