rant

[stas]

Не знаю, кто пишет man pages для BSD, но он явно мощный лентяй - множество страниц описано в стиле "function do_foo does foo". Например, документация к функциям pthread_mutexattr_setprioceiling, pthread_mutexattr_setprotocol, pthread_mutexattr_settype выглядит так:

The pthread_mutexattr_set*() functions set the attribute that corresponds to each function name.

Всё. Ни обьяснений, что означает каждый атрибут, ни списка допустимых значений для этих атрибутов, ни ссылки на то, где можно эти данные найти. Нахера такая документация нужна?

Comments

[vyhuhol.livejournal.com]

Обычно на такие вопросы отвечают так: "Сорсы есть. Не нравится, сам задокуметируй для будущих поколений".

[stas]

Ну да, делать мне больше в жизни нечего, как изучать сорсы ядра FreeBSD и его документировать. :)

[vyhuhol.livejournal.com]

Во-первых, я не говорил, чтоб ты этим занялся. :) Во-вторых, сам не хочешь документировать, то так не высказывай претензии. (Правда, в данном случае я совсем не practice what I preach). А в-третьих, раз они посиксные, то если ты возьмешь документацию из линукса, то она, наверно, будет, в общем, правильной. (Подчеркнуть "наверно" и "в общем" -- я с BSD-системами никогда не сталкивался.)

[stas]

Во-вторых, сам не хочешь документировать, то так не высказывай претензии.

Эгто ещё почему? Если я вижу, что что-то сделано дерьмово, то тот факт, что это делал не я, никоим образом мне не помешает огласить этот факт. Как говорится у Соловьёва в "Заколдованном принце" - тут стоит ишак, я вижу ишака и говорю - ишак!

А в-третьих, раз они посиксные, то если ты возьмешь документацию из линукса, то она, наверно, будет, в общем, правильной.

В общем - да. А devil, как всегда, in the details. В данном случае - все известные мне ОС эти функции реализуют по-разному, т.к. стандарт не указывает, какие именно из них и как должны реализовываться (точнее, даёт в этой области свободу разработчку). В нормальных ОС принято писать, как именно эти функции реализованы - особенно если они реализованы нестандартно - в мане. Во FreeBSD так не принято. Это печалит.

[meshko.livejournal.com]

Ну слушай, вся эта фигня очень свежая, её только к 5.3 до ума довели, скоро будет ман, я уверен. В Фре маны обычно лучше, чем в Линуксе.

[stas]

скоро будет ман, я уверен

Надежды юношей.

В Фре маны обычно лучше, чем в Линуксе.

Ну, значит мне опять не повезло :)