[devel] Документация с Мастером 2.4

[devel] Документация с Мастером 2.4

[Денис Смирнов]

[-- Attachment #1: Type: text/plain, Size: 376 bytes --]

Помнится в коробке с 2.2 была просто чудесная документация "для
разработчиков". Вплоть до программирования под PalmOS (что меня очень
приятно удивило). В 2.4 я чего-то ничего подобного не нашёл, кроме
введения по сборке пакетов и описания макросов. Меня глючит, или часть
девелоперской дкоументации просто выкинули?

-- 
С уважением, Денис

http://freesource.info


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] Документация с Мастером 2.4

[Andy Gorev]

Денис Смирнов wrote:
> Помнится в коробке с 2.2 была просто чудесная документация "для
> разработчиков". Вплоть до программирования под PalmOS (что меня очень
> приятно удивило). В 2.4 я чего-то ничего подобного не нашёл, кроме
> введения по сборке пакетов и описания макросов. Меня глючит, или часть
> девелоперской дкоументации просто выкинули?
Да, особенно жалко доки по CVS, которую когда-то Корнет писал.

-- 
С Уважением,
Андрей Горев

Re: [devel] Документация с Мастером 2.4

[Kirill Maslinsky]

Добрый вечер.

> Помнится в коробке с 2.2 была просто чудесная документация "для
> разработчиков". Вплоть до программирования под PalmOS (что меня очень
> приятно удивило). В 2.4 я чего-то ничего подобного не нашёл, кроме
> введения по сборке пакетов и описания макросов. Меня глючит, или часть
> девелоперской дкоументации просто выкинули?

Ну да, выкинули. В 2.2 Руководство разработчика было скорее сборником
отдельных статей и руководств по отдельным инструментам. Но в 2.4
хотелось видеть целостную книжку. Руководство разработчика под Linux вообще --
слишком масштабная задача: описать всё, что нужно разработчику под 
Linuх... я не возьмусь. А если описывать только что-нибудь, то сразу вознкиает вопрос о критериях отбора. Например, включаем мы руководство по cvs --
а почему не по subversion или arch? Разработка под PalmOS -- не менее 
частная вещь. Так что было решено ограничиться разработкой, специфичной
для ALT Linux. А документация по отдельным инструментам и статьи по 
разработке обязательно появятся в Сизифе в скором времени -- 
на правах alt-docs-extras-*. Их там нет пока только потому, 
что руки ещё не дошли.

-- 
Kirill Maslinsky
ALT Linux Team * Documentation Project   

Re: [devel] Документация с Мастером 2.4

[Денис Смирнов]

On Wed, Nov 24, 2004 at 09:09:45PM +0300, Kirill Maslinsky wrote:

KM> Ну да, выкинули. В 2.2 Руководство разработчика было скорее сборником
KM> отдельных статей и руководств по отдельным инструментам. Но в 2.4
KM> хотелось видеть целостную книжку. Руководство разработчика под Linux вообще --
KM> слишком масштабная задача: описать всё, что нужно разработчику под 
KM> Linuх... я не возьмусь. А если описывать только что-нибудь, то сразу вознкиает вопрос о критериях отбора. Например, включаем мы руководство по cvs --
KM> а почему не по subversion или arch? Разработка под PalmOS -- не менее 
KM> частная вещь. Так что было решено ограничиться разработкой, специфичной
KM> для ALT Linux. А документация по отдельным инструментам и статьи по 
KM> разработке обязательно появятся в Сизифе в скором времени -- 
KM> на правах alt-docs-extras-*. Их там нет пока только потому, 
KM> что руки ещё не дошли.

А те старые документы по GFDL или какими-либо ещё свободными лицензиями?

Думаю руководство разработчика тоже интересная задача. Обоснование любого
решения всегда есть.

Вопрос, IMHO, стоит немного по-другому -- подобная документация несколько
не для дистрибутива. А скорее для отдельного dev kit'а, где его основой и
может быть как раз документация.

