study/chsrc
1
0
Fork 0
mirror of https://github.com/RubyMetric/chsrc synced 2025-09-09 02:58:20 +08:00
Code Issues Packages Projects Releases Wiki Activity

规范注释

Browse Source
This commit is contained in:
Aoran Zeng 2025-08-22 16:41:05 +08:00
parent 536caa73eb
commit 18ba902da5
No known key found for this signature in database
GPG Key ID: 8F8BA8488E10ED98
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
src/framework/core.c
View File

@ -332,7 +332,7 @@ log_cmd_result (bool result, int exit_status)
/**
* 检测二进制程序是否存在
*
* @param check_cmd 检测 @param:prog_name 是否存在的一段命令，一般来说，填 @param:prog_name 本身即可，
* @param check_cmd 检测 `prog_name` 是否存在的一段命令，一般来说，填 `prog_name` 本身即可，
* 但是某些情况下，需要使用其他命令绕过一些特殊情况，比如 python 这个命令在Windows上
* 会自动打开 Microsoft Store，需避免
*
@ -372,8 +372,8 @@ query_program_exist (char *check_cmd, char *prog_name, int mode)
* @brief 生成用于 “检测一个程序是否存在” 的命令，该内部函数由 chsrc_check_program() 家族调用
*
* @note
* 1. Unix 中，where 仅在 zsh 中可以使用，sh 和 Bash 中均无法使用，因为其并非二进制程序
* 2. 因部分linux系统没有 `which` 和 `whereis` 命令，使用 `command -v` 代替
* 1. Unix 中，'where' 命令仅在 Zsh 中可以使用，sh 和 Bash 中均无法使用，因为其并非二进制程序
* 2. 因部分 Linux 发行版中没有 'which' 和 'whereis' 命令，使用 'command -v' 代替
*/
static char *
cmd_to_check_program (char *prog_name)
@ -386,7 +386,6 @@ cmd_to_check_program (char *prog_name)
}
XY_Deprecate_This("Use cmd_to_check_program() instead")
/**
* @brief 通过 `调用程序名 --version` 的方式检测程序是否存在
*
@ -396,6 +395,7 @@ XY_Deprecate_This("Use cmd_to_check_program() instead")
* 2. 有一些程序启动速度太慢，即使只调用 --version，也依旧会花费许多时间，比如 mvn
* 3. 有些程序并不支持 --version 选项 (虽然基本不可能)
*/
XY_Deprecate_This("Use cmd_to_check_program() instead")
static char *
cmd_to_check_program2 (char *prog_name)
{