* [devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф) @ 2010-01-27 10:39 ` Michael Shigorin 2010-01-27 12:15 ` Денис Смирнов 0 siblings, 1 reply; 3+ messages in thread From: Michael Shigorin @ 2010-01-27 10:39 UTC (permalink / raw) To: devel PreScriptum: перевожу вопрос по _документированию_ в devel@, сохраняя контекст. raorn@ ответил либо предложил иное, см.: http://lists.altlinux.org/pipermail/devel-newbies/2010-January/000171.html On Tue, Jan 26, 2010 at 11:01:30PM +0300, Anton A. Vinogradov wrote: > Дано: > 0. Имеем самосборный guake-0.4.0-alt0.2.src.rpm > 1. Умеем собирать в ~/RPM > 2. Умеем собирать в hasher > 3. Имеем смутное представление что такое git > 4. Понятия не имеем, что такое gear > 5. Не имеем времени "сражаться с этим в воображении" > > Надо: > Как можно быстрее протолкнуть пакет в сизиф. > > Начинаем: > http://www.altlinux.org/Git.alt/Краткое_руководство Сдобрил примечаниями, но вообще наше около-git.alt-овое хозяйство напрашивается на повторный проход по документации с girar-utils. Не соображу только, как лучше: - рядом упоминать и gear-*/girar-*, и ssh git.alt init-db; + pro: понимание механизмов работы утилит + contra: потенциальная каша в головах - упоминать только высокоуровневые утилиты, описывая их функциональность и отправляя в ман-страницы либо исходники за деталями (но там не всегда обозримо); + pro: более краткие и читабельные страницы + contra: отдаление от понимания происходящего - переименовать текущую страницу в "техническое руководство", а в качестве "краткого руководства" описать утилиты. + pro: документированность высокого и низкого уровня + contra: ? > "Создать свой репозиторий на git.alt очень просто" > Создал. Зачем мне test? А как удалить? > ладно. пусть будет. > создадим то, что надо > arc@arc-laptop ~ $ ssh git.alt init-db guake > girar-init-db: /people/arc/packages/guake.git > > "необходимо создать пустой локальный репозиторий" > Ок. Только не хочу я в домашнем каталоге. > > arc@arc-laptop ~ $ mkdir -p ~arc/Documents/ALTLinux/devel > arc@arc-laptop ~ $ cd ~arc/Documents/ALTLinux/devel > arc@arc-laptop ~/Documents/ALTLinux/devel $ > > arc@arc-laptop ~/Documents/ALTLinux/devel $ git init > Initialized empty Git repository in /home/arc/Documents/ALTLinux/devel/.git/ > > "Закоммитить в него нужное содержимое" > Ок. Но в примере ОДИН файл. Если весь каталог то "*"? > > Да и что мне заряжать в git для сборки пакета? Скелет RPM? > _______________________________________________ > devel-newbies mailing list > devel-newbies/lists.altlinux.org > https://lists.altlinux.org/mailman/listinfo/devel-newbies -- ---- WBR, Michael Shigorin <mike@altlinux.ru> ------ Linux.Kiev http://www.linux.kiev.ua/ ^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф) 2010-01-27 10:39 ` [devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф) Michael Shigorin @ 2010-01-27 12:15 ` Денис Смирнов 2010-01-27 15:22 ` [devel] q: [[git.alt]] с применением gear-*/girar-* Dmitry V. Levin 0 siblings, 1 reply; 3+ messages in thread From: Денис Смирнов @ 2010-01-27 12:15 UTC (permalink / raw) To: ALT Linux Team development discussions [-- Attachment #1: Type: text/plain, Size: 1012 bytes --] On Wed, Jan 27, 2010 at 12:39:42PM +0200, Michael Shigorin wrote: MS> - упоминать только высокоуровневые утилиты, описывая их MS> функциональность и отправляя в ман-страницы либо исходники MS> за деталями (но там не всегда обозримо); MS> + pro: более краткие и читабельные страницы MS> + contra: отдаление от понимания происходящего Не согласен. Отсылать к man-страницам из wiki это плохо. Идеальная документация состоит из справочника (man сраницы), и собственно документации -- tutorial и HOWTO, которые легче поддерживать на wiki. MS> - переименовать текущую страницу в "техническое руководство", MS> а в качестве "краткого руководства" описать утилиты. MS> + pro: документированность высокого и низкого уровня MS> + contra: ? Предлагаю выделить страничку HOWTO с рецептами, а также сделать tutorial -- отдельно по git, отдельно по git.alt. -- С уважением, Денис http://freesource.info ---------------------------------------------------------------------------- [-- Attachment #2: Digital signature --] [-- Type: application/pgp-signature, Size: 198 bytes --] ^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [devel] q: [[git.alt]] с применением gear-*/girar-* 2010-01-27 12:15 ` Денис Смирнов @ 2010-01-27 15:22 ` Dmitry V. Levin 0 siblings, 0 replies; 3+ messages in thread From: Dmitry V. Levin @ 2010-01-27 15:22 UTC (permalink / raw) To: ALT Linux Team development discussions [-- Attachment #1: Type: text/plain, Size: 203 bytes --] On Wed, Jan 27, 2010 at 03:15:11PM +0300, Денис Смирнов wrote: > Не согласен. Отсылать к man-страницам из wiki это плохо. Если эти man-страницы доступны по http, то не так уж и плохо. -- ldv [-- Attachment #2: Type: application/pgp-signature, Size: 198 bytes --] ^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2010-01-27 15:22 UTC | newest] Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2010-01-27 10:39 ` [devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф) Michael Shigorin 2010-01-27 12:15 ` Денис Смирнов 2010-01-27 15:22 ` [devel] q: [[git.alt]] с применением gear-*/girar-* Dmitry V. Levin
ALT Linux Team development discussions This inbox may be cloned and mirrored by anyone: git clone --mirror http://lore.altlinux.org/devel/0 devel/git/0.git # If you have public-inbox 1.1+ installed, you may # initialize and index your mirror using the following commands: public-inbox-init -V2 devel devel/ http://lore.altlinux.org/devel \ devel@altlinux.org devel@altlinux.ru devel@lists.altlinux.org devel@lists.altlinux.ru devel@linux.iplabs.ru mandrake-russian@linuxteam.iplabs.ru sisyphus@linuxteam.iplabs.ru public-inbox-index devel Example config snippet for mirrors. Newsgroup available over NNTP: nntp://lore.altlinux.org/org.altlinux.lists.devel AGPL code for this site: git clone https://public-inbox.org/public-inbox.git