Создаю библиотеку для работы с последовательными портами. [УШЕЛ ИЗ ПРОЕКТА].

[kuzulis]

Не, скорее всего оно не знает из какого базового происходит переопределение - т.е от QIODevice::open().
Наверное нужно как-то где-то это указать - но как - хз.

Далее,

/home/kuzulis/git/ng/qserialdevice/include/serialport.h:30: No documentation for 'SerialPort::dataBits'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:34: No documentation for 'SerialPort::dataErrorPolicy'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:35: No documentation for 'SerialPort::dtr'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:37: No documentation for 'SerialPort::error'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:33: No documentation for 'SerialPort::flowControl'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:31: No documentation for 'SerialPort::parity'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:29: No documentation for 'SerialPort::rate'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:38: No documentation for 'SerialPort::restoreSettingsOnClose'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:36: No documentation for 'SerialPort::rts'
/home/kuzulis/git/ng/qserialdevice/include/serialport.h:32: No documentation for 'SerialPort::stopBits'

Не создает описание этих методов, т.к. их имена также указаны в

Код

C++ (Qt)
    Q_PROPERTY(qint32 rate READ rate WRITE setRate)
    Q_PROPERTY(DataBits dataBits READ dataBits WRITE setDataBits)
    Q_PROPERTY(Parity parity READ parity WRITE setParity)
    Q_PROPERTY(StopBits stopBits READ stopBits WRITE setStopBits)
    Q_PROPERTY(FlowControl flowControl READ flowControl WRITE setFlowControl)
    Q_PROPERTY(DataErrorPolicy dataErrorPolicy READ dataErrorPolicy WRITE setDataErrorPolicy)
    Q_PROPERTY(bool dtr READ dtr WRITE setDtr)
    Q_PROPERTY(bool rts READ rts WRITE setRts)
    Q_PROPERTY(PortError error READ error RESET unsetError)
    Q_PROPERTY(bool restoreSettingsOnClose READ restoreSettingsOnClose WRITE setRestoreSettingsOnClose)
 

 В общем, нужно разбираться серьезно - но нет времени ижелания. Мож кто поможет.

[b-s-a]

Сделал поддержку StopReceivingPolicy для платформ, поддеживающих CMSPAR. И добавил новый код ошибки BreakConditionError.

[kuzulis]

Ок. Спс. Но не вижу mr.

[b-s-a]

гы. видимо не нажал на "создать".

[kuzulis]

Ага, замержил, также добавил и для Windows обработку этой ошибки.

[kuzulis]

Я тут сходил с утреца на #qt-labs, "немного" пообщался:

chriadam   but I guess lars and thiago would be the people to give you an answer regarding the feasibility of your QSerialDevice component for inclusion into Qt (as an add-ons module I presume you mean?)

kuzulis   Yes. But we also need help, as We have few resources.

kuzulis   Here is a link to the project https://gitorious.org/qserialdevice/qserialdevice/trees/2.0

chriadam   kuzulis: it's probably worth sending an email to the qt development mailinglist (development@qt-project.org) outlining your proposal, clearly explaining what you hope to achieve, what
                        you bring to the table, what you'd like the community to provide (eg, Symbian implementation etc), who should be maintainer etc etc

chriadam   that way, if there's a lot of interest, you may find that there's no shortage of people willing to provide expertise and effort maintaining the module. but if there's very little interest,
                        then it's less likely that the proposal will be accepted.

chriadam   purely because as you mention, for a new module to be added to Qt, it absolutely must be actively maintained and have CI integration etc, I would assume.

Я так понимаю, им на development@qt-project.org нужно что-то написать, типа что у нас уже есть, чего не хватает и т.п.
Но я не понял в принципе процесс.

Кто нибудь может помочь в написании петиции и объяснить, что это и с чем его едят?
Где регистрироваться на этот список рассылки и как и т.п.?

[kuzulis]

Вот, набросал кратко текст петиции

Hello

We want to provide a library QSerialDevice v 2.0 to work with serial ports:
https://gitorious.org/qserialdevice/qserialdevice/trees/2.0

We would like to include it as a separate module for Qt.
The implementation of the library is closely linked to the internal architecture of Qt
and uses some private classes Qt.

We want to know:
Is there interest in this subject, and find like-minded in its development?

At present, the library has two classes of SerialPort and SerialPortInfo.

So what we have:

SerialPort - full-fledged support for OS Windows, WinCE, POSIX-compatible.
Partially implements the interface for OS Symbian.

SerialPortInfo - fully supports OS Windows, WinCE, GNU/Linux, MacOSX, other * nix (simplified), Symbian.

For all classes added comments in QDoc style.

What else is needed make:

1. Implement SerialPort support in OS Symbian.
2. Make a proper configuration for documentation generation.
3. Make the correct configuration to build the project.
4. Correct spelling errors in comments.

Что еще писать нужно?

[b-s-a]

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

[kuzulis]

