源码网商城,靠谱的源码在线交易网站 我的订单 购物车 帮助

源码网商城

Linux shell命令帮助格式详解

  • 时间:2021-05-22 06:42 编辑: 来源: 阅读:
  • 扫一扫,手机访问
摘要:Linux shell命令帮助格式详解
[b]前言[/b] linux shell命令通常可以通过[code]-h[/code]或[code]--help[/code]来打印帮助说明,或者通过[code]man[/code]命令来查看帮助,有时候我们也会给自己的程序写简单的帮助说明,其实帮助说明格式是有规律可循的 [b]帮助示例[/b] 下面是[code]git reset[/code]命令的帮助说明,通过[code]man git-reset[/code]可以查看
git reset [-q] [<tree-ish>] [--] <paths>...
git reset (--patch | -p) [<tree-ish>] [--] [<paths>...]
git reset [--soft | --mixed | --hard | --merge | --keep] [-q] [<commit>]
对于命令和参数大致有如下几种类型 [list] [*]没有任何修饰符参数 : 原生参数[/*] [*]<>  : 占位参数[/*] [*][]  : 可选组合[/*] [*]()  : 必选组合[/*] [*]|   : 互斥参数[/*] [*]... : 可重复指定前一个参数[/*] [*]--  : 标记后续参数类型 [/*] [/list] 下面来一一介绍 参数类型解读 原生参数 说明文档里的字符即为命令需要使用的字符,比如以上命令的
git reset
这种参数在使用时必需指定,且和说明文档里的一致 [b]占位参数[/b] 表示方式: [code]<>[/code] 和原生参数类似,都是必需指定的,只不过占位参数的实际字符是在使用时指定的,同时为了方便阅读会用一个描述词汇来表示,并以[code]<>[/code]包围,比如
<paths>
表示路径,使用时可以指定为具体的路径,而[code]paths[/code]只是起一个说明作用,有些帮助说明里也会用大写来表示占位参数,比如将以上参数说明写成[code]PATHS[/code] [b]可选组合 [/b] 表示方式:  [code][][/code] 括号里的参数为可选参数,比如[code]usage[/code]第二个里面的[code][-q] [/code],则[code]-q[/code]为可选参数 可选项和占位参数也可以同时使用,如
[<commit>]
表示该参数可以指定某次提交,也可以不指定 [b]必选组合[/b] 表示方式:  [code]()[/code] 括号里的参数必需指定,通常里面会是一些互斥参数,比如
(--patch | -p)
表示[code]--patch[/code]和[code]-p[/code]这两个参数必需指定一个 [b]互斥参数 [/b] 表示方式: [code] |[/code] 互斥参数一般都在[code]()[/code]和[code][][/code]里,表示该参数只能指定其中一个,比如
[--mixed | --soft | --hard | --merge | --keep]
[b]重复参数[/b] 表示方式:[code] ...[/code] 表示前一个参数可以被指定多个,比如
<paths>...
[code]<paths>[/code]是一个占位参数,使用时必需指定为路径,...并表示可以指定多个路径。重复参数的一个典型使用场景就是移动文件,将多个文件移动到一个目录下,比如如下命令
git mv [<options>] <source>... <destination>
我们可以这样使用
git mv -f a.cpp b.py dir
此时options对应为[code]-f[/code]参数,source对应为[code]a.cpp b.py[/code],destination对应为[code]dir[/code] [b]标记后续参数类型[/b] 表示方式: [code]--[/code] 表示后续参数的某种类型,比如这里如果使用如下命令
git reset -p -- xx
对比第一个命令,这里的xx对应的应该是[code]<paths>[/code]参数,当我们指定[code]--[/code]之后,则git会认为xx就是一个路径,那怕它是特殊符号或者路径并不存在。这是shell命令的一个通用方式,比如我们有一个文件名为[code]-h[/code],如果想删除这个文件,执行
rm -h
肯定是无法删除的,因为这时-h会被认为是rm的一个参数选项,应该使用
rm -- -h
这时shell会将[code]-h[/code]解释为一个文件名传递给[code]rm[/code]命令 [b]解读实战[/b] 最后来解释一个比较复杂的帮助说明
git cat-file (-t [--allow-unknown-type]|-s [--allow-unknown-type]|-e|-p|<type>|--textconv) <object>
该命令参数由四个部分,其中[code]git[/code]和[code]cat-file[/code]为原生参数,[code]()[/code]里的为可选组合, [code]<object>[/code]为占位参数 组合又由6部分组成,为互斥关系
-t [--allow-unknown-type]
-s [--allow-unknown-type]
-e
-p
<type>
--textconv
因此该命令的帮助说明可以拆分如下
git cat-file -t <object>
git cat-file -t --allow-unknown-type <object>
git cat-file -s <object>
git cat-file -s --allow-unknown-type <object>
git cat-file -e <object>
git cat-file -p <object>
git cat-file <type> <object>
git cat-file --textconv <object>
[b]总结[/b] 以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流。
  • 全部评论(0)
联系客服
客服电话:
400-000-3129
微信版

扫一扫进微信版
返回顶部