使用`man date`的时候，前面的`DATE(1)`和后面的`DATE(1)`各是代表什么意思呢？

Question

在使用man命令查看date的时候：

$ man date


DATE(1)                   BSD General Commands Manual                  DATE(1)

NAME
     date -- display or set date and time

SYNOPSIS
     date [-jRu] [-r seconds | filename] [-v [+|-]val[ymwdHMS]] ...
          [+output_fmt]
     date [-jnu] [[[mm]dd]HH]MM[[cc]yy][.ss]
     date [-jnRu] -f input_fmt new_date [+output_fmt]
     date [-d dst] [-t minutes_west]

DESCRIPTION
     When invoked without arguments, the date utility displays the current
     date and time.  Otherwise, depending on the options specified, date will
     set the date and time or print it in a user-defined way.

     The date utility displays the date and time read from the kernel clock.
     When used to set the date and time, both the kernel clock and the hard-
     ware clock are updated.

     Only the superuser may set the date, and if the system securelevel (see
     

第一行中的：

DATE(1)                   BSD General Commands Manual                  DATE(1)      

请问下，前面的DATE(1)和后面的DATE(1)各是代表什么意思呢？

Answer 1

man man就有答案，这个数字叫section(章节)，不同的section代表手册的分类，比如命令帮助，头文件(.h)帮助，配置文件的帮助等等。

       The table below shows the section numbers of the manual followed by the types of pages they contain.

       1   Executable programs or shell commands
       2   System calls (functions provided by the kernel)
       3   Library calls (functions within program libraries)
       4   Special files (usually found in /dev)
       5   File formats and conventions eg /etc/passwd
       6   Games
       7   Miscellaneous (including macro packages and conventions), e.g. man(7), groff(7)
       8   System administration commands (usually only for root)
       9   Kernel routines [Non standard]

       A manual page consists of several sections.

其中最常见的section是1,5,8。

一个非常经典的例子是man passwd和man 5 passwd看到的section是不一样的，不指明section时，man手册会打开靠前的。

想知道你要查看的帮助关键字有多少个section，用whatis命令就可以了，如:

$ whatis passwd
passwd (1)           - change user password
passwd (5)           - the password file

Answer 2

DATE 就是这个文档的 title，一般是此文档名字的大写。
括号里的数字是分类，共有 9 类，1 指的是 可执行程序或 shell 命令，其他可以 man man 看一下。

你说的前后，其实是一样的，在原格式里只用写一遍，但 man 命令输出排版的时候在左右都输出了一遍，暂时不知道为什么设计（有什么历史原因？），可能是为了对称好看。

Answer 3

为什么标题上有两个DATE(1)
最终在/usr/share/groff/1.22.3/tmac/an-old.tmac层层定义的宏里找到了这行:

259 .de1 PT
260 .  tl '\\*[an-title](\\*[an-section])'\\*[an-extra3]'\\*[an-title](\\*[an-section])'
261 ..

编辑保存成

.  tl '\\*[an-title](\\*[an-section])'\\*[an-extra3]' [Eureka!] \\*[an-title](\\*[an-section])'

再执行

$ man date    

截图留念

参见文章:
为什么man page标题上有两个 DATE(1)的追踪过程