> оставлю это на его совести. :D

Думаю у него совесть чиста - он в вопросе разбирается.

> а нахрена? Разрабам ФС на это покласть, а от "новичков" кто её
> купит тоже ничего хорошего - устаревшие знания из такой книги нифига
> не догонят даже той доки (кстати очень не плохой) на вики
> http://xfs.org/index.php/XFS_Status_Updates и текста в комментариях

Нафига? Чтобы был ман дающий обзор общей концепции на общем уровне + наводки какие части где и как реализованы и чего смотреть. И зачем и почему реализовано именно так (на это очень редко дают ответ коменты и сгенеренные доки, но это важно для понимания как оно на самом деле должно работать). Актуальным курсом дел это не будет, но общее понимание алгоритмов и задумок - даст. А вот более тонкую синхронизацию с интересующим исходником уже естественно придется делать вкуривая оный. Только когда у вас гора манов и автогенеренный бред - концепция и вообще задумки авторов целиком как-то не очень хорошо складываются в единую стройную картину. У именно XFSников с этим еще более-менее ничего.

> современным ИДЕ прыгать по клику мышки не привыкать. Что на 100 страницах
> A4, что на 60 - один клик.

И тем не менее, сорцы пухнут, время компила растет, сорц захламляется.

> и мне не надо лесть чёрте куда, чтобы узнать что там за значения сможет принять
> вон та переменная из вон той структуры.

Именно такая информация в структуре как комент - да, удобно.

> ну а то что в доке это ещё будет и устаревшим - это к бабке не ходить.

Да и хрен с ним, задача доки дать понимание общей идеи и того что где и как реализовано, а вот конкретику реализации разумеется надо уже в сырце смотреть. А вот когда отделываются только автогенеренной докой - ну для чисто либы это может и ничего. Для ФС уже как-то не то, т.к. описание концепции и задумок автоматически не сгенерится, а без этого будет довольно сложно понять что и нафига.