2017-12-04 10:49
如果您使用Linux工具卡住了,第一个调用端口不应该是堆栈溢出,而应该是它的“手册页”。手动 - 手动简称 - 手动检索给定程序的文档。不幸的是,这往往是密集的,很难理解,缺乏实际的例子来帮助你解决你的问题。
TLDR是查看文档的另一种方式。而不是作为一个给定的工具的综合指南,而是专注于提供实际的例子驱动的指示如何工作。
以WGET为例。这是一个用于从互联网下载文件的工具。对于这样一个简单而日常的Unix工具,wget有一个奇怪而又冗长的man page。这不仅提供了详细的描述,还详尽地列出了许多命令 - 其中很多都很少使用。
另一方面,TLDR通过几句话(“从网上下载文件,支持HTTP,HTTPS和FTP”)进行总结,并提供了一些基于实际情况的使用方法示例您可能会遇到某种情况:如下载包含其所有资源的网页,或者检索FTP文件夹的内容。
对于那些按时间,TLDR是真棒。我不会完全依赖它,但对于某些应用程序来说,文档是非常不完整的。
例如,Git的TLDR页面几乎没有涉及到如何使用它,保存如何检查版本,以及如何调出Git帮助页面。有些工具没有任何文档,尽管当你认为这是一个非官方的第三方努力时,这是可以预料的。
这些缺陷很容易被原谅,特别是当你考虑到在很多情况下,它可以帮你省去一趟Google,去弄清楚事情是如何运作的。99%的人只是需要弄清楚一些语法,而实际上并不想陷入一个多余信息的困境,TLDR是非常好的。虽然它永远不会真正取代手册页,但它却很好地恭维了他们。