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.

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

gtk: Added gtk-paned-get-position, gtk-paned-set-position.

gtk: Added GtkPanedView, a specialized GtkPaned.

gtk: Remove deprecated functions: g_value_get_char, g_thread_init...

gtk: Update to Gtk+3.6.  Separate GtkScrolledWindow and GtkScrolledView.

Rename GtkScrollingWindow to GtkScrolledView and fix it to work with
Gtk+3.6.0 (in Ubuntu 12.10).  Create distinct classes for
GtkScrolledWindow and GtkScrolledView.  The former might be useful to
someone else, and substituting the latter for the former just invites
confusion.

Report a meaningful error message if the TUTORIAL file is hosed.

Do not remove a gtk-paned's child if it is destroyed.

If it is destroyed, it has already been removed (from the list of
children).

Init a <fix-layout>'s viewport size before it is realized.

Punt redundant code in the realize callback.  Initializing the size
early allows the view (scroll position) to be set whether the widget
is realized or not.

Fixed the Gtk tests to access the final malloced-aliens list.

Added gtk-widget-queue-resize and gtk-widget-queue-resize-no-redraw.

Merge branch 'master' into Gtk

Support callout struct and union parameter and return types.

Requested by Peter Feigl <craven@gmx.net>.

Update old "package: (ffi syntax)" comments.

Do not setsid() just because of --batch-mode.

Commit 6b474c5 has turned --batch-mode into something like a
--background option, ensuring that setsid() is called.  Re-worked the
logic so that tty interrupt characters are not frobbed in batch-mode
AND setsid() is not called (except according to the curious but
ancient heuristic/default: when there is no tty on stdin, stderr and
stdout and no --emacs option).

Work around broken IMAP servers that give bogus responses to FETCH.

Tidy up local declarations in DEFINE_BIT_COUNT.

`static' is pointless (and causes `gcc -O0' to actually allocate
static storage for them), and using uintmax_t rather than TYPE is
overkill.

Fix some ignored variable warnings in swank.scm.

Add BIT, BITS, SHIFTIN, and SHIFTOUT, for handily hacking bit fields.

Fix READ-PACKET in swank.scm to cope with partial reads.

Thanks, ecraven.

Merge branch 'master' into Gtk

Punt deprecated gdk_window_get_pointer.

Added <gtk-paned>, gtk-grid-attach-next-to.  Punted fix-resizer.

Also added gtk-orientable-get-orientation, just for completeness, and
documented cairo-clip-extents.

Support new location of Xcode 4.3 and later; just warn if can't find SDKs directory.

Integrate CALLER argument in guarantees.

gtk: Fix layout-draw-callback's level 2 trace report of cairo clip.

String-append don't take no numbers.

Remove handle-subprocess-status-change from nonblocking/subprocess-

wait.  Block-on-process-status-change has just continued because
handle-subprocess-status-change was just called; don't call it again.

Move maybe-signal-io-thread-events apply out of yield-thread.

Moved the call to yield-current-thread.  It is otherwise redundant
with all the i/o and timer event polling in thread-timer-interrupt-
handler, the other caller of yield-thread.

Fix test-select-descriptor, test-select-registry.

Both test-select- primitives (in uxio.c) now return 0 only if there
are no INTERRUPTs nor PROCESS-STATUS-CHANGEs pending.  A previous
attempt at this was incomplete or wrong (e.g. not spinning on
interrupted calls when interrupts are masked).

gtk: Vanquish spinning gtk-thread evil (again).

tests/runtime/test-gtk spins like crazy again.  With a gtk-thread
always ready to run and no thread waiting for io, wait-for-io is never
called and maybe-signal-io-thread-events never blocks.  Unfortunately
test-select-registry always returned INTERRUPT for non-blocking
selects with an empty registry.  It needs to return PROCESS-STATUS-
CHANGE when there is a pending process status change so that handle-
subprocess-status-change runs.  Thus OS_pause got a new argument:
blockp.  In uxio.c it can call OS_process_any_status_change and
return PROCESS-STATUS-CHANGE when necessary.

Merge branch 'master' into Gtk

Remove last remnants of SEQUENCE-3.  Rename return code for sequence-2 to sequence-continue.