Thread: [pure-lang-svn] SF.net SVN: pure-lang: [29] pure/trunk/README
Status: Beta
Brought to you by:
agraef
Menu
▾
▴
pure-lang-svn
|
From: <ag...@us...> - 2008-05-02 07:09:14
|
Revision: 29
http://pure-lang.svn.sourceforge.net/pure-lang/?rev=29&view=rev
Author: agraef
Date: 2008-05-02 00:09:21 -0700 (Fri, 02 May 2008)
Log Message:
-----------
Updated README.
Modified Paths:
--------------
pure/trunk/README
Modified: pure/trunk/README
===================================================================
--- pure/trunk/README 2008-05-02 07:03:42 UTC (rev 28)
+++ pure/trunk/README 2008-05-02 07:09:21 UTC (rev 29)
@@ -44,14 +44,18 @@
be changed at runtime by setting corresponding environment variables, see the
manpage for details).
-You can (and should) also run 'make check' to verify that your Pure
-interpreter works correctly. This can be done without installing the software.
-In fact, there's no need to install the interpreter if you just want to take
-it for a test drive, you can simply run it from the source directory. Just
-make sure that you set the PURELIB environment variable to the lib directory
-in the sources which holds the prelude and the other library scripts. The
-following command,
+There are a number of other variables you can set on the 'make' command line
+if you need special compiler (CXXFLAGS) or linker flags (LDFLAGS), or if you
+have to add special libraries (LIBS) like libiconv on OSX.
+After your build is done, you can (and should) also run 'make check' to verify
+that your Pure interpreter works correctly. This can be done without
+installing the software. In fact, there's no need to install the interpreter
+if you just want to take it for a test drive, you can simply run it from the
+source directory. Just make sure that you set the PURELIB environment variable
+to the lib directory in the sources which holds the prelude and the other
+library scripts. The following command,
+
PURELIB=./lib ./pure
will run the Pure interpreter with that setting in Bourne-compatible shells.
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
|
From: <ag...@us...> - 2008-05-25 06:06:08
|
Revision: 130
http://pure-lang.svn.sourceforge.net/pure-lang/?rev=130&view=rev
Author: agraef
Date: 2008-05-24 23:06:17 -0700 (Sat, 24 May 2008)
Log Message:
-----------
Add comment about licensing of examples.
Modified Paths:
--------------
pure/trunk/README
Modified: pure/trunk/README
===================================================================
--- pure/trunk/README 2008-05-25 05:42:48 UTC (rev 129)
+++ pure/trunk/README 2008-05-25 06:06:17 UTC (rev 130)
@@ -19,7 +19,10 @@
LICENSE
-GPL V3 or later. See the accompanying COPYING file for details.
+GPL V3 or later. See the accompanying COPYING file for details. Note that the
+sample scripts in the examples subdir, even though they are bundled with the
+sources, are considered to be in the public domain, so feel free to use them
+for whatever purpose.
INSTALLATION
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
|
From: <ag...@us...> - 2008-06-14 00:32:31
|
Revision: 215
http://pure-lang.svn.sourceforge.net/pure-lang/?rev=215&view=rev
Author: agraef
Date: 2008-06-13 17:32:38 -0700 (Fri, 13 Jun 2008)
Log Message:
-----------
Update installation instructions.
Modified Paths:
--------------
pure/trunk/README
Modified: pure/trunk/README
===================================================================
--- pure/trunk/README 2008-06-14 00:27:15 UTC (rev 214)
+++ pure/trunk/README 2008-06-14 00:32:38 UTC (rev 215)
@@ -38,10 +38,11 @@
Pure scripts are just ordinary text files, which can be created with any text
editor. The source directory contains Pure syntax highlighting files for Kate
-and Vim (no Emacs mode yet, sorry). You might wish to install these into your
-katepart/syntax and .vim/syntax directories, respectively. (For Vim you also
-need to enable the syntax highlighting for .pure files; see the comments at
-the beginning of pure.vim for details.)
+and Vim, as well as an Emacs mode which allows you to run the interpreter in
+an Emacs buffer. You might wish to install these into your katepart/syntax,
+.vim/syntax and Emacs site-lisp directories, respectively. (The Emacs and Vim
+modes must also be enabled in your corresponding startup files; see the
+comments at the beginning of pure-mode.el and pure.vim for details.)
See the manpage ('man pure' after installation) for information on how to use
the interpreter and a brief description of the Pure language. Some example
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
|
From: <ag...@us...> - 2008-06-14 22:24:18
|
Revision: 234
http://pure-lang.svn.sourceforge.net/pure-lang/?rev=234&view=rev
Author: agraef
Date: 2008-06-14 15:24:26 -0700 (Sat, 14 Jun 2008)
Log Message:
-----------
Update usage instructions.
Modified Paths:
--------------
pure/trunk/README
Modified: pure/trunk/README
===================================================================
--- pure/trunk/README 2008-06-14 20:58:03 UTC (rev 233)
+++ pure/trunk/README 2008-06-14 22:24:26 UTC (rev 234)
@@ -1,5 +1,6 @@
PURE - The Pure programming language.
+==== = ==============================
Pure is a functional programming language based on term rewriting. It has a
modern syntax featuring curried function applications, lexical closures and
@@ -14,11 +15,13 @@
be done.
WHERE TO GET IT
+----- -- --- --
You can find tarballs, binary packages and the svn repository at
http://pure-lang.sf.net.
LICENSE
+-------
GPL V3 or later. See the accompanying COPYING file for details. Note that the
sample scripts in the examples subdir, even though they are bundled with the
@@ -26,6 +29,7 @@
for whatever purpose.
INSTALLATION
+------------
Please see the INSTALL file for detailed instructions. On most Unix-like
systems, the usual './configure && make && sudo make install' should do the
@@ -35,23 +39,64 @@
instructions for installing LLVM are also included in the INSTALL file.
USING PURE
+----- ----
+To start the Pure interpreter, just type 'pure' at the command prompt. You'll
+be greeted with a sign-on message, after which the interpreter leaves you at
+its prompt and you can start typing definitions and expressions to be
+evaluated. Use the 'quit' command to exit the interpreter (on Unix systems you
+can also just type EOF a.k.a. Ctrl-D at the beginning of the interpreter's
+command line). For instance:
+
+Pure 0.4 (i686-pc-linux-gnu) Copyright (c) 2008 by Albert Graef
+This program is free software distributed under the GNU Public License
+(GPL V3 or later). Please see the COPYING file for details.
+Loaded prelude from /usr/local/lib/pure-0.4/prelude.pure.
+
+> fact n = if n>0 then n*fact (n-1) else 1;
+> map fact (1..10);
+[1,2,6,24,120,720,5040,40320,362880,3628800]
+> quit
+
+Of course, you can also put your definitions into a script and run that script
+from the command line:
+
+$ pure -x factorial.pure
+
+Add the -i option to force interactive mode when executing a script, and -q to
+suppress the sign-on message:
+
+$ pure -i -q -x factorial.pure
+>
+
Pure scripts are just ordinary text files, which can be created with any text
-editor. The source directory contains Pure syntax highlighting files for Kate
-and Vim, as well as an Emacs mode which allows you to run the interpreter in
-an Emacs buffer. You might wish to install these into your katepart/syntax,
-.vim/syntax and Emacs site-lisp directories, respectively. (The Emacs and Vim
-modes must also be enabled in your corresponding startup files; see the
-comments at the beginning of pure-mode.el and pure.vim for details.)
+editor. For Emacs users, the most convenient way to edit and run Pure scripts
+is Emacs Pure mode which works with both GNU Emacs and XEmacs. You'll have to
+install the pure-mode.el file from the Pure source directory into your Emacs
+site-lisp directory, and enable the mode in your .emacs file as explained at
+the beginning of the pure-mode.el file. Then you can just open and edit a Pure
+script in Emacs, and run it inside an Emacs buffer with Ctrl-C Ctrl-C. Syntax
+highlighting, auto-indentation and command line completion are also supported.
-See the manpage ('man pure' after installation) for information on how to use
-the interpreter and a brief description of the Pure language. Some example
-programs can be found in the examples subdir in the sources; in particular,
-have a look at the hello.pure program which will quickly give you an idea how
-Pure programs look like. You should also browse the scripts in the lib
-directory which contain the "built-in" definitions readily available when you
-start up the Pure interpreter.
+The source directory also contains Pure syntax highlighting files for Kate and
+Vim. You can install these into your .kde/share/apps/katepart/syntax and
+.vim/syntax directories, respectively. (The Vim mode must also be enabled in
+your vim startup file; see the comments at the beginning of pure.vim for
+details.)
+Online documentation is available as a manpage, which contains detailed
+information on how to use the interpreter and a brief description of the Pure
+language. You can invoke the manpage with 'man pure' after installation, or
+using the 'help' command inside the interpreter, or with Emacs' built-in
+manpage reader (the 'help' command won't work if the interpreter is running
+inside an Emacs buffer).
+
+Some example programs can be found in the examples subdir in the sources; in
+particular, have a look at the hello.pure program which will quickly give you
+an idea how Pure programs look like. You should also browse the scripts in the
+lib directory which contain the "built-in" definitions readily available when
+you start up the Pure interpreter.
+
This is currently all you get; more elaborate documentation of the Pure
language still needs to be written. But Pure is a really simple language; if
you have some experience using FPLs then you should be able to find your way
@@ -60,7 +105,6 @@
Enjoy! :)
-AUTHOR
Albert Graef
Dept. of Computer Music
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
|
From: <ag...@us...> - 2008-06-21 07:00:32
|
Revision: 273
http://pure-lang.svn.sourceforge.net/pure-lang/?rev=273&view=rev
Author: agraef
Date: 2008-06-20 15:29:34 -0700 (Fri, 20 Jun 2008)
Log Message:
-----------
Remove 'preliminary' disclaimer.
Modified Paths:
--------------
pure/trunk/README
Modified: pure/trunk/README
===================================================================
--- pure/trunk/README 2008-06-20 20:02:58 UTC (rev 272)
+++ pure/trunk/README 2008-06-20 22:29:34 UTC (rev 273)
@@ -10,10 +10,6 @@
has an LLVM backend to do JIT compilation, hence programs run blazingly fast
and interfacing to C modules is easy.
-Please note that this is a preliminary, "beta" release, so please report bugs
-to the author. Also have a look at the TODO file for stuff that still needs to
-be done.
-
WHERE TO GET IT
----- -- --- --
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
×
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.
Thanks for helping keep SourceForge clean.
X