Questions tagged «documentation»

对于有关书面文档的问题,例如手册,帮助文件,政策,说明或指南。

3
“ man”和“ info”文档之间有什么区别?
关于手册页和信息帮助文档: 为什么存在两个类似的文档来源? 有时可以使用手册页,而没有可用的信息。或相反亦然。 我还没有掌握韵律和背后的原因。 它们之间也许有很大的不同,但是即使存在,为什么它们两者都存在?似乎不必要加倍。

5
删除文档以节省硬盘空间
我喜欢在Virtual Box机器上创建一个很小的Ubuntu安装。它基本上应该只提供TeX Live和相关工具。我现在计算出我有将近1GB的数据/usr/share/doc。在这种情况下,我不需要此文档,只需要与LaTeX相关的man页面即可。 有没有办法使用卸载所有这些文档文件apt-get? 或者,仅删除的内容是否合理保存/usr/share/doc? 我喜欢与他人共享Virtual Box计算机,这应该不会有麻烦。

6
普通用户应该如何阅读/ usr / share / doc中的文档?
我最近了解到中有大量的文档/usr/share/doc。 似乎其中很多东西都被压缩了,因此没有管理权限就无法直接访问它: $ gunzip examples/letter.tex.gz gzip: examples/letter.tex: Permission denied 一种解决方案是让每个用户都复制其主目录中的每个项目以读取它,但这种安排似乎不利于常规浏览。 普通人如何阅读本文档? 我不倾向于相信一般用户将安装和维护Web服务器只是为了阅读本地文本文档。



2
降价药比阿西多克药有什么优势?
自从我发现它以来就一直使用Asciidoc,并将其大量用作我的事实上的README文本文件。它以文本形式可读,并且可以输出各种其他格式,例如手册页,pdf,html等。 最近,我已经看到越来越多的使用markdown的FLOSS项目。据我所知,它虽然很光滑,但与Asciidoc相比,它仍然感觉有限得多。甚至github似乎也比asciidoc更好地支持.md。我想念什么吗?那么多人使用.md是有原因的吗? 我认为asciidoc和一个绑定它们的文本文件的可移植性使其功能更加强大。 如果有人有任何见识,或者可以告诉我为什么降价(MD)如此惊人,我会为您购买虚拟啤酒。

5
软件包中缺少zsh手册页文档?
我有一个新安装的xubuntu 13.10 x64。我决定通过突触安装zsh并将其设置为默认外壳。安装的zsh版本是:zsh 5.0.2(x86_64-pc-linux-gnu)。 安装zsh看起来不错,但是似乎没有man文档zsh。输入命令可以man zsh给我以下信息:No manual entry for zsh. 除了zsh本身,zsh-lovers,zsh-doc,zsh-dbg外,我还从synaptic安装了。我在zsh安装中错过了什么,而最终却zsh没有人工文档?

1
内核异味值是什么意思?
运行cat /proc/sys/kernel/tainted打印当前内核污点值(以10为底)。我的理解是,该值是一个位域,其中每个位指示是否存在特定类型的异味。您可以使用以下方法提取位 python3 -c 'from pprint import pprint; pprint(list(zip(range(50), reversed(bin(int(open("/proc/sys/kernel/tainted").read()))[2:]))))' 我已经搜索过文档,但是所看到的仅能识别0到10位的含义。例如,http://www.kernel.org/doc/Documentation/sysctl/kernel.txt表示: tainted: Non-zero if the kernel has been tainted. Numeric values, which can be ORed together. The letters are seen in "Tainted" line of Oops reports. 1 (P): A module with a non-GPL license has been loaded, this includes modules …

1
在“ apt-cache取决于”输出中,Suggests,Recommends,|,<>是什么意思?
我已经检查了man / info页面,但是没有提到输出格式的某些方面 apt-cache depends man / info页面试图提供帮助(以一种钝的方式);quote:“对于输出的其余部分的特定含义,最好参考apt源代码” 现在公平地说,信息页面中的报价是针对它已经合理解释的“ showpkg”选项的,但是我的选项没有这样的解释...我知道Linux信息来自许多来源(不仅仅是man / info页),并且我不想特别翻阅源代码(尽管有时如此),所以这里是我想知道其含义的示例。 # I can assume what these mean, but... # What does | mean? (probably means 'or'???) # What does &lt;pkg&gt; and the following indentations mean? # At the end, the interaction(?) of Suggest and Recommends puzzles me. $ …

4
是否有可用的GUI手册页编辑器?
我发现手册页格式的编写非常痛苦。有没有可用的GUI(所见即所得或所见即所得)编辑器来简化此任务?我希望有一个像Kompozer一样是用于网页的应用程序。 我尝试了gmanedit,但发现它基本上只是一个带有一些容易使用的摘录的文本编辑器-必须知道手册页格式才能使用它,而编辑区域只是一个文本小部件。 虽然我希望使用Ubuntu官方存储库中的软件,但可以使用不受支持的安装方法(例如PPA或从源代码安装)来确定。

1
内核文档在哪里?
在CentOS中,我可以做yum install kernel-doc然后阅读/usr/share/doc/kernel-doc/Documentation/filesystems/proc.txt。 在Ubuntu中,我将如何做?Google教授告诉我它在源代码中,所以我这样做了,apt install linux-source但是找不到proc.txt任何地方。 我猜想在Ubuntu中有另一种方式。


1
是否有关于appindicator的python绑定的详细API文档?
我对自己的项目很认真,并且需要有关python的appindicator模块的良好文档。到目前为止,我发现了什么: dev.ubuntu.com上的API文档 社区Wiki条目 有关C代码的API文档 不错的博客文章 他们怎么了: 只是一个列表,没有对参数,返回值以及方法的作用进行解释 仅设计注意事项和背景-对实际编程无济于事 缺少python模块的东西(例如create_menu_from_desktop) 许多有用的信息已压缩但不完整 因此,基本上,我需要像3.一样详细的内容,但需要使用python模块。 我的问题的例子: 无效build_menu_from_desktop(desktop_file,desktop_profile) 参数应该是什么,该方法做什么?我的猜测是,该方法从“ * .desktop”文件创建菜单项。但是,如果是这样,为什么它不仅仅需要那个文件就需要更多的参数?文件中从菜单项中提取哪些条目?像这样的问题,我很难找到答案。


1
* -doc软件包的用途是什么?
我正在安装一些程序,每个程序都有一个XXX-doc程序包。我想是为了文档,甚至是手册页?因为我可以在线获取文档,所以在那种情况下可以删除所有doc软件包吗?我只需要基本的手册页,而不是整个文档,那么它们真正应该组成什么? 例如:vim-doc仅包含.html文件(使用进行了检查dpkg),因此我认为手册页不存在,那么doc包的用途是什么? 它是安全的:sudo apt-get purge (or remove) .*-doc?

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.