Skip to content

Commit

Permalink
Improve the Attribution section in README
Browse files Browse the repository at this point in the history
  • Loading branch information
wopian committed Apr 5, 2018
1 parent bc2577e commit 3a71d2c
Show file tree
Hide file tree
Showing 10 changed files with 262 additions and 508 deletions.
16 changes: 10 additions & 6 deletions CONTRIBUTING.ko_kr.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,15 @@
# 기여하기
*Available in: [English][EN_US], [한국어][KO_KR]*

:crossed_flags:
[English][EN],
한국어

[EN]:CONTRIBUTING.md
[KO_KR]:CONTRIBUTING.ko_kr.md

## 유용한 확장기능들
GitHub은 내장 에디터에서 AGC문법을 지원합니다.
그러나 불행하게도 대개 사용되는 에디터들은 그렇지 않습니다.
그러나 불행하게도 대개 사용되는 에디터들은 그렇지 않습니다.
하지만 확장 기능이 지원되는 에디터들이 있습니다.

- [Atom][5]
Expand All @@ -28,9 +34,9 @@ GitHub은 내장 에디터에서 AGC문법을 지원합니다.
- 만약 3개 이상의 개행이 있는경우 초과분을 제거하십시오.
- 1열에 `R0000`를 포함하는 경우 빈 줄로 치지 않습니다.
- 소스 이미지는 8열의 인쇄되지 않은 숫자로 생성되었습니다.
두 부분에 두 개의 공백과(빈 줄 한 개), 세 부분에 3개의 공백이(빈 줄 두 개) 강제됩니다.
두 부분에 두 개의 공백과(빈 줄 한 개), 세 부분에 3개의 공백이(빈 줄 두 개) 강제됩니다.
4-8의 값들은 정의되었지만 사용되지 않습니다. 자세한 내용은 [#159][7]를 참고하십시오.

예를 들어 이 코드는:
```plain
R0819 SUBROUTINE TO SKIP...
Expand All @@ -57,5 +63,3 @@ R0820
[5]:https://github.com/Alhadis/language-agc
[6]:https://github.com/wopian/agc-assembly#user-settings
[7]:https://github.com/chrislgarry/Apollo-11/issues/159
[EN_US]:CONTRIBUTING.md
[KO_KR]:CONTRIBUTING.ko_kr.md
16 changes: 9 additions & 7 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Contributing
*Available in : [English][EN_US], [한국어][KO_KR]*

:crossed_flags:
English,
[한국어][KO_KR]

[EN]:CONTRIBUTING.md
[KO_KR]:CONTRIBUTING.ko_kr.md

## Useful Extensions

Expand Down Expand Up @@ -36,7 +42,7 @@ or 2 blank lines in a row.
in column 8. A 2 there forced a double space (single blank line)
and a 3 forced a triple space (double blank line). Values 4-8 were
defined but never used. Read more about it in [#159][7]

For example the following:
```plain
R0819 SUBROUTINE TO SKIP...
Expand All @@ -62,10 +68,6 @@ Before you make a PR, please make sure your changes are consistent with the foll
* [AGC printouts for Comanche][8]
* [AGC printouts for Luminary][9]


[EN_US]:CONTRIBUTING.md
[KO_KR]:CONTRIBUTING.ko_kr.md

[0]:https://github.com/chrislgarry/Apollo-11/pull/new/master
[1]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
[2]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/
Expand All @@ -75,4 +77,4 @@ Before you make a PR, please make sure your changes are consistent with the foll
[6]:https://github.com/wopian/agc-assembly#user-settings
[7]:https://github.com/chrislgarry/Apollo-11/issues/159
[8]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/
[9]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
[9]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
14 changes: 2 additions & 12 deletions Comanche055/README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,8 @@
# Comanche055

This source code has been transcribed or otherwise adapted from digitized images of a hardcopy from the MIT Museum. The digitization was performed by Paul Fjeld, and arranged for by Deborah Douglas of the Museum. Many thanks to both.

The images (with suitable reduction in storage size and consequent reduction in image quality as well) are available online at www.ibiblio.org/apollo. If for some reason you find that the images are illegible, contact me at [email protected] about getting access to the (much) higher-quality images which Paul actually created.

Notations on the hardcopy document read, in part:

Assemble revision 055 of AGC program Comanche by NASA
2021113-051. 10:28 APR. 1, 1969

This AGC program shall also be referred to as
Colossus 2A

## Background
## Background

For organizatinal purposes RSB split the huge monolithic source code into smaller, more manageable chunks--i.e., into individual source
files. Those files are rejoined as "includes". The code chunks correspond to natural divisions into sub-programs. In fact, these divisions are more-or-less specified by the source code itself. Refer to the `"SUBROUTINE CALLS"` at the very beginning of `ASSEMBLY_AND_OPERATION_INFORMATION.agc`.
Expand All @@ -23,7 +13,7 @@ There was a big emphasis on reusability of the code in the original project, app
that you no longer have to worry about dropping the card deck. On the other hand, I (RSB) wasn't there at the time, so I may have no idea what I'm talking about.

Finally, note that the original Apollo AGC assembler (called `YUL`) is no longer available (as far as I can tell). Actually, it had already been replaced by another assembler (called `GAP`) by the time of Apollo 11, but GAP isn't available either. The replacement assembler yaYUL accepts a slightly different format for the source code from what YUL or GAP accepted, so the source code has been targeted for assembly with yaYUL.

What follows is simply a bunch of file-includes for the individual code chunks. The page numbers have been marked to make proof-reading easier. The page images also contain a lot of interesting tables (cross-referenced to page numbers) created by GAP, but not duplicated by yaYUL, so it's still valuable even if the source-files listed below are in hand.

## Source Code Index
Expand Down
103 changes: 35 additions & 68 deletions README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,80 +35,47 @@ Si está interesado en compilar el código fuente original, eche un vistazo a
[Virtual AGC][8].

## Attribuciones
```plain
Derechos de autor: Dominio público.
Nombre del archivo: CONTRACT_AND_APPROVALS.agc
Propósito: Parte del código fuente es para el Colossus 2A, también conocido
como Comanche 055. Es parte del código fuente del módulo de órdenes
(CM) Ordenador de abordo (AGC) para el Apollo 11.
Ensamblador: yaYUL
Contacto: Ron Burkey <[email protected]>.
Sitio Web: www.ibiblio.org/apollo.
Histórico de modificaciones: 2009-05-06 RSB Transcrito a partir de imágenes de las páginas
Este código fuente se ha transcrito o adaptado de imágenes digitalizadas
de una copia en papel presente en el museo del MIT. Los empleados del museo
Paul Fjeld y Deborah Douglas relizaron la digitalización y la gestión de las
imágenes respectivamente. Muchas gracias a ambos. Las imágenes (con la
consecuente reducción de su tamaño para almacenamiento y de su calidad) están
disponibles en línea en la dirección www.ibiblio.org/apollo. Si por alguna razón
considera que algunas imágenes son ilegibles, contacte comigo en [email protected]
para obtener acceso a la imágenes de (más) alta calidad las cuales Paul creó en su
momento.
Algunas notas en la copia en papel del documento muestran la siguiente información:
Revisión de ensamblado 055 del programa Comanche de AGC por NASA
2021113-051. 10:28 APR. 1, 1969
Página 1

#************************************************************************
# *
# ESTE PROGRMA DEBE TAMBIÉN LLAMARSE: *
# *
# *
# COLOSSUS 2A *
# *
# *
# ESTE PROGRMA SE CREÓ PARA UTILIZARSE EN EL CM TAL Y COMO *
# SE ESPECIFICA EN EL INFORME R-577. ESTE PROGRMA SE PREPARÓ *
# EN EL PROYECTO DSR 55-23870, ESPONSORIZADO POR EL CENTRO DE *
# NAVES TRIPULADAS DEL CENTRO NACIONAL DE AERONAÚTICA Y *
# ADMINISTRACIÓN ESPACIAL A TRAVÉS DEL CONTACTO NAS 9-4065 *
# DEL LABORATORIO DE INSTRUMENTACIÓN DEL INSTITUTO DE TECNOLOGÍA *
# DE MASSACHUSSETS, CAMBRIDGE, MASS. *
# *
#************************************************************************
ENVIADO: MARGARET H. HAMILTON FECHA: 28 MAR 69
M.H.HAMILTON, RESPONSABLE DE PROGRAMACIÓN DE COLOSSUS
GUÍA Y NAVEGACIÓN DE APOLLO
| | |
- | -
Derechos de autor | Dominio público
Comanche055 | Part of the source code for Colossus 2A, the Command Module's (CM) Apollo Guidance Computer (AGC) for Apollo 11<br>`Assemble revision 055 of AGC program Comanche by NASA`<br>`2021113-051. 10:28 APR. 1, 1969`
Luminary099 | Part of the source code for Luminary 1A, the Lunar Module's (LM) Apollo Guidance Computer (AGC) for Apollo 11<br>`Assemble revision 001 of AGC program LYM99 by NASA`<br>`2021112-061. 16:27 JUL. 14, 1969`
Ensamblador | yaYUL
Contacto | Ron Burkey <[email protected]>
Sitio Web | www.ibiblio.org/apollo
Digitalización | Este código fuente se ha transcrito o adaptado de imágenes digitalizadas de una copia en papel presente en el museo del MIT. Los empleados del museo Paul Fjeld y Deborah Douglas relizaron la digitalización y la gestión de las imágenes respectivamente. Muchas gracias a ambos.

APROBADO: DANIEL J. LICKLY FECHA: 28 MAR 69
D.J.LICKLY, DIRECTOR DE DESARROLLO DEL PROGRAMA DE LA MISIÓN
PROGRAMA DE GUÍA Y NAVEGACIÓN DE APOLLO
### Contract and Approvals
*Derivado de [CONTRACT_AND_APPROVALS.agc]*

APROBADO: FRED H. MARTIN FECHA: 28 MAR 69
FRED H. MARTIN, JEFE DEL PROYECTO COLOSSUS
PROGRAMA DE GUÍA Y NAVEGACIÓN DE APOLLO
APROBADO: NORMAN E. SEARS FECHA: 28 MAR 69
N.E. SEARS, DIRECTOR DEL DESARROLLO DE LA MISIÓN
PROGRAMA DE GUÍA Y NAVEGACIÓN DE APOLLO
APROBADO: RICHARD H. BATTIN FECHA: 28 MAR 69
R.H. BATTIN, DIRECTOR DEL DESARROLLO DE LA MISIÓN
PROGRAMA DE GUÍA Y NAVEGACIÓN DE APOLLO
```plain
ESTE PROGRMA DEBE TAMBIÉN LLAMARSE:
COLOSSUS 2A*
ESTE PROGRMA SE CREÓ PARA UTILIZARSE EN EL CM TAL Y COMO
SE ESPECIFICA EN EL INFORME R-577. ESTE PROGRMA SE PREPARÓ
EN EL PROYECTO DSR 55-23870, ESPONSORIZADO POR EL CENTRO DE
NAVES TRIPULADAS DEL CENTRO NACIONAL DE AERONAÚTICA Y
ADMINISTRACIÓN ESPACIAL A TRAVÉS DEL CONTACTO NAS 9-4065
DEL LABORATORIO DE INSTRUMENTACIÓN DEL INSTITUTO DE TECNOLOGÍA
DE MASSACHUSSETS, CAMBRIDGE, MASS.
```

APROBADO: DAVID G. HOAG FECHA: 28 MAR 69
D.G. HOAG, DIRECTOR
PROGRAMA DE GUÍA Y NAVEGACIÓN DE APOLLO
Enviado por | Role | Fecha
--------------------- | ---- | -----
Margaret H. Hamilton | Colossus Programming Leader<br>Apollo Guidance and Navigation | 28 Mar 69

APROBADO: RALPH R. RAGAN FECHA: 28 MAR 69
R.R. RAGAN, DEPUTY DIRECTOR
LABORATORIO DE INSTRUMENTACIÓN
```
Apronado por | Role | Fecha
------------------ | ---- | -----
Daniel J. Lickly | Director, Mission Program Development<br>Apollo Guidance and Navigation Program | 28 Mar 69
Fred H. Martin | Colossus Project Manager<br>Apollo Guidance and Navigation Program | 28 Mar 69
Norman E. Sears | Director, Mission Development<br>Apollo Guidance and Navigation Program | 28 Mar 69
Richard H. Battin | Director, Mission Development<br>Apollo Guidance and Navigation Program | 28 Mar 69
David G. Hoag | Director<br>Apollo Guidance and Navigation Program | 28 Mar 69
Ralph R. Ragan | Deputy Director<br>Instrumentation Laboratory | 28 Mar 69

[CONTRACT_AND_APPROVALS.agc]:https://github.com/chrislgarry/Apollo-11/blob/chrislgarry-sourcecode-index/Comanche055/CONTRACT_AND_APPROVALS.agc
[1]:https://cdn.rawgit.com/aleen42/badges/c9246f74/src/nasa.svg
[2]:https://www.nasa.gov/mission_pages/apollo/missions/apollo11.html
[3]:http://www.ibiblio.org/apollo/
Expand Down
104 changes: 35 additions & 69 deletions README.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,81 +27,47 @@ Merci de lire [CONTRIBUTING.md][7] avant d' ouvrir un pull request
Si vous êtes interessé par la compilation du code source original visitez [Virtual AGC][8].

## Attribution
```plain
Copyright: Domaine publique.
Nom du fichier: CONTRACT_AND_APPROVALS.agc
Objet: Partie du code source de Colossus 2A, AKA Comanche 055.
Partie du code source pour le module de commande (CM)
Ordinateur embarqué de navigation (AGC), pour Apollo 11.
Assembleur: yaYUL
Contact: Ron Burkey <[email protected]>.
Site web: www.ibiblio.org/apollo.
Historique des modifications: 2009-05-06 RSB Transcriptions à partir d'images de pages.
Ce code source a été transcrit ou autrement adapté à partir de données numérisées.
des images d'une copie papier du Musée du MIT. La numérisation a été effectuée.
par Paul Fjeld, et organisé par Deborah Douglas du Musée. Grand merci aux deux.
Les images (avec une réduction appropriée de la taille de stockage et de l'espace de stockage.
de la qualité de l'image) sont disponibles en ligne à l'adresse suivante
www.ibiblio.org/apollo. Si, pour une raison quelconque, vous constatez que les images sont
illisible, contactez-moi à l'adresse [email protected] pour obtenir l'accès à
(beaucoup) d'images de meilleure qualité que Paul a réellement créées.
Notations sur le document papier lues, en partie :
Assembleur révision 055 du programme AGC Comanche de la NASA.
2021113-051. 10:28 APR. 1, 1969
Page 1
#************************************************************************
# *
# CE PROGRAMME DE L'AGC SERA ÉGALEMENT DÉSIGNÉ SOUS LE NOM DE: *
# *
# *
# COLOSSUS 2A *
# *
# *
# CE PROGRAMME EST DESTINÉ À ÊTRE UTILISÉ EN CM COMME INDIQUÉ *
# DANS LE RAPPORT R-577. CE PROGRAMME A ÉTÉ PRÉPARÉ DANS LE CADRE *
# DU DSRDSR PROJET 55-23870, PARRAINÉ PAR L'ENGIN SPATIAL HABITÉ *
# CENTRE NATIONAL DE L' AÉRONAUTIQUE ET DE L''ADMINISTRSTION SPATIALE *
# PAR LE BIAIS DU CONTRAT NAS 9-4065 AVEC LE LABORATOIRE *
# D'INSTRUMENTATION,NSTITUT DU MASSACHUSETTS TECHNOLOGIE, *
# CAMBRIDGE, MASSE. *
#************************************************************************

| | |
- | -
Copyright | Domaine publique
Comanche055 | Partie du code source de Colossus 2A, le module de commande (CM) Ordinateur embarqué de navigation (AGC), pour Apollo 11.<br>`Assemble revision 055 of AGC program Comanche by NASA`<br>`2021113-051. 10:28 APR. 1, 1969`
Luminary099 | Partie du code source de Luminary 1A, le module de lunaire (LM) Ordinateur embarqué de navigation (AGC), pour Apollo 11.<br>`Assemble revision 001 of AGC program LYM99 by NASA`<br>`2021112-061. 16:27 JUL. 14, 1969`
Assembler | yaYUL
Contact | Ron Burkey <[email protected]>
Website | www.ibiblio.org/apollo
Digitalization | Ce code source a été transcrit ou autrement adapté à partir de données numérisées des images d'une copie papier du Musée du MIT. La numérisation a été effectuée par Paul Fjeld, et organisé par Deborah Douglas du Musée. Grand merci aux deux.

SOUMIS: MARGARET H. HAMILTON DATE: 28 MAR 69
M.H.HAMILTON, COLOSSUS PROGRAMMING LEADER
APOLLO GUIDE ET NAVIGATION
### Contract and Approvals
*Dérivé de [CONTRACT_AND_APPROVALS.agc]*

APPROUVÉ: DANIEL J. LICKLY DATE: 28 MAR 69
D.J.LICKLY, DIRECTOR, MISSION PROGRAM DEVELOPMENT
APOLLO GUIDANCE AND NAVIGATION PROGRAM
APPROUVÉ: FRED H. MARTIN DATE: 28 MAR 69
FRED H. MARTIN, COLOSSUS PROJECT MANAGER
APOLLO GUIDE ET PROGRAMME DE NAVIGATION
APPROUVÉ: NORMAN E. SEARS DATE: 28 MAR 69
N.E. SEARS, DIRECTOR, MISSION DEVELOPMENT
APOLLO GUIDE ET PROGRAMME DE NAVIGATION
APPROUVÉ: RICHARD H. BATTIN DATE: 28 MAR 69
R.H. BATTIN, DIRECTOR, MISSION DEVELOPMENT
APOLLO GUIDE ET PROGRAMME DE NAVIGATION
```plain
CE PROGRAMME DE L'AGC SERA ÉGALEMENT DÉSIGNÉ SOUS LE NOM DE:
COLOSSUS 2A
CE PROGRAMME EST DESTINÉ À ÊTRE UTILISÉ EN CM COMME INDIQUÉ
DANS LE RAPPORT R-577. CE PROGRAMME A ÉTÉ PRÉPARÉ DANS LE CADRE
DU DSRDSR PROJET 55-23870, PARRAINÉ PAR L'ENGIN SPATIAL HABITÉ
CENTRE NATIONAL DE L' AÉRONAUTIQUE ET DE L''ADMINISTRSTION SPATIALE
PAR LE BIAIS DU CONTRAT NAS 9-4065 AVEC LE LABORATOIRE
D'INSTRUMENTATION,NSTITUT DU MASSACHUSETTS TECHNOLOGIE,
CAMBRIDGE, MASSE.
```

APPROUVÉ: DAVID G. HOAG DATE: 28 MAR 69
D.G. HOAG, DIRECTOR
APOLLO GUIDE ET PROGRAMME DE NAVIGATION
Soumis par | Role | Date
--------------------- | ---- | ----
Margaret H. Hamilton | Colossus Programming Leader<br>Apollo Guidance and Navigation | 28 Mar 69

APPROUVÉ: RALPH R. RAGAN DATE: 28 MAR 69
R.R. RAGAN, DEPUTY DIRECTOR
LABORATOIRE D'INSTRUMENTATION
```
Approuvé par | Role | Date
------------------ | ---- | ----
Daniel J. Lickly | Director, Mission Program Development<br>Apollo Guidance and Navigation Program | 28 Mar 69
Fred H. Martin | Colossus Project Manager<br>Apollo Guidance and Navigation Program | 28 Mar 69
Norman E. Sears | Director, Mission Development<br>Apollo Guidance and Navigation Program | 28 Mar 69
Richard H. Battin | Director, Mission Development<br>Apollo Guidance and Navigation Program | 28 Mar 69
David G. Hoag | Director<br>Apollo Guidance and Navigation Program | 28 Mar 69
Ralph R. Ragan | Deputy Director<br>Instrumentation Laboratory | 28 Mar 69

[CONTRACT_AND_APPROVALS.agc]:https://github.com/chrislgarry/Apollo-11/blob/chrislgarry-sourcecode-index/Comanche055/CONTRACT_AND_APPROVALS.agc
[1]:https://cdn.rawgit.com/aleen42/badges/c9246f74/src/nasa.svg
[2]:https://www.nasa.gov/mission_pages/apollo/missions/apollo11.html
[3]:http://www.ibiblio.org/apollo/
Expand Down
Loading

0 comments on commit 3a71d2c

Please sign in to comment.