Talk:Ru/api/kernel

From KolibriOS wiki
Revision as of 07:09, 27 March 2010 by SoUrcerer (talk | contribs)
Jump to navigation Jump to search

Огромная статья. Может, лучше разбить на отдельные статьи?

Разбить API на 70 статей? Да, было бы здорово. Короткие темы логично было бы дополнять примерами кода и описаниями соответствующих оберток системных вызовов.

В качестве примера: Ru/api/SysFn07. Может, еще какой-нибудь шаблон для удобства добавить? --Art zh 01:15, 27 March 2010 (EET)



Хм, шаблон. Интересная идея. Можно попробовать сделать либо полный шаблон, навроде такого:



Системная функция name - about
==Параметры==
* eax = eax
==Возвращаемое значение==
return
==Замечания==
notes
   


Такой вот скрипт, проверяющий, что поле eax, например, не пустое:

* {{#if: {{eax}} | eax = {{eax}} }}

Тогда обращаться к шаблону надо будет примерно так:

{{SysFn|name=7|eax=7 - номер функции|ebx=указатель на изображение в формате BBGGRRBBGGRR|ecx=[размер по оси x]*65536 + [размер по оси y]|edx = [координата по оси x]*65536 + [координата по оси y]|return=функция не возвращает значения|notes= Координаты изображения - это координаты верхнего левого угла изображения относительно окна.<br /> Размер изображения в байтах = ''3 * Xsize * Ysize''. <br /> Соответствующий системный вызов: '''??''' <br />}}

Насколько рационально делать такой шаблон - не знаю. Ведь для каждой функции могут быть детали... Просто прийти к какому-нибудь стандарту по оформлению статей - как с приложениями определились более-менее.

Мне кажется, что правильнее начинать статью не с дублирования её заголовка как подраздела, а сразу с пояснения сути функции. Вроде бы так принято в вики.

Плюс... И/или добавить шаблон для отображения в нижней части страницы - как с приложениями. Если таковой востребован, могу наваять :)--SoUrcerer 08:52, 27 March 2010 (EET)

Ах, да. Ещё нужно определиться с именами для шаблона... Если для полного шаблона - то предлагаю System_function, а для шаблона оглавления - Syscalls?--SoUrcerer 09:02, 27 March 2010 (EET)

И ещё :) почему такой странный адрес? Ru/api/SysFn07

Не логичнее просто создавать статью c именем функции или её номером, а потом объединить всё в категории? Автопереключение языка не работает, английскую версию вики вряд ли кто-то возьмется править в ближайшее время...--SoUrcerer 09:09, 27 March 2010 (EET)