LINUX.ORG.RU

Ну, нигде....

И сделать ее сложно, ибо АПИ с каждым релизом нафиг меняется.

А дело было бы большое...

Lockywolf ★★★
()
Ответ на: комментарий от Lockywolf

Сейчас у каждого свой велосипед .. я вот подумал , может есть проеты , где ... общая база .. Имхо «Developers , developers» это для любой ОС как гимн должно быть

Loki13 ★★★★★
() автор топика

Для каждой библиотеки есть как минимум документация на сайте.

А ещё библиотеки любят пихать доки в /usr/share/doc

Kosyak ★★★★
()
Ответ на: комментарий от Loki13

>>Сейчас у каждого свой велосипед .. я вот подумал , может есть проеты , где ... общая база .. Имхо «Developers , developers» это для любой ОС как гимн должно быть

Сделай :-)

Всего-то делов - все собрать, сделать cross-reference и обновлять с каждым релизом.

Начни с SUS, X11, Directfb, OSS, Motif, GTK, Qt, Curses.

Также добавь туда кучу мелких библиотек, о которых никто не слышал, но которые нужны для ключевых компонентов.

(gmp, gsl, libx86, etc...)

Lockywolf ★★★
()

Такая есть у коммерческих проектов типа qt и java

как известно у открытых проектов отговорка: наша документация это быдлокод.

wfrr ★★☆
()
Ответ на: комментарий от Lockywolf

Тут работы человек на 100 минимум , просто , если проект уже есть , то я бы присоеденился , а делать не реально

Loki13 ★★★★★
() автор топика

Просто посмотриете MSDN прежде чем коментить

MSDN не идеал , но то к чему можно стремится .. то что Microsoft сделал лучше всего

Loki13 ★★★★★
() автор топика
Ответ на: комментарий от Legioner

man

Это уж точно. Никакой MSDN старому доброму man'у в подметки не годится.

Eddy_Em ☆☆☆☆☆
()
Ответ на: комментарий от Legioner

Во-первых, на libc Линукс не заканчивается.
Во-вторых, сравните ваш man 3 fopen и MSDN...

Автор глубоко прав. Впрочем, это повторялось уже многократно. Увы, это большая проблема Линукса. Некогда разработчикам документацию подробную писать, а уж о том, чтобы сделать ее неотъемлемой частью проекта, большинство и слышать не хочет.

proud_anon ★★★★★
()
Ответ на: комментарий от proud_anon

Во-первых, на libc Линукс не заканчивается.

man pages есть не только для libc.

Во-вторых, сравните ваш man 3 fopen и MSDN...

У меня MSDN никаких положительных эмоций не вызывает. Документация там крайне скудная, половина текста автосгенерирована captain-obvious.exe. Когда приходилось писать под венду, очень много информации приходилось искать вне MSDN. Тот же Qt имеет гораздо более удобную документацию.

Legioner ★★★★★
()
Ответ на: комментарий от Legioner

по убожеству шоле? Аль еще какие критерии есть?

wfrr ★★☆
()
Ответ на: комментарий от Legioner

>половина текста автосгенерирована captain-obvious.exe
Лучше уж captain-obvious.exe, чем colonel-disappointment.bin

В смысле, лучше уж написать лишнего, так как это можно пропустить, чем не написать нужного.

очень много информации приходилось искать вне MSDN

А когда под Линукс пишете, вы одними манами, что ли, обходитесь? Тут-то такого централизованного ресурса вообще нет.

И не такая уж она и скудная, хотя иногда поиск ее занимает значительное время из-за того, что выпадает всякий мусор.

proud_anon ★★★★★
()
Ответ на: комментарий от Legioner

Документация там крайне скудная, половина текста автосгенерирована captain-obvious.exe. Когда приходилось писать под венду, очень много информации приходилось искать вне MSDN.

Я конечно дико извиняюсь, но кто-нибудь из вас, вообще, пользовался подпиской MSDN (это той, что идет на дисках). Вещь! По крайней мере 7 лет назад, это было одна из самых полных и удобных документаций для винды. 60 CD-дисков, идущих в чемоданчике, с собственноручно подписанным какой-то шишкой из МС письмом... М-м-м. Радость анального зондирования.

Kakerlak
()
Ответ на: комментарий от Kosyak

Это не документация, а всего-навсего полный сборник всех продуктов МС, нужных для разработки.

zgen ★★★★★
()

Для разработчика конечно имеется в смысле

Ну когда же кончатся эти странные люди, которые знают что нужно разработчикам лучше самих разработчиков.

ei-grad ★★★★★
()

Не понятно, что конкретно имеется ввиду - технческий движок, или набор документации по конкретным библиотекам?

Если чисто движок, то чем конкретно не устраивает например doxygen/javadoc/то, что используется для документации Qt?

Если наполнение, то претензии наверное нужно предъявлять к конкретным библиотекам, но тогда не совсем понятно, чего именно не хватает автору.

Для прикладного гуя - документация по Qt - идеал для подражания. Для ынтырпрайз-гуя и сервера - документация по Java и сопутствующим библиотекам - аналогично. Со всякого рода Rubu/Php и пр. не сталкивался, но судя по их раскрученности, полагаю что проблем с документацией у них тоже нет. Стандартный набор всяких сишных вызовов вроде тоже нормально документирован через man (кому не нравится лазить по ссылкам в консоли дарю хинт - наберите #fopen или что тоже самое man:fopen в адресной строке конка - будет сюрприз, info:/ тоже должно работать).

Когда-то давно требовалось немного поковыряться с иксовыми библиотеками - там да - набор доступной информации был не очень обширен, а в интернете людей, столкнувшимися с моими проблемами, было исчезающе мало, что в общем логично - кому сейчас придет в голову делать что-то на голых иксах/мотифе - разве только разработчикам Qt/Gtk, которые с этим судя по всему и так справляются.

Плюс самый главный фактор - доступность исходников всего и вся. В msdn все очень красиво ровно до тех пор, пока выполняемые задачи на 99% согласуются с теми примерами, которые указаны в документации. Шаг влево/вправо (что требуется довольно часто) - можно разбивать голову об стену - попытка понять, почему та или иная функция работает именно так, а не иначе похожа на процесс подбора нужной отмычки к хорошо защищенному замку - можно целую неделю ковыряться пробуя разные комбинации параметров, а результата не будет.

bender ★★★★★
()
Ответ на: комментарий от bender

Скорее наверное имел ввиду консолидацию всей информации в одном месте и доступность по нажатию одной кнопки

Loki13 ★★★★★
() автор топика
Ответ на: комментарий от ei-grad

На работе под венду и пишу , а теперь решил для себя под линукс писать и столкнулся с тем что большинство инфы разрознено

Loki13 ★★★★★
() автор топика
Ответ на: комментарий от Loki13

Ты все-таки определись с тем, какую задачу собираешься выполнять. Если нужен гуй и переферия - бери Qt - за пределы его документации никуда вылезать не потребуется - там есть все - и виджеты, и файлы, и сокеты и xml - и работать при этом будет и линуксе, и в винде и где еще только не будет работать. Если очень нужны разные левые библиотеки, то да - по каждой из них доки будут отдельно, но msdn как-бы тоже я думаю к чужим библиотекам документацию не прилагает.

bender ★★★★★
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.