Alexander Leidinger с помощью системы Doxygen (http://www.stack.nl/~dimitri/doxygen/) подготовил документацию (http://www.leidinger.net/FreeBSD/src_docs/) к исходному коду ядра FreeBSD.В сгенерированных документах представлены описания используемых структур данных, определения функций, макросов, и другая информация. Все описания содержат указатели на местоположение их определения, а зависимые данные связаны гиперссылками.
URL: http://kerneltrap.org/node/5149
Новость: http://www.opennet.me/opennews/art.shtml?num=5491
кхм... автор новости сам то хоть посмотрел на эту "документацию" :-?// wbr
Посмотрел, я чего-то неправильно написал?
> Посмотрел, я чего-то неправильно написал?берем например dev_pci.pdf. содержимое - банальный набор кросс-ссылок вида "ф-я xxx находится в файле xxx". все. с вашей точки зрения, это можно называть гордым словом "документация"?
// wbr
>> Посмотрел, я чего-то неправильно написал?
>
>берем например dev_pci.pdf. содержимое - банальный набор кросс-ссылок вида "ф-я xxx находится
>в файле xxx". все. с вашей точки зрения, это можно называть
>гордым словом "документация"?Надо было назвать новость: "Банальный набор ссылок к исходному коду ядра FreeBSD"? :)
ИМХО, даже наличие такой документации, уменьшает сложность работы с исходниками ядра для незнающих людей. По крайней мере можно легко найти где находится необходимое определение. Для себя конечно я там мало интересного нашёл, я это с таким же успехом нахожу с помощью grep -r, но всё же это лучше чем ничего. К тому же, там присутсвуют графы зависимосетй, тоже полезная информация.
> Надо было назвать новость: "Банальный набор ссылок к исходному коду ядра FreeBSD"? :)если так оно и есть - да. зачем лишний раз вводить народ в заблуждение? тем более, что файлы там не самые самые маленькие, по 9-10Mb. кому-то может быть напряжно их качать и обнаружить в конце совершенно не то, что ожидалось.
> ИМХО, даже наличие такой документации, уменьшает сложность работы с исходниками ядра для незнающих людей.
imho практически никоим образом, бо
> По крайней мере можно легко найти где находится необходимое определение.
grep -r pfind /sys/sys/*
на порядок проще и быстрее, чем поиск в большом и толстом pdf.> Для себя конечно я там мало интересного нашёл, я это с таким же успехом нахожу с помощью grep -r, но всё же это лучше чем ничего.
вот и я о том же..
> К тому же, там присутсвуют графы зависимосетй, тоже полезная информация.
в таком виде таки не особо :)
// wbr
настроеный vim умеет бегать по исходникам очень удобно
Я то думал......
кто-лубить на блюдичке с голубой коемочкой пусть потрудится сам написать критиковать каждый мастер.Сом бы хоть пальцем пошевелил.Я лично очень рад что появляются интузиасты делающие попытки в этом направлении.Это колективный труд а не одного человека.Если знал бы досконально ядро сым-бы подробно описал.В английском варианте єто хорошо но по нему работу адра понять очень сложно. Толковое описание толко увеличит круг молодых специалистов в дальнейшем и хороших специалистов
С документацией для разработчиков в BSD-системах вобще хреново. Не говоря уж о переводах на русский...
И это, ИМХО, самый значительный ее недостаток.
самый главный файл kern.pdf запорчен уже пять раз качаю не открівается
это не проблема разработчиков.А группы перевада зато это полностью операционая система а не одной ядро и много дистрибутивов.В этом с моей субективной конечно точки зрения существенное отличие