Wow, thank you for the detailed and well organized analysis!

Let me address your points one by one.

There are two questions on mz3Viewer (1.1 and 2.1)

1.1 Search stratagy mz3Viewer

To make it most comfortable for the user a combination of search strategies is used. The goal is to find a good compromise between performance (fast response, short search times) and number of hits.

Search depth

The search depth is limited to one. Exception: the folder name contains "mz3". In such case also sub folders are searched.

Search pathes

You are right, a former version of mz3Viewer searched in myDocuments, desktop and other folders; with search depths of 1…3; depending on the path. That was far too complex and could take pretty long if the user had much data. Hard to predict, several disadvantages with no real value. So that was abandoned

Actually only the documents/mz3Viewer/ path is searched. All Mz3 Titles that are entered as zipped Offline package will end up in that folder. And if you plan to collect Mz3 Titles for viewing with mz3Viewer, that would be the best location. Those Mz3 Titles will be found automatically.

To help during the "development process", i.e. while working with mz3Tool (or mz3Demo), also the remembered "destination" pathes are searched. Or in other words: Every path that shows up in the "Recent destination" drop downlist is searched also. With that you will find all Mz3 Titles you worked on recently also in the mz3Viewer list.

If you start mz3Viewer with a file (an mz3 or mz3z or zip file), also that path will be added to the list.

You can do so in double clicking on such file, if that extension is assigned to mz3Viewer. Or in "opening with" such file and selcting mz3Viewer.

You also can drag&drop such file on mz3Viewer (anywhere in the window) or the program icon of mz3Viewer.

Updates and Maintenance

Updates and Maintenance

If mz3Viewer cannot find a saved path during start, that path will be deleted in the list automatically.

Summary:

This strategy should help seeing Mz3 Titles of interest in most cases. You can sort each column to quickly find the Mz3 Title you are interested in. You even could enter some characters of the name and mz3Viewer will show the first Mz3 Title containing that string.

If mz3Viewer does not find what you expected, simply drag&drop your file on mz3Viewer and next time it’ll be in the list.

I do not see any reason qhy the user should restrict that automatically built list. And as explained: he could in simply deleting or renaming folders he does not want to see in the list.

This should help most users finding "their" titles quickly and easily, and still give full control.

First paragraph:

1.2 … 1.6 Mostly correct; and all that is on purpose

"mixing" of Mz3 Titles does not harm, but offers the option to share certain genral configuration settings (as explained in my previous answer). Once you create an "Offline package", the Mz3 Titles are serparated and no more mixed.

It is by intention that existing data is not deleted. Only that way you can convert/exchange a selected range of pages.

Helpful in case of Mz3 Titles with hundreds of pages and a big time saver.

Also needed if you do not convert again but just do changes that only require a new "Create". Like adding video or sound, changing the kind of pages (stiff, flexible), change other book attributes, …

Also in case of multilingual Mz3 Titles (more than one language supported in the book) a "mixing" is needed.

As you correctly realized, if that default behaviour is not what you need/like, you can defnie a different OUT (destination) path or place your PDF file in a different location; i.e. not "mixing" your PDFs. Or in other words:

mixed in -> mixed out ๐Ÿ˜‰

mz3Tool relies on finding an _mz3Data folder. Therefore that folder always is created. And you never should rename it! Otherwise that folder will be created again and all former data is not seen/found any longer.

See also the blog post MegaZine3 Variants and Folder Structure where in the last paragraph that is explained in more detail.

And finally on your point 1.6: It is possible to delete entries in the list; in two ways:

  • indirectly in deleting, moving or renaming the respective (real) path. During start mz3Tool like mz3Viewer checks if the pathes in the list do exist. In case they don’t, the reference is taken off the list.
  • there is a button now that allows to delete the complete list. Especially if the list is long this can be the faster, more comfortable approch.

Second paragraph

Most points should be addressed already.

On your remark on versioning:

If you do not like the "automatic" handling (or "mixing" as you call it; which should not harm and is similar as "mixing" PDF files in having them in the same folder?!?):

Why don’t you manage your versions in putting them in sub folders named after the version?

This is a standard approach and does not clutter but organize. And then all data is separated in _mz3Data sub folders ot the respective version folders

Third paragraph

3.1 It is (see above: either use the delete option (trash icon) or hide the path (delete/move/rename)

3.2 don’t understand; you can define any path as OUT destination, also another "default" path

3.3 not sure I understand fully; Not touching (overwriting) data of other files is the expected and desired behaviour, I think.

3.4. That kind of warning already is given: if data exists, i.e. if the PDF file was converted before, the Mz3 Title will be shown; without conversion. A conversion always only happens if initiated by the user.

If no Mz3 title is shown: it most probably is a new file name or it was never converted before.

If a book shows up after a PDF file was entered/selected, it is a known name and the PDF file was converted before.

3.5 Same as 3.3? No, although data of different PDF files is kept in the same folder ("mixed"), this does not mean that changing one file should delelte all others (most users would kill me if that happened ;-).

But you always have the option doing so:

Everything is transparent, the folder structure is know and you in many cases can open the desired folder with a click on the "…" button or the "open folder icon".

Summary

you might have a special use case with many versions (and not many different Mz3 Titles).

mz3Tool is not a version management tool. That is up to you and you have all means doing so. And I hope I could show you some options for doing so.