有时您会感到沮丧，想要“振作起来”——我如何在 unix 中添加此手册条目？

Question

Cris-Mac-Book-2:src cris$ man up
No manual entry for up

我该如何补救这种情况？

我想为不存在的命令添加一个“发明的”手动条目，up以便我可以man up在需要时输入。建议包含的内容是对手动添加说明的欢迎补充。

另外，如果我的工作站有女性用户，我一定会使用ln女性：

Cris-Mac-Book-2:src cris$ sudo link /usr/bin/man /usr/bin/woman
Cris-Mac-Book-2:src cris$ woman
What manual page do you want?
Cris-Mac-Book-2:src cris$ 

尽管我可能应该Which womanual page do you want?将其更改为- 是否涉及重新编译或是否有补丁？

Answer 1

这里似乎是添加新手册页的好说明：

操作方法：Linux / UNIX 创建联机帮助页

简而言之，联机帮助页只是一个文本文件，带有 troff 的附加格式信息

它通常采用以下格式

.\" Manpage for up.
.\" Contact cheer_up@havesomechocolate.com to correct errors or typos.
.TH man 8 "06 May 2010" "1.0" "name man page"
.SH NAME
up \- into a higher position or level
.SH SYNOPSIS
up [anything you like]
.SH DESCRIPTION
up is a pretty good place to be
.SH OPTIONS
up does not take any options, though you can choose the speed of your acent 
.SH SEE ALSO
yes(1), time cat (2) cal 3() 
.SH BUGS
No known bugs. Gravity is not a bug, "Its a feature"
.SH AUTHOR
Chris Stringfellow (cheer_up@havesomechocolate.com)

将此另存为 up

然后，您可以man ./up从同一目录查看联机帮助页

手册页通常在下面/usr/local/man/man8/并被 gzip 压缩

您可以复制您的联机帮助页，cp up /usr/local/man/man8/up.1然后使用 gzip 将其压缩gzip /usr/local/man/man8/name.1

然后你可以用 man up 测试它 - 它应该输出这样的东西

Answer 2

尽管我可能应该Which womanual page do you want?将其更改为- 是否涉及重新编译或是否有补丁？

重新编译会产生最好的结果，但同时应该这样做：

#!/bin/bash

ARG=${1/woman/man}

man $ARG > /dev/null 2>&1

if [ $? -eq 0 ]; then
    man $ARG 2> /dev/null \
        | sed \
            -e 's/\(m[ae]n\)/wo\1/g' \
            -e 's/\(M[AE]N\)/WO\1/g' \
            -e 's/M\([ae]n\)/Wom\1/g' \
            -e 's/    //' \
            -e 's/\([^ ]\)  /\1 /g' \
        | less
else
    man $ARG 2>&1 | sed -e 's/\(m[ae]n\)/wo\1/'
fi

另存为/usr/sbin/woman，设置执行权限并开始测试：

woman
woman down
woman woman