Uploaded image for project: 'Qt Mobility'
  1. Qt Mobility
  2. QTMOBILITY-1817

More clear deprecation of Bearer Management API needed

    XMLWordPrintable

Details

    • Bug
    • Resolution: Done
    • P2: Important
    • 1.2.x
    • 1.1.2
    • Documentation
    • a33e26a4dba3f74c3b15fd4360c02ad90f9d9313

    Description

      There has been cases where some existing applications are crashing in Symbian due to Qt Mobility Bearer management. The result was that the API is deprecated and the issues are not fixed as same issue doesn't exist in Qt's Bearer API.

      It would be good to label deprecated APIs clearly from the reference documentation so that this is the first sentence in the doc page. Perhaps Qt reference doc needs global way to label deprecation that it's done similar throughout the docs. (E.g. similar to @deprecated tag in other doc systems.)

      For Qt mobility bearer management the suggestion is to:

      1. Have this indicated from the top of the page as the first sentence: http://doc.qt.nokia.com/qtmobility-1.2/bearer-management.html

      2. Have the deprecation be labeled in each class docs:
      a) http://doc.qt.nokia.com/qtmobility-1.2/qnetworkconfiguration.html
      b) http://doc.qt.nokia.com/qtmobility-1.2/qnetworkconfigurationmanager.html
      c) http://doc.qt.nokia.com/qtmobility-1.2/qnetworksession.html

      Attachments

        Activity

          People

            pyard Peter Yard (closed Nokia identity) (Inactive)
            auotila Aleksi Uotila
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: