Board.KolibriOS.org

Official KolibriOS board
It is currently Sun May 26, 2019 9:16 pm

All times are UTC+03:00




Post new topic  Reply to topic  [ 31 posts ]  Go to page Previous 1 2 3 Next

В каком формате Вы хотели бы видеть документацию по KolibriOS?
txt 20%  20%  [ 13 ]
html 42%  42%  [ 27 ]
chm 22%  22%  [ 14 ]
rtf 6%  6%  [ 4 ]
Другой 9%  9%  [ 6 ]
Total votes: 64
Author Message
PostPosted: Sun Oct 07, 2007 2:14 pm 
HORROR
Quote:
Вот...несчастье... почти нажал кнопку "Отправить"....а тут Чубайс привет прислал

Я вот думаю купить ИБП на 700W. Очень редко, но все-таки отрубают сеть, и по закону подлости это случается в самый неподходящий момент.
Quote:
и один из них выбрать из разряда "обычным_юзверем_не_ковыряемый"

Quote:
Тут наиболее банальная связка ХТМЛ-Дежавю

ИМХО PDF тоже подойдет, ЕМНИП там можно устанавливать защиту от редактирования, конечно, сломать можно все, но все же.
Quote:
Доки для юзверей ОБЯЗАТЕЛЬНО должны быть отделенными от док для кодеров и быть предельно простыми и исключать двойное толкование

Доки для пользователей обычно пишут другие более продвинутые пользователи, программистам уже тяжело выражаться, не забираясь в дебри. Когда я пытаюсь объяснять на пальцах, юзеры обычно обижаются - типа что-же мы же не настолько тупые чтобы нам ТАК объясняли, перехожу на обычный свой язык - лица становятся чистыми и светлыми, одухотворенными... не испорченными следами интеллекта. :mrgreen:
Quote:
Хороший пример доки для начинающего юзверя (только не кидать в меня камнями) книжка от Win95. Самое основное, с картинками (типа комиксы) и FAQ...

А зачем кидаться то? Большая часть компьютерщиков так начинала, хоть и ни за какие коврижки теперь не признаются. (Типа родились уже умными)
Я начинал с Бейсика и Фокала на БК-0010, книжка по Win95 мне попалась в руки уже, после того как я ковырял свой первый PC. А до этого был Фигурнов, зачитанный до дыр. А более трамплинистой книжки, чем Жаров "Железо IBM PC" мне больше в жизни не попадалось - столько информации в доступной форме я больше не видел. Разумеется, это все не руководства для программистов, но без них невозможно начать более серьезной работы.
Quote:
P.S. Надо прежде всего четко сформулировать политику составления манов

Может ты, и займешься этим? Было бы хорошо.
Удачи.


Top
   
PostPosted: Sun Oct 07, 2007 5:43 pm 
Offline
User avatar

Joined: Thu Mar 01, 2007 7:57 pm
Posts: 835
HORROR wrote:
Вот...несчастье... почти нажал кнопку "Отправить"....а тут Чубайс привет прислал :)

Есть хорошее лекарство - это браузер Firefox 2
Он восстанавливает аварийно прерванную сессию, включая введённый тобой текст ;)

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


Top
   
PostPosted: Sun Oct 07, 2007 5:44 pm 
Offline
User avatar

Joined: Thu Mar 01, 2007 7:57 pm
Posts: 835
Mario97: где можно взять всю эту литературу?

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


Top
   
PostPosted: Sun Oct 07, 2007 6:12 pm 
Атауальпа
Библиотека, знакомые, Интернет http://google.ru/


Top
   
PostPosted: Sun Oct 07, 2007 6:16 pm 
Offline
User avatar

Joined: Thu Mar 01, 2007 7:57 pm
Posts: 835
Спасибоя, я поищу. Возможно, эта литература поможет мне начать что-то делать.

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


Top
   
PostPosted: Sun Oct 07, 2007 10:39 pm 
Offline
User avatar

Joined: Thu Mar 01, 2007 4:16 pm
Posts: 426
Я проголосовал за chm, но это, в принципе, тот же html, только собранный в один файл.
Ограниченный просмотрщик html без валидации вполне можно сделать. Только лучше ориентированить на стандарт xhtml, парсить xml значительно проще. Разве что возникнет проблема со шрифтами, как всегда.

..bw


Top
   
PostPosted: Mon Oct 08, 2007 9:36 am 
Offline

Joined: Wed Feb 21, 2007 3:03 pm
Posts: 188
А по-моему срать (извиняюсь за слово) какой формат документации. Самое главное чтоб документация была толковая, а остальное не важно. При желании из простого хтмл делается и chm и pdf и txt, конвертеров, благо, хватает. Да и мозги присутствуют :) Действительно, нашелся бы человек, который сможет донести это до людей. Я согласен с Mario79, у меня такая же проблема, я не могу найти эту грань, либо получается объяснение для даунов, либо для себе подобных.

