BUGS -> Current Defects, Difficulties, Issues, and Major Malfunctions

NOW ACTIVELY MAINTAINED AT https://docs.google.com/spreadsheets/d/1VuAkuAM_0Lgv3Hhk0U2LKUWK0Ot6owXgx3_3uVSh7wQ

==========================================================================================================================================================================

- BUG promoting / marketing, we are mostly unknown which deprives the people of their excellent FOSS

- BUG MsWin volume S/N progress to differentiate identically mounted drive letters across runs, ex. removable D: yesterday is not the D: mounted today, but we save all as D: and Fileaxy will become confused, especially with Folder child[]

- BUG empty folder deletion Undo either did not work or was unable to display its Path SC again due to no empties policy

- BUG occasional deadlocks at ThreadTeam task canceling, need to use a 10 sec. time-out mutex from java.concurrent or migrate to a LIFO based ExecutorService

- BUG folder watcher removal of moved or deleted files is too broad in that removes/hides files which were not moved

- BUG damaged or non-standard images that are not rendered by JRE but are successfully rendered by IM/GM do not make it into 16x16 ARGB form for comparison

- BUG Select All command not always working, seems SC_Path confused about partial selection or not (if only one dir to show?)

- BUG the reorder bulk renamer trims all preceeding and postfixed spaces of the prefix text which surprised the user

- BUG getting an error beep when successfully moving dir with one SFP showing

- BUG in folder picker, if files moved with right-click on folder, Cancel button does not undo the move as expected

- BUG associator SFP[] Delete notification should check transaction [] present and if found, then lostDisassoc

- BUG Undoing multi-files to trash results in the mangled names where collision, ex. "[99]readme.txt", being restored to location properly but not unmangled back into original name

- BUG still have a few cases where Win10 (and other platforms?) is reporting dir.canWrite() as true when Files.isWritable( dir ) is false

- BUG when on the Duplicates view tab and determining duplicates task is running, and then user creates new Browser from this, canceling the new Browser's find duplicates task hangs the UI until the original Browser's find duplicates task completes

- BUG now missing FCs/SFPs are left around after rename operations, since this is intermittent (seems worse when Icon previews) is probably indicates that a File.exists() is being misused or Inventory Set is not thread safe

- BUG (View) button in JList_selector panel enabled even when no viewable in selection

- BUG when running Find Similars in the 1st pixelizer pass, hitting the Cancel button seemed to corrupt access to ARGBs after that point, or something.

- BUG saw issues with dirs in the same parent dir who only differ by case, hard to notice because SC_Path dir refresh then overwrites it

- BUG unix CLI launch with, for example `find ...` resultant arguments, always results in an empty browser when Fileaxy next launched without CLI

- BUG right-click in Importer file kinds tally and Wizard Inventory file kinds tally does not scroll to the correct type in Kinds view tab or got to any particularly imported file because About view has no button bar and relays out

- BUG after Reorder applied to seq, then Move To from there scrambles the -display- of files into non-AlphaNum order user just specifies

- BUG user expectation is that once a Path is auto-sync, changing the name of that Path outside of Fileaxy will cause an update (this requires two Watchers and ref counting for the shared common parent dir between several watched)

- BUG after Moving correlated series in Duplicates, other SFPs disappear leaving only one (which also can not be selected).  Can not just blanket "Check Again" when 100K+ files

==========================================================================================================================================================================

- SECURITY BUG ImageMagick6 not always using robust file type checks before decoding malicious or compromised image files, workaround is to use IM7 or GraphicsMagick

==========================================================================================================================================================================

- DESIGN BUG need a better splash window than just 128x128 logo .PNG, esp on slow Mac takes 15 secs to show when large data set or many windows

- DESIGN BUG Find Similar for multi SFPs dialog needs Show Presenter item in group preview pop-up button (do have a Command key for that though)

- DESIGN BUG delete store keys needs path quanta opposed to common string in top label

- DESIGN BUG need an Action status bar that tells the user what just happened, ex. Renamed 30 files, Dropped 50 files, Trashed 1 files -OR- better tool tip on undo button with last action summarized (10 day history with times that persists thru runs would be nice also)

- DESIGN BUG file rename dialog needs ability to add, change or remove the dot extension. Also via typeable JComboBox of exts, i.e. can't change a file's extension in Rename dialog

- DESIGN BUG no move of a mini-directory button to trash when dir has contents, dir deleting doesn't work when any other files present in trash on Fedora/Ubuntu (Mac? Win?) and Undo then also fails when return dir contains files

- DESIGN BUG "Portal" folder pop-up menus missing composite files preview submenu

- DESIGN BUG right-click "Trash Path" command should, if no sub-dirs, also trash that directory with its files, currently two operations with one being from mini-dir button

- DESIGN BUG more similarity slider ticks, too big of difference between 75% and 88%

- DESIGN BUG Importer Folder icons should show (with a green check-mark over folder icon) which are currently Imported

