“Benioku” un Kökeni

32

İnsanlar Benioku dosyalarını yazmaya ne zaman başladı?

Görünüşe göre hemen hemen tüm programların formatı ne olursa olsun bu dosyaya sahip.

Bu belgenin belgelenmiş ilk kullanımı var mı?

documentation terminology history

— Mahmoud Hossam
kaynak

19

Yazılım dokümantasyonunun belgelenmiş ilk kullanımları var mı? ...

— vines

1

@ yazılım yazılım belgeleri! = Benioku

— Mahmoud Hossam,

Ama Benioku aittir.

— üzüm

2

@Vines Yazılım dokümantasyonunun bir benioku dosyası kullanma kuralından önce geldiğinden eminim.

— Mahmoud Hossam,

21

Bir kanonik ilk kullanımdan haberim yok. Jargon Dosya README olarak anlatılmaktadır:

Hacker-eye tanıtımı, geleneksel olarak bir Unix kaynak dağıtımının üst düzey dizininde bulunur

Bu yüzden bazı erken Unix kaynak ağaçlarına baktım, Unix Tree'nin izniyle ( Unix Miras Derneği ve Unix Arşivi tarafından sağlandı ). İlk birliklerde bulunan bazı README dosyaları şunlardır:

/ sys / source / lex / PADB 1.0'dan README (Temmuz 1977) - bulabildiğim en erken
/ usr / doc / Yedinci Basım'dan README (Ocak 1979) - kaynak ağacın tamamı için bulabildiğim en erken sürüm
/ usr / doc / 3BSD'den README (Mart 1980) - BSD için bulabileceğim en erken

Böylece, Temmuz 1977’deki gelişmelere açık!

— Tom Anderson
kaynak

1

ITS'nin ötesine uzanıyor, ne yazık ki, en son değiştirildiği tarihte, arşivlendiği tarih ile karşılaştırıldığında zaman damgalı bir şey bulmak oldukça zor. İlk README büyük olasılıkla 1960'lı yılların sonlarında yaratıldı, ancak bunun oldukça zor olduğunu kanıtladı .

— Tim Post

@Tim - Delikli kartların bir yığınında bir README!

— Martin Beckett,

Kasım 1974 ve Mart 1975’ten bir tane buldum: programmers.stackexchange.com/questions/96966/origin-of-readme/…

— Hugo

10

Geçen sene bir İşletim Sistemleri dersi aldım ve profesörümün tüm delikli kartları ve mag bantları için README'lerin (gerçek fiziksel basılı dosyalar) ve "program" olan başka bir şeyleri olduğunu söylediklerini hatırladım. O zaman gerçekten yaratılmış, koştu ve diğer her şeyi elde etmekle uğraşmış olan cesur süreçten ötürü birine ihtiyacınız vardı. Bu README'ler bazen delikli kartların bir hata kontrolü ve hata ayıklama biçimi olarak nasıl delinmesi gerektiğinin gerçek çıktılarını da içeriyordu.

Kongre, görünüşe göre, eski delik delme kartlarında, tüm delikli kartlarda, üzerine basılmış kapaklarda README ifadesi ile bir "reem" kağıdının tutturulması, bu delikli kartların sisteme kullanımı ve yerleştirilmesi için tüm talimatların bulunduğu bir sistemdir. .

Bir süre referans için, bu 60'lı olurdu. Ancak delikli kart sistemi, 1700'lerden beri "otomatik" tezgahları kontrol etmek için kullanılıyordu, belki de bu kadar eskiydi.

— Jeff Langemeier
kaynak

8

Bu alt.folklore.computers iş parçacığı aracılığıyla bulundu :

PDP-8 işletim sistemlerinden birine eşlik eden bir dokümana bahse giriyorum ya da yazılım paketleri muhtemelen en eskisi gibi olacak.

Ben PDP-10 arşivinde bulunan en eski UCI LISP "dir READ.ME bir zaman damgası ile 4 DECUS kütüphane banttan", 27-Mar-1975 :

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

Ne yazık ki, önceki mini işletim sistemlerinden çoğu, teyp ve / veya disk dizini yapısında [benzersiz] bir zaman damgasını desteklemiyor, bu nedenle bir belgenin gerçekten en son ne zaman düzenlendiğini söylemek zor.

Dosya sadece 27 Mart 1975 zaman damgasına sahip değildir, aynı zamanda dosyada kendiliğinden imzalanmış ve tarih atılmıştır :

                    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

Düzenleme: PDP-10 Arşivlerini dolaşırken 27 Kasım 1974’ten daha eski bir README.TXT buldum , hem zaman damgası hem de dosyada imzaladım :

[README.TXT, SPICE / SINC / SLIC için DOC dosyasıdır]

Bu güvenli bant, devre analizi programlarını içerir:
    SPICE SINC and SLIC
Uygulamalar Yazılım Bülteni Cilt 4'te açıklanan

Gereksinimler:

SPICE, Sağ ayarlı Holerith verilerini kullanması nedeniyle FORTRAN-10 sürüm 4 gerektirir. Yaklaşık 47K'da yürütülür.

[...]

ayrıca bu dosyayı, FORVS ile birlikte SAV'lar ve SECOND.MAC için kaynak zamanlama rutini içerir. SPICE üç bölüme ayrılır: 1SPICE.FOR, 2 ve 3.

Her bir programı tanımlayan basılı bir belge var. Bunlar DECUS paketine dahil edilmiştir. Dokümantasyon ve programlar, Univ. CDC 6400’de Berkley’de bulunan Calif. Test verileri için SLIC ve SINC, 6400'e göre hafif bir değişiklik göstermiştir, SPICE, değişiklik göstermez.

İyi şanslar! Ashley Grayson 27-NOV-74

[README.TXT’nin sonu]

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

— Hugo
kaynak