Re: [devel] alt-docs-xsl-manpages

Re: [devel] alt-docs-xsl-manpages

[Илья Евсеев]

> Date: Tue, 28 Dec 2004 15:38:34 +0300
> From: Vitaly Ostanin <vyt@vzljot.ru>

> Есть предложение переименовать пакет
> alt-docs-xsl-manpages во что-нибудь более подходящее.
нет проблем. во что?

> Стили из этого пакета взяты из samba,
Да.
> в cvs docs их нет, 
Идут переговоры :-)

> и мне не ясно, какое отношение они имеют к alt-docs-xsl*.
Только одно: насколько я понимаю, стилю рекомендуется назначать URI,
по которому его при необходимости можно будет подключать в другой стиль.
В файле catalog находится набор подстановок из URI в локальные каталоги.
Подразумевается, что man.xsl скоро будет положен
в http://docs.altlinux.ru/releases/xsl/current/,
то есть на него станет возможно ссылаться,
хотя сейчас такой необходимости нет.

> Кроме того, некрасиво брать чужую работу
> и подменять ссылку на оригинал ссылкой на собственную страницу.
> И даже на собственной странице нет ссылки на оригинал,

К сожалению, у оригинала нет своей страницы.
Он в лучшем случае доступен как часть CVS/SVN,
и то я его пока там не отыскал.
Когда отыщу - вставлю на Веб-страницу и в %SOURCE1.

В %description сказано, что стили разработаны Samba Team.
%description вынесен на Веб-страницу пакета.
Если считается, что авторство оригинала следует обозначить
как-то более развёрнуто (упомянуть Бокового?),
готов учесть конкретные предложения.
Если бы в XSL были комментарии, я бы их оставил.
Если необходимо, я могу сам их туда добавить,
перечислив всех и вся, кого только можно.

Что касается указания собственной страницы в %url пакета,
то об этом я уже писал: как пользователю при знакомстве с пакетом
мне зачастую нужна ссылка не только на оригинальные исходники,
но и на текущие исходники для сборки. Зачем - отдельный вопрос.
Тем более, что со второго на первое организовать ссылку легко,
а наоборот - как-то не очень. Поэтому, начав собирать пакеты,
я решил помещать в них ссылку на страницу сборки,
а в начале странице сборки - ссылку на страницу разработки.

> и нет описания, какие именно "minimal modifications"
> были применены к оригиналу.
Только те, которые позволяют компилировать стиль без samba-docs.
Прямо сейчас не вспомню, но там подключались settings.xsl
с настройками, интересными только для db2latex
(размер страницы, портрет/ландшафт и т.д.) и что-то ещё в том же духе.
То есть убрана пара строк. В следующей сборке готов откатиться
на оригинальный man.xsl с прикладыванием патча.

С уважением,
Илья Евсеев

[devel] Re: alt-docs-xsl-manpages

[Vitaly Ostanin]

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

Илья Евсеев пишет:
>>Date: Tue, 28 Dec 2004 15:38:34 +0300
>>From: Vitaly Ostanin <vyt@vzljot.ru>
> 
>>Есть предложение переименовать пакет
>>alt-docs-xsl-manpages во что-нибудь более подходящее.
> 
> нет проблем. во что?

Это Вам надо придумать, во что.

>>Стили из этого пакета взяты из samba,
> 
> Да.
> 
>>в cvs docs их нет, 
> 
> Идут переговоры :-)

Первый раз слышу.

>>и мне не ясно, какое отношение они имеют к alt-docs-xsl*.
> 
> Только одно: насколько я понимаю, стилю рекомендуется назначать URI,
> по которому его при необходимости можно будет подключать в другой стиль.
> В файле catalog находится набор подстановок из URI в локальные каталоги.
> Подразумевается, что man.xsl скоро будет положен
> в http://docs.altlinux.ru/releases/xsl/current/,
> то есть на него станет возможно ссылаться,
> хотя сейчас такой необходимости нет.

Об это неплохо было бы поставить в известность мантейнера 
alt-docs-xsl до выкладывания пакета.

>>Кроме того, некрасиво брать чужую работу
>>и подменять ссылку на оригинал ссылкой на собственную страницу.
>>И даже на собственной странице нет ссылки на оригинал,
> 
> К сожалению, у оригинала нет своей страницы.
> Он в лучшем случае доступен как часть CVS/SVN,
> и то я его пока там не отыскал.
> Когда отыщу - вставлю на Веб-страницу и в %SOURCE1.

Выкладывать пакет с неотысканным source рановато...

> В %description сказано, что стили разработаны Samba Team.
> %description вынесен на Веб-страницу пакета.
> Если считается, что авторство оригинала следует обозначить
> как-то более развёрнуто (упомянуть Бокового?),
> готов учесть конкретные предложения.

В URL пакета должна стоять ссылка на оригинал пакета или не 
стоять вовсе (что тоже неправильно). Информативность данной 
промежуточной Веб-страницы равна нулю.

> Если бы в XSL были комментарии, я бы их оставил.
> Если необходимо, я могу сам их туда добавить,
> перечислив всех и вся, кого только можно.
> 
> Что касается указания собственной страницы в %url пакета,
> то об этом я уже писал: как пользователю при знакомстве с пакетом
> мне зачастую нужна ссылка не только на оригинальные исходники,
> но и на текущие исходники для сборки. Зачем - отдельный вопрос.

И я Вам об этом уже писал. У Вас свои этические соображения - и 
на здоровье. Только не надо применять свои соображения на пакетах 
alt-docs-xsl*. У стилей alt-docs-xsl уже есть мантейнер. Это 
основная мысль моего письма.

> Тем более, что со второго на первое организовать ссылку легко,
> а наоборот - как-то не очень. Поэтому, начав собирать пакеты,
> я решил помещать в них ссылку на страницу сборки,
> а в начале странице сборки - ссылку на страницу разработки.
> 
>>и нет описания, какие именно "minimal modifications"
>>были применены к оригиналу.
> 
> Только те, которые позволяют компилировать стиль без samba-docs.
> Прямо сейчас не вспомню, но там подключались settings.xsl
> с настройками, интересными только для db2latex
> (размер страницы, портрет/ландшафт и т.д.) и что-то ещё в том же духе.
> То есть убрана пара строк. В следующей сборке готов откатиться
> на оригинальный man.xsl с прикладыванием патча.

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

<skipped/>

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

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

[devel] Re: alt-docs-xsl-manpages

[Michael Shigorin]

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

On Tue, Dec 28, 2004 at 04:57:15PM +0300, Vitaly Ostanin wrote:
> >>Есть предложение переименовать пакет
> >>alt-docs-xsl-manpages во что-нибудь более подходящее.
> >нет проблем. во что?
> Это Вам надо придумать, во что.

Ты о "зарезервированности" префикса alt-docs? 
Так бы сразу и сказал :)

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

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

[devel] Re: alt-docs-xsl-manpages

[Vitaly Ostanin]

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

Michael Shigorin пишет:
> On Tue, Dec 28, 2004 at 04:57:15PM +0300, Vitaly Ostanin wrote:
> 
>>>>Есть предложение переименовать пакет
>>>>alt-docs-xsl-manpages во что-нибудь более подходящее.
>>>
>>>нет проблем. во что?
>>
>>Это Вам надо придумать, во что.
> 
> 
> Ты о "зарезервированности" префикса alt-docs? 
> Так бы сразу и сказал :)

alt-docs-xsl. Так и сказал. Как раз где ты вырезал ;)

<skipped/>

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

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