PureBasic - форум

Информация о пользователе

Привет, Гость! Войдите или зарегистрируйтесь.


Вы здесь » PureBasic - форум » Программирование на PureBasic » Улучшение справки


Улучшение справки

Сообщений 1 страница 3 из 3

1

В общем создал тему чтобы отписывать об ошибках.

Сразу попалась ошибка:

FileSystem\RenameFile.html
"ни чего" - пишется слитно

Ещё проверка орфографии скриптами:

Window3D/index.html
Gadget3D\index.html

имет  -> имеет

MainGuide\history.html
двухкратном   -> двукратном (не критично, можно написать "двойном")

Reference\Explanation.html
инете   -> интернете (минимум сленга)

Material\AddMaterialLayer.html
фотошопе  -> Photoshop`е (не критично, название фирмы пишется как есть)

в функциях Billboard встречается 9 раз:
требуется получить. этот Номер возвращает  (новое предложение должно быть с большой буквы)

часто используется сокращение "т. д." 11 раз с пробелом и 153 раза "т.д." без пробела, я пишу слитно без пробела т.д. т.п. т.е. т.н.

Поиск двойных слов с помощью регулярного выражения

Код:
(?<![А-яЁё])([А-яЁё]{2,})[\t ]+\1(?![А-яЁё])

Gadget\WebGadget.html
С этим Гаджетом могут могут произойти

MainGuide\history.html
25 Июля 2016 : Версия Версия 5.43 LTS

MainGuide\lgpl.html
копию общедоступной библиотеки библиотеки GNU

Mesh\AddMeshManualLOD.html
разных LOD-Сеток для для одной основной Сетки

Reference\ide_debugger.html
X-сервера, или для для удалённой разработки

String\LCase.html
знаками, т.е. 'E' будет будет преобразовано в 'e'.

String\UCase.html
знаками, т.е. 'e' будет будет преобразовано в 'E'.

ListViewGadget()

- SetGadgetItemState(): Выделяет или снимает выделение с указанного элемента.
...
- SetGadgetState(): Делает указанный элемент выделенным (все прочие выделенные элементы теряют этот статус). 'State'- это индекс элемента, если задано -1, не один элемент не будет выделен.

в описании 2 пункта, с одинаковым описанием "выделяет элемент/пункт", это запутывает, SetGadgetItemState не сработал, SetGadgetState работает.

AESEncoder

Пробел для строки и ее завершающий символ

Пространство (место) для помещения строки и её завершающего символа null, нуль-терминированной строки.

во втором примере этот же текст дробится на 2 строки, мне кажется неправильно таким способом комментировать код.

PathRequester
нужен пример с GetHomeDirectory(), чтобы была универсальность, так как C:\ на линуксе нет.

ComboBoxGadget
- SetGadgetState(): Устанавливает для указанного элемента статус выбранного.
на самом деле "Устанавливает указанный пункт выбранным (по индексу)", а указанный элемент выбранный это можно двояко понимать и в большую сторону непонимания, например как то, что комбобокс является активным элементом окна, это тоже выбранный. А чтобы не путаться в терминах, надо разделить элемент окна и пункт внутри элемента окна, а не одним словом "элемент" называть и элемент окна и элемент списка, будь то комбо, листвью, листикон.

PureBasic - Map (Хеш-Карта)
Почему Хеш? Лучше раздел назвать Map (Карта), без PureBasic (и так понятно) и Хеш. Аналогично PureBasic - Array (Массив), PureBasic - List (Связный Список)

MenuItem()

Модификаторы могут комбинироваться с помощью символа "+": "Сохранить Как" + Chr(9) + "Ctrl+Shift+S". На OS X, когда ярлык создан в Меню, нет никакой необходимости вызывать функцию AddKeyboardShortcut() с помощью этого ярлыка.

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

GetJSONMember
Вероятно в примере в последней строке должно быть "z", а не "y".

Отредактировано AZJIO (29.07.2021 11:34:04)

0

2

AZJIO
добавь в шапку ссылку на актуальный перевод, а то ж не известно какую редачишь..

Fingerprint()
"До регистрации плагина необходимо вызвать UseCRC32Fingerprint()." - До лучше заменить на "Для" ведь "UseCRC32Fingerprint() - Регистрирует плагин CRC32 fingerprint для будущего использования."
или перефразировать как-то так "Перед использованием необходимо вызвать UseCRC32Fingerprint() для регистрации плагина.""

Отредактировано Lin (20.06.2021 22:26:21)

0

3

Lin написал(а):

AZJIO
добавь в шапку ссылку на актуальный перевод, а то ж не известно какую редачишь..

скачал с ru-board последняя ссылка в шапке - 5.72, а у меня была последняя 5.71 двумя месяцами ранее.

0


Вы здесь » PureBasic - форум » Программирование на PureBasic » Улучшение справки