TITLE

  vahunz - Make source code un-/more legible.

VERSION 

  1.7

AUTHOR

  Thomas Aglassinger <agi@giga.or.at>

DESCRIPTION

  Vahunz is a CLI-based replace command that can replace many words
  across several files with only one invocation.

  Normally the target words will be created randomly, turning
  meaningful names into unlegible garbage. For example, a function
  name like read_input_file() could be replaced by g7B() or something
  as useless. Additionally, comments and indention can be removed.

  As an option, you can specify specific substitutes, so Vahunz can
  also be applied in a non-destructive manner. This can be used to
  replace inconsistent, too short or unlegible names by something more
  meaningful. Among programmers, this process is known as "The Great
  Renaming".

  An Amiga Installer script acting as frontend to the CLI command is
  included, so most tasks can be performed without having to deal with
  cryptic command line options.

FEATURES

  - Stores less/more legible copy in a different directory
  - Supports C, C++ and Java
  - Auto-detects programming language
  - New names since last run are easy to see
  - Names can easily be declared to be modified or left untouched;
    for example, it makes no sense to replace printf().
  - Words being part of comments or string constants are not replaced
  - Fast, as internally names are stored in an AVL-tree
  - Several options to back-trace problems in vahunzed code
  - Includes a set of standard dictionaries for various environments
  - Includes source code (vahunzed ANSI C)

NEW FEATURES

  - Fixed some bugs

SPECIAL REQUIREMENTS

  AmigaOS 2.04, 2MB of regular memory, 68020

AVAILABILITY

  - Every Aminet-mirror, file "dev/misc/vahunz.lha", for example:

    ftp://wuarchive.wustl.edu/pub/aminet/dev/misc/vahunz.lha

  - http://www.giga.or.at/~agi/vahunz/

PRICE

  Freeware.

DISTRIBUTABILITY

  Freely distributable as long the conditions described in the manual
  are met.

EXAMPLE

  For example, one might have a code excerpt like this:

    int main(void)
    {
        while (sepp_age < 83)
        {
            grow_older(sepp_name, &sepp_age);
            print_sepp();
        }
        printf("\n%s died.\n", sepp_name);
        exit(EXIT_SUCCESS);
    }

  After vahunzing, this is what it might look like:

    int main(void)
    {
    while (g8B < 83)
    {
    z3V(v6Z, &g8B);
    f4V();
    }
    printf("\n%s died.\n", v6Z);
    exit(EXIT_SUCCESS);
    }

  As you can see, the internal names have been garbled, but the
  symbols of the standard library are preserved.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  277     628  44.1% -lh5- 33bd Sep  6  1998 vahunz.info