Я потихоньку медитирую над побоным решением. И в нём можно обосновать всё.
Например в примере с cvs всё понятно -- cvs сейчас стандарт де-факто,
который разработчик _обязан_ знать. subversion его естественная замена (он
и есть cvs на стеоридах, по сути). Вот arch/darcs/... это совсем другая
тема. Которую пока поднимать я бы не решился.

PalmOS не такая уж и частная вещь. Ибо наладонники сейчас у многих. А
PalmOS это "дёшево и сердито".

И т.д. Но нужно это всё небольшому проценту пользователей. Также как и
интеловский диск, на самом деле.

-- 
С уважением, Денис

http://freesource.info

Re: [devel] Документация с Мастером 2.4

[Stanislav Ievlev]

On Wed, Nov 24, 2004 at 08:01:02PM +0300, Andy Gorev wrote:
> Денис Смирнов wrote:
> >Помнится в коробке с 2.2 была просто чудесная документация "для
> >разработчиков". Вплоть до программирования под PalmOS (что меня очень
> >приятно удивило). В 2.4 я чего-то ничего подобного не нашёл, кроме
> >введения по сборке пакетов и описания макросов. Меня глючит, или часть
> >девелоперской дкоументации просто выкинули?
> Да, особенно жалко доки по CVS, которую когда-то Корнет писал.
там был дока про CVS совсем другого автора, если я не ошибаюсь ;)

наверное всё связано с объёмом коробки, который жёстко ограничен.
> 
> -- 
> С Уважением,
> Андрей Горев
> _______________________________________________
> Devel mailing list
> Devel@altlinux.ru
> https://lists.altlinux.ru/mailman/listinfo/devel

Re: [devel] Документация с Мастером 2.4

[Денис Смирнов]

[-- Attachment #1: Type: text/plain, Size: 722 bytes --]

On Thu, Nov 25, 2004 at 11:41:31AM +0300, Stanislav Ievlev wrote:
> >>Помнится в коробке с 2.2 была просто чудесная документация "для
> >>разработчиков". Вплоть до программирования под PalmOS (что меня очень
> >>приятно удивило). В 2.4 я чего-то ничего подобного не нашёл, кроме
> >>введения по сборке пакетов и описания макросов. Меня глючит, или часть
> >>девелоперской дкоументации просто выкинули?
>> Да, особенно жалко доки по CVS, которую когда-то Корнет писал.
SI> там был дока про CVS совсем другого автора, если я не ошибаюсь ;)
SI> наверное всё связано с объёмом коробки, который жёстко ограничен.

Нынешняя коробка заметно больше её наполнения.

-- 
С уважением, Денис

http://freesource.info


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] Документация с Мастером 2.4

[Stanislav Ievlev]

On Thu, Nov 25, 2004 at 02:46:15PM +0300, Денис Смирнов wrote:
> On Thu, Nov 25, 2004 at 11:41:31AM +0300, Stanislav Ievlev wrote:
> > >>Помнится в коробке с 2.2 была просто чудесная документация "для
> > >>разработчиков". Вплоть до программирования под PalmOS (что меня очень
> > >>приятно удивило). В 2.4 я чего-то ничего подобного не нашёл, кроме
> > >>введения по сборке пакетов и описания макросов. Меня глючит, или часть
> > >>девелоперской дкоументации просто выкинули?
> >> Да, особенно жалко доки по CVS, которую когда-то Корнет писал.
> SI> там был дока про CVS совсем другого автора, если я не ошибаюсь ;)
> SI> наверное всё связано с объёмом коробки, который жёстко ограничен.
> 
> Нынешняя коробка заметно больше её наполнения.
ничего подобного, там ещё ведь и диски есть.
> 
> -- 
> С уважением, Денис
> 
> http://freesource.info
> 



> _______________________________________________
> Devel mailing list
> Devel@altlinux.ru
> https://lists.altlinux.ru/mailman/listinfo/devel

