c_cpp/etc/calc/README.WINDOWS

   1 Dear calc user on a Windoz based system,
   2
   3 See the HOWTO.INSTALL file for information on how to build and install calc.
   4 See also the README file.
   5
   6 NOTE: The main developers do not have access to a Windoz based platform.
   7       While we will make an effort to not break calc Windoz based system,
   8       our lack of a Windoz test environment will mean we will make mistakes
   9       from time to time.  Hopefully Windowz users can overcome these mistakes.
  10       Of course you are welcome to send us any patches that fix your
  11       Windoz build environment.
  12
  13 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  14 =-= compiling with Cygwin =-=
  15 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  16
  17 An effort is being made to allow windows users to compile calc using the
  18 Cygwin project (http://sources.redhat.com/cygwin/) with the GCC compiler
  19 and Un*x tools for Windows.
  20
  21 The major porting work for Cygwin was performed by Thomas Jones-Low
  22 (tjoneslo at softstart dot com).
  23
  24 In March 2009, Michael Penk (mpenk at wuska dot com) reported success in
  25 installs under Cygwin:
  26
  27     On my fairly complete Cygwin installs, everything compiles,
  28     checks, and installs correctly.  My Cygwin is configured
  29     in a very standard way (out of the box, using all of Cygwin's
  30     defaults).  The install worked on 5 different machines with
  31     Cygwin on them: one XP home, one XP professional, and three
  32     Vista professionals.
  33
  34 Using the calc Makefile, he did the following:
  35
  36     make all target=Cygwin
  37     make check
  38     make install
  39
  40 He also reports:
  41
  42     Of course, one should be logged in as an Administrator when
  43     one builds and installs calc.
  44
  45 He was compiling calc 2.12.4.0 with Cygwin version 1.5.25-15.
  46
  47 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  48 =-= If all else fails, for Cygwin =-=
  49 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  50
  51 Much earlier (2001?) Thomas Jones-Low (tjoneslo at softstart dot com)
  52 recommended that you generate by hand all of the header files that
  53 by the Makefile.  This has been done for you via the makefile rule:
  54
  55         make win32_hsrc
  56
  57 which uses the Makefile variables in win32.mkdef to form these header
  58 files under win32 directory.
  59
  60 You will find generated versions of these files located in the win32
  61 sub-directory.  These files may be appropriate for your Cygwin building
  62 needs.
  63
  64 In particular:
  65
  66         Just copy the win32/*.[ch] files up into the top level calc
  67         source directory, edit them (if needed) and build using the
  68         Cygwin GCC compiler and Cygwin build environment.
  69
  70 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  71 =-= compiling under DJGPP =-=
  72 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  73
  74 You might want to try using the DJGPP system to compile calc.  See:
  75
  76         http://www.delorie.com/djgpp/
  77
  78 for DJGPP details and availability.
  79
  80 To compile with DJGPP, one needs to select a number of Makefile
  81 variable changes.  Eli Zaretskii <eliz at is dot elta dot co dot il>
  82 recommends the following settings:
  83
  84         TERMCONTROL= -DUSE_TERMIOS
  85         BYTE_ORDER= -DLITTLE_ENDIAN
  86         LONG_BITS= 32
  87         HAVE_FPOS_POS= -DHAVE_NO_FPOS_POS
  88         FPOS_BITS= 32
  89         OFF_T_BITS= 32
  90         DEV_BITS= 32
  91         INODE_BITS= 32
  92         HAVE_USTAT= -DHAVE_NO_USTAT
  93         HAVE_GETSID= -DHAVE_NO_GETSID
  94         HAVE_GETPGID= -DHAVE_NO_GETPGID
  95         HAVE_GETTIME= -DHAVE_NO_GETTIME
  96         HAVE_GETPRID= -DHAVE_NO_GETPRID
  97         HAVE_URANDOM_H= NO
  98         ALIGN32= -UMUST_ALIGN32
  99         HAVE_MALLOC_H= YES
 100         HAVE_STDLIB_H= YES
 101         HAVE_STRING_H= YES
 102         HAVE_TIMES_H= NO
 103         HAVE_SYS_TIMES_H= YES
 104         HAVE_TIME_H= YES
 105         HAVE_SYS_TIME_H= YES
 106         HAVE_UNISTD_H= YES
 107         BINDIR= /dev/env/DJDIR/bin
 108         INCDIR= /dev/env/DJDIR/include
 109         LIBDIR= /dev/env/DJDIR/lib
 110         MANDIR= /dev/env/DJDIR/man/man1
 111         CATDIR= /dev/env/DJDIR/man/cat1
 112         NROFF= groff
 113         CALCPATH= .;./cal;~/.cal;${CALC_SHAREDIR};${CUSTOMCALDIR}
 114         CALCRC= ${CALC_SHAREDIR}/startup;~/.calcrc;./.calcinit
 115         CALCPAGER= less.exe -ci
 116         DEBUG= -O2 -gstabs+ -DWINDOZ
 117
 118 The 'Linux set' or 'gcc set' (see the Select your compiler type section)
 119 should work for DJGPP systems if you set the above Makefile variables.
 120
 121 Look for Makefile comments of the form:
 122
 123         # Select ...something... for DJGPP.
 124
 125 Follow those recommendations.  In cases where they conflict with
 126 the above Makefile list, follow the recommendation in the Makefile.
 127
 128
 129 ## Copyright (C) 2002-2009  Landon Curt Noll and Thomas Jones-Low
 130 ##
 131 ## Calc is open software; you can redistribute it and/or modify it under
 132 ## the terms of the version 2.1 of the GNU Lesser General Public License
 133 ## as published by the Free Software Foundation.
 134 ##
 135 ## Calc is distributed in the hope that it will be useful, but WITHOUT
 136 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 137 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
 138 ## Public License for more details.
 139 ##
 140 ## A copy of version 2.1 of the GNU Lesser General Public License is
 141 ## distributed with calc under the filename COPYING-LGPL.  You should have
 142 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
 143 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 144 ##
 145 ## @(#) $Revision: 30.2 $
 146 ## @(#) $Id: README.WINDOWS,v 30.2 2009/03/14 02:29:31 chongo Exp $
 147 ## @(#) $Source: /usr/local/src/bin/calc/RCS/README.WINDOWS,v $
 148 ##
 149 ## Under source code control:   2001/02/25 14:00:05
 150 ## File existed as early as:    2001
 151 ##
 152 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
 153 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/