* [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