does EXTRACT_ALL = YES不会提取所有内容，也会显示未记录的警告

EXTRACT_ALL = YES是Sphinx文档生成工具中的一个配置选项，用于指定是否提取所有内容来生成文档。当设置为YES时，Sphinx会尝试提取所有的文档注释，包括未记录的警告。然而，即使设置为YES，有时仍然可能会出现未记录的警告。

未记录的警告通常是由于以下原因之一导致的：

1. 注释格式不正确：如果注释的格式不符合Sphinx的要求，例如缺少必要的标记或标记使用不正确，Sphinx可能无法正确提取注释内容，并生成未记录的警告。
2. 缺少必要的文档标记：有些注释需要特定的标记才能被Sphinx正确提取，如果缺少这些标记，Sphinx可能无法将其识别为文档内容，并生成未记录的警告。
3. 注释位于不支持的位置：有些注释只能在特定的位置被Sphinx提取，如果注释位于不支持的位置，Sphinx可能无法正确提取注释内容，并生成未记录的警告。

为了解决这个问题，可以采取以下步骤：

1. 检查注释格式：确保注释的格式符合Sphinx的要求，包括正确使用标记和标记的语法。
2. 添加必要的文档标记：根据需要，添加必要的标记以确保Sphinx可以正确提取注释内容。可以参考Sphinx的文档或相关文档了解所需的标记。
3. 确认注释位置：确保注释位于Sphinx支持的位置，例如函数、类、模块等。

总结起来，EXTRACT_ALL = YES可以用于指定是否提取所有内容来生成文档，但仍然可能会出现未记录的警告。为了解决这个问题，需要检查注释格式、添加必要的文档标记和确认注释位置。更多关于Sphinx的信息和使用方法，可以参考腾讯云的文档：Sphinx文档生成工具。