Change log and explanations:
- Exchange the title and summary of animate covers
- Remove period (.) as a legal character in CC template-generated path names, replacing it with an underscore.
- Add an option to rename book files if a book with a different path is being downloaded
Explanation for the last two.
- Remove periods: CC has always changed periods (and other characters) to underscores when downloading books using the content server and cloud connections (without templates). Calibre does similar things when sending books via the wireless device. Up to now, templates have allowed periods, meaning that a template could generate a different name than calibre or the default file name mechanism. This change attempts to make the methods work better together. They should also prevent at least some of the problems Purple Lady is reporting.
- Rename book files: By default and since forever, when sending a book over the wireless device that already exists in CC's library, calibre + CC reused the old path, ignoring the results of the template. This means that if you changed a book's author from AAA to BBB and then resent the book, the file name would still contain AAA. If you downloaded a book that already exists via the content server or the cloud a similar thing happened. The book file was not renamed. This is good behavior in that it prevented creation of duplicate files. The bad behavior is that the file names might not match the metadata.
When templates were introduced this behavior changed. Using the above example, if you changed the author from AAA to BBB then you would get two copies of the book on your device, one with path AAA ... and one with path BBB .... This has the good behavior that file names match metadata. It has the bad behavior that you can get multiple copies of the same book in your CC library.
The changes I made attempt to get the best of both worlds. If templates are in use then if a book is downloaded by any method, the book file is renamed to match the template. File names match metadata and only one copy exists. The down side is that during wireless connects CC can "ignore" calibre and use a file name that calibre doesn't know about. Calibre interprets this as meaning that there are two copies on the device when in fact there aren't. CC now shows a message (a toast) to tell you that calibre might be confused. Disconnecting and reconnecting eliminates the confusion.
I added an option to Settings / File Names to disable this new behavior, should someone prefer what it did before. The new behavior is [EDIT] disabled by default.
I will make the release sometime before my evening. I am still testing.