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

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 это называется главное меню, а не "Пуск"
     
     
   • Резюме:
     Необходимо исправлять в оригинале перед переводом.

В статье QByteArray

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


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


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

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

В этой теме надо решать не как перевести, а как должен выглядеть английский текст. Дабы при переводе с помощью 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 (во всяком случае в винде)
.

это неподходящая проверка, 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();
}

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

misc.html



и qwindowsmime.html

аналогично:



Пропущена 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.

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


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

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

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

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

Да, я даже не знаю, что решить. Они сами в нескольких местах делают упор на различиях, типа "Так исторически сложилось...", а потом сами смешивают эти два понятия. Можно, конечно, им на это попинать. Просто, когда читаешь текст целиком, эта путаница бросается в глаза. Обычно, никто не читает описание конструктора по умолчанию, поэтому и не обратили внимание на такую фигню.

Проверила, что во всех случаях возвращает data(). Везде возвращается указатель на 0. Другие функции тоже, я думаю, различий не делают. Так что, похоже,различия только в isNull() и isEmpty().

А к Троллям у меня есть более серьезная претензия. ЙаМайскЫйПчОЛ, если хочешь, отпишу о ней в личку.

Анна, к нам тут заходил сотрудник трольтеха, надоб его на помощь позвать.

Файл examples-overview.html

Qt's painting system is able to render vector graphics, images, and outline font-based text with sub-pixel accuracy accuracy using anti-aliasing to improve rendering quality.

Два раза стоит accuracy.

Файл annotated.html

QDBusObjectPath
Enables the programmer to identify the
Должно быть (д.б.)
Enables the programmer to identify the OBJECT_PATH type provided by the D-BUS typesystem

QDBusSignature
Enables the programmer to identify the
д.б.
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
д.б.
Used to describe the parameters for drawing various parts of a Q3DockWindow

Phonon::BackendCapabilities::Notifier
(пусто)
д.б.
Notifications about backend capabilities

===============================
Файл model-view-model-subclassing.html:

Implementations must call beginRemoveRows() before inserting new columns into any underlying data structures, and call endRemoveRows() immediately afterwards.
д.б.
Implementations must call beginRemoveRows() before rows are removed from any underlying data structures, and call endRemoveRows() immediately afterwards.

Implementations must call beginInsertColumns() before rows are removed from any underlying data structures, and call endInsertColumns() immediately afterwards.
д.б.
Implementations must call beginInsertColumns() before inserting new columns into any underlying data, and call endInsertColumns() immediately afterwards.

Обратите внимание на курсив.
Проблемы при копи-пасте, очевидно.

================
Файл qlistview.html:

Screenshot of a Macintosh style table view
Screenshot of a Macintosh style list view

Screenshot of a Plastique style table view
Screenshot of a Plastique style list view

запостил трольтехам, вот ответ:

файл qt.html
Написано:


предложение не завершено, надо выяснить, что должно быть.

Файл qxmlnodemodelindex.html

Мне кажется, что подразумевалось
it is usually a good idea.., а не не интегрированная среда разработки)

файл qt.html
Написано:


Хотя такой тип курсора не позволяет взаимодействовать.

Есть еще одно перечисление:


но изображения курсора одинаковы, видимо ошибка в картинках

В каталоге с картинками есть картинка cursor-busy.png ()

В файле qt4-interview.html:



Возможно, вместо QComboBox должно быть QTreeView?
Поскольку выше упоминается именно эти два представления.

скорее всего нет, т.к. речь идет о списковой модели, а ее используют списковое представление (QListView) и выподающий список в QComboBox

Хм-м, как-то не очень похоже на правду. Все равно чего-то не хватает.

Вот цитата из QStringListModel:



Если бы цитата в посте 19 был такой:



я бы согласился.

>>QStringListModel is a convenience model that can be used to hold strings for view widgets such as QListView and QComboBox.
QStringListModel - вспомогательная модель, которая может быть использована, чтобы держать (хранить) строки для виджетов-представлений таких как QListView и QComboBox.

из 19-го
>>QStringListModel is a convenience model that can be used to hold strings for views such as QListView and QComboBox.
QStringListModel - вспомогательная модель, которая может быть использована, чтобы держать (хранить) строки для представлений таких как QListView и QComboBox.

меня не смущает отсутствие слова виджет.

Ок.

demos-mediaplayer-mediaplayer-cpp.html

Судя из контекста имелось в виду close

да!
более полный контекст:

         case QEvent::Close:
             //we just ignore the cose events on the video widget

graphicsview-padnavigator-panel-h.html

В описании класса Panel заметил такую строчку:

QGraphicsItem ***grid;

Выглядит очень подозрительно

А почему бы и нет, тот же трех мерный массив.

QGraphicsItem grid[][][];

Kagami, похоже на правду:

 grid = new QGraphicsItem **[height];

это в graphicsview-padnavigator-panel-cpp.html

Ну, может быть. Зато это точно очепятка

Нашел в ipc-sharedmemory-dialog-cpp.html
Судя по всему, они хотели написать location

Там же:

Во-первых firs. Наверно имелось в виду first. Так же непонятно насчет "\tt {Load Image From File...}". Судя по всему они в исходной документации что-то где-то забыли закрыть. Такая же ошибка с \tt встречается в этом же файле еще раз, в следующем комментарии.

Там же два раза встретил ошибку вида:

Видимо она тоже появилась из-за ошибок в тегах исходной документации

