3.1宏格式

存档文件中的每个宏都有一个带前缀的全大写名称AX公司_。宏存储在同名文件中，位于小写，并带有后缀.m4毫米.除非绝对必要时，文件内容应为ASCII格式。例如，使用撇号（U+27）用于引用标识符而不是Unicode引号标记字符U+2018、U+2019。

该文件应以包含三个名为部分：概要、说明和许可证。

摘要概述了宏的用法和参数。在这个部分，方括号([])用于指示可选参数，并且可以嵌套。

描述包含宏的散文描述。它应该描述宏的功能，以及给定参数的含义在大纲中。描述还应确定：

• 任何默认宏参数值
• 有新的吗--带有或--启用选项，以及它们的默认值
• 参考的任何参数变量(AC_ARG_VAR公司)
• 任何替代变量(AC_瑞士)
• 任何定义的预编译器常量(AC_定义)

宏应定义为AC_DEFUN公司，使用正确的引用。注释应在宏中自由使用dnl公司用于m4sh级别的注释和#用于shell级别的注释。

如果宏被重命名AU_ALIAS公司宏应用于引导旧名称的用户使用新名称：

AU_ALIAS（[旧名]，[AX_NEW_NAME]）

3.2提交宏

要向Autoconf存档提交更新，请在补丁跟踪器并附上一个（最好git-format-patch（1）-格式化）补丁文件。的用户github.com网站可能更喜欢为自动控制Github的存档镜像。请确保您的提交包含以下项目：

• 显示如何调用宏的概要，
• 宏目的的简要描述，
• 作者列表（可选电子邮件地址），
• 许可条款，以及
• m4源代码。

宏可以在任何GPL兼容自由软件许可然而，自由软件基金会，建议使用全许可证用于Autoconf宏。

3.3编写高度可用的宏

Autoconf宏的使用方式多种多样编写良好的宏应该足够灵活，以适应所有这些用途。

请参阅自动工具神话破坏者关于如何编写封装良好、可移植的建议宏。