Difference between revisions of "Talk:Ru/api/kernel"

From KolibriOS wiki
Jump to navigation Jump to search
m
m
Line 11: Line 11:
  
 
----
 
----
'''Системная функция <nowiki>{{name}}</nowiki>''' - <nowiki>{{about}}</nowiki>
+
'''Системная функция =name''' - about
  
 
==Параметры==
 
==Параметры==
<nowiki>
+
 
* {{#if: {{eax}}
+
<nowiki>  
 +
Такой вот скрипт, проверяющий, что поле eax не пустое
 +
  * {{#if: {{eax}}
 
     | eax = {{eax}}
 
     | eax = {{eax}}
 
     }}
 
     }}
* {{#if: {{ebx}}
 
    | ebx = {{ebx}}
 
    }}
 
(и т.д.)
 
 
</nowiki>
 
</nowiki>
 +
 +
* eax = eax
 +
...
 +
 
==Возвращаемое значение==
 
==Возвращаемое значение==
<nowiki>
 
 
   
 
   
  {{return}}
+
  return
  
{{#if: {{notes}}
+
==Замечания==
    | ==Замечания==
+
notes
      {{notes}
+
      
     }}
 
</nowiki>
 
 
----
 
----
  
 
Тогда обращаться к шаблону надо будет примерно так:
 
Тогда обращаться к шаблону надо будет примерно так:
 +
 
<nowiki> {{SysFn|name=7|eax=7 - номер функции|ebx=указатель на изображение в формате BBGGRRBBGGRR|ecx=[размер по оси x]*65536 + [размер по оси y]|edx = [координата по оси x]*65536 + [координата по оси y]|return=функция не возвращает значения|notes= Координаты изображения - это координаты верхнего левого угла изображения относительно окна.<br />
 
<nowiki> {{SysFn|name=7|eax=7 - номер функции|ebx=указатель на изображение в формате BBGGRRBBGGRR|ecx=[размер по оси x]*65536 + [размер по оси y]|edx = [координата по оси x]*65536 + [координата по оси y]|return=функция не возвращает значения|notes= Координаты изображения - это координаты верхнего левого угла изображения относительно окна.<br />
 
  Размер изображения в байтах = ''3 * Xsize * Ysize''. <br />
 
  Размер изображения в байтах = ''3 * Xsize * Ysize''. <br />

Revision as of 06:57, 27 March 2010

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

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

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



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


Системная функция =name - about

Параметры

Такой вот скрипт, проверяющий, что поле eax не пустое * {{#if: {{eax}} | eax = {{eax}} }}

* eax = eax

...

Возвращаемое значение

return

Замечания

notes
   

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

{{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)