c_cpp/etc/calc/BUGS

   1 If you notice something wrong, strange or broken, try rereading:
   2
   3    README.FIRST
   4    HOWTO.INSTALL
   5    BUGS (this file)
   6
   7 If that does not help, cd to the calc source directory and try:
   8
   9    make check
  10
  11 Look at the end of the output, it should say something like:
  12
  13     9998: passed all tests  /\../\
  14     9999: Ending regression tests
  15
  16 If it does not, then something is really broken!
  17
  18 If you made and modifications to calc beyond the simple Makefile
  19 configuration, try backing them out and see if things get better.
  20
  21 To be sure that your version of calc is up to date, check out:
  22
  23         http://www.isthe.com/chongo/tech/comp/calc/calc-download.html
  24
  25 The calc web site is located at:
  26
  27         http://www.isthe.com/chongo/tech/comp/calc/index.html
  28
  29 =-=
  30
  31 If you have tried all of the above and things still are not right,
  32 then it may be time to send in a bug report.  You can send bug
  33 and bug fixes reports to:
  34
  35     calc-bugs at asthe dot com
  36
  37     [[ NOTE: Replace 'at' with @, 'dot' is with . and remove the spaces ]]
  38     [[ NOTE: The EMail address uses 'asthe', the web site URL uses 'isthe' ]]
  39
  40 Your subject must contain the words:
  41
  42        calc bug report
  43
  44 You may have additional words in your subject line.
  45
  46 When you send your report, please include the following information:
  47
  48     * a description of the problem
  49     * the version of calc you are using (if you cannot get calc
  50       to run, then send us the 4 #define lines from version.c)
  51     * if you modified calc from an official patch, send me the mods you made
  52     * the type of system you were using
  53     * the type of compiler you were using
  54     * any compiler warnings or errors that you saw
  55     * cd to the calc source directory, and type:
  56
  57         make debug > debug.out 2>&1             (sh, ksh, bash users)
  58         make debug >& debug.out                 (csh, tcsh users)
  59
  60       and send the contents of the 'debug.out' file.
  61
  62 Stack traces from core dumps are useful to send as well.
  63
  64 Fell free to use the above address to send in big fixes (in the form
  65 of a context diff patch).
  66
  67 =-=
  68
  69 Known bugs:
  70
  71     We are sure some more bugs exist.  When you find them, please let
  72     us know!  See the above for details on how to report and were to
  73     EMail your bug reports and hopefully patches to fix them.
  74
  75 =-=
  76
  77 Problems that have known work-a-rounds:
  78
  79     * There is a bug in gcc v4.1.0 that causes calc to fail the regression
  80       test.  The work-a-round is to compile with gcc v4.1.1 or later.  This
  81       problems was observed on Fedora 5.
  82
  83 =-=
  84
  85 mis-features in calc:
  86
  87     Some problems are not bugs but rather mis-features / things that could
  88     work better.  The following is a list of mis-features that should be
  89     addressed and improved someday.
  90
  91     * When statement is of the form { ... }, the leading { MUST BE ON
  92       THE SAME LINE as the if, for, while or do keyword.
  93
  94       This works as expected:
  95
  96         if (expr) {
  97             ...
  98         }
  99
 100       However this WILL NOT WORK AS EXPECTED:
 101
 102         if (expr)
 103         {
 104             ...
 105         }
 106
 107       This needs to be changed.  See also "help statement", "help unexpected",
 108       and "help todo".
 109
 110     * The chi.cal resource file does not work well with odd degrees
 111       of freedom.  Can someone improve this algorithm?
 112
 113     * The intfile.cal resource file reads and writes big or little Endian
 114       integers to/from files the hard way.  It does NOT use blkcpy.  The
 115       following code:
 116
 117         i = (ord("\n") << 16) | (ord("i") << 8) | ord("H")
 118         b = blk()
 119         copy(i, b)
 120         fd = fopen("file", "w")
 121         copy(b, fd);
 122         fclose(fd)
 123
 124       will write an extra NUL octet to the file.  Where as:
 125
 126         read intfile
 127         i = (ord("\n") << 16) | (ord("i") << 8) | ord("H")
 128         be2file(i, "file2")
 129
 130       will not.
 131
 132 ## Copyright (C) 1999-2013  Landon Curt Noll
 133 ##
 134 ## Calc is open software; you can redistribute it and/or modify it under
 135 ## the terms of the version 2.1 of the GNU Lesser General Public License
 136 ## as published by the Free Software Foundation.
 137 ##
 138 ## Calc is distributed in the hope that it will be useful, but WITHOUT
 139 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 140 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
 141 ## Public License for more details.
 142 ##
 143 ## A copy of version 2.1 of the GNU Lesser General Public License is
 144 ## distributed with calc under the filename COPYING-LGPL.  You should have
 145 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
 146 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 147 ##
 148 ## @(#) $Revision: 30.2 $
 149 ## @(#) $Id: BUGS,v 30.2 2013/08/11 01:09:27 chongo Exp $
 150 ## @(#) $Source: /usr/local/src/bin/calc/RCS/BUGS,v $
 151 ##
 152 ## Under source code control:   1994/03/18 14:06:13
 153 ## File existed as early as:    1994
 154 ##
 155 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
 156 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/