myshell/manual.go

package main

import (
	"io"
	"strings"
)

func manual() io.Reader {
	return strings.NewReader(`bg ：后台执行job
- bg [%JID]... ：使指定编号的job在后台继续执行
- bg ：使编号最小的job在后台继续执行

[前台执行的进程 ：在shell中执行的进程；在进程结束并返回shell之前，shell不能执行其他命令]
[后台执行的进程 ：shell的子进程，隐式执行；在进程结束并返回shell之前，shell可以执行其他命令]

cd ：修改工作目录
- cd DIRECTORY ：将工作目录修改为DIRECTORY
- cd .. ：返回上一层目录
- cd ：将工作目录修改为主目录
- cd ~ ：将工作目录修改为主目录

clr ：清屏
- clr ：清屏并在屏幕第一行显示命令提示符

dir ：显示目录内容
- dir ：显示工作目录（即当前目录）下的所有文件
- dir DIRECTORY ：显示DIRECTORY下的所有文件

echo ：显示内容并换行
- echo COMMENT ：在屏幕上显示COMMENT并换行

env ：显示用户环境变量
- env ：显示所有用户环境变量

[环境变量 ：指定操作系统运行环境的一些参数，保证shell命令的正确执行]
[用户环境变量 ：与shell无关的环境变量，不同的shell拥有相同的用户环境变量]

exec ：执行命令
- exec COMMAND ：执行COMMAND命令

exit ：退出shell
- exit ：退出当前shell，退出状态为0
- exit CODE ：退出当前shell，退出状态为CODE

fg ：前台执行job
- fg [%JID]... ：使指定编号的job在前台继续执行
- fg ：使编号最小的job在前台继续执行

help ：显示用户手册
- help ：显示用户手册，并用more过滤
- help -N ：显示用户手册，并用more过滤，每页显示N行
- help +N ：显示用户手册，并用more过滤，从第N行开始显示

jobs ：显示job列表
- jobs ：显示所有job的列表
- jobs [%JID]... ：显示指定编号的job的列表

pwd ：显示工作目录
- pwd ：显示工作目录绝对路径

set ：显示所有环境变量或设置参数
- set ：显示所有环境变量（包括用户环境变量和shell环境变量）
- set [STR]... ：设置命令行参数为指定列表

[shell环境变量 ：与shell有关的环境变量，不同的shell拥有不同的shell环境变量]
[同一种shell的不同进程也拥有不同的shell环境变量]

shift ：左移参数
- shift ：将命令行参数左移1位
- shift [NUM] ：将命令行参数左移NUM位

test ：测试条件
- test -d FILE ：测试FILE是否为目录文件
- test -f FILE ：测试FILE是否为普通文件
- test -s FILE ：测试FILE大小是否不为0
- test -r FILE ：测试FILE是否可读
- test -w FILE ：测试FILE是否可写
- test -x FILE ：测试FILE是否可执行
- test NUM1 -eq NUM2 ：测试NUM1是否等于NUM2
- test NUM1 -ge NUM2 ：测试NUM1是否大于等于NUM2
- test NUM1 -gt NUM2 ：测试NUM1是否大于NUM2
- test NUM1 -le NUM2 ：测试NUM1是否小于等于NUM2
- test NUM1 -lt NUM2 ：测试NUM1是否小于NUM2
- test NUM1 -ne NUM2 ：测试NUM1是否不等于NUM2
- test NUM1 == NUM2 ：测试NUM1是否等于NUM2
- test NUM1 != NUM2 ：测试NUM1是否不等于NUM2

time ：显示时间
- time ：显示当前时间

umask ：显示或设置umask
- umask ：显示当前umask
- umask OCT ：设置umask为OCT

[umask ：用于设置用户创建文件和目录的默认权限；umask用3位8进制数表示，分别为所有者、所在组、其他的权限，每1位8进制表示3位2进制，分别为读、写、执行权限]
[目录文件创建时的默认权限为0777&~umask，即umask中为1的位在默认权限中为0；例如umask=0022时，目录文件的默认权限为0755]
[普通文件创建时的默认权限为0666&~umask；例如umask=0022时，普通文件的默认权限为0644]

unset ：重设变量
- unset [VAR]... ：重设指定的环境变量，值变为空

[I/O重定向 ：在命令中使用< FILE可以将FILE文件作为命令的标准输入]
[在命令中使用> FILE可以将FILE文件作为命令的标准输出，如果FILE文件已存在则会覆盖写入]
[在命令中使用>> FILE可以将FILE文件作为命令的标准输出，如果FILE文件已存在则会追加写入]
[在命令中使用2> FILE可以将FILE文件作为命令的标准错误输出，如果FILE文件已存在则会覆盖写入]
[在命令中使用2>> FILE可以将FILE文件作为命令的标准错误输出，如果FILE文件已存在则会覆盖写入]

[管道 ：执行命令COMMAND1 | COMMAND2 | ... | COMMANDN，可以依次将前一个命令的标准输出作为下一个命令的标准输入]
[第一个命令的标准输入和最后一个命令的标准输出为默认值]
	`)
}