Commit 50801756 authored by anton's avatar anton

documentation updates

fixed some portability bugs in vmgen-ex and vmgen-ex2
updated copyright years
parent ee83c3f8
......@@ -2,7 +2,7 @@
#use this with parameters and env variables like "configure"
#Copyright (C) 2000,2002 Free Software Foundation, Inc.
#Copyright (C) 2000,2002,2003 Free Software Foundation, Inc.
#This file is part of Gforth.
......
......@@ -2,7 +2,20 @@ Copyright (C) 2003 Free Software Foundation, Inc.
This file is free documentation; the Free Software Foundation gives
unlimited permission to copy, distribute and modify it.
You need gcc version 2.0 or later to compile gforth.
Prerequisites
You need gcc version 2.0 or later to compile gforth. Recommended:
gcc-2.95.* (other versions produce slower code).
To use the new C interface, you need to install the ffcall libraries
before configuring Gforth. You can find them on
ftp://ftp.santafe.edu/pub/gnu/ffcall-1.8.tar.gz (USA)
ftp://ftp.ilog.fr/pub/Users/haible/gnu/ffcall-1.8.tar.gz (Europe)
Building and Installing
First, type
......@@ -87,18 +100,18 @@ hierarchy, say
Moreover, if your GCC is not called gcc (but, e.g., gcc-2.7.1), you
should say so during configuration. E.g.:
env CC=gcc-2.7.1 ./configure
./configure CC=gcc-2.7.1
You can also pass additional options to gcc in this way, e.g., if you
want to generate an a.out executable under Linux with gcc-2.7.0:
env "CC=gcc -b i486-linuxaout -V 2.7.0" ./configure
./configure CC="gcc -b i486-linuxaout -V 2.7.0"
You can change the sizes of the various areas used in the default
image `gforth.fi' by passing the appropriate Gforth command line
options in the FORTHSIZES environment variable:
env "FORTHSIZES=--dictionary-size=256k --data-stack-size=16k --fp-stack-size=15872b --return-stack-size=15k --locals-stack-size=14848b" ./configure
./configure "FORTHSIZES=--dictionary-size=256k --data-stack-size=16k --fp-stack-size=15872b --return-stack-size=15k --locals-stack-size=14848b"
The line above reaffirms the default sizes. Note that the locals
stack area is also used as input buffer stack.
......@@ -107,7 +120,7 @@ If C's "long long" do not work properly on your machine (i.e., if the
tests involving double-cell numbers fail), you can build Gforth such
that it does not use "long long":
env ac_cv_sizeof_long_long=0 ./configure
./configure ac_cv_sizeof_long_long=0
Cross-Installation
......@@ -212,4 +225,3 @@ INFOPATH=/usr/local/info:/usr/info
2. Create a file called 'dir' in 'usr/local/info'. Use the file
'/usr/info/dir' as a template. You can add the line for gforth
manually, or use '/sbin/install-info' (man install-info for details).
\ ADD.FS Kernal additional things 20may93jaw
\ Copyright (C) 1995,1996,1997,1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ ansi.fs Define terminal attributes 20may93jaw
\ Copyright (C) 1995,1996,1997,1998,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1998,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
......@@ -2,7 +2,7 @@
\ Copyright (C) 1992-2000 by Bernd Paysan
\ Copyright (C) 2000,2001 Free Software Foundation, Inc.
\ Copyright (C) 2000,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ four stack assembler 19jan94py
\ Copyright (C) 2000 Free Software Foundation, Inc.
\ Copyright (C) 2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Parameter for target systems 06oct92py
\ Copyright (C) 1995,1999,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,1999,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Copyright (C) 1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
/* cache flushing for the PPC
Copyright (C) 1998,2001 Free Software Foundation, Inc.
Copyright (C) 1998,2001,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
\ Parameter for target systems 06oct92py
\ Copyright (C) 1995,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
/*
This is the machine-specific part for Intel 386 compatible processors
Copyright (C) 1995,2000 Free Software Foundation, Inc.
Copyright (C) 1995,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
\ Parameter for target systems 06oct92py
\ Copyright (C) 1995,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ asmbasic.fs basic assebmler definitions
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ bitmask.fs Generic Bitmask compiler 13aug97jaw
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ generic.fs implements generic assembler definitions 13aug97jaw
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ numref.fs
\ Copyright (C) 1998,2001 Free Software Foundation, Inc.
\ Copyright (C) 1998,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ asm/target.fs
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ assertions
\ Copyright (C) 1995,1996,1997,1999,2002 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1999,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ BUFOUT.STR Buffered output for Debug 13jun93jaw
\ Copyright (C) 1995,1996,1997,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ chains.fs execution chains for gforth 21jun97jaw
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ colorize.fs Coloured .NAME and WORDS 20may93jaw
\ Copyright (C) 1995,1996,1997,1999,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1999,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Compare nonrelocatable images and produce a relocatable image
\ Copyright (C) 1996,1997,1998,2002 Free Software Foundation, Inc.
\ Copyright (C) 1996,1997,1998,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
@ECHO OFF
REM Copyright (C) 1995,1996,1997,1998,2000 Free Software Foundation, Inc.
REM Copyright (C) 1995,1996,1997,1998,2000,2003 Free Software Foundation, Inc.
REM
REM This file is part of Gforth.
REM
......
/*
Copyright (C) 1996,1997,1998,2000 Free Software Foundation, Inc.
Copyright (C) 1996,1997,1998,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
......@@ -21,12 +21,12 @@ dnl Process this file with autoconf to produce a configure script.
dnl We use some automake macros here,
dnl but don't use automake for creating Makefile.in
AC_INIT([gforth],[0.6.1-20030806],[https://savannah.gnu.org/bugs/?func=addbug&group=gforth])
AC_INIT([gforth],[0.6.2],[https://savannah.gnu.org/bugs/?func=addbug&group=gforth])
AC_PREREQ(2.54)
#snapshots have numbers major.minor.release-YYYYMMDD
#note that lexicographic ordering must be heeded.
#I.e., 0.4.1-YYYYMMDD must not exist before 0.4.1!
UPDATED="August 6, 2003"
UPDATED="August 25, 2003"
AC_SUBST(UPDATED)
AC_CONFIG_HEADERS(engine/config.h)
......
\ Simple debugging aids
\ Copyright (C) 1995,1997,1999,2002 Free Software Foundation, Inc.
\ Copyright (C) 1995,1997,1999,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
......@@ -762,16 +762,66 @@ signal. This option is useful when the engine and/or the image might be
severely broken (such that it causes another signal before recovering
from the first); this option avoids endless loops in such cases.
@cindex --no-dynamic, command-line option
@cindex --dynamic, command-line option
@item --no-dynamic
@item --dynamic
Disable or enable dynamic superinstructions with replication
(@pxref{Dynamic Superinstructions}).
@cindex --no-super, command-line option
@item --no-super
Disable dynamic superinstructions, use just dynamic replication; this is
useful if you want to patch threaded code (@pxref{Dynamic
Superinstructions}).
@cindex --ss-number, command-line option
@item --ss-number=@var{N}
Use only the first @var{N} static superinstructions compiled into the
engine (default: use them all; note that only @code{gforth-fast} has
any). This option is useful for measuring the performance impact of
static superinstructions.
@cindex --ss-min-..., command-line options
@item --ss-min-codesize
@item --ss-min-ls
@item --ss-min-lsu
@item --ss-min-nexts
Use specified metric for determining the cost of a primitive or static
superinstruction for static superinstruction selection. @code{Codesize}
is the native code size of the primive or static superinstruction,
@code{ls} is the number of loads and stores, @code{lsu} is the number of
loads, stores, and updates, and @code{nexts} is the number of dispatches
(not taking dynamic superinstructions into account), i.e. every
primitive or static superinstruction has cost 1. Default:
@code{codesize} if you use dynamic code generation, otherwise
@code{nexts}.
@cindex --ss-greedy, command-line option
@item --ss-greedy
This option is useful for measuring the performance impact of static
superinstructions. By default, an optimal shortest-path algorithm is
used for selecting static superinstructions. With @option{--ss-greedy}
this algorithm is modified to assume that anything after the static
superinstruction currently under consideration is not combined into
static superinstructions. With @option{--ss-min-nexts} this produces
the same result as a greedy algorithm that always selects the longest
superinstruction available at the moment. E.g., if there are
superinstructions AB and BCD, then for the sequence A B C D the optimal
algorithm will select A BCD and the greedy algorithm will select AB C D.
@cindex --print-metrics, command-line option
@item --print-metrics
Prints some metrics used during static superinstruction selection:
@code{code size} is the actual size of the dynamically generated code.
@code{Metric codesize} is the sum of the codesize metrics as seen by
static superinstruction selection; there is a difference from @code{code
size}, because not all primitives and static superinstructions are
compiled into dynamically generated code, and because of markers. The
other metrics correspond to the @option{ss-min-...} options. This
option is useful for evaluating the effects of the @option{--ss-...}
options.
@end table
@cindex loading files at startup
......
\ create a documentation file
\ Copyright (C) 1995,1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ dotx.fs a always (simple) hexadecimal .s
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ nesting.fs displays nesting for primitive trace 12jun97jaw
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ shex.fs Output Routines for Motorola S-Records 16jul97jaw
\ Copyright (C) 1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ ekey etc.
\ Copyright (C) 1999,2002 Free Software Foundation, Inc.
\ Copyright (C) 1999,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
/* replacement for asinh, acosh, and atanh */
/*
Copyright (C) 1996,2000 Free Software Foundation, Inc.
Copyright (C) 1996,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* alignment-clean replacements for library functions
Copyright (C) 1995,1997,2000 Free Software Foundation, Inc.
Copyright (C) 1995,1997,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* some routines for double-cell arithmetic
only used if BUGGY_LONG_LONG
Copyright (C) 1996,2000 Free Software Foundation, Inc.
Copyright (C) 1996,2000,2003 Free Software Foundation, Inc.
* Copyright (C) 1995 Dirk Uwe Zoller
*
* This library is free software; you can redistribute it and/or
......
/* direct key io driver
Copyright (C) 1995,1996,1997,1998,1999,2002 Free Software Foundation, Inc.
Copyright (C) 1995,1996,1997,1998,1999,2002,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* a memcmp implementation
Copyright (C) 1995,1998,2000 Free Software Foundation, Inc.
Copyright (C) 1995,1998,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* a memmove implementation
Copyright (C) 1995,1998,2000 Free Software Foundation, Inc.
Copyright (C) 1995,1998,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* Peephole optimization routines and tables
Copyright (C) 2001,2002 Free Software Foundation, Inc.
Copyright (C) 2001,2002,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* a simple pow10 implementation
Copyright (C) 1995,1998,2000 Free Software Foundation, Inc.
Copyright (C) 1995,1998,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* VM profiling support stuff
Copyright (C) 2001,2002 Free Software Foundation, Inc.
Copyright (C) 2001,2002,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* select replacement for DOS computers for ms only
Copyright (C) 1995,1998,2000 Free Software Foundation, Inc.
Copyright (C) 1995,1998,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* a strerror implemenation
Copyright (C) 1995,2000 Free Software Foundation, Inc.
Copyright (C) 1995,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
/* a strsignal implementation
Copyright (C) 1995,2000 Free Software Foundation, Inc.
Copyright (C) 1995,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
\ envos.fs set os-specific environmental queries 07jul97jaw
\ Copyright (C) 1997,2000 Free Software Foundation, Inc.
\ Copyright (C) 1997,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ envos.fs set os-specific environmental queries 07jul97jaw
\ Copyright (C) 1997,1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1997,1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ envos.fs set os-specific environmental queries 07jul97jaw
\ Copyright (C) 1997,2000 Free Software Foundation, Inc.
\ Copyright (C) 1997,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Etags support for GNU Forth.
\ Copyright (C) 1995,1998,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,1998,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
......@@ -2,7 +2,7 @@
\ first n arguments. Gforth is restarted to create an exception frame
\ for the exception handler.
\ Copyright (C) 2000,2001 Free Software Foundation, Inc.
\ Copyright (C) 2000,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Convert image to C include file
\ Copyright (C) 1998,1999,2002 Free Software Foundation, Inc.
\ Copyright (C) 1998,1999,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
#! /usr/local/lib/gforth/0.2.0/kernel.fi
\ file hex dump
\ Copyright (C) 1997,2002 Free Software Foundation, Inc.
\ Copyright (C) 1997,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
REM @ECHO OFF
REM Copyright (C) 1997-1998,2000 Free Software Foundation, Inc.
REM Copyright (C) 1997-1998,2000,2003 Free Software Foundation, Inc.
REM This file is part of Gforth.
......
/*
Copyright 1997,2000 Free Software Foundation, Inc.
Copyright 1997,2000,2003 Free Software Foundation, Inc.
This file is part of Gforth.
......
#! /bin/sh
# @configure_input@
#Copyright (C) 1997,1998,2000,2002 Free Software Foundation, Inc.
#Copyright (C) 1997,1998,2000,2002,2003 Free Software Foundation, Inc.
#This file is part of Gforth.
......@@ -33,7 +33,7 @@ if test $# = 0 || test $1 = --help || test $1 = -h; then
elif test $1 = --version || test $1 = -v; then
echo "gforthmi (@PACKAGE_NAME@) @PACKAGE_VERSION@"
$GFORTH --version
echo 'Copyright (C) 1998,2002 Free Software Foundation, Inc.'
echo 'Copyright (C) 1998,2002,2003 Free Software Foundation, Inc.'
echo 'This program is part of Gforth'
$GFORTH -e "license bye"
exit 0
......
......@@ -3,7 +3,7 @@
\ This file is part of Gforth.
\ Copyright (C) 1995,1997,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1997,2000,2003 Free Software Foundation, Inc.
\ Copyright (c)1993 L.C. Benschop Eindhoven.
\ Gforth is free software; you can redistribute it and/or
......
\ recursive descent parser generator )
\ Copyright (C) 1995,1996,1997,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,2000,2003 Free Software Foundation, Inc.
\ Copyright 1990, 1991, 1994 Martin Anton Ertl
\ This program is free software; you can redistribute it and/or modify
......
#! /usr/local/bin/gforth
\ Copyright (C) 2000,2002 Free Software Foundation, Inc.
\ Copyright (C) 2000,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ defining words for words with non-default and non-immediate compilation semantics
\ Copyright (C) 1996,1997,2000 Free Software Foundation, Inc.
\ Copyright (C) 1996,1997,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ run-time routine headers
\ Copyright (C) 1997,1998,2002 Free Software Foundation, Inc.
\ Copyright (C) 1997,1998,2002,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Structural Conditionals, based on branches 12dec92py
\ Copyright (C) 1995,1996,1997,1999,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1999,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Structural Conditionals, branches with plugins 10May99jaw
\ Copyright (C) 1995-1997,1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995-1997,1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Structural Conditionals, loops part 12dec92py
\ Copyright (C) 1995,1996,1997,1999,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1999,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Structural Conditionals, loops no extra (?do) 10May99jaw
\ Copyright (C) 1995-1997,1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995-1997,1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ Structural Conditionals 12dec92py
\ Copyright (C) 1995,1996,1997,1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ run-time code for defining words
\ Copyright (C) 1995,1996,1997,1998,1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1998,1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ ERRORE.FS English error strings 9may93jaw
\ Copyright (C) 1995,1996,1997,1998,1999,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1998,1999,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ kernel.fs this is a master include file for the kernel sources 2may97jaw
\ Copyright (C) 1995,1996,1997,1998,1999,2001 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1998,1999,2001,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ print license
\ Copyright (C) 1995,1996,1997,1998,2000 Free Software Foundation, Inc.
\ Copyright (C) 1995,1996,1997,1998,2000,2003 Free Software Foundation, Inc.
\ This file is part of Gforth.
......
\ pass.fs pass pointers from cross to target 20May99jaw
\ Copyright (C)