“自述文件”的起源


32

人们什么时候开始编写自述文件?

似乎几乎所有程序都具有此文件,而不管格式如何。

该文件是否有任何书面记载的首次使用?


19
是否有任何书面记录的软件文档首次使用?...
vines

1
@vines软件文档!=自述文件
Mahmoud Hossam

但是自述文件属于。
葡萄树

2
@vines我确定软件文档先于使用自述文件的约定。
Mahmoud Hossam

Answers:


21

我不知道规范的首次使用。在行话文件描述的自述为:

传统上,骇客的介绍包含在Unix源分发的顶级目录中

因此,我看了一些早期的Unix源代码树,这要感谢Unix Tree(由Unix Heritage SocietyUnix Archive提供)。早期unice中发现的一些README文件包括:

因此,欢迎1977年7月取得进展!


1
它超出了ITS的范围,不幸的是,很难找到在上次修改日期与存档日期之间实际带有时间戳的内容。第一个自述文件可能是在1960年代后期创建的,但是证明这是一项艰巨的任务。
蒂姆·波斯特

@Tim-一堆打孔卡上的自述文件!
马丁·贝克特

我发现了一个从1974年11月和1975年3月:programmers.stackexchange.com/questions/96966/origin-of-readme/...
雨果

10

我去年参加了一次操作系统课程,记得我的教授告诉我说,他们的所有打孔卡和磁带都具有README(实际的物理打印文件)以及几乎所有的“程序”。那时,您真的需要一个,因为要进行创建,运行以及其他所有过程都非常费力。这些自述文件有时还包括有关打孔卡应如何打孔的实际打印输出,以作为错误检查和调试的一种形式。

该约定显然也沿袭了旧系统,因为所有打孔卡都在纸上盖了“ reem”纸,上面写着“ README”字样,上面有所有使用和将打孔卡装入系统的说明。 。

作为时间参考,这应该是60年代。但是从1700年代开始,用于控制“自动”织机的打孔卡系统就已经存在,所以甚至可以说是古老的。


8

通过以下alt.folklore.computers线程找到:

我敢打赌,其中某个PDP-8操作系统或软件包附带的某些文档可能是最旧的。

我在PDP-10档案中找到的最古老的是第四版DECUS库磁带中的UCI LISP“ READ.ME ”,时间戳为 1975年3月27日

http://pdp-10.trailing-edge.com/decuslib10-04/index.html

不幸的是,许多早期的微型操作系统在磁带和/或磁盘目录结构中均不支持[唯一]时间戳,因此很难确定文档的真正编辑时间。

该文件不仅具有1975年3月27日的时间戳,而且在文件本身中进行了方便的签名和标注日期:

                    UCI LISP

                    Random Notes

                    [...]

  Should  problems  arise  with   this   system,  please
  communicate  them  to  the  Department  of  Information and
  Computer Science at UCI;  they will be directed to whomever
  is currently managing the UCI LISP system.

            William J. Earl
            Department of Information and Computer Science
            University of California
            Irvine, California

            27 March 1975

编辑:浏览PDP-10档案库我发现早于1974年11月27日的README.TXT,包括时间戳文件

[README.TXT是SPICE / SINC / SLIC的DOC文件]

此故障安全磁带包含电路分析程序:

    SPICE SINC and SLIC

在《应用软件公告》第4卷中进行了介绍。

要求:

SPICE需要使用FORTRAN-10版本4,因为它使用了经过Right调整的Holerith数据。执行约47K。

[...]

它还包括此文件,与SAVes一起使用的FOROTS以及计时程序SECOND.MAC的源代码。SPICE分为三个部分:1SPICE.FOR,2和3。

有一份印刷版文档描述了每个程序。这些包含在DECUS数据包中。这些文档和程序最初是由大学EE部门开发的。是CDC 6400上加州伯克利分校的专利。对于测试数据,SLIC和SINC相对于6400略有变化,而SPICE则没有变化。

祝好运!阿什莉·格雷森(Ashley Grayson)74年11月27日

[README.TXT结尾]

http://pdp-10.trailing-edge.com/decus_20tap3_198111/01/decus/20-0079/readme.txt.html

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.