Merge branch 'master' into Gtk

Fix for fix for bug #36887: return '() from IGNORABLE parser.

The tail expr was accidentally deleted in the previous commit.

Fix for bug #36887: Ignore a free variable and sf fails.

Ignoring a free variable now just causes a warning (and names the variable).

Don't setsid Scheme.

If you want to detach from the controlling terminal, use a trivial
wrapper program that calls setsid and then exec (e.g., pgrphack from
daemontools), or add a primitive to Scheme to daemonize without race
conditions.

Hitting ^C at the terminal now works to interrupt Scheme in batch
mode, e.g. when run under make during the build.

Merge branch 'master' into Gtk

compiler: Don't let continuation-analysis add a cycle...

...to the block tree, which it would do (causing a "maximum recursion
depth exceeded" abort during block->dbg-block) when compiling crazy
code like:

      (define (fubar param)
(define (closure) param)
(define (loop)
  (closure)
  (loop)
  ;; It doesn't break without this
  (tail-call)))
      (fubar sumpn)

This patch checks that the "Acceptable substitute" for a block's
stack-link is not inside the block.

Missed a dependency: edwin needs win32 syntaxed first.

Put build-ffis back in the native build.

Merge branch 'master' into Gtk

Revert tterm.c changes.

tterm.c is not used when not USE_TERMCAP, so these old changes are
unnecessary... and potentially confusing.

Add configure option `--without-termcap'.

Punt the termcap primitives (all of microcode/tterm.c!) if configured
--with-termpcap=no.  The console port ops like clear and x-size were
already equipped with useful(?) defaults.  In fact Edwin (on X11)
still works!

Merge branch 'make-jobs'

Reduce loading verbiage in compile-imail and compile-xml targets.

Their respective compile.scm scripts load everything anyway.

Split compile-edwin target into syntax-edwin/compile-edwin.

Split compile-runtime target into syntax-runtime and compile-runtime.

Dependents of runtime-*.pkd for cref need only syntax-runtime.
Increases parallelism.

Generate an intermediate lib/compiler.com.

We stopped installing this ages ago and hence stopped building it,
but now that each subdirectory is built in a separate process, it's
useful to avoid reloading the compiler repeatedly during the build.

First stab at making top-level makefile jobs-safe for native builds.

This enables coarse-grained parallelization of the build.  There's a
nontrivial amount of crap encoded in the makefile about how to do the
build, but that's better than the nontrivial amount of dependency
crap implied by the total ordering in etc/compile.scm, most of which
can go away once the liarc and svm builds are converted similarly.

This does not restructure the build; we still have various bootstrap
and staging botches going on which we need to get rid of.  Fixing
those nicely will require some changes to liar and sf so that we can
compile a fresh compiler into a subdirectory, say `boot', using the
host compiler, and then use that to compile the system.  Liarc
approximates that with the `boot-root' installation prefix, but that
kludge breaks incremental builds which means we never, ever try to
touch the liarc build because the turnaround time is too painful.

doc: open-tcp-stream-socket

This procedure no longer has buffer-size and line-translation parameters.
Thanks to nick.f.russell@gmail.com for noticing this.

doc: accommodate texinfo 5.1

Thanks to Charles Moss <czm>.

Merge branch 'master' into Gtk

Temporarily: inform older hosts about new type code SEQUENCE.

Like d4d8ea1 this patch allows the released 9.1.1 (LIAR/C
distribution) to compile the compiler.  Without it, make-liarc-dist.sh
fails.  It seems the hack in d4d8ea1 is saved in a native
x-runtime.com but not in a LIAR/C-based x-runtime.com. ?

Don't add empty arguments to -I and -L if pg_config fails.

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 '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.

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

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.

planetarium: Replace "tellurian" with "tellurion".

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 '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: Punt tests if no errors or DISPLAY not set.

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: 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.

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

Add a trivial test for it.

Found by Pavel Panchekha.

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: Added pango-layout-set-markup.  Caught up documentation.

Merge branch 'master' into Gtk

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