- DESIGN BUG SCs being right-clickable is not evident to new users, perhaps Help panels on West side could blurb that (SC's also except left-click)

- DESIGN BUG About view tab needs only the progress bar and Cancel button from the tool bar of the other views, i.e. hide menu bar, search, and selection JList

- DESIGN BUG smarter series for calendar dates (clustering when facing the GMT midnight problem, ie do not break over two days work that was done across a dateline) or pick time bin size hour/day/week/month/year

- DESIGN BUG thumbnails need to baseline different height FCs by bottom, i.e. not layout aligned by top edge but rather bottom so file names, etc line up

- DESIGN BUG SC_Path menu Up command grayed out when no parent SC, should change to Up... and give the choice of importing it with a depth of one, i.e. just that directory thru submenus

- DESIGN BUG Presenter needs to set Title With Zoom Info, presently just in tooltip

- DESIGN BUG selected items in JList not in same order as current view tab, selection JList needs to be resorted (and ensure index visible) by appropriate Associator Comparator when changing Tab Views

- DESIGN BUG migrate (Hide/Show) command button to right-click folder info sub-menu?

==========================================================================================================================================================================

- INTERMITTENT BUG saw issues in Select by Date dialog fouling up validation when not seeing last character typed and not enabling (Select) button

- INTERMITTENT BUG pick a Path to scroll to button the dialog shows all grayed out when it should not, ex. Flex

- INTERMITTENT BUG apparently Select All and then clicking Selection cmd blocks UI if 1K+ icons have not been rendered (investigate because something happened)

- INTERMITTENT BUG renaming a selection from Alphanum view tab thru the Reorder view tab using Exclude and then Include at least once or drag-ordering, when returning to the AlphaNum view tab the selection is mangled. Probably due to a bad selection .wake() optimization

- INTERMITTENT BUG reorder renaming twice seems to loose all selection, seems to confuse cache also as files switch names but icons don't know who to follow, might have something to with promote

- INTERMITTENT BUG Reorder some .jpgs and a .wmv  Saw the .wmv dropped from the browser <- because not viewable?

==========================================================================================================================================================================

- SIMULTANEOUS RUNNING BUG need file lock for Fileaxy folder on startup and then at shutdown to delay a second running Fileaxy

- SIMULTANEOUS RUNNING BUG need file lock specific to TheArgbPixelizer recovery file so two Fileaxy instances don't smash the file simultaneously if above lock not implemented

==========================================================================================================================================================================

- HELPER APP BUG hardening ImageMagick when bad .PDF, look for text "DelegateFailed" in console error stream

- HELPER APP BUG command line options for ImageMagick and GraphicsMagick convert to intermediate .PNG need to specify an opaque white background, noticed PDFs with transparency and black text can not be seen against black background of Presenter

==========================================================================================================================================================================

- MSWIN BUG '.bmp' files not rendering in Presenter

- MSWIN BUG persisted window location may not safely be in Desktop space when restored later and a monitor is missing, NOT FIXED ON VISTA WITH BOTTOM SYSTEM BAR!

- MSWIN BUG need to test metadata capture in ffprobe from ffmpeg suite

- MSWIN BUG entire "Go to Path" sub-menu should gray out when clicked on a missing drive letter Path SC like "Z:\", only MSWin needs this since Unix will always mount a '/'

- MSWIN BUG [Alt]+[Esc] being intercepted and converted to window hide (and [Ctrl]+[Esc] diverts to Windows Start menu)

- MSWIN BUG Icon Store keys for files at root of a drive letter are is stored and ref'd with an extra '\' but  other keys on drive not like that, like "Z:\\test.png"

==========================================================================================================================================================================

- MAC BUG [Alt]+[Esc] tidy too slow since OSX all windows iconify to Dock animation is one at a time, not simultaneous as expected

- MAC BUG [ALT] Rename-Reorder button text change broke from believed wonky window focus issues with JDK or OSX itself, hardware probably insufficient for installing OSX 10.11

- MAC BUG INTERMITTENT, drag-and-drop, even between Fileaxy windows, is emitting Mac specific messages to err console as of latest JRE8/Mac10.9 updates [tested OK on Linux]

- MAC BUG for normal users, need a non-MacPorts/HomeBrew (signed?) binary deployment solution for Mac with ImageMagick and/or GraphicsMagick

- MAC BUG user expected Mac alias to work like a symlink to import a folder but it did not and user was surprised

- MAC BUG no MIME type information, fall back to 'file' command?

- MAC BUG reliable race condition on iMac 2008 and MacOSX 10.6.8.  Had to sacrifice a very sweet multi-threading opportunity for reliability, may will have time to set up a synchronized monitor latter on.

- MAC BUG following all symlinks on recursive directory scan making the target too big and not accurate

- MAC BUG none of the host OS icons, small or large, are showing up, seems to not implement this aspect of JRE6

==========================================================================================================================================================================

- LINUX BUG when reading a damaged file on a physically damaged HFS+ volume on Linux, Java's 'native' .readFully() never returns (throws no Exception nor times out) which blocks app from quitting. [when testing on Mac, it auto-fixed that block]

- LINUX BUG Ubuntu Unity D.M. uses some [ALT] clicks for system-wide purpose (on Ubuntu16.04LTS [ALT] clicks on tool buttons do work as expected, also no problem with Xubuntu's xfce D.M.)

- LINUX BUG desktop icon integration broken with 32x32 icons tho works with 16x16

- LINUX BUG Debian MIME type icons are mostly .SVG and JRE8 does not internally support .SVG rendering (no problem with Xubuntu's xfce D.M.)

- LINUX BUG drag-n-drop is INTERMITTENTly throwing an Exception in the bowels of .getDragFlavors() on Unity in Ubuntu (Fedora 20 works and is not broken)

==========================================================================================================================================================================

- UNIX BUG the root dir can not show its sub-folders from persistence due to splits error in get path_to_child_names in FolderCentral (confirmed even after MSWin drive letters fix)

==========================================================================================================================================================================

- PERFORMANCE have stores listen for big GC to write BLOBs so as to soft ref them reducing memory pressure, this is possible via GarbageCollectorMXBean { https://stackoverflow.com/questions/30041332/a-useful-metric-for-determining-when-the-jvm-is-about-to-get-into-memory-gc-trou/30045806#30045806 } and google search "java event listener eden garbage collection"

- PERFORMANCE improve similar matching by using the image pyramid 1x1, 2x2, 4x4, 8x8, 16x16 scheme mentioned in ContentAccess, currently only 1x1 and 16x16 checked

- PERFORMANCE similar pixel scoring should be improved by making sure a 2x2 version matches within the same tolerances as the 1x1 version of the 16x16 ARGB, this will force the matching pixels to be better grouped by quadrant proximity and less scatter-shot with false positives DON'T FORGET to flip, rotate, etc

- PERFORMANCE review and drop all uses of String.intern() if that String is centralized elsewhere (Directory Central / Folder).  Sampled profiling indicates .intern() as a big time suck

- PERFORMANCE cache last Similarity Search so that the similarity slider can be moved back and forth quickly or the last search recalled

- PERFORMANCE CliUtil needs to have a dedicated Executor ThreadPool (though has pool for console Out/Err stream drain threads)

- PERFORMANCE GraphicsMagic 'mogrify' command can batch up hundreds of operations without .DLL, .SO, .DYLIB process thrashing but first test for speed improvement in case it lingers as a psudo-service for a few minutes first

- PERFORMANCE folder watching is not batching up alterations and is thus not performant, dropping in 100 dirs from the Host OS into a watched folder will cause 100 panel updates

- PERFORMANCE [dual thread I/O makes it bearable] loads next screen full of FC icons so that slow page downs do not clunk so bad, i.e. avoid delay while loading like a web or PDF viewer would

- PERFORMANCE more parallelization of CPU cores (FC construction an insertion into non-parented series JPanel?)

- PERFORMANCE dragging-and-drop leaks the File objs that were dragged in.  Noticed on Mac when 15K+ from Finder.  Might be fixed in JRE 1.8.0_25

==========================================================================================================================================================================

- ARCHITECTURE need SHA-1_to_Regfi tandem arrays to map file content like e-books and reduce duplicate contents across many Diff/Sync'd volumes

- ARCHITECTURE when showing or sorting by Dimensions, any broken image causes Duplicates and Similar SC correlation popper buttons to not appear because no SC will exist to iterate through until the info gather task checks those broken dimensions again

- ARCHITECTURE broken image render counts as pure white 16x16 ARGB when Similarity checking, broken image should not be considered at all

- ARCHITECTURE have stores listen for big GC cleanup to write icon BLOBs so as to soft ref them for later GC, technique uses ManagementFactory.getGarbageCollectorMXBeans(), see https://stackoverflow.com/questions/30041332/a-useful-metric-for-determining-when-the-jvm-is-about-to-get-into-memory-gc-trou

- ARCHITECTURE remove "one second" kludge from mixing java.ioFile.lastModified() and results from java.nio.Files.getLastModifiedTime() (or Attributes struct) rounding errors present from differing levels of time resolution on Host OS

- ARCHITECTURE extend ContentAccess with ImageContentAccess and include lazy metadata data, height width, and SoftReference to menu preview image which will help to dethunk UI when IM/GM

- ARCHITECTURE when original file renamed or moved from Host OS, does not update in browser.  Will need a FileID or inode or Java7 per file watching.

- ARCHITECTURE memory issues, using 250MB for 100K files, has improved lately, might want to consider dynamic Folder contents based mode (java.awt.Component is incredibly wasteful and we are stuck with it)

- ARCHITECTURE save memory by converting filename (and directory path) Strings to UTF-8 (a'la JDK6 string compression, supposed to be back for JDK9)

==========================================================================================================================================================================

- README include SourceForge write up and URL

- README provide other text files description

- README verify chain-of-trust with instructions on building and jarring CompileSrc bootstrap .JAR itself from ./src/CompileSrc.java (and drop EOL'd Java6 baseline syntax)

==========================================================================================================================================================================

- WONT/CANT FIX Path view tab headers cause layout problems when they are wider than the available space

- WONT/CANT FIX following symbolically linked image files even though Import configuration says not to, see "/usr/share/icons/"
