Trouble Logo Troubleshooting Tycho

Other sources of information:

  • Tycho Help System Overview
  • Tycho 0.2.1 Release Notes
  • Tycho Bugs
  • Tycho Frequently Asked Questions (FAQ)
  • Tcl and Itcl Internet Resources
  • Below is a list of common problems that people have with Tycho.

    Problems Starting Tycho

    Itcl Versions

    Note that Tycho0.2 and later will not work with Itcl2.0 or Itcl2.1, you must have Itcl2.2. (Itcl2.0 was shipped with Ptolemy0.6, Itcl2.2 was shipped with with Ptolemy0.7 and 0.7.1)

    If Tycho fails to start with a message like:
    cxh@kahn > tycho
    ld.so.1: itkwish: fatal: libitk2.2.so: can't open file: errno=2
    Killed
    cxh@kahn
    
    then the problem is that the itkwish binary cannot find its shared libraries. If you are using prebuilt Itcl binaries, be sure that your path is setup so $TYCHO/bin is before directory that contains the itkwish binary.

    For example, under C shell:

    set path = ($TYCHO/bin $path)
    
    If you are using the prebuilt Itcl binaries, the ITCLDIR variable should be set to the location of the untar'd Itcl files.

    If you are using Ptolemy, then your path should be set:

    set path = ($PTOLEMY/bin $PTOLEMY/bin.$PTARCH $path)
    

    Error Message about "error while autoloading tk_setPalette"

    If you see a message like:
    error while autoloading "tk_setPalette": bad option "join": should be
    atime, dirname, executable, exists, extension, isdirectory,
    isfile, lstat, mtime, owned, readable, readlink, root, size,
    stat, tail, type, or writable
    	
        invoked from within
    "tk_setPalette activeBackground #e6ceb1 activeForeground black \
    background #ffe4c4 disabledForeground #b0b0b0 foreground black \
    highlightBackground ..."
    
    then you are probably running Itcl2.0, but the tclIndex files were prepared with Itcl2.1 or later. Tycho0.2 will not work with Itcl2.0, you must upgrade to Itcl2.2 or later. See the Installation guide for more information.

    CircularList error message

    Unable to load Tycho.tcl startup file: invalid command name "CircularList"
    
    Probably the $TYCHO/kernel/tclIndex file is corrupt, try recreating it by cding to that directory and typing make.

    file join error message

    If you are starting up Tycho0.1.1 or later and you see a message about
     bad option "join": should be atime, dirname, executable, 
        exists, extension, isdirectory, isfile, lstat, mtime, owned, readable, 
        readlink, root, size, stat, tail, type, or writable
            while executing
        "file join $tycho kernel"
            invoked from within
    
    then the problem is that you are running an Itcl2.0 itkwish, and Tycho0.2 requires Itcl2.2, which includes the Tcl7.6 file join command. The way to tell is to start itkwish by hand and type
    set itcl::version
    
    you should get back 2.2 if you are running Itcl2.2.

    Problems creating indices

    The BuilderDialog can be used to create Tycho indices, to create the indices by hand, follow the steps below.
    1. Do
      cd $TYCHO
      make realclean
      make install
      
      
      make realclean removes the tclIndex files and doc/codeDoc/*.
      make install creates the tclIndex files and recreates the doc/codeDoc/*. The doc/codeDoc/* files get created once by tydoc, then $TYCHO/lib/idx/codeDoc.idx gets created, then the tydoc files get recreated so that they can use $TYCHO/lib/idx/codeDoc.idx.
    2. If that does not work, and you are using a private tree that has links to a master Tycho tree, destroy your private tree and use tylndir to create a new one. tylndir is documented in $TYCHO/doc/coding/directories.html

    Color problems under Windows

    Under Itcl2.2 on Windows, some colors in bitmaps might be rendered incorrectly. An example of this is the parts of bitmap in the Tycho Welcome Window will be yellow instead grey.

    One workaround is to use the Color Palette settings and change the number of colors. To get to this control panel, right click on the background, select Properties, which will bring up the Display Properties window. In that window, select the Settings tab and then change the Color Palette setting. You may need to to try several different settings before finding one that works best for you.

    Debugging hints

    You can start Tycho by hand by starting up itkwish and then sourcing $TYCHO/kernel/Tycho.tcl.

    If the tcl variable tyDebug is set to 1, then Tycho.tcl will print out status messages as it starts up. Also, if tyDebug is set to 1, then Tycho will not automatically exit if there is an error during startup.

    The example below shows how it is possible to start up Tycho from itkwish

    cxh@carson 37% setenv TYCHO ~/pt/tycho
    cxh@carson 38% cd $TYCHO/kernel
    cxh@carson 39% itkwish
    % set tyDebug 1
    1
    % source Tycho.tcl
    TYCHO=/users/cxh/pt/tycho
    Loaded packages
    Processed argv
    About to create a TclShell
    About to unset
    % exit
    cxh@carson 40% 
    

    Up to: Tycho Introduction - Previous: Installation - Tycho Home Page


    Copyright © 1996-1998, The Regents of the University of California. All rights reserved.
    Last updated: 05/18/98, comments to: tycho@eecs.berkeley.edu