Merge branch 'Gtk' into Gtk-Screen

planetarium: Replace old filenames, redundant code in mit-make.scm.

Use load-package-set to load the tellurion.  Add graphics.scm and load
it before its users, to ensure they all link to the same binding(?).

planetarium: Use r3rs-number->string, just with (int) format.

Only integers formatted per the (int) specification are supported.

planetarium: Rename fancy-... to r3rs-...

planetarium: Abbreviate filenames from mit-scheme-... to mit-...

planetarium: Rename *all* MIT-specific files with "mit-" prefix.

Merge branch 'master' into Gtk

runtime: Make it nicer to (ge '(R3RS)).

The default parser and unparser expect to find bindings for
e.g. *parser-table* in any given environment, but there are no such
bindings in a package with parent #f (unless you import them).  If you
don't, executing (ge '(R3RS)) puts the REPL into a tight little error
loop.  This patch makes the parser and unparser consult the (USER)
package if they don't find these bindings in the current environment.

Once "in" a package like (r3rs) it is tricky to get out(!).  Entering
(ge '(USER)) will just produce an error: unbound variable GE.  Thus
the default/repl-eval now looks for an unquoted expression and
evaluates it in the (USER) package, so you can enter ,(ge '(USER)) to
get back.

planetarium: Cool it with the integration and other declarations.

Internal (declare)s are still used, but top-level declarations
(usual-integrations) and (integrate-external) are already made by
compile-file, so are just another barrier to portabimini.

Procedures like project and make-x-rotation-matrix need not be inlined
as they already use flo:vectors to pass 2, 3 and 9 flonums around
efficiently.  Not inlining these reduces matrices.scm to zero
integrable definitions (no .ext file)!

planetarium: Create an (r3rs) package and use it.

Fix planetarium.pkg.  Putting files into separate packages requires
some changes.  Move read-cil-file to an MIT-Scheme-specific
package/file; move cil-file to load before mit-scheme-cil.scm.  Add
explicit clear-graphics and flush-graphics exports from the graphics
packages.  Why did geometry.scm have to be changed?

Merge branch 'master' into Gtk

cref: one more place must allow #f for a package's parent.

Merge branch 'master' into Gtk

ffi: Temporay hack is no longer needed.

cref: Support (parent #f) packages.  Punt system-global-package.

The package-structure<? sort did not ensure that BOTH a package's
parent-in-name and parent-environment were created first.  An easier
sort ensures only that the parent-environment is created first.  The
parent-in-name was only needed to hang the "child" on a tree.  This
patch replaces the tree with a list: *packages*.  Thus a
parent-in-name is not needed and the only parent/child tree is the
environment tree.

To catch out old code searching for packages via package/children (as
in swank.scm) the system-global-package binding was removed, as was
package/child.  Package/add-child! seems popular and so is supported
(with only minor trouble, i.e. no APPENDing during the cold load).
Package creation by other means is... not supported.

gtk: Fix documentation and tests.

Match @deffnx and symbol names containing : and /.  Document
gtk-graphics/make; punt gtk-graphics-device-type.  Fix old spelling of
tellurion in tests.

Merge branch 'master' into Gtk

Add (unused) attribute to Rdl.

This eliminates LAIR/C build log noise to the tune of 70,000 lines!

Merge branch 'Gtk' into Gtk-Screen

Merge branch 'master' into Gtk

Typo: thread-queue/dequeue-until!.

Revert this commit when the release can build without it.

These last vestiges of TC_COMBINATION_1, TC_COMBINATION_2, TC_PCOMB0,
TC_PCOMB1, and TC_PCOMB2 remain only to allow building directly from
release 9.1.

Remove all trace of type codes COMBINATION-2, PCOMB0, etc.

This finishes what 3fc580e started.  The resulting system runs but
does not build with the released version 9.1.  That version puts old
combinations in .exts that cannot be fasloaded by this new version.
As the old combination types are no longer compilable nor even
interpretable, it seems the build process loads them but does not use
them.

The following commit will put just the gc handlers back, which is
sufficient to allow building directly from 9.1.

gtk-screen: Add spawn-edit.

gtk-screen: Punt horizontal scrollbars on typein window.

Move vertical scrollbars to left side(s).

Merge branch 'Gtk' into Gtk-Screen

Fix Gtk doc xrefs. Add cairo-move-to, cairo-new-sub-path.

Merge branch 'Gtk' into Gtk-Screen

Catch up Gtk documentation.  Fix typo in ref-manual/graphics.texi.

gtk: Export surface-ink?, set-surface-ink-position!.

Removed (renamed) set-surface-ink!.

Added new, Gtk3 window type hints to gtk-window-set-type-hint.

Merge branch 'Gtk' into Gtk-Screen

planetarium: Replace "tellurian" with "tellurion".

Merge branch 'Gtk' into Gtk-Screen

planetarium: Fix snapshot.scm to syntax in correct environment.

Fix argument order in HASH-TABLE/MODIFY! documentation.

Fix tabification in (runtime hash-table) package description.

Merge Alexey's hash table documentation and tweaks from ages ago.

There was some little issue but I forget what it was.

Warn that weak references are scary and hard to get right.

Redirect to provided higher-level abstractions.

Update hash-table/count for multiple entry types.

Record the reason for the restrictions in hash-table/modify!

I found this non-obvious when I was writing the documentation, so it
seems appropriate to record it somewhere.  On the other hand, it does
not seem appropriate to burden the user with having to read it ---
just obey the restriction and you'll be fine.  Will anyone ever read
comments in the source of the manual?  Is there a better place to
record this knowledge?

Add some concept index entries that seem reasonable.

Update the documentation of hash-table/clean!

Deprecate {strong/weak}-hash-table/constructor.

Flush the detailed description of what they do as having been copied
into the description of HASH-TABLE/CONSTRUCTOR.

Rewrite the hash table constructors section with more weakness options.

Define and export key-ephemeral-eq and key-ephemeral-eqv tables as
replacements for the key-weak versions.

Punt descriptions of old hash table constructor procedures to the
bottom of the section and say they are for backward compatibility.

One may object to MAKE-KEY-EPHEMERAL-EQ-HASH-TABLE on the grounds that
it invites a combinatorial explosion of names:
make-key/datum-weak-eqv-hash-table
make-datum-ephemeral-string-hash-table
make-key&datum-ephemeral-equal-hash-table (!?)
and so on ad nauseam.

Where will it end?  The criterion I used to decide which names to
export and document and which names to leave alone and defer to the
general HASH-TABLE/CONSTRUCTOR mechanism was simply to update the
existing documentation.  The manual already listed
MAKE-WEAK-EQ-HASH-TABLE.  It is now named MAKE-KEY-WEAK-EQ-HASH-TABLE,
so that name is included.  But really, a key-weak table is just a
performance optimization over a key-ephemeral table, to save work when
you know the data will not hold the keys strongly.  So
MAKE-KEY-EPHEMERAL-EQ-HASH-TABLE is in; it was, in fact, the reason I
wanted Taylor to implement ephemerons in the first place.
MAKE-KEY-EPHEMERAL-EQV-HASH-TABLE is in to preserve the symmetry
between eq? and eqv? that was already present in the manual.  But the
rest of them are out, because they weren't there before.  If
datum-weak tables were so important that their constructor really must
be given a name here, then (arguably) why were they not already
implemented and documented?  The fact that MIT Scheme only supported
strong and key-weak tables for a long time suggests that those kinds
are the most common, and therefore the most deserving of slots in the
name space.

Relocate and update the examples of defining hash table contructors.

Now in terms of HASH-TABLE/CONSTRUCTOR and entry types.

Draft documentation of HASH-TABLE/CONSTRUCTOR and all the entry types.

Will adjust the surrounding text to fit it in in a separate commit.

Redirect cross reference to Weak References

on the grounds that that is now the landing page for the discussion of
strength and weakness.

Improve documentation of hash-table/{modify,intern}!

By the mechanism of implementing Taylor's suggestions.  Also add
sentences about average running times.

Deparenthesize.

Collect "Weak Pairs" and "Ephemerons" into a section called "Weak References".

State the common motivation, define the common terminology, and
describe the contrasts between weak pairs and ephemerons in the common
section, and tighten the "Weak Pairs" and "Ephemerons" sections
themselves back to just describing their data structures.

Rewrite the description of intricacies with ephemeron-broken? per
Taylor's recommendation to name the ephemeron explicitly and use more
active language.

Documenting hash-table/modify! and hash-table/intern!.  Also slightly
reworded the introduction to hash-table/lookup, to make it more
positive.

Documenting the fact that MIT Scheme implements SRFI 69, the
relationship between the MIT Scheme native hash table API and the one
specified by SRFI 69, and the reason why it is appropriate to provide
both (it's not pure backwards compatibility).  This includes
documenting the bugs in SRFI 69.

Grammar.

Pointing out what ephemerons are for; emphasizing the special feature
of ephemerons, and the distinction between ephemerons and weak pairs.

Clarifying that ephemeron-broken? indicates that an ephemeron is whole by returning #f.

Correcting a typo.

Merge branch 'Gtk' into Gtk-Screen

Merge branch 'master' into Gtk

Undo commit 93d3d5c so that "out of memory" need not be The End...

...even in batch-mode.  The effect of 93d3d5c can be had more
elegantly, as pointed out in 6b3f8e0: "Always wrap stdin in a (begin
...)..."

tests: Replace : with / so progress notes are not errors to Emacs.

Add thread-queue/dequeue-no-hang!, rm peek-until, fix -no-hang.

Fix when-non-empty-before, which did not append! to waiting-dequeuers,
and thus would only time out.

Un-export peek-until.  Its TIME argument is... weird -- not universal.
Swat can import it.

Finish replacing type code SEQUENCE-2 with SEQUENCE.

Hack runtime.sf to inform older hosts about new type code.

gtk-screen: Punt tests if errors or DISPLAY not set.

Merge branch 'Gtk' into Gtk-Screen

gtk: Punt tests if no errors or DISPLAY not set.

Merge branch 'Gtk' into Gtk-Screen

gtk: Replace leftover references to gtk+-2.0 with gtk+-3.0.

gtk: Use gtk-graphics/make in planetarium/snapshot.

Gtk-graphics/make doesn't care if DISPLAY is set.

gtk: Only warn if DISPLAY not set.

Some of the Gtk libraries are useful without a DISPLAY.

gtk: Add gtk-graphics/make.

Add src/planetarium/snapshot, tweaks, TODO list.

Factor draw-tellurian out of run-tellurian for snapshot.scm.  Tweak
position of lat/long text.  Use default fore/background.

Add no-window? parameter to gtk-graphics/open.

Add cairo-surface-write-to-png.

This should really use cairo_surface_write_to_png_stream.

gtk: Add src/planetarium/, which works with a simple graphics device.

Just half a tellurian for now -- a drawing of Earth showing the
position of the Sun.  On a simple (or even an X11) graphics device
just the terminator is drawn.  The light and dark sides of Earth are
undistinguished.  On a Gtk graphics device, the dark side is shaded
light gray.

gtk: Update fix-demo.scm's copyright notice.  Turn the ball blue.

gtk: Add gtk-graphics device type.

Just the simple operations plus fill-polygon-list, draw-circle,
set-foreground-color and set-background-color.

gtk: Add Cairo <surface-ink>.  Use it in fix-layout demo.

Adjust demo for a smaller drawing size.

gtk: Add many cairo- wrappers: cairo-image-surface-create...

... cairo-pattern-create-linear, cairo-pattern-create-radial,
cairo-pattern-add-color-stop, cairo-create, cairo-translate,
cairo-scale, cairo-set-source, cairo-set-source-color, cairo-arc,
cairo-paint, cairo-fill, cairo-stroke, cairo-set-font-matrix,
cairo-matrix, cairo-surface-destroy, cairo-surface-flush, and
cairo-pattern-destroy.

gtk: Add gtk-window-set-type-hint.

gtk: Add thread-queue/dequeue-no-hang!, rm peek-until, fix -no-hang.

Fix when-non-empty-before, which did not append! to waiting-dequeuers,
and thus would only time out.

Not exporting peek-until.  Its TIME argument is... weird -- not
universal.  Swat can import it.

Merge branch 'master' into Gtk

gtk-screen: Customize scrollbar behavior.

Specialize the internal fix-layout-adjustment-parameters generic.

Merge branch 'Gtk' into Gtk-Screen

gtk: Allow for specialization of fix-layout scrollbar behavior.

The new generic procedure fix-layout-adjustment-parameters allows
Edwin to customize scrolling.

gtk: load option SUBPROCESS, so main.scm can hook/subprocess-wait.

gtk-screen: Expose handler must not layout-line! during redraw-line!.

Renamed %layout-line! to emphasize that it should not be used without
interlocking with the expose handler, i.e. without without-interrupts.
Most calls are serialized by edwin-thread but the expose handler can
intervene (and likely WILL when running interpreted s-code), so all
calls should be without-interrupts, for now.

Punt exposing uninitialized lines.

Simplify the destruction of override text (a simple-text-ink) AND
ensure that it does not call %layout-line! via text-ink-pango-layout.

Unparse the symbol whose name is `.' as `|.|'.

Add a trivial test for it.

Found by Pavel Panchekha.

Merge branch 'Gtk' into Gtk-Screen

gtk: Document pango-layout-set-markup.  Fix many @brefs.

Define @bref{}'s as actual references ONLY in the HTML version, where
they can be hyperlinks to a binding's documentation.  Otherwise they
are just hyphenated names in @code style, except in Info.  In Info,
even single-quotes around these names is really too much.

gtk-screen: Crude face support using pango-layout-set-markup.

gtk-screen: merge for pango-layout-set-markup

gtk: Added pango-layout-set-markup.  Caught up documentation.

Merge branch 'Gtk' into Gtk-Screen

Merge branch 'master' into Gtk

microcode: Quiet some unused-but-set-variable warnings.

gtk-screen: Name i/o procedures.

Rename a testing procedure to agree with a cousin in Gtk.

gtk-screen: Merge with Gtk.

Eliminate some diffs between the Gtk and Gtk-Screen branches.

gtk: Update the time-slice window BEFORE sleeping.

Thus when the toolkit flames out, the time-slice window stops on the
list of file descriptors Scheme IS waiting on (NOT the descriptors it
WAS waiting on).