Astral Man
We Will Rock You
Документирование кода с помощью XML
Возникла идея документирования кода с помощю XML, например:
Файл парсится (все что между '/**' и '**/'), получаем готовый XML и делаем с ним все что угодно.
Это актуально?
Возникла идея документирования кода с помощю XML, например:
PHP:
/**
<file>
<type>function</type>
<name>Функция такая...</name>
<version>0.0.1</version>
... и т.д.
</file>
**/
/**
<function name="myFunction">
<var>
<name>$var1</name>
<desc>Переменная первая, для того-то...</desc>
</var>
<var>
<name>$var2</name>
<desc>Переменная номер два...</desc>
</var>
**/
function($var1, $var2) {
....
}
/** </function> **/
Это актуально?