标签: manpage

我希望能够在vim中阅读手册页.由于某种原因,似乎vim无法通过管道读取程序的输出(即'(man ls)| vi'似乎不起作用,奖励指向可以解释原因的人),并获得围绕这个,我一直在使用以下小脚本:

tempo = `mktemp`
man $1 > $tempo ; vi $tempo

这个脚本使用的临时文件,我觉得工作正常,但我想知道是否有一个很好的方法来阅读vim中的手册页而不需要制作临时文件

有没有办法将所有Linux手册页转换为纯文本,html或markdown？

我需要为我在系统上安装的每个man文件执行此操作.

如何将python doc字符串转码为Github readme.md？

虽然看起来似乎每个人都做了,我似乎无法得到一个像样的解决方案,我认为它应该很容易,所以似乎人们不太可能抛出两个转换器......

我试过了什么

pydoc 其实很简单.pydoc的输出是联机帮助页(UNIX系统的groff格式).这是一个死胡同,因为男人对md不是一件事.通过HTML,pydoc3 -w+ pandoc,完全将文档字符串转换为位.

自定义代码似乎有很多简短的自定义代码,但对于少数我尝试过的输出似乎不如pydoc那样好,它有一个摘要,添加了继承的方法并列出了一些属性.

mkdocs.有人建议在某处.它只会污染我的文件夹,因为它是一个误导性的名称,因为它不是docstrings> md转换器,而是md> html.

狮身人面像+潘多克.在解决了UTF-8问题之后,我放弃了Sphinx,因为我有一个要转换的py脚本,并且快速启动的autodoc设置没有解析我的脚本.我尝试用Python导入sphinx.ext.autodoc但TBH的文档太长了,我放弃了.

NB

有一个[一年前未解答的SO问题](从Python Docstrings自动生成GitHub Wiki文档)关于这个主题,但我希望通过提供更多细节我会得到答案.

我打字的时候遇到了这个问题man 2 open.它说开放有两种,一种有两个args,一种有三种!上次我检查时我们无法在C中重载功能.他们是怎么做到的？他们用C++写的吗？

int open(const char * pathname, int flags);
int open(const char * pathname, int flags, mode_t mode);

我有一个名为mongoose.1的mongoose web服务器的手册页,作为make和make install命令的结果,在我的ubuntu 12.04上安装了mongoose web服务器.但是,手册页条目不在手册页数据库中.

当我这样做时,在我的命令行输出:"man mongoose"

akshay@akshay-Inspiron-N5010:~/mongoose$ man mongoose
  No manual entry for mongoose
  See 'man 7 undocumented' for help when manual pages are not available.

我知道存储它们的所有手册页的路径是: -

/usr/local/share/man/

我提前感谢你的回答.

如何访问手册页的特定部分？

我开始使用Docker,只是提取了一个基本的ubuntu映像.我在通过docker-machine运行Docker的Windows 7机箱上.

不知道为什么,我无法在bash上找到man命令.我尝试将人的路径输出到$ PATH,但仍然没有快乐.

docker@default:~$ docker run -it ubuntu bash
root@2dd12b770666:/# man ls
bash: man: command not found
root@2dd12b770666:/# whereis man
man: /usr/local/man /usr/share/man
root@2dd12b770666:/# export PATH=/usr/local/man:/usr/share/man:$PATH
root@2dd12b770666:/# echo $PATH
/usr/local/man:/usr/share/man:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
root@2dd12b770666:/# man
bash: man: command not found
root@2dd12b770666:/#

如果export命令不起作用,则不确定编辑bashrc是否会产生任何影响.所以没试过.还有什么我需要做的才能在码头图像上运行man？

在MacOSX上,"man glRotate"打开了glRotate手册页.

在ubuntu上,manpages-dev和manpages-posix-dev insatlled,"man glRotate"没有提出glRotate手册页(虽然我可以构建和编译gl应用程序).

我错过了什么？我该如何设置？

我看到了手册页test.

提到下面的地方.

-e  pathname
    True if pathname resolves to a file that exists. False if pathname cannot be resolved.
-f  pathname
    True if pathname resolves to a file that exists and is a regular file. False if pathname cannot be resolved, or if pathname resolves to a file that exists but is not a regular file.

如果pathname解析为存在的文件并且是常规文件,则该-f标志表示 True 可以告诉任何人什么是常规文件以及什么不是常规文件.

根据info groff(第5.11节字符翻译), \.应该只打印点.然而,这似乎并非如此.如果我渲染此联机帮助页

.TH x x x x
\.SH foo

我被foo渲染为一个部分标题,并.SH没有打印.

那么,为什么会发生这种情况,如何在groff线的开始处逃避点(和撇号)？