c_cpp/etc/calc/help/todo

   1 Calc Todo Items:
   2
   3     The following items should be addressed sometime in the short to
   4     medium term future, if not before the next release.
   5
   6     Code contributions are welcome.  Send patches to:
   7
   8             calc-contrib at asthe dot com
   9
  10     Calc bug reports, however, should send to:
  11
  12             calc-bugs at asthe dot com
  13
  14     [[ NOTE: Replace 'at' with @, 'dot' is with . and remove the spaces ]]
  15     [[ NOTE: The EMail address uses 'asthe' and the web site URL uses 'isthe' ]]
  16
  17     See the BUGS file or try the calc command:
  18
  19             help bugs
  20
  21     See also the 'wishlist' help files for the calc enhancement wish list.
  22
  23 =-=
  24
  25 Very High priority items:
  26
  27     * Improve the way that calc parses statements such as if, for, while
  28       and do so that when a C programmer does.  This works as expected:
  29
  30             if (expr) {
  31                 ...
  32             }
  33
  34       However this WILL NOT WORK AS EXPECTED:
  35
  36             if (expr)
  37             {
  38                 ...
  39             }
  40
  41       because calc will parse the if being terminated by
  42       an empty statement followed by a
  43
  44             if (expr) ;
  45             {
  46                 ...
  47             }
  48
  49       See also "help statement", "help unexpected", "help todo", and
  50       "help bugs".
  51
  52     * Consider using GNU autoconf / configure to build calc.
  53
  54     * It is overkill to have nearly everything wind up in libcalc.
  55       Form a libcalcmath and a libcalclang so that an application
  56       that just wants to link with the calc math libs can use them
  57       without dragging in all of the other calc language, I/O,
  58       and builtin functions.
  59
  60     * Fix any 'Known bugs' as noted in the BUGS file or as
  61       displayed by 'calc help bugs'.
  62
  63 =-=
  64
  65 High priority items:
  66
  67     * Verify, complete or fix the 'SEE ALSO' help file sections.
  68
  69     * Verify, complete or fix the 'LINK LIBRARY' help file sections.
  70
  71     * Verify, complete or fix the 'LIMITS' help file sections.
  72
  73     * Verify, complete or fix the 'SYNOPSIS' and 'TYPES' help file sections.
  74
  75     * Perform a code coverage analysis of the 'make check' action
  76       and improve the coverage (within reason) of the regress.cal suite.
  77
  78     * Address, if possible and reasonable, any Calc Mis-features
  79       as noted in the BUGS file or as displayed by 'calc help bugs'.
  80
  81     * Internationalize calc by converting calc error messages and
  82       text strings (e.g., calc startup banner, show output, etc.)
  83       into calls to the GNU gettext internationalization facility.
  84       If somebody translated these strings into another language,
  85       setting $LANG would allow calc to produce error messages
  86       and text strings in that language.
  87
  88 =-=
  89
  90 Medium priority items:
  91
  92     * Complete the use of CONST where appropriate:
  93
  94         CONST is beginning to be used with read-only tables and some
  95         function arguments.  This allows certain compilers to better
  96         optimize the code as well as alerts one to when some value
  97         is being changed inappropriately.  Use of CONST as in:
  98
  99             int foo(CONST int curds, char *CONST whey)
 100
 101         while legal C is not as useful because the caller is protected
 102         by the fact that args are passed by value.  However, the
 103         in the following:
 104
 105             int bar(CONST char *fizbin, CONST HALF *data)
 106
 107         is useful because it calls the compiler that the string pointed
 108         at by 'fizbin' and the HALF array pointer at by 'data' should be
 109         treated as read-only.
 110
 111       One should make available a the fundamental math operations
 112       on ZVALUE, NUMBER and perhaps COMPLEX (without all of the
 113       other stuff) in a separate library.
 114
 115     * Clean the source code and document it better.
 116
 117     * Add a builtin function to access the 64 bit FNV hash which
 118       is currently being used internally in seed.c.
 119
 120 ## Copyright (C) 1999-2007  Landon Curt Noll
 121 ##
 122 ## Calc is open software; you can redistribute it and/or modify it under
 123 ## the terms of the version 2.1 of the GNU Lesser General Public License
 124 ## as published by the Free Software Foundation.
 125 ##
 126 ## Calc is distributed in the hope that it will be useful, but WITHOUT
 127 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 128 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
 129 ## Public License for more details.
 130 ##
 131 ## A copy of version 2.1 of the GNU Lesser General Public License is
 132 ## distributed with calc under the filename COPYING-LGPL.  You should have
 133 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
 134 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 135 ##
 136 ## @(#) $Revision: 30.2 $
 137 ## @(#) $Id: todo,v 30.2 2007/09/08 02:52:42 chongo Exp $
 138 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/todo,v $
 139 ##
 140 ## Under source code control:   1999/10/20 07:42:55
 141 ## File existed as early as:    1999
 142 ##
 143 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
 144 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/