[PATCH]preface.texi (Manual Layout)

[Stephen Compall]

I would have done a text workup along with the syntax bits I did, but
decided it wouldn't really help that much.  But if you think revising
the text would be useful, I'd be happy to look it over.

2003-11-11  Stephen Compall  <address@hidden>

        * preface.texi (Manual Layout): Wrap POSIX, API, and SLIB in
        @acronym.

        Change from paragraph format (somewhat clumsy-looking on
        paper, at least) to @table format, with headers @strong.

        Made example modules complete sentences.

Snag the patch at
http://csserver.evansville.edu/~sc87/dist/Manual-Layout-1sirian.patch

Here is the Info output, though you really can't see *most* of the
changes I made there:


Layout of this Manual
*********************

   The manual is divided into five parts.

*Part I: Introduction to Guile*
     Provides an overview of what Guile is and how you can use it.  A
     whirlwind tour shows how Guile can be used interactively and as a
     script interpreter, how to link Guile into your own applications,
     and how to write modules of interpreted and compiled code for use
     with Guile.  Everything introduced here is documented again and in
     full by the later parts of the manual.  This part also explains
     how to obtain and install new versions of Guile, and how to report
     bugs effectively.

*Part II: Writing and Running Guile Scheme*
*Part III: Programming with Guile*
     Document all aspects of practical programming using Guile.  This
     covers both the Scheme level -- where we provide an introduction to
     the key ideas of the Scheme language -- and use of Guile's `scm'
     interface to write new primitives and objects in C, and to
     incorporate Guile into a C application.  It also covers the use of
     Guile as a POSIX-compliant script interpreter and how to use the
     Guile debugger.

*Part IV: Guile API Reference*
     Documents Guile's core API.  Most of the variables and procedures
     in Guile's core programming interface are available in both Scheme
     and C and are related systematically such that the C interface can
     be inferred from the Scheme interface and vice versa.  Therefore,
     this part of the manual documents the Guile API in
     functionality-based groups with the Scheme and C interfaces
     presented side by side.  Where the Scheme and C interfaces for a
     particular functional area do differ -- which is sometimes
     inevitable, given the differences in the structure of the two
     languages -- this is pointed out and explained.  In all cases the
     overriding principle is that all the reference documentation for a
     given functional area is grouped together.

*Part V: Guile Modules*
     Describes some important modules, distributed as part of the Guile
     distribution, that extend the functionality provided by the Guile
     Scheme core.  Two important examples are:

        * The POSIX module, which provides Scheme-level procedures for
          system and network programming that conform to the POSIX
          standard.

        * The SLIB module, which makes Aubrey Jaffer's portable Scheme
          library available for use in Guile.


--
Stephen Compall or s11 or sirian

The eye is a menace to clear sight, the ear is a menace to subtle hearing,
the mind is a menace to wisdom, every organ of the senses is a menace to its
own capacity. ...  Fuss, the god of the Southern Ocean, and Fret, the god
of the Northern Ocean, happened once to meet in the realm of Chaos, the god
of the center.  Chaos treated them very handsomely and they discussed together
what they could do to repay his kindness.  They had noticed that, whereas
everyone else had seven apertures, for sight, hearing, eating, breathing and
so on, Chaos had none.  So they decided to make the experiment of boring holes
in him.  Every day they bored a hole, and on the seventh day, Chaos died.
                -- Chuang Tzu

David John Oates Marxist Ft. Bragg csystems ASIO Mole Crowell SCUD
missile cryptanalysis S Key AIEWS tempest Crypto AG Watergate
terrorism