评论中的“@(#)”是什么意思?
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
, rmdel
、unget
和 what
。经典 (AT&T) 版本包括命令 cdc
、comb
、help
(是的,就是 pre-empted 这个名字;现在有时被称为 sccshelp
),sact
、sccsdiff
和 val
。某些系统提供了一个程序 sccs
,它与 cvs
或 git
一样,将命令名称作为其第一个参数。 SCCS 是闭源的。开源社区首先使用 RCS,后来使用 CVS,后来出现了大量其他替代方案,例如 Git, Subversion, Mercurial, Fossil, Bazaar, ... 你至少可以找到两个开源版本的 SCCS:Schily-SCCS 和 CSSC(一个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
,用于维护文件的不同版本(这已被允许维护整个目录版本的系统所取代,如cvs
或 git
)。如今,它已完全被正在使用的新修订软件所取代……但这些是用于识别目标代码中特殊字符串的标签。源代码版本系统使用该序列作为一些介绍性(和罕见的)转义序列,使其能够识别您在代码中看到的字符串。这些字符串允许自动处理源文件中的属性,就像您在其他答案中发布的示例代码中看到的那样。
在 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
, rmdel
、unget
和 what
。经典 (AT&T) 版本包括命令 cdc
、comb
、help
(是的,就是 pre-empted 这个名字;现在有时被称为 sccshelp
),sact
、sccsdiff
和 val
。某些系统提供了一个程序 sccs
,它与 cvs
或 git
一样,将命令名称作为其第一个参数。 SCCS 是闭源的。开源社区首先使用 RCS,后来使用 CVS,后来出现了大量其他替代方案,例如 Git, Subversion, Mercurial, Fossil, Bazaar, ... 你至少可以找到两个开源版本的 SCCS:Schily-SCCS 和 CSSC(一个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
,用于维护文件的不同版本(这已被允许维护整个目录版本的系统所取代,如cvs
或 git
)。如今,它已完全被正在使用的新修订软件所取代……但这些是用于识别目标代码中特殊字符串的标签。源代码版本系统使用该序列作为一些介绍性(和罕见的)转义序列,使其能够识别您在代码中看到的字符串。这些字符串允许自动处理源文件中的属性,就像您在其他答案中发布的示例代码中看到的那样。