[1343] Manuals

Title Text:The most ridiculous offender of all is the sudoers man page, which for 15 years has started with a ‘quick guide’ to EBNF, a system for defining the grammar of a language. ‘Don’t despair’, it says, ‘the definitions below are annotated.’<

Origin:https://xkcd.com/1343/

https://www.explainxkcd.com/wiki/index.php/1343:_Manuals

该图表显示了有关其手册的工具质量:

如果您甚至不需要手册来使用某种工具,那么该工具往往有助于有效地解决问题。

如果您确实需要手册,该工具可能会解决问题,但您必须先了解该手册才能有效地使用此工具。

对于需要手册但却不存在的工具来说,这些工具的帮助很少 – 这些工具往往会产生比他们解决的问题更多的问题。

但最糟糕的工具是手册从手册本身的描述开始 – 这意味着工具非常复杂,手册很难理解。

标题文本是指sudoers,即unix命令sudo的配置文件。 sudo允许用户运行具有提升权限的程序,如149:Sandwich中所述。手册页是针对类Unix系统上的不同工具,命令,文件和函数的手册集合,可以使用工具人员查看。您可以在终端中键入man man以获取手动程序的联机帮助页。例如,还参见漫画912:手动覆盖。

sudoers文件指定哪些用户具有sudo访问权限,以及允许哪些命令作为其他用户(通常是root用户)运行。该文件的语法非常复杂,并且该联机帮助页使用扩展的Backus’aur Form(或EBNF)来描述语法。 sudoers手册页首先解释了EBNF的语法,在描述sudoers文件的语法时,它们在整个手册页的其余部分引用。 sudoers man page非常长,时钟为1504行。相比之下,联机帮助页手册页只有566行。某些分发版本和版本之间的行数可能不同。

标题文本还指出,手册的保证“不要绝望”因为“下面的定义带有注释”,不能令人放心,而只是强调要阅读的文件的长度和复杂性。

Leave a Reply

Your email address will not be published. Required fields are marked *

Categories