itemviews-chart-pieview-cpp.html

Опять проблема с незакрытыми тегами

это и подобное - не ошибки. Дело в том, что эти html'ьники содержат исходники, следовательно ты видишь коментарии в них. А в коментариях содержатся всякие метки системы документирования.

Это похоже на TeX

это qdoc3 (тоже есть и в doxygen'е)

Не то что бы ошибка, но на мой взгляд недочет в статье "An Introduction to Model/View Programming".
В главе "Creating New Models" http://www.doc.crossplatform.ru/qt/en/4.5....ing-models.html вначале описывается read-only модель и приведен код:

QVariant StringListModel::data(const QModelIndex &index, int role) const
 {
     if (!index.isValid())
         return QVariant();

     if (index.row() >= stringList.size())
         return QVariant();

     if (role == Qt::DisplayRole)
         return stringList.at(index.row());
     else
         return QVariant();
 }

Далее когда модель переделывают в редактируюмую описывают создание метода setData и изменение flags , но IMHO еще надо описать переделку метода data на что-то типа:

QVariant StringListModel::data(const QModelIndex &index, int role) const
 {
     if (!index.isValid())
         return QVariant();

     if (index.row() >= stringList.size())
         return QVariant();

     if (role == Qt::DisplayRole or role == Qt::EditRole) // <-- Изменения
         return stringList.at(index.row());
     else
         return QVariant();
 }

Иначе редактор создается пустым.

Sokoloff, похоже, что ты прав.

Sokoloff, я написал об этом тролям, вот их ответ:

Файл style-reference.html

=====================

It can set the following states on the spin box.:

It can set the following states on the spin box:

=====================

When QMenu receives paint events ,it calculates the size of each menu item and draws them individually with CE_MenuItem

When QMenu receives paint events, it calculates the size of each menu item and draws them individually with CE_MenuItem

=====================

It is QMainWindowLayout that calculates the bounding rectangles (i.e., position and size of the toolbars and their contents.

It is QMainWindowLayout that calculates the bounding rectangles (i.e., position and size of the toolbars and their contents).

=====================

(Menu items do not have a separate element for their label (contents), so all drawing is done in CE_MenuItem.

(Menu items do not have a separate element for their label (contents), so all drawing is done in CE_MenuItem.)

=====================

QStyleOptionFrame is used for drawing the panel frame The lineWidth is set to PM_MenuBarPanelWidth.

QStyleOptionFrame is used for drawing the panel frame. The lineWidth is set to PM_MenuBarPanelWidth.

=====================


Файл stylesheet-reference.html:

The style of the border's right edge/

The style of the border's right edge.

=====================

For example, a lone tab in a <a0>QTabBar</a0>.

For example, alone tab in a QTabBar.

=====================

In addition to the usually supported pseudo states, item subcontrol supports the :selected, :default, :exclusive and the non-exclusive pseudo states.

In addition to the usually supported pseudo states, ::item subcontrol supports the :selected, :default, :exclusive and the :non-exclusive pseudo states.

=====================

ex: the ex width of the font (i.e., the height of 'x')

если должна быть ширина (width), то:

ex: the ex width of the font (i.e., the width of 'x')

или - если должна быть высота - то:

ex: the ex height of the font (i.e., the height of 'x')

graphicsview-diagramscene.html:
Наверно тут имелось в виду two.

Vi == We?

Вот тут вообще мозг сломал.
Наверно правильно так:
Получилось примерно так: "DiagramScene использует сигнал, вырабатываемый когда текст теряет фокус, чтобы удалить текстовый элемент если он пустой, т.е. он не содержит текст"

qgraphicsitem.html:

Лишние скобки, скорее всего пропущена ссылка

Пропущена ссылка

Два раза "from".

Такое ощущение что вместо "as" больше подходит "if"

Мне кажется что это слово тут лишнее

Лишние скобочки. Не говоря о ранее упомянутой проблеме с "as"

Ну что, стоит ли написать баг-репорт?

надо удостовериться, что в 4.6 они есть.
Если есть, то можно написать сославшись прямо на твоё сообщение в форуме.
Поэтому можешь отредактировать своё сообщение добавив коментарий и на онглийском.

и я не нашел в 4.6. Остальные есть. Пойду писать баг-репорт.

UPD: Написал

Странно.. Пришло письмо от автоответчика. В нем есть такая фраза:
Но в баг-трекере ошибки с таким номером я не нашел

это регистрационный номер issue, по нашему "входящее" (термин документооборота).
Его рассмотрят, если посчитают полезным свяжутся с тобой, и, возможно, создадут "таску"

По моему опыту написания замечаний тролям по документации, они создают "таску" только внутреннюю для разработчиков и не публикуют её.
Т.е. ответ от человека примерно такой:

Теперь все понятно

Ошибка в картинках на странице Qt Namespace Reference Qt 4.3.2:
картинки Qt::SplitHCursor, Qt::SplitVCursor следует поменять местами. Для вертикального QFrame::VLine присущ Qt::SplitHCursor при наведении, а для горизонтального - Qt::SplitVCursor. А в документации неверно указаны картинки данных курсоров.

AD, это для перечисления enum Qt::CursorShape?

Да.

тогда там всё правильно.

Не понял? Почему? Ты проверял? Я проверял, потому и написал...

да, я вот сейчас смотрю сюда и вижу, что по разному.

В 4.5 тоже