评论中的“@(#)”是什么意思?

What does "@(#)" in comments mean?

在 OpenBSD 代码 here 中,有一条注释以:

结尾
@(#)init_main.c 8.9 (Berkeley) 1/21/94

@(#) 的目的是什么?我会假设这是为了让搜索更容易,但为什么 @(#) 而不是另一种更有意义的字符模式,如 INFO:?我知道它不是特定于 OpenBSD 的,因为我记得以前看过这个。

这是 what 程序查找的 SCCS 版本信息的标记。它将报告多个结束标记之一的后续内容:空字节、换行符、双引号 "、大于 > 和反斜杠 \.

什么 SCCS?它代表源代码控制系统,由 AT&T(贝尔实验室)的 Marc J Rochkind 为 Unix 开发。它是第一个广泛使用的 Unix-based VCS(版本控制系统),并在 POSIX 中使用命令 admin、[=64= 进行了标准化]delta, get, prs, rmdelungetwhat。经典 (AT&T) 版本包括命令 cdccombhelp(是的,就是 pre-empted 这个名字;现在有时被称为 sccshelp),sactsccsdiffval。某些系统提供了一个程序 sccs,它与 cvsgit 一样,将命令名称作为其第一个参数。 SCCS 是闭源的。开源社区首先使用 RCS,后来使用 CVS,后来出现了大量其他替代方案,例如 Git, Subversion, Mercurial, Fossil, Bazaar, ... 你至少可以找到两个开源版本的 SCCS:Schily-SCCSCSSC(一个GNU 对 SCCS 的重新实现),它们在很大程度上与 SCCS 兼容。与 RCS 和许多其他系统一样,SCCS 是一个集中式 VCS,与 Git 等分布式 VCS (DVCS) 形成对比。预计在某处存储 SCCS-managed 文件的主版本。

至于为什么用@(#)而不是INFO或其他符号,原因恰恰是为了避免与常规文本发生任何似是而非的混淆。除了作为 SCCS 标记之外,您不太可能有理由编写该字符序列。

我在 RCS $Id$ 字符串前面使用它(可以通过 RCS 包中的 ident 单独跟踪)。因此,例如,我的 rmk 程序产生:

$ what rmk
rmk:
    RMK Version 25.92 (2017-10-09)
    *** SCCS enabled ***
    *** RCS enabled ***
    $Id: getopt.h,v 2015.3 2015/09/29 07:13:26 jleffler Exp $
    $Id: stderr.h,v 10.12 2017/04/08 03:43:34 jleffler Exp $
    $Id: sastrings.h,v 2.16 2015/07/05 06:52:05 jleffler Exp $
    $Id: list.h,v 9.6 2016/03/06 18:09:00 jleffler Exp $
    $Id: emalloc.h,v 5.10 2015/02/17 04:50:35 jleffler Exp $
    $Id: debug.h,v 3.13 2016/01/17 15:47:27 jleffler Exp $
    $Id: kludge.h,v 1.16 2016/01/17 15:48:53 jleffler Exp $
    $Id: config.h,v 9.14 2016/09/05 05:37:55 jleffler Exp $
    $Id: make.h,v 9.20 2017/03/28 21:03:36 jleffler Exp $
    $Id: main.c,v 9.20 2016/08/30 22:38:57 jleffler Exp $
    $Id: basename.c,v 2.4 2008/02/11 08:44:50 jleffler Exp $
    $Id: check.c,v 9.6 2016/03/06 07:36:35 jleffler Exp $
    $Id: cleanup.c,v 9.6 2016/08/30 22:38:57 jleffler Exp $
    *** DEBUGGING ENABLED ***
    $Id: debug.c,v 3.12 2016/07/13 00:00:35 jleffler Exp $
    $Id: emalloc.c,v 5.13 2016/01/17 16:05:58 jleffler Exp $
    $Id: errhelp.c,v 8.5 2009/03/02 19:13:51 jleffler Exp $
    $Id: estrdup.c,v 5.7 2015/06/02 03:05:40 jleffler Exp $
    $Id: getopt.c,v 2015.2 2015/09/29 07:13:58 jleffler Exp $
    $Id: input.c,v 9.24 2017/10/09 20:34:18 jleffler Exp $
    $Id: list.c,v 9.4 2015/07/16 00:13:23 jleffler Exp $
    $Id: macro.c,v 9.15 2016/08/30 22:38:57 jleffler Exp $
    $Id: make.c,v 9.12 2017/03/28 21:03:36 jleffler Exp $
    $Id: names.c,v 9.12 2016/08/30 22:38:57 jleffler Exp $
    $Id: rcs.c,v 9.9 2016/08/30 22:38:57 jleffler Exp $
    $Id: rcsfile.c,v 9.9 2016/08/30 22:38:57 jleffler Exp $
    $Id: rules.c,v 9.9 2016/03/06 03:58:52 jleffler Exp $
    $Id: sastrings.c,v 2.22 2015/07/05 06:52:05 jleffler Exp $
    $Id: sccs.c,v 9.11 2016/08/30 22:38:57 jleffler Exp $
    $Id: sccsfile.c,v 9.8 2016/08/30 22:38:57 jleffler Exp $
    $Id: stderr.c,v 10.19 2017/07/10 04:54:26 jleffler Exp $
    $Id: touch.c,v 9.7 2016/03/06 17:31:17 jleffler Exp $
    $Id: vstrcpy.c,v 1.13 2008/02/11 08:44:50 jleffler Exp $
    $Id: archive.c,v 9.11 2017/06/04 04:44:17 jleffler Exp $
    $Id: clnpath.c,v 2.19 2017/03/26 06:32:49 jleffler Exp $
    $Id: dirname.c,v 2.6 2012/02/06 01:55:16 jleffler Exp $
    $Id: tokenise.c,v 2.2 2017/03/26 06:33:37 jleffler Exp $
$

它允许我查看哪些文件的哪些版本用于构建程序,以及一些用 @(#) 标记标记的辅助信息。 运行 在其中一个源文件 (stderr.c) 上,我得到:

$ what stderr.c
stderr.c:
    File:           $RCSfile: stderr.c,v $
    Version:        $Revision: 10.19 $
    Last changed:   $Date: 2017/07/10 04:54:26 $
    Purpose:        Error reporting routines
    Author:         J Leffler
    Copyright:      (C) JLSS 1988-2017
    Product:        :PRODUCT:


    $Id: stderr.c,v 10.19 2017/07/10 04:54:26 jleffler Exp $
$

文件的标题如下所示:

/*
@(#)File:           $RCSfile: stderr.c,v $
@(#)Version:        $Revision: 10.19 $
@(#)Last changed:   $Date: 2017/07/10 04:54:26 $
@(#)Purpose:        Error reporting routines
@(#)Author:         J Leffler
@(#)Copyright:      (C) JLSS 1988-2017
@(#)Product:        :PRODUCT:
*/

what 报告的其他字符串出现在文件的下方。其中一个空行来自:

#if defined(USE_STDERR_FILEDESC)
extern const char jlss_id_stderr_c_with_filedesc[];
const char jlss_id_stderr_c_with_filedesc[] =
        "@(#)" __FILE__ " configured with USE_STDERR_FILEDESC";
#endif /* USE_STDERR_FILEDESC */

那里的标记后跟一个双引号,所以该行的其余部分没有被报告——它看起来像输出中的一个空行。最后列出的行是嵌入在 object 文件中的行,因此在使用 object 文件的程序中,例如 rmk.

这是旧 AT&T sccs 代码的回忆。这是一个旧的源代码修订系统,如rcs,用于维护文件的不同版本(这已被允许维护整个目录版本的系统所取代,如cvsgit)。如今,它已完全被正在使用的新修订软件所取代……但这些是用于识别目标代码中特殊字符串的标签。源代码版本系统使用该序列作为一些介绍性(和罕见的)转义序列,使其能够识别您在代码中看到的字符串。这些字符串允许自动处理源文件中的属性,就像您在其他答案中发布的示例代码中看到的那样。