                       **************************
                       *   How to Report Bugs   *
                       **************************

Email bug reports to llnlxdir@llnl.gov.  Please report compiler-generated
warning errors as well as run-time errors.  In addition to the particulars
of the problem, please specify:

  o  LLNL XDIR version number

  o  System (e.g., SGI IRIX 4.0.5)

  o  Compiler (e.g., gcc) and options

  o  Versions of Motif and X11


                           ******************
                           *   Known Bugs   *
                           ******************

  o  LLNL XDIR sometimes has trouble dealing with entry names that contain
     embedded spaces.  The symptom is that XDIR will behave as though the
     entry name consists of only the last blank-delimited part of the name.
     This problem occurs most frequently in the Full Info Layout mode.  So,
     as a workaround, try switching to another layout mode.

  o  Recursive file transfers to a Windows system running the WFTPD daemon
     will encounter problems if the name of any transferred directory
     contains more than eight characters.

  o  If LLNL XDIR is built with SOCKS, the STOP button will have no effect
     while connecting to a remote host.

  o  On Linux systems, Xdir binaries built with Motif 2.0 can die with a
     segmentation fault when closing a directory window.  This does not
     occur on all Linux systems using Motif 2.0, and is apparently due to
     a Motif bug.  One of the vendors that supplies Motif for Linux systems
     has reported the bug to OSF.  Until the bug is fixed, the only work-
     around I know of is to replace the following line in dirwin3.c,

             XtDestroyWidget(dirwin->w_shell);
     with
             XtUnrealizeWidget(dirwin->w_shell);

     This will cause the directory window to disappear upon closing and
     will free resources on the X server, but will not free widget data
     structures in the Xdir client (hence, the executable will act as though
     it has a bad memory leak).

  o  On Solaris 2.4 systems, Xdir binaries built with Motif libraries that
     were not supplied by Sun Microsystems have been known to die during
     certain operations in the function _XmIEndUpdate().  The segmentation
     fault seems to be due to a Motif bug, but this has not been confirmed.
     The problem has not been observed with binaries built with the Motif
     supplied by Sun Microsystems.

  o  LLNL XDIR might not behave as desired if you attempt to recursively
     transfer or delete a directory that is not tree-like (that is, which
     contains links that create loops in the file system).

  o  Although the cache mechanism is fairly reliable, it is possible to
     contrive cases involving the move or recursive copy operations in
     which the cache can get out of sync with the actual directory
     structure.