Re: [devel] Документация с Мастером 2.4

[Alexey I. Froloff]

[-- Attachment #1: Type: text/plain, Size: 1070 bytes --]

* Stanislav Ievlev <inger@> [041125 15:35]:
> > > >>Помнится в коробке с 2.2 была просто чудесная документация "для
> > > >>разработчиков". Вплоть до программирования под PalmOS (что меня очень
> > > >>приятно удивило). В 2.4 я чего-то ничего подобного не нашёл, кроме
> > > >>введения по сборке пакетов и описания макросов. Меня глючит, или часть
> > > >>девелоперской дкоументации просто выкинули?
> > >> Да, особенно жалко доки по CVS, которую когда-то Корнет писал.
> > SI> там был дока про CVS совсем другого автора, если я не ошибаюсь ;)
> > SI> наверное всё связано с объёмом коробки, который жёстко ограничен.
> > Нынешняя коробка заметно больше её наполнения.
> ничего подобного, там ещё ведь и диски есть.
А диски-то зачем?  Все уже всё скачали ;-)

-- 
Regards, Sir Raorn.
-------------------
На основании этого можно сделать очевидные выводы:
+ нам удобно, чтобы чужие spec-файлы у нас работали (хотя бы для удобства
  подготовки своего spec-файла);
+ нам все равно, будут ли наши spec-файлы работать где-либо еще.
		-- ldv in sisyphus@

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] Документация с Мастером 2.4

[Kirill Maslinsky]

Добрый день!

> А те старые документы по GFDL или какими-либо ещё свободными лицензиями?
Ну да.

> Думаю руководство разработчика тоже интересная задача. Обоснование любого
> решения всегда есть.
> 
> Вопрос, IMHO, стоит немного по-другому -- подобная документация несколько
> не для дистрибутива. А скорее для отдельного dev kit'а, где его основой и
> может быть как раз документация.

Именно так. Для дистрибутива -- то, что относится к разработке в ALT.
Грубо говоря, из которой будет понятно, откуда взялся этот дистрибутив,
и почему он такой ;)

-- 
Kirill Maslinsky
ALT Linux Team * Documentation Project   

Re: [devel] Документация с Мастером 2.4

[Kirill Maslinsky]

> > >введения по сборке пакетов и описания макросов. Меня глючит, или часть
> > >девелоперской дкоументации просто выкинули?
> > Да, особенно жалко доки по CVS, которую когда-то Корнет писал.
> там был дока про CVS совсем другого автора, если я не ошибаюсь ;)
> 
> наверное всё связано с объёмом коробки, который жёстко ограничен.

И ещё с объёмом людей, готовящих книжки, который тоже жёстко ограничен.
Прибавление ещё какого-нибудь раздела -- это +n страниц разметки/правки/вычитки/вёрстки...

-- 
Kirill Maslinsky
ALT Linux Team * Documentation Project   

[devel] Re: Документация с Мастером 2.4

[Vitaly Ostanin]

[-- Attachment #1: Type: text/plain, Size: 687 bytes --]

Kirill Maslinsky пишет:

>>>>введения по сборке пакетов и описания макросов. Меня глючит, или часть
>>>>девелоперской дкоументации просто выкинули?
>>>>        
>>>>
>>>Да, особенно жалко доки по CVS, которую когда-то Корнет писал.
>>>      
>>>
>>там был дока про CVS совсем другого автора, если я не ошибаюсь ;)
>>
>>наверное всё связано с объёмом коробки, который жёстко ограничен.
>>    
>>
>
>И ещё с объёмом людей, готовящих книжки, который тоже жёстко ограничен.
>Прибавление ещё какого-нибудь раздела -- это +n страниц разметки/правки/вычитки/вёрстки...
>  
>

Я не помню в docs@ набора добровольцев на вычитку...

-- 
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 252 bytes --]

[devel] Re: Документация с Мастером 2.4

[Michael Shigorin]