зы. ребят, знаете чего не хватает, документации для разработчиков ядра.


Top
   
PostPosted: Mon Oct 08, 2007 9:49 am 
k@sTIg@r
ИМХО исходники ядра в каком то смысле самии являются документацией - все процедуры мы обзывавем учитывая их назначение, а прокомментировать каждую строку кода нереально.


Top
   
PostPosted: Mon Oct 08, 2007 11:08 am 
Offline

Joined: Wed Feb 21, 2007 3:03 pm
Posts: 188
> все процедуры мы обзывавем учитывая их назначение
Ух, я бы тут поспорил :) Правда, щас дело обстоит куда лучше, чем когда я увидел колибри в первый раз. Когда драйвер мыши писал, особо нравились mouse_count, а также win_pos, win_stack и остальные... Пока не посмотришь их использование, трудновато догадаться в каком виде они хранятся и как используются. Это касается и некоторых функций. Никого не хочу обидеть ;) ибо сам такой же...

Допустим, опять же драйвер мыши. Есть несколько файлов связаных с мышью. В каком искать то что нужно мне. Приходится все пересматривать. И т.д. Вам легко, вы мсходники ядра знаете, знаете где что лежит. Новичкам сложнее. Но это было всего-лишь предложение...


Top
   
PostPosted: Mon Oct 08, 2007 7:43 pm 
Offline
User avatar

Joined: Thu Mar 01, 2007 4:16 pm
Posts: 426
В исходниках очень трудно разобраться. Нужно как минимум комментировать каждый файл/модуль и желательно структуры, а так же функции и др. ключевые моменты.

..bw


Top
   
PostPosted: Wed Oct 10, 2007 3:58 pm 
По поводу исходников... подрабатывал я по студенчеству на мотороллу..... кодером. Ходил дядька - менеджер и за исходники драл нещадно:
- за использование слэнга в коментариях, сокращений
- за более чем ДВЕ строки кода подрят без комментариев (проверяла прога-анвлизатор)
- за то, что комментариев менее 17% от общего количества знаков, причем знаки препинания и спецсимволы не учитывались(проверяла прога-анвлизатор)
- за то, что комментарий невнятен.

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

Что косается "Доки для чайников"... я ужо говорил - ближе к концу ноября.
Тут надо самому для начала попробывать всё,
подомогаться разработчиков,
грязно поприставать к тому что есть....
а потом показать какомунить подростку и по результатам...начать все заново...:)


Top
   
PostPosted: Wed Oct 10, 2007 4:47 pm 
Offline

Joined: Thu Sep 20, 2007 8:09 pm
Posts: 96
Вотпо поводу комментов согласен. У меня шерсть дыбом стоит, т.к. разобраться не получается...


Top
   
PostPosted: Wed Oct 10, 2007 7:25 pm 
Offline
Kernel Developer
User avatar

Joined: Mon Nov 28, 2005 8:00 pm
Posts: 1601
Все вопросы по исходникам ядра можно задавать мне (по мылу, или личным сообщением, или ещё как-нибудь), я в них довольно хорошо разбираюсь.

_________________
Ушёл к умным, знающим и культурным людям.


Top
   
PostPosted: Wed Oct 10, 2007 7:30 pm 
Offline
User avatar

Joined: Mon Apr 16, 2007 6:38 pm
Posts: 1222
тогда предлагаю тебе сохранять свои ответы на вопросы, тогда в итоге наберется документация по ядру)

_________________
И мы уже давно не пешки,
Мы пули, мы орлы, и решки!
Война ютит бинарный код,
Умри, или иди вперед!


Top
   
PostPosted: Thu Oct 11, 2007 6:41 pm 
Offline
User avatar

Joined: Thu Mar 01, 2007 7:57 pm
Posts: 835
У меня есть такое замечание.
В исходниках часто пишут:
Code:
include '..\..\..\macros.inc'

Виндовый Fasm это понимает, а Fasm для Kolibri ругается.
У меня вчера с этим были проблемы, когда в Kolibri компилировал Stackcfg, пришлось править на
Code:
include 'macros.inc'

_________________
Всех выше те, кто доброе творят,
И за дела добра не ждут наград,
Всем жертвуют для страждущих людей,
Не думая о выгоде своей.


Top
   
Display posts from previous:  Sort by  
Post new topic  Reply to topic  [ 31 posts ]  Go to page Previous 1 2 3 Next

All times are UTC+03:00


Who is online

Users browsing this forum: No registered users and 2 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB® Forum Software © phpBB Limited