编程函数说明的格式通常包括以下几个部分：
函数名称
函数名称应该简洁明确，能够清晰地表达函数的功能。
参数列表
函数可能有零个或多个参数，参数列表需要列出每个参数的名称和类型。
对于每个参数，可以给出该参数的功能描述。
返回值
函数可能有一个或多个返回值，需要列出每个返回值的名称和类型。
对于每个返回值，可以给出该返回值的功能描述。
函数功能描述
需要详细描述函数的功能和实现方法。
可以使用文字、伪代码或流程图等形式，清晰地描述函数的执行步骤。
示例代码（可选）：
提供一个或多个示例代码，展示如何调用该函数以及函数的返回结果。
```python
def add_numbers（num1: int, num2: int） -> int:
"""
计算两个整数的和。
参数：
num1 （int）： 第一个整数
num2 （int）： 第二个整数
返回：
int： 两个整数的和
"""
sum = num1 + num2
return sum
调用函数并打印结果
result = add_numbers（3, 5）
print（"The sum of 3 and 5 is:", result）
```
在这个示例中，函数名称是 `add_numbers`，参数列表包括 `num1` 和 `num2`，它们的类型都是 `int`。返回值是 `sum`，类型也是 `int`。函数功能描述清晰地说明了该函数的作用和实现方法。示例代码展示了如何调用该函数并打印结果。
根据具体的编程语言和文档要求，函数说明的格式可能会有所不同。上述示例是一个通用的Python函数说明格式，其他编程语言可能会有不同的语法和格式要求。