软件用户手册编写指南

用户手册（GB8567——88）

1引言
1.1编写目的
　　说明编写这份用户手册的目的，指出预期的读者。

1.2背景
　　说明：
　　a.    这份用户手册所描述的软件系统的名称；
　　b.    该软件项目的任务提出者、开发者、用户（或首批用户）及安装此软件的计算中心。

2用途
2.1功能
结合本软件的开发目的逐项地说明本软件所具有各项功能以及它们的极限范围。

2.2性能
2.2.1精度
　　逐项说明对各项输入数据的精度要求和本软件输出数据达到的精度，包括传输中的精度要求。

2.2.2时间特性
　　定量地说明本软件的时间特性，如响应时间，更新处理时间，数据传输、转换时间，计算时间等。

2.2.3灵活性
　　说明本软件所具有的灵活性，即当用户需求（如对操作方式、运行环境、结果精度、时间特性等的要求）有某些变化时，本软件的适应能力。

2.3安全保密
　　说明本软件在安全、保密方面的设计考虑和实际达到的能力。

3运行环境
3.1硬设备
　　列出为运行本软件所要求的硬设备的最小配置，如：
　　a.    处理机的型 、内存容量；
　　b.    所要求的外存储器、媒体、记录格式、设备的型 和台数、联机／脱机；
　　c.    I／O设备（联机／脱机；
　　d.    数据传输设备和转换设备的型 、台数。

3.2支持软件
　　说明为运行本软件所需要的支持软件，如：
　　a．   操作系统的名称、版本 ；
　　b．   程序语言的编译／汇编系统的名称和版本 ；
　　c．   数据库管理系统的名称和版本 ；
　　d．   其他支持软件。

3.3数据结构
　　列出为支持本软件的运行所需要的数据库或数据文卷。

4使用过程
　　在本章，首先用图表的形式说明软件的功能同系统的输入源机构、输出接收机构之间的关系。

4.1安装与初始化
　　一步一步地说明为使用本软件而需进行的安装与初始化过程，包括程序的存储形式、安装与初始化过程中的全部操作命令、系统对这些命令的反应与答复。表征安装工作完成的测试实例等。如果有的话，还应说明安装过程中所需用到的专用软件。

4.2输入
　　规定输入数据和参量的准备要求。

4.2.2输入格式
　　说明对初始输入数据和参量的格式要求，包括语法规则和有关约定，如：
　　a.    长度—一例如字符数／行，字符数／项；
　　b.    格式基准——例如以左面的边沿为基准；
　　c.    标 ——例如标记或标识符；
　　d.    顺序——例如各个数据项的次序及位置；
　　e.    标点——例如用来表示行、数据组等的开始或结束而使用的空格、斜线、星 、字符组等。
　　f.    词汇表——给出允许使用的字符组合的列表，禁止使用＊的字符组合的列表等；
　　g.    省略和重复——给出用来表示输人元素可省略或重复的表示方式；
　　h.    控制——给出用来表示输入开始或结束的控制信息。

4.2.3输入举例
　　为每个完整的输入形式提供样本，包括：
　　a．   控制或首部——例如用来表示输入的种类和类型的信息，标识符输入日期，正文起点和对所用编码的规定；
　　b．   主体——输入数据的主体，包括数据文卷的输入表述部分；
　　c．   尾部——用来表示输入结束的控制信息，累计字符总数等；
　　d．   省略——指出哪些输入数据是可省略的；
　　e．   重复——指出哪些输入数据是重复的。

4.3输出对每项输出作出说明
4.3.1输出数据的现实背景
　　说明输出数据的现实背景，主要是：
　　a．   使用——这些输出数据是给谁的，用来干什么；
　　b．   使用频度——例如每周的、定期的或备查阅的；
　　c．   媒体——打印、CRI显示、磁带、卡片、磁盘，
　　d．   质量管理—一例如关于合理性检验、出错纠正的规定；
　　e．   支配——例如如何确定输出数据是保留还是废弃，是否要分配给其他接受者等。

4.3.2输出格式
　　给出对每一类输出信息的解释，主要是：
　　a．   首部——如输出数据的标识符，输出日期和输出编 ；
　　b．   主体——输出信息的主体，包括分栏标题；
　　c．   尾部——包括累计总数，结束标记。

4.4文卷查询
　　这一条的编写针对具有查询能力的软件，内容包括：同数据库查询有关的初始化、准备、及处理所需要的详细规定，说明查询的能力、方式，所使用的命令和所要求的控制规定。

4.5出错处理和恢复
    列出由软件产生的出错编码或条件以及应由用户承担的修改纠正工作。指出为了确保再启动和恢复的能力，用户必须遵循的处理过程。

4.6终端操作
  　当软件是在多终端系统上工作时，应编写本条，以说明终端的配置安排、连接步释、数据和参数输入步骤以及控制规定．说明通过终端操作进行查询、检索、修改数据文卷的能力、语言、过程以及辅助性程序等。