Ошибки в исходной документации Опции

[Litkevich Yuriy]

Надо собирать ошибки обнаруженные в исходной документации
----

1. qtxml.html
   
   • Описание:
     в файле qtscript.html навигация выглядит так:
     [Previous: QtSvg Module] [Qt's Modules] [Next: QtXml Module]
     а в qtxml.html так:
     [Previous: QtSvg Module] [Qt's Modules] [Next: QtDesigner Module]
     хотя в место [Previous: QtSvg Module]
     должно быть [Previous: QtScript Module]
     
     
   • Резюме:
     Исправленно в хранилище, но надо проверять в следующих версиях
   
   
   
2. qmainwindow.html - обнаружила Анна
   
   • Описание:
     Есть упоминание несуществующей функции setDockWidgetCorner()
     
     
   • Резюме:
     Оставлено как есть (надо бы у тролей поинтерисоваться).
   
   
   
3. annotated.html
   
   • Описание:
     Незавершенное предложение: QDBusObjectPath - Enables the programmer to identify the
     Должно быть: QDBusObjectPath - Enables the programmer to identify the OBJECT_PATH type provided by the D-BUS typesystem
     
     
   • Описание:
     Незавершенное предложение: QDBusSignature - Enables the programmer to identify the
     Должно быть: QDBusSignature - Enables the programmer to identify the SIGNATURE type provided by the D-BUS typesystem
     
     
   • Описание:
     Незавершенное предложение: QStyleOptionQ3DockWindow - Used to describe the parameters for drawing various parts of a
     Должно быть: QStyleOptionQ3DockWindow - Used to describe the parameters for drawing various parts of a Q3DockWindow
     
     
   • Резюме:
     Необходимо исправлять в оригинале перед переводом иначе сегмент получится один и тот же и перевод будет один.
   
   
   
   
4. containers.html
   
   • Описание:
     Опечатка: "... but here are the guiding priciples:"
     Должно быть: "... but here are the guiding principles:"
     
     
   • Резюме:
     Необходимо исправлять в оригинале перед переводом.
   
   
5. install-x11.html
   
   • Описание:
     Написано: "Run the Qt Examples and Demos either by typing qtdemo on the command line or through the desktop's Start menu."
     Должно быть: "Run the Qt Examples and Demos either by typing qtdemo on the command line or through the desktop's Main menu."
     
     В GNU/Linux дистрибутивах на основе KDE/GNOME это называется главное меню, а не "Пуск"
     
     
   • Резюме:
     Необходимо исправлять в оригинале перед переводом.

Сообщение отредактировал Litkevich Yuriy - 25.10.2008, 10:52

Причина редактирования: добавил еще ошибку

[Litkevich Yuriy]

это неподходящая проверка, isEmpty() тоже даст конкретный результат.

я такой тест провел:

#include <QtCore>
//#include "class.h" 

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

  QByteArray *dt1 = new QByteArray();
  QByteArray *dt2 = new QByteArray((const char *)0);
  
    qDebug() << "dt1->isNull() " << dt1->isNull() << "\n";        //true
    qDebug() << "dt1->isEmpty() " << dt1->isEmpty() << "\n";    //true
    qDebug() << dt1 << "\n";                                    //0x3f9358
    qDebug() << *dt1 << "\n";                                    // ""
    
    qDebug() << "dt2->isNull() " << dt2->isNull() << "\n";        // true
    qDebug() << "dt2->isEmpty() " << dt2->isEmpty() << "\n";    // true
    qDebug() << dt2 << "\n";                                    // 0x3f8ac8
    qDebug() << *dt2 << "\n";                                    // ""    
    
    
    return 0; //a.exec();
}

похоже что в документации правильно:

Constructs an empty byte array.

там еще такие строчки есть:

We recommend that you always use isEmpty() and avoid isNull().