Skip to content

Getting all available Medley documentation converted to PDF #838

@masinter

Description

@masinter

I've been working on this for a while but maybe it's not obvious.
There is now a utility in medley/internal/MEDLEY-UTILS called HCFILES:
(FILESLOAD MEDLEY-UTILS) (HCFILES) will scan MEDLEYDIR and all subdirectories for TEDIT TED SKETCH TXT files and convert to postscript ... which then I run through the Acrobat distiller to create PDFs, and then use Acrobat to combine into a single file.
After reverting back to an older version of TEDIT (from envos) and making a small patch to SKETCH
(viz #836 (review) ) I've managed to convert 99% of the TEdit documents to a single 4.5 MB 2058 page PDF. https://drive.google.com/drive/u/0/folders/10ZBQty5gEwdBnZHtEbXfe5f1dHGziGZG

So far the problems remain

  • 3-4 crashes in GC with bad free list. Fortunately, (HCFILES) with no arguments defaults to "don't convert if the .PS file is already there". The files get stored in tmp/psfiles/path where path is the original file name with > turned into -; so (SAVEVM) before starting, run (HCFILES) and on the crash, delete the last .PS file and restart.
  • Several image object files will be loaded again if not loaded already. I load TMAX, IMTOOLS and a couple of others in my init; haven't tested whether the autoloading of IMAGEOBJ functions work for those.
  • This doesn't work with current TEdit (see notes on PR Tedit2 move tedit files to separate tedit subdirectory attempt 2 #836 and following)
  • the changes to HCFILES and SKETCH aren't checked in.
  • Documentation written in Japanese doesn't convert to PDF (shows up as black boxes)
  • Odd formatting glitches...
  • This is just one step of documenting maiko and medley sufficiently to address many of the "documentation" wishes and issues.

Metadata

Metadata

Assignees

Labels

duplicateThis issue or pull request already existshelp wantedExtra attention is needed

Type

No type

Projects

Status

No status

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions