Отправлено: 19.10.07 10:26. Заголовок: Косяки документации

Предлагаю сделать такую ветку постоянно действующей т.к. топичная информация никогда не переведется
Со временем затирать исправленные замечания.

И сейчас, в связи с тем, что пришлось очень много ее (документацию) штудировать,
я нашел много серьезных несоответствий сильно затрудняющих процесс программирования.

Примеры

Все описания Draw , например
DRAW LINE IN WINDOW <WindowName> AT <nRow>,<nCol>
TO <nRow>,<nCol>
[PENCOLOR <anPenColor>]
[PENWIDTH <nPenWidth>]

А должно быть либо в одну строчку, либо каждый перенос строки должен заканчиваться ;

Аналогично - TAB, DEFINE TIMER, DEFINE TREE и т.д.
Эти косяки сильно маскируются (практически нивелируются) при использовании
визуального форм-дизайнера, автор которого в этих тонкостях разбирался.


Команда
ON KEY ALT <Key> [ OF <ParentWindow>] ACTION <ActionProcedureName> | <bBlock>
В списке доступных Key я не нашел нужный мне простой ESC.
А, оказывается, нужно как в примере
ON KEY ESCAPE ACTION Form_2.Button_2.OnClick
безо всяких ALT.
И еще там есть модификатор WIN

Команды PUSH KEY вообще не нашел

А функция SetProperty( <cWindowName>[,<cControlName>], <cPropertyName> , <PropertyValue> )
может иметь до 7 (семи) аргементов!!!

И откуда это узнать? Я случайно наткнулся в текстах.
Не проверять же каждое описание в документации по исходникам.
А вот кстати проверим GetProperty ...
Ну вот - оказывается не до 3, а до 6 (шести) аргументов.
Так-так... Ну а еще проверим...
DoMethod(<WindowName>,[<ControlName>],<MethodName>)
- до 9 (девяти) аргументов!!!

Товарищи!!! От нас скрывают всю правду!!! Всю мощь и гибкость MiniGUI!!!

Есть лишние пробелы в написании имен и в др.важных местах,
т.ч. просто скопировать и вставить не получится.
Например
Get Property (<cWindowName>[,<cControlName>] ,<cPropertyName>)--> PropertyValue

Перечень команд без каких-либо объяснений
Например - Image List.
Наверное предполагается, что пользователи МиниГУИ знают WinAPI,
и поэтому им не трудно догадаться - о чем идет речь.
Аналогично - некоторые непонятные свойства некоторых контролов.
...

Да... Перечитав ранее написанное я подумал, что косяков столько, что сначала нужно документацию
тщательно переработать и только потом устранять редкие мелкие неточности.

А как народ считает? Или никто документацией не пользуется? Всем хватает исходников?
И только я, как начинающий минигуист-харборист (т.е. как лох), пользуюсь документацией.

P.S.
Сейчас проверил "What's New" - нашел последнее упоминание о SetProperty( )
2006/12/05: Build 28 (HMG 1.2 Extended) Published.
· Enhanced: The Tab control supports a new Image property:
· function syntax
SetProperty ( ParentForm, ControlName, 'IMAGE', Column, cImage )
GetProperty ( ParentForm, ControlName, 'IMAGE', Column )

 Отправлено: 25.10.07 11:36. Заголовок: Re:

Григорий, minigui.txt - это хорошо.
Но я имел ввиду именно ch файл с extern объявлениями.

gfilatov пишет:

цитата:

Это реально (!?) - уж больно специфический продукт для русскоязычной аудитории, привыкшей к бесплатным СИ-билдеру, Дельфи и т.п.

Я думаю сильно помог бы русскоязычный файл помощи. Кстати и желающие помочь в его создании есть - SADSTAR и G-Serge

 Отправлено: 25.10.07 14:08. Заголовок: Re:

Петр пишет:

цитата:

Я думаю сильно помог бы русскоязычный файл помощи. Кстати и желающие помочь в его создании есть - SADSTAR и G-Serge

Спасибо за доверие Но скорее всего времени не будет. А пока неплохо обхожусь файлом помощи англоязычным и исходниками собственно библиотеки.
А вот ОТДЕЛЬНЫЙ раздел обмена опытом и взаимопомощи, повторюсь, не помешает.

 Отправлено: 25.10.07 15:05. Заголовок: Re:

На нет и суда нет
Лично мне тоже исходников хватает ( для open source это в общем общепринятая практика, редко какой проект может похвастаться полноценной справочной системой ).
Но это крайне важно для развития проекта. Вот вы беспокоитесь, а не будут ли в следующем релизе внесены какие-то изменения влияющие на работу моей программы. А задаться вопросом - будет ли следующий релиз вы не пробовали?
По поводу отдельного раздела. Это вопрос к администратору. Вдруг он (администратор) окажется отзывчивым человеком Но, по моему для этого и есть форум. Создание нового раздела - ничего не решит. Ведь по сути весь раздел GUI держится на активности Григория Филатова
На практике обмен опытом и взаимопомощь чаще всего выглядит так, как я писал : мне нужно - начинаю задавать вопросы и возмущаться, что никто не хочет ответить. Написал программу - забыл о форуме. А с какой стати отвечать? Да еще человеку который на форуме раз в месяц появляется - по крайней нужде. IMHO yужно - ищи, учи.

 Отправлено: 25.10.07 17:27. Заголовок: Re:

