有时您感到沮丧,想要“加油” —如何在UNIX中添加此手动条目?


44
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?将其更改为-会涉及重新编译还是有补丁?



3
您还应该建立符号链接,lawyer以便在遇到不稳定状况时可以这样做lawyer up
贾斯汀·

5
是的,明智!即使我尝试过,nice lawyer up它仍然想使用所有系统资源。
Cris Stringfellow

1
这是一个热门问题!
加拿大卢克REINSTATE MONICA

Answers:


31

以下似乎是添加新手册页的良好说明:

如何: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/并被压缩

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

然后您可以和man up一起测试-应该会输出类似这样的内容


4
另外,如果您不喜欢写原始的* roff标记,则可以在POD中编写页面,然后使用pod2man将其转换为手册页。
Ilmari Karonen

8

尽管我可能应该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

2
但是,我在我的新女士中发现了一个错误。她一直在说No wo0ual entry for down- 我说错了什么?
Cris Stringfellow

woman sed\1通过\9for 提及s/regexp/replacewoment/,因此\0可能并非在所有sed版本中都可用。我已经编辑了答案。
丹尼斯

2
woman sed下次我一定会检查的-他们通常是正确的!;)顺便说一句,它现在可以工作。No womanual entry for sex很经典。Sed woman页面是经典的沉闷:A single comwomand may be specified as the first arguwoment to sed.
Cris Stringfellow
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.