Bug 481132 - According documentation »kalarm« allows calendar directories where each event is a single ICS file – in practice it doesn't
Summary: According documentation »kalarm« allows calendar directories where each event...
Status: RESOLVED FIXED
Alias: None
Product: kalarm
Classification: Applications
Component: general (show other bugs)
Version: 3.5.4.2
Platform: openSUSE Linux
: NOR normal
Target Milestone: ---
Assignee: David Jarvie
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2024-02-09 17:41 UTC by Flossy Cat
Modified: 2024-02-10 18:12 UTC (History)
0 users

See Also:
Latest Commit:
Version Fixed In: 23.08.5


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Flossy Cat 2024-02-09 17:41:46 UTC
SUMMARY
According https://docs.kde.org/stable5/en/kalarm/kalarm/create-edit.html#calendars (search for the heading "Storage type") is claimed:
> KAlarm handles two alarm calendar storage types:
> …
> Local directory: Alarms are stored in a local folder, each alarm being stored in a separate iCalendar file within the folder. 
> This storage method has the advantage that in the event of file corruption, you should lose only one alarm, 
> not the entire calendar.

Exactly for that reason I wanted to create a "Local directory" calendar but »kalarm« only allows to choose a 
local ICS file (i.e. all events lumped together within a single).


STEPS TO REPRODUCE
1. open »kalarm« and add a new calendar
2. the popup window only allows to select a single ICS file, not a directory and provides no way to create a "Local directory" calendar.

OBSERVED RESULT
No option to add a "Local directory" calendar in contrast to documentation:

> Add...
>
>    Add a calendar of the selected type to the list. You are asked to choose a storage type, following which the calendar 
> configuration dialog is displayed, where you can enter the location of the calendar and its characteristics. If there is no 
> existing alarm calendar in the specified location, a new one will be created.

EXPECTED RESULT
»kalarm« provides the choice of storage type as documented and implements adding "Local directory" calendars.
(much less prefered solution: documentation is corrected … ;-)

SOFTWARE/OS VERSIONS
[copied from System Information]
Operating System: openSUSE Leap 15.5
KDE Plasma Version: 5.27.9
KDE Frameworks Version: 5.103.0
Qt Version: 5.15.8
Kernel Version: 5.14.21-150500.55.44-default (64-bit)
Graphics Platform: X11
Processors: 8 × Intel® Core™ i5-10210U CPU @ 1.60GHz
Memory: 7.6 GiB of RAM
Graphics Processor: Mesa Intel® UHD Graphics
Comment 1 David Jarvie 2024-02-10 18:12:33 UTC
The local directory calendar functionality was removed some time ago in KAlarm version 3.0 (KDE Applications 20.08), when KAlarm ceased to use Akonadi for calendar storage. The description of the local directory calendar has now been removed from the documentation for KDE Gear 23.08.5 (commit 268ecdf9300a900a6b9cd0908ae670ec342b59e9) and 24.02 (commit 936f9adf949e8b273ebaadf4bb1e12ab0f945994).

Note that the link to the KAlarm documentation in your bug report actually shows an out of date version of the documentation. The last released revision of the documentation was for KAlarm version 3.6. I've raised a bug report https://bugs.kde.org/show_bug.cgi?id=481176 to get the website updated.