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

[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

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

[Анна]

В статье QByteArray

в описании класса сказано:

For historical reasons, QByteArray distinguishes between a null byte array and an empty byte array. A null byte array is a byte array that is initialized using QByteArray's default constructor or by passing (const char *)0 to the constructor. An empty byte array is any byte array with size 0. A null byte array is always empty, but an empty byte array isn't necessarily null:

Однако, при описании конструктора:

QByteArray::QByteArray ()
Constructs an empty byte array.

Мне кажется, во втором случае все же правилнее перевести неинициализированный массив.

[AD]

В статье QByteArray

в описании класса сказано:

A null byte array is a byte array that is initialized using QByteArray's default constructor or by passing (const char *)0 to the constructor.

Однако, при описании конструктора:

QByteArray::QByteArray ()
Constructs an empty byte array.

Мне кажется, во втором случае все же правилнее перевести неинициализированный массив.

Мне тоже так кажется. А в исходной поправить на null byte array!

[Litkevich Yuriy]

Мне кажется, во втором случае все же правилнее перевести неинициализированный массив.

В этой теме надо решать не как перевести, а как должен выглядеть английский текст. Дабы при переводе с помощью OmegaT все было правильно. Т.е. сначало вносится правка в английскую документацию, а потом переводим с помощью OmegaT.

Анна, укажи в какой версии ты это обнаружила и какой именно файл.

P.S. z я пока непонял ошибка это или нет. Надо бы как-то поэксперементировать с этим классом.

[Анна]

здесь, примерно, один экран вверх от начала описания функций класса. Начинается со слов "For historical reasons, QByteArray distinguishes between a null byte array..." + описание первого конструктора.

В документации к 4.4.0 то же самое.

Проверяется легко

QByteArray dt;
bool res = dt.isNull();
// res будет равен true (во всяком случае в винде)
.

Сообщение отредактировал Анна - 1.10.2008, 16:31

[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().

[alex977]

misc.html

Maps open-standard MIME to Window Clipboard formats

и qwindowsmime.html

аналогично:

The QWindowsMime class maps open-standard MIME to Window Clipboard formats.

Пропущена S в слове WindowS - речь идет о буфере обмена именно ОС WindowS.

[Анна]

Ты взял оба случая, когда создаются "null byte" массивы, как и сказано в описании класса (isNull() возвращает true).
А если взять конструктор QByteArray(""), то isNull() вернет false, а isEmpty() - true. Это создался "empty" массив

Вот где у них неточность:

QByteArray() они называют "empty" массивом
а про QByteArray ( const char * data, int size ) пишут, что при условии, что data=0, создается "null byte"
Хотя в обоих случаях isNul() вернет true., т.е. они оба "null byte".

"empty" массив создается конструктором QByteArray(""). isNull() вернет false, а isEmpty() - true.

---------------------------------------------
Резюме:

QByteArray::QByteArray ()
Constructs an empty byte array.
See also isEmpty().

QByteArray::QByteArray ( const char * str )
Constructs a byte array initialized with the string str.

исправляем на

QByteArray::QByteArray ()
Constructs an null byte array.
See also isEmpty() and isNull().

QByteArray::QByteArray ( const char * str )
Constructs a byte array initialized with the string str.
If str is 0, a null byte array is constructed.
QByteArray makes a deep copy of the string data.

Сообщение отредактировал Анна - 2.10.2008, 10:37

[ЙаМайскЫйПчОЛ]

Анна, Если хочешь, я тролям в суппорт отпишу пусть пошерстят у себя???
Может вопрос терминов?

И вообще имея платный аккаунт у тролей грех им не пользоваться.
Давайте синхронизируем деятельность тов. переводчиков с багфиксингом у троллей.

Сообщение отредактировал ЙаМайскЫйПчОЛ - 2.10.2008, 22:26

[Litkevich Yuriy]

тут понять надо есть ошибка или нет, я что-то вообще непойму чем отличить эти два варианта, если не пользоватся штатными функциями (isNull() isEmpty()), да и троли рекомендуют избегать первую