On Thu, Nov 25, 2004 at 06:48:11PM +0300, Kirill Maslinsky wrote:
> И ещё с объёмом людей, готовящих книжки, который тоже жёстко
> ограничен.

Угу.  Читал и думал, что 2.2 вычитывал меньше 2.0, а 2.4 --
вообще не. (и не только я, догадываюсь)

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

[devel] Re: Документация с Мастером 2.4

[Michael Shigorin]

On Thu, Nov 25, 2004 at 04:34:48PM +0300, Kirill Maslinsky wrote:
> Именно так. Для дистрибутива -- то, что относится к разработке
> в ALT.  Грубо говоря, из которой будет понятно, откуда взялся
> этот дистрибутив, и почему он такой ;)

Как по мне, так бутстрап вполне неплохой вышел (тоже узнал для
себя кой-чего нового из легионовых (видимо) записок :)

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [devel]Документация с Мастером2.4

[Alex Ott]

>On Wed, Nov 24, 2004 at 09:09:45PM +0300, Kirill Maslinsky wrote:
>Я потихоньку медитирую над побоным решением. И в нём можно обосновать всё.
>Например в примере с cvs всё понятно -- cvs сейчас стандарт де-факто,
>который разработчик _обязан_ знать. subversion его естественная замена (он
>и есть cvs на стеоридах, по сути). Вот arch/darcs/... это совсем другая
>тема. Которую пока поднимать я бы не решился.

а зря - arch -- хороший выбор, особенно для team-разработки

Re: [devel] Документация с Мастером2.4

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 648 bytes --]

On Tue, Nov 30, 2004 at 05:31:33PM +0300, Alex Ott wrote:
> >On Wed, Nov 24, 2004 at 09:09:45PM +0300, Kirill Maslinsky wrote:
> >Я потихоньку медитирую над побоным решением. И в нём можно обосновать всё.
> >Например в примере с cvs всё понятно -- cvs сейчас стандарт де-факто,
> >который разработчик _обязан_ знать. subversion его естественная замена (он
> >и есть cvs на стеоридах, по сути). Вот arch/darcs/... это совсем другая
> >тема. Которую пока поднимать я бы не решился.
> 
> а зря - arch -- хороший выбор, особенно для team-разработки

Конечно, arch - хороший выбор, но стоит ли его навязывать (на данном этапе)?


-- 
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel]Документация с Мастером2.4

[Alex Ott]

>On Tue, Nov 30, 2004 at 05:31:33PM +0300, Alex Ott wrote:
>> >On Wed, Nov 24, 2004 at 09:09:45PM +0300, Kirill Maslinsky wrote:
>> >Я потихоньку медитирую над побоным решением. И в нём можно обосновать всё.
>> >Например в примере с cvs всё понятно -- cvs сейчас стандарт де-факто,
>> >который разработчик _обязан_ знать. subversion его естественная замена (он
>> >и есть cvs на стеоридах, по сути). Вот arch/darcs/... это совсем другая
>> >тема. Которую пока поднимать я бы не решился.
>> 
>> а зря - arch -- хороший выбор, особенно для team-разработки
>
>Конечно, arch - хороший выбор, но стоит ли его навязывать (на данном этапе)?

а иначе не получится работать offline. централизованные репозитории - это не совсем хорошо. я например с работы просто не могу достучаться до altlinux в силу административных препятствий

Re: [devel]Документация с Мастером2.4

[Денис Смирнов]

