// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page qtversit-index.html
    \title Qt Versit
    \brief Qt Versit enables clients to import and export contact and calendar
    information in vCard and iCalendar formats.

    Most of the time your contacts do not remain in isolation in a single
    device, but coexist on various mobile phones, computers, and servers. A
    standard way to exchange the contacts is through the Versit \reg documents.

    The Qt Versit API enables you to import calendar or contact information in
    VCard and iCalendar format to the Qt Organizer and Qt Contact API, and to
    store the information on the current platform. Alternatively, you can
    export organizer and contact information to VCal or iCalendar files which
    you can then import into other calendars and contact storages, or easily
    share through Bluetooth or email, for example.

    The \l{Qt Organizer} module has information about supported
    \l{Supported iCalendar Features}{iCalendar features}.

    \section1 Getting Started

    To include the definitions of the module's classes, use the following
    directives. The generic Qt Versit is used in the contacts use case, and it
    is extended with Qt Organizer:

    \snippet doc_src_qtversit.cpp versit include
    \snippet doc_src_qtversit.cpp versit organizer include

    To use the C++ library in your application, add the following to your
    \c CMakeLists.txt file:

    \snippet snippets/CMakeLists.txt cmake_use

    \section1 Related Information

        \section2 Guides
        \list
        \li \l{Supported vCard Features}
        \li \l{Qt Versit Overview}
        \li \l{Qt Versit Plugins}
        \endlist

        \section2 References

        \list
        \li \l{Qt Versit C++ Classes}
        \endlist
*/
