Changeset 9001 in project


Ignore:
Timestamp:
02/25/08 21:51:46 (12 years ago)
Author:
svnwiki
Message:

Changes applied for Vincent Manis (24.84.33.56) through svnwiki:

Corrected some typos, and other minor things.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/new-chapter1

    r8741 r9001  
    99
    1010''(This document describes version 3.0.0)'' TODO: the version number
    11 should be moved from here to the cover or index page. ''No, leave the Chicken version number on every manual page so that we know if a non-updated page exists. --John Cowan''
     11should be moved from here to the cover or index page. ''No, leave the
     12Chicken version number on every manual page so that we know if a
     13non-updated page exists. --John Cowan'' Agreed, it should be on EVERY
     14manual page. Also, it should be on the front cover. That suggests an
     15automated way of getting it there? If that's too complicated, I'd
     16suggest leaving it here AND putting it on the cover. -- vincent
    1217
    1318'''Chicken is a compiler that translates Scheme source files into
     
    188193can pretty much ignore the C compiler once you have installed it.)
    189194
    190 * On a Linux system, the GNU Compiler Collection ({{gcc}}) should be installed as part of the basic operating system.
    191 * On Macintosh OS X, you will need the XCode tools, which are shipped on the OS X DVD with recent versions of the operating system.  ''What about Fink or such?''
     195* On a Linux system, the GNU Compiler Collection ({{gcc}}) should be
     196  installed as part of the basic operating system.
     197* On Macintosh OS X, you will need the XCode tools, which are shipped
     198  on the OS X DVD with recent versions of the operating system.
     199  ''TODO: What about Fink or such? MacPorts would be the other case, I
     200  guess. Here we're talking about C compilers, so I'm not sure if
     201  people use the Fink or MacPorts gcc compilers.'' 
    192202* On Windows, you have four choices.
    193 ** Cygwin ([[http://sources.redhat.com/cygwin]]) provides a relatively full-featured Unix environment for Windows.
    194 ** The GNU Compiler Collection has been ported to Windows, in the MinGW system ([[http://mingw.sourceforge.net]]). Unlike Cygwin,  executables produced with MinGW do not need the Cygwin DLLs in order to run.
     203** Cygwin ([[http://sources.redhat.com/cygwin]]) provides a relatively
     204  full-featured Unix environment for Windows. 
     205** The GNU Compiler Collection has been ported to Windows, in the
     206  MinGW system ([[http://mingw.sourceforge.net]]). Unlike Cygwin,
     207  executables produced with MinGW do not need the Cygwin DLLs in order
     208  to run.   
    195209*** TODO: explain mingw build here
     210** MSys is a companion package to MinGW; it provides a minimum
     211  Unix-style development/build environment, again ported from free
     212  software.
    196213*** TODO: explain mingw-msys build here
    197 ** Microsoft Visual Studio will soon be supported, including the Express edition, which is a non-free but no-cost compiler suite available from Microsoft   ([[http://www.microsoft.com/express/vc]]). Chicken supports command-line building using the Microsoft C/C++ compiler.  Visual Studio users will want to install the Unix Utilities, available at  [[http://www.call-with-current-continuation.org/tarballs/UnxUtils.zip]], in order to get suitable versions of {{make}}, {tar}}, {{gzip}}, and similar commands.
     214** Microsoft Visual Studio will soon be supported, including the
     215  Express edition, which is a non-free but no-cost compiler suite
     216  available from Microsoft
     217  ([[http://www.microsoft.com/express/vc]]). Chicken supports
     218  command-line building using the command-line C/C++ compiler.
     219*** Visual
     220  Studio users will want to install the Unix Utilities, available at
     221  [[http://www.call-with-current-continuation.org/tarballs/UnxUtils.zip]],
     222  in order to get suitable versions of {{make}}, {{tar}}, {{gzip}}, and
     223  similar commands. 
     224
     225Refer to the {{README}} file for the version you're installing for
     226more information on the installation process.
    198227
    199228TODO: what's the least we can possibly say about PATH,
    200 CHICKEN_INCLUDE_PATH, DYLD_LIBRARY_PATH, etc?  ''The least we can say at this point is nothing at all.  Let's do that.''
     229CHICKEN_INCLUDE_PATH, DYLD_LIBRARY_PATH, etc?  ''The least we can say
     230at this point is nothing at all.  Let's do that.''
     231* ''Agreed: the previous paragraph is my substitute for this TODO,
     232which we can just delete.''
    201233
    202234=== Development environments
     
    220252might satisfy your needs.
    221253
    222 * Emacs ([[http://www.gnu.org/software/emacs]]) is available for Linux/Unix, Macintosh, and Windows systems; CHICKEN provides Emacs support out of the box, with the {{hen.el}} Emacs Lisp file. Consult the ``Emacs Guide for Chicken Users'' (TODO: this document doesn't exist yet) for information on setting up and using Emacs with Chicken.
     254* Emacs ([[http://www.gnu.org/software/emacs]]) is available for Linux/Unix, Macintosh, and Windows systems; CHICKEN provides Emacs support out of the box, with the {{hen.el}} Emacs Lisp file. Consult the `Emacs Guide for Chicken Users' (TODO: this document doesn't exist yet) for information on setting up and using Emacs with Chicken.
    223255
    224256* Epsilon ([[http://www.lugaru.com]]) is a commercial text editor whose design was   inspired by Emacs. Although Scheme support isn't provided,  a Lisp mode is available on Lugaru's FTP site, and could with some work be made to duplicate the Emacs support.
     
    226258* {{vim}} ([[http://www.vim.org]]) is a descendant of the venerable {{vi}} editor first included with Berkeley versions of Unix.  TODO: say more about using vim with Chicken, all I know about vi is that you can get out by typing :q! .
    227259
    228 TODO: other editors? Slick? Multi-Edit? Visual Studio? Eclipse? TextMate?  Please fill in anything you know about. Has somebody done a SchemeScript for Chicken?
     260TODO: other editors? Slick? Multi-Edit? Visual Studio? Eclipse? TextMate?  jEdit? some other editor? Please fill in anything you know about. Has somebody done a SchemeScript for Chicken?
    229261
    230262=== Using the interpreter
     
    313345program (TODO: insert xref).
    314346
    315 The program itself uses one of the libraries included with Chicken,
    316 the regular expression library, {{regex}}.
     347{{regex}}, the regular expression library, is one of the libraries
     348included with Chicken.
    317349
    318350 (use regex)
     
    351383the results into an executable file. (Note: in a Windows environment
    352384with Visual Studio, you may find that {{csc}} refers to Microsoft's
    353 C\# compiler. There are a number of ways of sorting this out, of which
     385C# compiler. There are a number of ways of sorting this out, of which
    354386the simplest is to make a Windows batch file named {{cshc.bat}} which
    355 invokes the Chicken compiler, and organize your {{PATH}} accordingly.)
     387invokes {{csc}} using its absolute path name, and
     388organize your {{PATH}} accordingly.)
    356389
    357390Compiled code can be intermixed with interpreted code on systems that
     
    402435
    403436Here's the external library. We {{declare}} that {{pal-proc}} is a
    404 ``unit'', which is the basis of separately-compiled modules in
     437`unit', which is the basis of separately-compiled modules in
    405438Chicken. (Units deal with separate compilation, but don't involve
    406439separated namespaces; namespaced module systems are available as
     
    528561Those who are interfacing to substantial C libraries should consider using the
    529562easyffi egg, or SWIG.
     563
Note: See TracChangeset for help on using the changeset viewer.