Bug 469117

Summary: No explanation for folder aware or random aware options in the Advanced Renaming tool documentation
Product: [Applications] digikam Reporter: michael2macdonald
Component: DocumentationAssignee: Digikam Developers <digikam-bugs-null>
Status: RESOLVED FIXED    
Severity: minor CC: caulier.gilles, metzpinguin, michael2macdonald
Priority: NOR    
Version First Reported In: 8.1.0   
Target Milestone: ---   
Platform: unspecified   
OS: All   
Latest Commit: Version Fixed/Implemented In: 8.1.0
Sentry Crash Report:

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