Петр пишет:

цитата:

На практике обмен опытом и взаимопомощь чаще всего выглядит так, как я писал : мне нужно - начинаю задавать вопросы и возмущаться, что никто не хочет ответить. Написал программу - забыл о форуме. А с какой стати отвечать? Да еще человеку который на форуме раз в месяц появляется - по крайней нужде.

Человек, написавший программу и забИвший на форум - забИвает не столько на форум, сколько на MiniGUI. Надеюсь, последнее очевидно. Интересен проект - читают форум и по возможности пишут на него, проект неинтересен - ну и форум тогда вместе с проектом побоку. Просто и логично.
Мне проект интересен. По этой причине и ищу, и учу, и вопросы задаю задаю на форуме, поскольку не всё смог найти. Но если бы все вопросы по библиотеке были бы более-менее СИСТЕМАТИЗИРОВАНЫ, что я и предлагаю сделать введением отдельного раздела, это сделало бы форум как минимум привлекательнее.
По крайней мере, не придётся при каждом новом вопросе весь форум перерывать, и спрашивать то, о чем уже десять раз разжевали :)

Петр пишет:

цитата:

По поводу отдельного раздела. Это вопрос к администратору. Вдруг он (администратор) окажется отзывчивым человеком

При желании, на fastbb.ru не проблема сделать даже отдельный форум. И назначить администратором на нём себя, любимого.

 Отправлено: 25.10.07 17:47. Заголовок: Re:

G-Serge пишет:

цитата:

на fastbb.ru не проблема сделать даже отдельный форум

Это так
Но задача состоит не в том, чтобы плодить еще один форум, который будет посещать 1 или 2 или 3 заинтересованных лица
IMHO Проблема в том, чтобы как можно больше людей могли участвовать в проекте и сказать
G-Serge пишет:

цитата:

Мне проект интересен.

 Отправлено: 25.10.07 18:01. Заголовок: Re:

Григорий, я всего лишь предлагаю способ НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ информацию о различных составляющих проекта КОЛЛЕКТИВНО, общедоступно и по возможности без проволочек. А отдельный раздел или даже форум использовать просто как своеобразный справочник, поскольку это самый дешёвый способ эту самую коллективность и общедоступность организовать.

 Отправлено: 25.10.07 20:11. Заголовок: Re:

G-Serge пишет:

цитата:

я всего лишь предлагаю способ НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ

А кто против? Осталось технические детали уладить
Я согласен с Григорием, новый форум открывать не стоит ( как и уходить с англоязычного форума HMG ).
Ведь очевидно, что целевая аудитория - пользователи [x]Harbour. И думаю Dima тоже ничего против иметь не будет, чтобы открыть новый раздел.
Но чтобы "НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ информацию о различных составляющих проекта" одной коллективной работы мало будет. Кому-то нужно будет поработать модератором, кому координировать работу, причем уделять всему этому достаточно времени, хотя бы на начальном этапе. И здесь "скорее всего времени не будет" не пройдет.

 Отправлено: 25.10.07 20:46. Заголовок: Re:

Петр пишет:

цитата:

И здесь "скорее всего времени не будет" не пройдет.

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

Петр пишет:

цитата:

Но чтобы "НАКАПЛИВАТЬ и СИСТЕМАТИЗИРОВАТЬ информацию о различных составляющих проекта" одной коллективной работы мало будет. Кому-то нужно будет поработать модератором, кому координировать работу, причем уделять всему этому достаточно времени, хотя бы на начальном этапе.

Ну, как говорится - ЛИХА БЕДА НАЧАЛО :) Глядишь, и тронется лёд в нужном направлении.

 Отправлено: 25.10.07 21:34. Заголовок: Re:

Хорошо.
Хотелось бы увидеть мнения Григория и Dima.

 Отправлено: 25.10.07 22:05. Заголовок: Re:

Петр пишет:

цитата:

ЛИХА БЕДА НАЧАЛО

Просто откройте новую тему в ветке GUI этого форума под названием "MiniGUI FAQ", например.

G-Serge пишет:

цитата:

тронется лёд в нужном направлении

 Отправлено: 25.10.07 22:19. Заголовок: Re:

gfilatov пишет:

цитата:

Просто откройте новую тему в ветке GUI этого форума под названием "MiniGUI FAQ", например.

Сдаётся мне, не будет этого достаточно.
Со временем запросто может получиться винегрет из различающихся по специфике вопросов ( причем трудно предположить, на сколько страниц эта ТЕМА протянется ), в котором опять-же придётся рыться всякий раз.
Тогда уж хотя бы создавать отдельные темы по каждому из более-менее частых вопросов и имеющихся контролов и функций в частности - если ПО ДРУГОМУ ну никак не получается.

Но впрочем - дело хозяйское

 Отправлено: 26.10.07 09:33. Заголовок: Re:

G-Serge пишет:

цитата:

Сдаётся мне, не будет этого достаточно

Если относиться к этому серьезно, то конечно этого не будет достаточно. Нужно открывать новую ветку, создать несколько тем, в т.ч. и sticky - приклеенных (например - новости, документация, инструментарий). И права модератора, если не администратора очень желательны.