Interlisp · masinter · Nov 22, 2021 · Oct 24, 2021 · Oct 24, 2021
diff --git a/BUILDING.md b/BUILDING.md
@@ -1,10 +1,14 @@
 # How to build a medley release
 
 Originally done only with shell scripts:
-
+```
 ./scripts/loadup-all.sh 
+```
+to make the loadups
+```
 ./scripts/loadup-and-release.sh
-
+```
+to go on to make the tgz files and release them
 
 # Using github actions
 

diff --git a/README.md b/README.md
@@ -125,16 +125,25 @@ files.
 
 Each directory should have a README.md, but briefly
 
-- docs -- Documentation files (either PDFs or online help)
-- fonts -- raster fonts (or font widths) in various resolutions for display, postscript, interpress, press formats
-- greetfiles -- various configuration setups
-- internal -- These _were_ internal to Venue; now internal/library and internal/test
-- library  -- packages that were supported (30 years ago)
-- lispusers -- packages that were only half supported (ditto)
-- loadups   -- has sysouts and other builds
-- scripts  -- some scripts for fixing up things
-- sources   -- sources for Interlisp and Common Lisp implementations
-- unicode  -- data files for support of XCCS to and from Unicode mappings
+* BUILDING.md -- instructions on how to make your own loadups
+* clos -- early implementation of Common Lisp Object System
+* CLTL2 -- files submitted to bring Medley up to the conformance to "Common Lisp, the Language" 2nd edition. Not enough to conform to the ANSII standard lisp.
+* Dockerfile -- used when building Docker containers with Medley
+* docs -- Documentation files (either PDFs or online help; see medley/wiki)
+* fonts -- raster fonts (or font widths) in various resolutions for display, postscript, interpress, press formats
+* greetfiles -- various configuration setups
+* internal -- These _were_ internal to Venue; now internal/library and internal/test
+* library  -- packages that were supported (30 years ago)
+* lispusers -- User contributed packages that were only half supported (ditto)
+* loadups   -- has sysouts and other builds plus a few remnants
+* obsolete  -- files we should remove from the repo
+* rooms -- implementation of ROOMS window / desktop manager
+* run-medley -- script to enhance the options of running medley
+* scripts  -- some scripts for fixing up things
+* sources   -- sources for Interlisp and Common Lisp implementations
+* unicode  -- data files for support of XCCS to and from Unicode mappings
 
 plus
    Dockerfile, and scripts for building and running medley
+   tmp directory for use during build processes
+
diff --git a/docs/README.md b/docs/README.md
@@ -0,0 +1,11 @@
+This directory has:
+
+* dinfo  -- files for HelpSys man command Interlisp Reference Manual
+* Documentation Tools -- should be moved into Library
+
+ * Various conversions of Medley legacy documentation
+
+ Needs to be cleaned up. Putting PDF files in the repo doesn't seem right; 
+ we can make PS and PDF files as part of building a loadup
+
+
diff --git a/fonts/README.md b/fonts/README.md
@@ -0,0 +1,16 @@
+# Fonts
+
+These are a not-very-well curated directories of fonts.
+
+"adobe" -- display versions of Postscript's fonts
+ palatino 8 9 10 12 14 18
+ "altofonts" -- random remnants of fonts used with Alto
+ "big" -- supposedly bigger fonts but turned out not (see #482)
+ "displayfonts" -- separated into directories by charset
+ "ipfonts" -- fonts (or font width information for Xeorx Interpress file format.
+ "other" -- random fonts associated with lispusers packages and not available elsewhere.
+ "postscriptfonts" -- fonts for postscript
+ "press" -- fonts for the older-than-interpress "press" format.
+
+ "xeroxprivate" -- ?? Seems like junk
+
diff --git a/greetfiles/README.md b/greetfiles/README.md
@@ -0,0 +1,10 @@
+# medley/greetfiles
+
+This directory is somewhat vestigal -- it originally was used to hold 'initialization' files for everyone. Medley repo has only two:
+
+NOGREET   -- file to set as "system init" when doing loadups that don't want any personalization.
+
+SIMPLE-INIT -- system init for git-directory relative directory structure.
+      Contains INTERLISPMODE.
+
+
diff --git a/greetfiles/initcommands.txt b/greetfiles/initcommands.txt
diff --git a/patches/NOXNSPATCH → library/lafite/NOXNSPATCH b/patches/NOXNSPATCH → library/lafite/NOXNSPATCH
diff --git a/patches/NOXNSPATCH.LCOM → library/lafite/NOXNSPATCH.LCOM b/patches/NOXNSPATCH.LCOM → library/lafite/NOXNSPATCH.LCOM
diff --git a/loadups/README.md b/loadups/README.md
@@ -0,0 +1,15 @@
+# medley/loadups
+
+This directory is for holding the sysouts from a release
+* lisp.sysout    (the system in the IRM + Common Lisp)
+* full.sysout    (lisp + modernizations + TEdit and others)
+
+* starter.sysout you have to have a running Medley to make a new one(!)
+  this file is just a stable place to stand.
+
+* whereis.hash  A "hash file" directory index of everything
+
+* lisp.venuesysout full.venuesysout -- vintage sysouts for comparision
+
+Plus, if you make your own loadups (from BUILDING.md) you'll see some .dribble files which are the logs of the build proccess.
+
diff --git a/greetfiles/INIT → obsolete/greetfiles/INIT b/greetfiles/INIT → obsolete/greetfiles/INIT
diff --git a/greetfiles/INIT.LCOM → obsolete/greetfiles/INIT.LCOM b/greetfiles/INIT.LCOM → obsolete/greetfiles/INIT.LCOM
diff --git a/greetfiles/LOCAL-INIT → obsolete/greetfiles/LOCAL-INIT b/greetfiles/LOCAL-INIT → obsolete/greetfiles/LOCAL-INIT
diff --git a/greetfiles/LOCAL-INIT.LCOM → obsolete/greetfiles/LOCAL-INIT.LCOM b/greetfiles/LOCAL-INIT.LCOM → obsolete/greetfiles/LOCAL-INIT.LCOM
diff --git a/greetfiles/PARC-INIT → obsolete/greetfiles/PARC-INIT b/greetfiles/PARC-INIT → obsolete/greetfiles/PARC-INIT
diff --git a/greetfiles/PARC-INIT.LCOM → obsolete/greetfiles/PARC-INIT.LCOM b/greetfiles/PARC-INIT.LCOM → obsolete/greetfiles/PARC-INIT.LCOM
diff --git a/library/CHARS → obsolete/library/CHARS b/library/CHARS → obsolete/library/CHARS