[-- Attachment #1: Type: text/plain, Size: 938 bytes --]

On Tue, Nov 30, 2004 at 05:31:33PM +0300, Alex Ott wrote:
>>On Wed, Nov 24, 2004 at 09:09:45PM +0300, Kirill Maslinsky wrote:
>>Я потихоньку медитирую над побоным решением. И в нём можно обосновать всё.
>>Например в примере с cvs всё понятно -- cvs сейчас стандарт де-факто,
>>который разработчик _обязан_ знать. subversion его естественная замена (он
>>и есть cvs на стеоридах, по сути). Вот arch/darcs/... это совсем другая
>>тема. Которую пока поднимать я бы не решился.
AO> а зря - arch -- хороший выбор, особенно для team-разработки

Не спорю что хороший. Даже очень хороший. Но вот как-то не получается у
меня с ним подружиться.

Ты можешь дать ссылку на описание usecase? При пошаговой работе по
документации всё работает. Но полноценно использовать у меня не
получилось. В том числе не понял как организовывать распределённую
периодически-offline разрабокту.

-- 
С уважением, Денис

http://freesource.info


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re:[devel]Документация с Мастером2.4

[Alex Ott]

>On Tue, Nov 30, 2004 at 05:31:33PM +0300, Alex Ott wrote:
>>>On Wed, Nov 24, 2004 at 09:09:45PM +0300, Kirill Maslinsky wrote:
>>>Я потихоньку медитирую над побоным решением. И в нём можно обосновать всё.
>>>Например в примере с cvs всё понятно -- cvs сейчас стандарт де-факто,
>>>который разработчик _обязан_ знать. subversion его естественная замена (он
>>>и есть cvs на стеоридах, по сути). Вот arch/darcs/... это совсем другая
>>>тема. Которую пока поднимать я бы не решился.
>AO> а зря - arch -- хороший выбор, особенно для team-разработки
>
>Не спорю что хороший. Даже очень хороший. Но вот как-то не получается у
>меня с ним подружиться.
>
>Ты можешь дать ссылку на описание usecase? При пошаговой работе по
>документации всё работает. Но полноценно использовать у меня не
>получилось. В том числе не понял как организовывать распределённую
>периодически-offline разрабокту.

У меня есть идея написать статью про это, но пока нет времени

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

Re: [devel]Документация с Мастером2.4

[Alexey Voinov]

[-- Attachment #1: Type: text/plain, Size: 909 bytes --]

Alex Ott wrote
> >AO> а зря - arch -- хороший выбор, особенно для team-разработки
> >Не спорю что хороший. Даже очень хороший. Но вот как-то не получается у
> >меня с ним подружиться.
> >
> >Ты можешь дать ссылку на описание usecase? При пошаговой работе по
> >документации всё работает. Но полноценно использовать у меня не
> >получилось. В том числе не понял как организовывать распределённую
> >периодически-offline разрабокту.
> У меня есть идея написать статью про это, но пока нет времени
> 
> обычно ход работ такой -- есть репозиторий, от него ответвляешь свою
> версию, работаешь, коммитишь, периодически забираешь в центральный
> репозиторий изменения, или втягиваешь из него чужие изменения
Кстати, насчёт центрального репозитория: его может оказаться удобно
организовать с помощью arch-pqm.

-- 
Best Regards!
Alexey Voinov
	     
voins@voins.program.ru
voins@altlinux.ru


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re:[devel]Документация с Мастером2.4

[Alex Ott]

>Alex Ott wrote
>> >AO> а зря - arch -- хороший выбор, особенно для team-разработки
>> >Не спорю что хороший. Даже очень хороший. Но вот как-то не получается у
>> >меня с ним подружиться.
>> >
>> >Ты можешь дать ссылку на описание usecase? При пошаговой работе по
>> >документации всё работает. Но полноценно использовать у меня не
>> >получилось. В том числе не понял как организовывать распределённую
>> >периодически-offline разрабокту.
>> У меня есть идея написать статью про это, но пока нет времени
>> 
>> обычно ход работ такой -- есть репозиторий, от него ответвляешь свою
>> версию, работаешь, коммитишь, периодически забираешь в центральный
>> репозиторий изменения, или втягиваешь из него чужие изменения
>Кстати, насчёт центрального репозитория: его может оказаться удобно
>организовать с помощью arch-pqm.

угу, с его помощью и лучше сделать - чтобы вручную не вытягивать изменения. Надо посмотреть на стиль разработки самого tla