[generic]                69468  208854  33.3% -lh5- f6f1 Sep 17  1998 vahunz/dignorary/amiga.ignore
[generic]                 2313    5325  43.4% -lh5- 78ec Sep 17  1998 vahunz/dignorary/ansi.ignore
[generic]                    1       1 100.0% -lh0- 0780 Sep  4  1998 vahunz/dignorary/empty.ignore
[generic]                47739  151894  31.4% -lh5- 0860 Aug 16  1999 vahunz/dignorary/java.ignore
[generic]                65700  187597  35.0% -lh5- 627a Sep 17  1998 vahunz/dignorary/unix.ignore
[generic]                  116     204  56.9% -lh5- 5d60 Feb  9  1998 vahunz/example/Makefile
[generic]                  236     367  64.3% -lh5- c564 Feb  9  1998 vahunz/example/older.c
[generic]                  118     165  71.5% -lh5- 6b07 Feb  9  1998 vahunz/example/older.h
[generic]                  413     781  52.9% -lh5- 8a17 Feb 14  1998 vahunz/example/sepp.c
[generic]                  277     628  44.1% -lh5- d939 Sep  6  1998 vahunz/manual.info
[generic]                 2600    5775  45.0% -lh5- b732 Apr 16  2001 vahunz/manual/beyond.html
[generic]                 2689    6506  41.3% -lh5- 9594 Apr 16  2001 vahunz/manual/dictionary.html
[generic]                 3379    8262  40.9% -lh5- ff61 Apr 16  2001 vahunz/manual/future.html
[generic]                  138     138 100.0% -lh0- caae Jan 14  1996 vahunz/manual/image/back.gif
[generic]                  190     190 100.0% -lh0- 1fb4 Jan 14  1996 vahunz/manual/image/copy.gif
[generic]                  170     170 100.0% -lh0- efae Jan 14  1996 vahunz/manual/image/index.gif
[generic]                  176     176 100.0% -lh0- 1d32 Jan 14  1996 vahunz/manual/image/main.gif
[generic]                  189     189 100.0% -lh0- 2f1a Jan 14  1996 vahunz/manual/image/next.gif
[generic]                  168     168 100.0% -lh0- bfd0 Jan 14  1996 vahunz/manual/image/noback.gif
[generic]                  211     211 100.0% -lh0- 96b5 Jan 14  1996 vahunz/manual/image/nocopy.gif
[generic]                  200     200 100.0% -lh0- 1c77 Jan 14  1996 vahunz/manual/image/noindex.gif
[generic]                  193     193 100.0% -lh0- a1df Apr 16  2001 vahunz/manual/image/nomain.gif
[generic]                  212     212 100.0% -lh0- 45a4 Jan 14  1996 vahunz/manual/image/nonext.gif
[generic]                  213     213 100.0% -lh0- f4b8 Jul 15  1996 vahunz/manual/image/noprev.gif
[generic]                  188     188 100.0% -lh0- 8594 Jan 14  1996 vahunz/manual/image/prev.gif
[generic]                  141     141 100.0% -lh0- 3dee Nov  4  1995 vahunz/manual/image/up.gif
[generic]                  981     981 100.0% -lh0- 63d4 Feb 21  1998 vahunz/manual/image/vahunz-now.gif
[generic]                 1553    1553 100.0% -lh0- 7636 Apr 19  1998 vahunz/manual/image/vahunz.gif
[generic]                 2765    2765 100.0% -lh0- c7ef Sep 25  1998 vahunz/manual/image/verhunz.gif
[generic]                 1896    4472  42.4% -lh5- 1200 Apr 16  2001 vahunz/manual/index.html
[generic]                  256     481  53.2% -lh5- 6ad7 Sep  6  1998 vahunz/manual/index.html.info
[generic]                 2545    5867  43.4% -lh5- 7d75 Apr 16  2001 vahunz/manual/inside.html
[generic]                 1164    2592  44.9% -lh5- 23e9 Apr 16  2001 vahunz/manual/keyctionary.html
[generic]                 1676    3484  48.1% -lh5- 372b Apr 16  2001 vahunz/manual/legal.html
[generic]                 2423    5507  44.0% -lh5- c3b0 Apr 16  2001 vahunz/manual/overview.html
[generic]                 1677    3416  49.1% -lh5- 5ead Apr 16  2001 vahunz/manual/problems.html
[generic]                 4779   12347  38.7% -lh5- bcb8 Apr 16  2001 vahunz/manual/reference.html
[generic]                  750    1534  48.9% -lh5- 9a1b Apr 16  2001 vahunz/manual/requirements.html
[generic]                 1383    2945  47.0% -lh5- b23b Apr 16  2001 vahunz/manual/source.html
[generic]                 1057    2256  46.9% -lh5- 4e71 Apr 16  2001 vahunz/manual/support.html
[generic]                 1166    2431  48.0% -lh5- 910e Sep 17  1998 vahunz/manual/tschak.html
[generic]                 4339   10868  39.9% -lh5- a87b Apr 16  2001 vahunz/manual/tutorial.html
[generic]                  964    2056  46.9% -lh5- d709 Apr 16  2001 vahunz/manual/use-case-1.html
[generic]                 2071    4923  42.1% -lh5- 8dc7 Apr 16  2001 vahunz/manual/use-case-2.html
[generic]                 1349    2913  46.3% -lh5- 7285 Apr 16  2001 vahunz/manual/use-case-3.html
[generic]                 1687    3469  48.6% -lh5- 93dc Apr 16  2001 vahunz/manual/use-case-4.html
[generic]                 1400    3007  46.6% -lh5- a643 Apr 16  2001 vahunz/manual/use-case-5.html
[generic]                 1374    2972  46.2% -lh5- 482d Apr 16  2001 vahunz/manual/use-case-6.html
[generic]                  343    1195  28.7% -lh5- 9fb4 Apr 19  1998 vahunz/source/compile
[generic]                 9275   25256  36.7% -lh5- fc99 Oct 24  1997 vahunz/source/ubiqx/COPYING.LIB
[generic]                 1754    5701  30.8% -lh5- 3739 Apr 17  2001 vahunz/source/ubiqx/ubi_AVLtree.c
[generic]                  848    1945  43.6% -lh5- a0d6 Apr 17  2001 vahunz/source/ubiqx/ubi_AVLtree.h
[generic]                 2269    6273  36.2% -lh5- 1a2b Apr 17  2001 vahunz/source/ubiqx/ubi_BinTree.c
[generic]                 1288    3065  42.0% -lh5- 82bd Apr 17  2001 vahunz/source/ubiqx/ubi_BinTree.h
[generic]                 2046    6893  29.7% -lh5- e4e1 Apr 17  2001 vahunz/source/ugly/expstr.c
[generic]                  915    2552  35.9% -lh5- 7633 Apr 17  2001 vahunz/source/ugly/expstr.h
[generic]                  499    1105  45.2% -lh5- 92c9 Apr 17  2001 vahunz/source/ugly/udebug.h
[generic]                 2859    7975  35.8% -lh5- 5192 Apr 17  2001 vahunz/source/ugly/umemory.c
[generic]                  876    2306  38.0% -lh5- b5db Apr 17  2001 vahunz/source/ugly/umemory.h
[generic]                 1392    3398  41.0% -lh5- 4b27 Apr 17  2001 vahunz/source/ugly/ustring.c
[generic]                  707    1600  44.2% -lh5- 15dc Apr 17  2001 vahunz/source/ugly/ustring.h
[generic]                  768    1953  39.3% -lh5- e77c Apr 17  2001 vahunz/source/ugly/utypes.h
[generic]                  923    2236  41.3% -lh5- 1797 Apr 17  2001 vahunz/source/vahunz/keywords.c
[generic]                 8776   25186  34.8% -lh5- d137 Apr 17  2001 vahunz/source/vahunz/vahunz.c
[generic]                  515    1074  48.0% -lh5- a40d Apr 17  2001 vahunz/source/vahunz/vahunz_rev.h
[generic]                 2448    3860  63.4% -lh5- 0934 Sep 16  1998 vahunz/tschak/blank-to-hyphen
[generic]                  253     466  54.3% -lh5- 8f5b Sep 16  1998 vahunz/tschak/blank-to-hyphen.c
[generic]                  397     886  44.8% -lh5- a089 Sep  2  1998 vahunz/tschak/def_vahunz.info
[generic]                  806    2035  39.6% -lh5- 2231 Aug 16  1999 vahunz/tschak/scan_javadoc.e
[generic]                   39      42  92.9% -lh5- 84ae Aug 12  1999 vahunz/tschak/SCOPTIONS
[generic]                20932   36516  57.3% -lh5- 949d Apr 16  2001 vahunz/vahunz
[generic]                 7522   31784  23.7% -lh5- a669 Aug 16  1999 vahunz/Vahunz-Tschak
[generic]                  430     930  46.2% -lh5- d3f4 Sep 16  1998 vahunz/Vahunz-Tschak.info
[generic]                 1373    2598  52.8% -lh5- a0de Apr 17  2001 vahunz/vahunz.readme
[generic]                  267     496  53.8% -lh5- 5075 Sep  4  1998 vahunz/vahunz.readme.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        76 files  307490  841541  36.5%            Apr 26  2001