Ок. Ну а регистрироваться где-то нужно, или просто шлю письмо на этот адрес и все?

И что в письме писать то?
Нужно ж как-то пафосно, с чувством и расстановкой, с хорошим литературным слогом.
И как его озаглавить?

[Igors]

Если уж такое неумное желание написать, тогда короче

Hello Qt

Here is my library QSerialDevice v 2.0
https://gitorious.org/qserialdevice/qserialdevice/trees/2.0

If you're interested to include it into reguar Qt stuff - please let me know

Thanks
kuzulis

Делая copy/paste чата на паблик форум Вы уменьшаете свои шансы возможно до нуля. Это никак не зависит от содержания чата, просто если человек понимает что значит "private" - это высоко оценивается всеми, (буржуинами никак не меньше) и наоборот.

[b-s-a]

Озаглавить можно как-то так: "What about including serial port support component to Qt?"
Да пафосно, думаю, не нужно. Это письмо в список рассылки. Думаю, тебе сразу начнут задавать вопросы. Как вариант, можешь создать отдельный баг на багтрекере и в письмо воткнуть ссылку на него. На багтрекере общаться удобней.

Igors, на счет "Hello Qt" я сильно сомневаюсь. Уж лучше тогда "Hello, developers" или просто "Hi". Остальной текст тоже ни о чем. Потому что chriadam четко написал, что он хотел бы узнать. Думаю, максимум этой информации и надо предоставить в письме.

[Igors]

Озаглавить можно как-то так: "What about including serial port support component to Qt?"
Да пафосно, думаю, не нужно. Это письмо в список рассылки. Думаю, тебе сразу начнут задавать вопросы. Как вариант, можешь создать отдельный баг на багтрекере и в письмо воткнуть ссылку на него. На багтрекере общаться удобней.

Igors, на счет "Hello Qt" я сильно сомневаюсь. Уж лучше тогда "Hello, developers" или просто "Hi". Остальной текст тоже ни о чем. Потому что chriadam четко написал, что он хотел бы узнать. Думаю, максимум этой информации и надо предоставить в письме.

Редко, но все же бывает что "думаю" не помогает. Поймите меня правильно, я никак не хочу Вас задеть. Но если Вы сами не ходили по этой дорожке - Вам лучше воздержаться от советов. 

[kuzulis]

Делая copy/paste чата на паблик форум Вы уменьшаете свои шансы возможно до нуля. Это никак не зависит от содержания чата, просто если человек понимает что значит "private" - это высоко оценивается всеми, (буржуинами никак не меньше) и наоборот.

Да ладно, новичку "мне" простительно. Я не чатланин. На будущее учту.

Вот тогда как-то так:

Title : "What about including serial port support component to Qt?"

Hello.

We want to provide a library QSerialDevice v 2.0 to work with serial ports:
https://gitorious.org/qserialdevice/qserialdevice/trees/2.0

We would like to include it as a separate module for Qt.

The implementation of the library is closely linked to the internal architecture of Qt
and uses some private classes Qt.

We want to know:
Is there interest in this subject, and find like-minded in its development?

At present, the library has two classes of SerialPort and SerialPortInfo.

So what we have:

Class SerialPort - full-fledged support for OS Windows, WinCE, POSIX-compatible.
Partially implements the interface for OS Symbian.
As a basis of the SerialPort was taken QAbstractSocket, therefore, their implementation is somewhat similar.

Class SerialPortInfo - fully supports OS Windows, WinCE, GNU/Linux, MacOSX, other * nix (simplified), Symbian.
As a basis of the SerialPortInfo was taken QPrinterInfo, therefore, their implementation is somewhat similar.

For all class added comments in QDoc style.

What else is needed make:

1. Implement SerialPort support in OS Symbian.
2. Make a proper configuration for documentation generation.
3. Make the correct configuration to build the project.
4. Correct spelling errors in comments.

If you're interested to include it into reguar Qt stuff - please let me know

Thanks
kuzulis

Так пойдет?

ЗЫ:
Ну а письмо прям так и слать на этот емайл и всё? Больше ничего не нужно?

Блин.. стока всего наговорили.. Так как эфективнее будет то?

И как ОНИ будут задавать вопросы (т.е. как я получу ихние вопросы)?
Проведите-ка ликбез!  А то я ж не в теме совершенно.

[poru]

Думаю, что в методах: WinSerialPortEngine::setRate, WinSerialPortEngine::setDataBits, WinSerialPortEngine::setParity нужно убрать проверки на UnknownRate, UnknownDataBits, UnknownParity. Это выполнит ОС. А проверку проводить после updateDcb.

Например rate == UnknownRate (-1), фиксируем ошибку UnsupportedPortOperationError, возвращаем false.
Если rate == 5555, ошибку не фиксируем, но возвращаем false. Как потом ошибку анализировать?

[kuzulis]

Если rate == 5555, ошибку не фиксируем, но возвращаем false. Как потом ошибку анализировать?

5555 это не ошибка. это Custom Rate