2006-03-19 Juan M. Guerrero * doc/fftw3.texi: Added djgpp specific info. * tools/fftw_wisdom.1.in: Added djgpp specific info. diff -apruNU3 fftw-3.1.1.orig/doc/fftw3.texi fftw-3.1.1/doc/fftw3.texi --- fftw-3.1.1.orig/doc/fftw3.texi 2006-03-04 21:17:56 +0000 +++ fftw-3.1.1/doc/fftw3.texi 2006-03-19 20:24:08 +0000 @@ -480,7 +480,7 @@ The basic usage of FFTW to compute a one @end example (When you compile, you must also link with the @code{fftw3} library, -e.g. @code{-lfftw3 -lm} on Unix systems.) +e.g. @code{-lfftw3 -lm} on Unix systems or @code{-lfftw -lm} on DJGPP systems.) First you allocate the input and output arrays. You can allocate them in any way that you like, but we recommend using @code{fftw_malloc}, @@ -596,8 +596,9 @@ typecast.) Single and long-double precision versions of FFTW may be installed; to use them, replace the @code{fftw_} prefix by @code{fftwf_} or -@code{fftwl_} and link with @code{-lfftw3f} or @code{-lfftw3l}, but -use the @emph{same} @code{} header file. +@code{fftwl_} and link with @code{-lfftw3f} or @code{-lfftw3l} (@code{-lfftwf} +on DJGPP systems; there is still no long double precision library available on +DJGPP systems), but use the @emph{same} @code{} header file. @cindex precision Many more flags exist besides @code{FFTW_MEASURE} and @@ -1679,7 +1680,8 @@ Nevertheless, if the choice is between u using possibly-suboptimal wisdom (created on the same machine, but for a different binary), the wisdom is likely to be better. For this reason, we provide a function to import wisdom from a standard system-wide -location (@code{/etc/fftw/wisdom} on Unix): +location (@code{/etc/fftw/wisdom} on Unix and +@code{/dev/env/DJDIR/etc/fftw/wisdom} on djgpp): @cindex wisdom, system-wide @example @@ -1722,7 +1724,8 @@ All programs using FFTW should include i @end example You must also link to the FFTW library. On Unix, this -means adding @code{-lfftw3 -lm} at the @emph{end} of the link command. +means adding @code{-lfftw3 -lm} or @code{-lfftw -lm} on +DJGPP systems at the @emph{end} of the link command. @menu * Complex numbers:: @@ -1787,8 +1790,10 @@ interfaces, you: @item Link to the single/long-double libraries; on Unix, @code{-lfftw3f} or -@code{-lfftw3l} instead of (or in addition to) @code{-lfftw3}. (You -can link to the different-precision libraries simultaneously.) +@code{-lfftw3l} instead of (or in addition to) @code{-lfftw3}. On +DJGPP systems use @code{-lfftwf}; there is still no long double precision +library available on DJGPP. (You can link to the different-precision +libraries simultaneously.) @item Include the @emph{same} @code{} header file. @@ -3235,7 +3240,7 @@ read pointer is unspecified. @code{fftw_import_system_wisdom} reads wisdom from an implementation-defined standard file (@code{/etc/fftw/wisdom} on Unix -and GNU systems). +and GNU systems and @code{/dev/env/DJDIR/etc/fftw/wisdom} on djgpp). @cindex wisdom, system-wide The return value of these import routines is @code{1} if the wisdom was diff -apruNU3 fftw-3.1.1.orig/tools/fftw_wisdom.1.in fftw-3.1.1/tools/fftw_wisdom.1.in --- fftw-3.1.1.orig/tools/fftw_wisdom.1.in 2006-02-25 18:57:34 +0000 +++ fftw-3.1.1/tools/fftw_wisdom.1.in 2006-03-19 20:24:08 +0000 @@ -40,6 +40,9 @@ Programs using FFTW can be written to lo string, or other source. Moreover, it is likely that many FFTW-using programs will load the \fBsystem wisdom\fR file, which is stored in .I /etc/fftw/wisdom@PREC_SUFFIX@ +(or in +.I /dev/env/DJDIR/etc/fftw/wisdom@PREC_SUFFIX@ +on DJGPP systems) by default. .I fftw@PREC_SUFFIX@-wisdom can be used to create or add to such wisdom files. In its most @@ -55,6 +58,9 @@ option) and the output .I wisdom@PREC_SUFFIX@ file can then be copied (as root) to .I /etc/fftw/ +(or to +.I /dev/env/DJDIR/etc/fftw/ +on DJGPP systems) or whatever. The @@ -66,6 +72,9 @@ option, as in the example above. If the system wisdom file .I /etc/fftw/wisdom@PREC_SUFFIX@ +(or +.I /dev/env/DJDIR/etc/fftw/wisdom@PREC_SUFFIX@ +on DJGPP systems) already exists, then .I fftw@PREC_SUFFIX@-wisdom reads this existing wisdom (unless the @@ -166,6 +175,9 @@ mode). \fB\-n\fR, \fB\--no-system-wisdom\fR Do not import the system wisdom from .I /etc/fftw/wisdom@PREC_SUFFIX@ +(or from +.I /dev/env/DJDIR/etc/fftw/wisdom@PREC_SUFFIX@ +on DJGPP systems) (which is normally read by default). .TP \fB\-w\fR \fIfile\fR, \fB\--wisdom-file\fR=\fIfile\fR