[frameworks-kholidays] [Bug 457176] New: No API documentation for HolidayRegion::rawHolidaysWithAstroSeasons()

[David Jarvie]

https://bugs.kde.org/show_bug.cgi?id=457176

            Bug ID: 457176
           Summary: No API documentation for
                    HolidayRegion::rawHolidaysWithAstroSeasons()
           Product: frameworks-kholidays
           Version: 5.96.0
          Platform: Other
                OS: Linux
            Status: REPORTED
          Severity: normal
          Priority: NOR
         Component: general
          Assignee: kdepim-bugs at kde.org
          Reporter: djarvie at kde.org
  Target Milestone: ---

There is nothing in the API documentation to indicate what
HolidayRegion::rawHolidaysWithAstroSeasons() is for, as compared to
HolidayRegion::rawHolidays() - the API description for the two methods is
identical. The name rawHolidaysWithAstroSeasons doesn't mean anything to me, so
a description is necessary.

Looking at the autotest/testholidayregion.cpp code, it seems,
counter-intuitively, that rawHolidaysWithAstroSeasons() is functionally
equivalent to the deprecated holidays() function. Rather, I would have expected
that rawHolidays() would now be equivalent to holidays().

Please include descriptions for rawHolidaysWithAstroSeasons() and rawHolidays()
which makes clear what each is actually for.

SOFTWARE/OS VERSIONS
KDE Frameworks Version: 5.97.0

-- 
You are receiving this mail because:
You are the assignee for the bug.