diff --git a/docs/Doxyfile.local b/docs/Doxyfile.local
new file mode 100644
index 0000000..f0b0f2e
--- /dev/null
+++ b/docs/Doxyfile.local
@@ -0,0 +1,7 @@
+### KApiDox Project-specific Overrides File
+
+# define so that deprecated API is not skipped
+PREDEFINED += \
+    "KI18N_ENABLE_DEPRECATED_SINCE(x, y)=1" \
+    "KI18N_BUILD_DEPRECATED_SINCE(x, y)=1" \
+    "KI18N_DEPRECATED_VERSION(x, y, t)="
diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 4c5e4a2..b50daa6 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -1,127 +1,128 @@
 set(libki18n_SRCS
     klocalizedstring.cpp
     klocalizedtranslator.cpp
     kcatalog.cpp
     kuitmarkup.cpp
     common_helpers.cpp
     klocalizedcontext.cpp
     main.cpp
 )
 
 ecm_qt_declare_logging_category(libki18n_SRCS
     HEADER ki18n_logging.h
     IDENTIFIER KI18N
     CATEGORY_NAME kf5.ki18n
 )
 
 ecm_qt_declare_logging_category(libki18n_SRCS
     HEADER ki18n_logging_kuit.h
     IDENTIFIER KI18N_KUIT
     CATEGORY_NAME kf5.ki18n.kuit
 )
 
 add_library(KF5I18n ${libki18n_SRCS})
 add_library(KF5::I18n ALIAS KF5I18n)
 ecm_generate_export_header(KF5I18n
     BASE_NAME KI18n
     GROUP_BASE_NAME KF
     VERSION ${KF5_VERSION}
     DEPRECATED_BASE_VERSION 0
     DEPRECATION_VERSIONS 5.0
     EXCLUDE_DEPRECATED_BEFORE_AND_AT ${EXCLUDE_DEPRECATED_BEFORE_AND_AT}
 )
 
 target_include_directories(KF5I18n INTERFACE "$<INSTALL_INTERFACE:${KDE_INSTALL_INCLUDEDIR_KF5}/KI18n>")
 target_include_directories(KF5I18n PRIVATE ${LibIntl_INCLUDE_DIRS})
 
 target_link_libraries(KF5I18n PUBLIC Qt5::Core)
 # This is only required for platforms which don't use glibc (with glibc LibIntl_LIBRARIES will be empty)
 target_link_libraries(KF5I18n PRIVATE ${LibIntl_LIBRARIES})
 target_compile_options(KF5I18n PRIVATE -DTRANSLATION_DOMAIN=\"ki18n5\")
 
 set_target_properties(KF5I18n PROPERTIES VERSION   ${KI18N_VERSION_STRING}
                                          SOVERSION ${KI18N_SOVERSION}
                                          EXPORT_NAME I18n
 )
 
 install(TARGETS KF5I18n EXPORT KF5I18nTargets ${KF5_INSTALL_TARGETS_DEFAULT_ARGS})
 
 ecm_generate_headers(KI18n_HEADERS
   HEADER_NAMES
     KLocalizedContext
     KLocalizedString
     KLocalizedTranslator
     KuitMarkup
     KuitSetup
     REQUIRED_HEADERS KI18n_HEADERS
 )
 
 find_package(PythonModuleGeneration)
 
 if (PythonModuleGeneration_FOUND)
   ecm_generate_python_binding(
     TARGET KF5::I18n
     PYTHONNAMESPACE PyKF5
     MODULENAME KI18n
     RULES_FILE "${CMAKE_SOURCE_DIR}/cmake/rules_PyKF5.py"
     SIP_DEPENDS
       QtCore/QtCoremod.sip
     HEADERS
       klocalizedcontext.h
       klocalizedstring.h
       klocalizedtranslator.h
       kuitmarkup.h
       kuitsetup.h
   )
 endif()
 
 install(FILES
     ${KI18n_HEADERS}
     ${CMAKE_CURRENT_BINARY_DIR}/ki18n_export.h
     DESTINATION "${KDE_INSTALL_INCLUDEDIR_KF5}/KI18n" COMPONENT Devel
 )
 
 ### ktranscript plugin
 if (BUILD_WITH_QML)
 
 set(ktranscript_LIB_SRCS
     ktranscript.cpp
     common_helpers.cpp
 )
 add_library(ktranscript MODULE ${ktranscript_LIB_SRCS})
 generate_export_header(ktranscript BASE_NAME KTranscript)
 target_link_libraries(ktranscript PRIVATE Qt5::Qml Qt5::Core)
 
 install(TARGETS ktranscript DESTINATION ${KDE_INSTALL_PLUGINDIR}/kf5)
 
 endif()
 
 if (BUILD_QCH)
     ecm_add_qch(
         KF5I18n_QCH
         NAME KI18n
         BASE_NAME KF5I18n
         VERSION ${KF5_VERSION}
         ORG_DOMAIN org.kde
         SOURCES # using only public headers, to cover only public API
             ${KI18n_HEADERS}
             "${CMAKE_SOURCE_DIR}/docs/programmers-guide.md"
             "${CMAKE_SOURCE_DIR}/docs/translators-guide.md"
         MD_MAINPAGE "${CMAKE_SOURCE_DIR}/README.md"
         LINK_QCHS
             Qt5Core_QCH
         INCLUDE_DIRS
             ${CMAKE_CURRENT_BINARY_DIR}
         BLANK_MACROS
             KI18N_EXPORT
             KI18N_DEPRECATED_EXPORT
             KI18N_DEPRECATED
+            "KI18N_DEPRECATED_VERSION(x, y, t)"
         TAGFILE_INSTALL_DESTINATION ${KDE_INSTALL_QTQCHDIR}
         QCH_INSTALL_DESTINATION ${KDE_INSTALL_QTQCHDIR}
         COMPONENT Devel
     )
 endif()
 
 include(ECMGeneratePriFile)
 ecm_generate_pri_file(BASE_NAME KI18n LIB_NAME KF5I18n DEPS "core" FILENAME_VAR PRI_FILENAME INCLUDE_INSTALL_DIR ${KDE_INSTALL_INCLUDEDIR_KF5}/KI18n)
 install(FILES ${PRI_FILENAME} DESTINATION ${ECM_MKSPECS_INSTALL_DIR})