summaryrefslogtreecommitdiff
path: root/web/fweb
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /web/fweb
Initial commit
Diffstat (limited to 'web/fweb')
-rw-r--r--web/fweb/READ_ME129
-rw-r--r--web/fweb/READ_ME-1.6x75
2 files changed, 204 insertions, 0 deletions
diff --git a/web/fweb/READ_ME b/web/fweb/READ_ME
new file mode 100644
index 0000000000..17c6130dc8
--- /dev/null
+++ b/web/fweb/READ_ME
@@ -0,0 +1,129 @@
+ --- FWEB PUBLIC FILES ---
+ Last update: September 23, 1998
+
+FWEB is a literate programming tool that works in conjunction with LaTeX.
+The concept of literate programming was invented by Donald Knuth, and
+implemented by him in his original WEB for Pascal, which he used to
+document TeX. FWEB is based on an early version (0.5) of Silvio Levy's
+CWEB. The 'F' stands for Fortran (which motivated the initial
+development), but FWEB now supports multiple-language programming in C,
+C++, Fortran, Ratfor, and TeX.
+
+FWEB is a SPARE-TIME ACTIVITY. It was developed in a quasi-academic
+environment at the Plasma Physics Laboratory of Princeton University
+(sponsored by the U.S. Dept. of Energy) in order to support various
+computational projects in plasma turbulence and fusion research. With
+continuing cuts in U.S. fusion research funding, that environment and the
+laboratory are under great pressure. This implies that FWEB support for
+the foreseeable future will be spotty at best. Suggestions and bug reports
+are still very welcome; the future direction of FWEB is considerably
+influenced by these.
+
+Unfortunately, because of my primary professional responsibilities I am no
+longer able to consistently answer questions about how to use FWEB. Please
+first make a serious attempt to find the answer in the on-line info
+documentation. If that fails, address questions to the fweb-users mailing
+list (which, of course, I do read). See NOTICE dated Sept. 25, 1995 below.
+
+Please address all correspondence about suggestions and bug reports to
+
+ krommes@princeton.edu
+
+These may not be acknowledged individually, but each one is definitely studied.
+
+A companion file READ_ME-?.?? introduces the most recent release in more
+detail.
+
+
+IMPORTANT NOTICES (most recent first):
+
+===============================================================================
+
+NOTICE (September 23, 1998): fweb-1.61 is available from
+
+ ftp.pppl.gov:/pub/fweb/fweb-1.61.tar.gz.
+
+fweb-1.61 is just fweb-1.60 with a variety of bug fixes.
+
+Because of extended travel, there may be no support for problems with this
+release until December, 1998, so upgrade with care.
+
+NOTICE (March 18, 1998): The promised release of fweb-1.60 hasn't happened
+yet. The next shot I have at doing so will be mid-May. Meanwhile, the tar
+file for fweb-1.53 has been restored.
+
+NOTICE (January 9, 1998): ``fweb-1.60'' will soon be available.
+ In preparation, all tar files have been temporarily removed.
+ The `beta' has been removed from 1.60-beta. This version should be
+robust, and it's probably safe to upgrade. The next planned major release
+is fweb-2.00, expected around January 1, 2000.
+
+NOTICE (January 1, 1998): FAQ disappears
+ The FWEB FAQ, which was an independent user activity, seems to have
+disappeared. Please consult the on-line documentation.
+
+NOTICE (January 1, 1997): ``fweb-1.60-beta'' is available.
+ This version fixes various bugs. It also implements some support for
+large projects involving multiple web source files.
+ If you are happy with the behavior of your present FWEB installation, I
+do not recommend that you bother to upgrade just yet. Of course, tests by
+patient pioneers are always welcome.
+
+NOTICE (September 25, 1995): ``Using the FWEB mailing lists''
+ To learn about the commands you can use with the FWEB mailing lists (see
+notice below), send a message to `majordomo@pppl' with the single word
+`help' in the body of the message.
+ Messages sent to the FWEB mailing lists are archived in
+ftp.pppl.gov:/pub/fweb/archive/fweb-{users,installers}.archive. You can
+obtain these by sending a message of the form, e.g., `get
+fweb-users.archive' to `majordomo@pppl.gov', or by anonymous ftp.
+
+NOTICE (September 23, 1995): ``fweb-1.53.tar.Z regenerated''
+ fweb-1.53.tar.Z was regenerated to fix the following minor problems:
+ * The Makefile didn't install fweb.info-7.
+ * A warning about `disgarded const' in style.c (interpreted as an
+error by some compilers) was removed.
+ * Paths related to the `-H' option weren't always processed correctly.
+
+NOTICE (September 22, 1995): ``fweb-1.53 is available''
+ fweb-1.53 is available, including executable files for the IBM-PC. See
+READ_ME-1.5x for more details.
+
+NOTICE (September 21, 1995): ``Obtaining FWEB information''
+ The FWEB info documentation is available on the World Wide Web from
+
+ http://w3.pppl.gov/~krommes/fweb_toc.html
+
+ The FWEB FAQ is available from
+
+ http://www.arsc.sunyit.edu/fwebdocs/fweb.html
+
+ You may subscribe to one or both of the mailing lists `fweb-users' and
+`fweb-installers'. Send e-mail to `majordomo@pppl.gov'. In the body of
+the message, say, e.g.,
+
+ subscribe fweb-users
+
+NOTICE (May 1, 1995): ``fweb-1.50 is available''
+
+ FWEB version 1.50 is available. This is an incremental release in order
+to provide support for LaTeX2e in native mode. Many, although by no means
+all, bugs reported with previous releases have been fixed. For more
+information about v1.50, please see READ_ME-1.50.
+
+ Version 1.30, which for several years has been declared to be the stable
+version of choice, is gradually getting out of date. I now recommend that
+current users try VERY, VERY CAUTIOUSLY to upgrade to v1.50. Don't do that
+the week before a critical deadline.
+
+ Because I am currently on research leave (until summer of 1995),
+FWEB-related time has been very scarce. Therefore, FWEB-1.50 is a somewhat
+stripped-down version that is missing the collection of demos and
+voluminous documentation that had accreted over the years, so it may not be
+appropriate for new users. Demos will be reinstated later as they are
+upgraded. Documentation is now maintained exclusively in texinfo format.
+Testing on personal computers and other non-standard machines will
+eventually be done, but not for at least some months. However, if you have
+a standard Unix environment, you should not have too many problems.
+
+ A list of important bugs can be found in READ_ME-1.5x.
diff --git a/web/fweb/READ_ME-1.6x b/web/fweb/READ_ME-1.6x
new file mode 100644
index 0000000000..62abccdf78
--- /dev/null
+++ b/web/fweb/READ_ME-1.6x
@@ -0,0 +1,75 @@
+ FWEB version 1.6x
+ September 23, 1998
+
+ (See the BUGS list at the end of this file.)
+
+ FWEB v1.6x (where 'x' is a number like '3') is available via
+anonymous ftp from
+
+ ftp.pppl.gov:/pub/fweb/fweb-1.6x.tar.gz
+
+This release is primarily intended to add support for large projects that
+involve multiple web source files. In particular, the indexes created by
+weaving those files can be merged.
+
+ To unpack the release,
+
+ gunzip fweb-1.6x.tar.gz
+ tar -xf fweb-1.6x.tar
+
+or, if you have gnu tar,
+
+ gtar -zxf fweb-1.6x.tar.gz
+
+This creates the directory fweb-1.6x with the four subdirectories Boot,
+Demos, Manual, and Web:
+
+ Boot --- Presently almost entirely useless; ignore it.
+ Demos --- Presently empty.
+ Manual --- Documentation, style files, etc.
+ Web --- *.c and *.h files for installation; source code.
+
+ Major points to note with this release are:
+
+ * For detailed installation instructions, see the READ_ME.FWEB file
+in the top-level directory of the release.
+
+ * As fusion research in the U.S. collapses around us, time for
+serious work on FWEB has been severely limited. Nevertheless, it's
+probably time to users to upgrade to Version 1.6. There won't be another
+release for a couple of years.
+
+ * Executables for the IBM-PC are not yet provided.
+
+ * For a list of the principle new features with version 1.6x, see
+the texinfo documentation, menu item `New Features'.
+
+
+ BUGS
+ Version 1.62
+
+* The command-line option `-n!' MUST NOT be used if you reference ANY
+built-in FWEB functions, such as $PI or $IF. With that option, the
+built-in functions will not be properly defined. This is an egregious
+mistake that I hope to correct soon.
+
+* fweave is not presently fully compatible with ``Standard C++''---i.e.,
+the first ANSI/ISO specification. In particular, FWEB has no provision for
+dealing with the scoping requirements introduced by namespaces. In fact,
+FWEB has little understanding of scope at all, so even in pre-Standard C++
+the introduction of class types in a local scope isn't handled in a
+sensible way by fweave. That is, types (highlighted in boldface) once
+defined remain defined for the duration of the code.
+
+ It is feasible to fix most of this, but since several previous authors did
+not have such scoping requirements in mind, the fix requires some real
+work. I hope to do that for the next major release (sometime in the next
+century).
+
+* In Fortran codes, ftangle incorrectly indents the first module comment.
+
+ Temporary fix: Use either of `-Tv' or `-#'.
+
+* Higher-order (> 127) characters in strings may or may not be processed
+correctly.
+