Bug 469117 - No explanation for folder aware or random aware options in the Advanced Renaming tool documentation
Summary: No explanation for folder aware or random aware options in the Advanced Renam...
Status: RESOLVED FIXED
Alias: None
Product: digikam
Classification: Applications
Component: Documentation (show other bugs)
Version: 8.1.0
Platform: unspecified All
: NOR minor
Target Milestone: ---
Assignee: Digikam Developers
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-04-28 19:54 UTC by michael2macdonald
Modified: 2023-04-29 12:47 UTC (History)
3 users (show)

See Also:
Latest Commit:
Version Fixed In: 8.1.0


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description michael2macdonald 2023-04-28 19:54:32 UTC
SUMMARY
The Digikam documentation currently explains what the "Extension aware numbering and Folder aware numbering" options do, but doesn't mention the folder aware or random aware options. These options should be included in the documentation.
Comment 1 Maik Qualmann 2023-04-28 20:31:43 UTC
Folder aware is explained in the documentation and Random is unique string/numbering.

-----
In the sequence Number dialog you will find two options: Extension aware numbering and Folder aware numbering. If they are checked digiKam will start a new sequence for every file extension and / or folder.
-----

Maik
Comment 2 Maik Qualmann 2023-04-28 20:36:37 UTC
I assume you don't mean Folder aware numbering, but Counter aware numbering. Counter aware numbering searches for the highest used counter in the filename in the image's directory and continues it.

Maik
Comment 3 michael2macdonald 2023-04-28 21:52:38 UTC
(In reply to Maik Qualmann from comment #2)
> I assume you don't mean Folder aware numbering, but Counter aware numbering.
> Counter aware numbering searches for the highest used counter in the
> filename in the image's directory and continues it.
> 
> Maik

Thank you, I did mean counter-aware numbering. Random aware numbering is pretty self-explanatory, but my main issue is that counter-aware numbering is unclear and I could not find any explanation on how it works. It would be great if you could add that exact explanation to the docs:

"Counter aware numbering searches for the highest used counter in the filename in the image's directory and continues it."
Comment 4 caulier.gilles 2023-04-29 03:28:59 UTC
Git commit c2be462859efff0c748e576382e479bd77597aec by Gilles Caulier.
Committed on 29/04/2023 at 03:27.
Pushed by cgilles into branch 'master'.

Describe "Randow text aware numbering" option in Advanced renamed tool online documentation.

M  +6    -1    main_window/image_view.rst

https://invent.kde.org/documentation/digikam-doc/commit/c2be462859efff0c748e576382e479bd77597aec
Comment 5 caulier.gilles 2023-04-29 07:07:21 UTC
Maik,

The "Random text aware numbering" is an undocumented option in the Advanced Rename online documentation. What"s the purpose of this rule ?

Gilles
Comment 6 Maik Qualmann 2023-04-29 11:46:01 UTC
Hi Gilles,

This was a user wish to have a random numeric code for the  numbering. It is a random number with up to 31 digits created by QUuid. It is clear that with e.g. "##" there is still no random sequence, with more "#" it becomes more and more unique.

Maik
Comment 7 Maik Qualmann 2023-04-29 11:52:18 UTC
Small correction, it's a hexadecimal random string.

Maik
Comment 8 caulier.gilles 2023-04-29 12:47:18 UTC
Git commit 45c395b3f5c2ff7715aec4555a35daf3b9f174bc by Gilles Caulier.
Committed on 29/04/2023 at 12:46.
Pushed by cgilles into branch 'master'.

Online documentation: add more details about rename numbering options
FIXED-IN: 8.1.0

M  +1    -1    main_window/image_view.rst

https://invent.kde.org/documentation/digikam-doc/commit/45c395b3f5c2ff7715aec4555a35daf3b9f174bc