From: "Dmitry V. Levin" <ldv@altlinux.org>
To: ALT Linux Team development discussions <devel@lists.altlinux.org>
Subject: Re: [devel] Q: is python-module-sphinx build-recursion OK?
Date: Wed, 2 Mar 2016 01:19:40 +0300
Message-ID: <20160301221940.GA8367@altlinux.org> (raw)
In-Reply-To: <20160301220520.GA9565@dad.imath.kiev.ua>
[-- Attachment #1: Type: text/plain, Size: 2039 bytes --]
On Wed, Mar 02, 2016 at 12:05:21AM +0200, Igor Vlasenko wrote:
> On Tue, Mar 01, 2016 at 04:04:55AM +0300, Ivan Zakharyaschev wrote:
> > На самом деле, это из специального автообновляемого пакета
> > python3-module-objects.inv и это копируется только в doc/ и tests/, т.е.
> > можно предположить, что нужно для тестов (можно легко понять) и ещё для
> > чего-то, возможно, документации (не очень понятно, почему документация
> > пакета не может быть собрана из своих исходников без зависимости на данные
> > из внешнего мира). Я в этом мало что смыслю. Надеюсь на комментарий
> > кого-нибудь, кто знает: есть ли причины делать так странно или можно сделать
> > по-другому и лучше?
>
> objects.inv -- это база данных, которую sphinx
> использует для создания кросс-ссылок на документацию
> других модулей из документации текущего проекта.
>
> К примеру, javadoc тоже может ссылаться в документации
> текущего пакета на документацию из других пакетов;
> для этого javadoc требует, чтобы соответствующая документация
> других пакетов была доступна.
>
> У sphinx другой подход. У него есть централизованная
> публичная постоянно обновляемая доступная через интернет
> база данных кросс-ссылок.
>
> Когда sphinx генерирует документацию, он смотрит в эту базу
> и вставляет там где надо кросс-ссылки.
>
> Раньше sphinx просто автоматом при своей сборке выкачивал
> свежий objects.inv из сети.
>
> Когда Дмитрий запретил интернет в hasher chroot,
> Евгению пришлось оторвать objects.inv в отдельный
> пакет, а я по его просьбе поручил обновение
> этой базы сервису cronbuild.
Сейчас в /usr/lib/python2.7/site-packages/sphinx/objects.inv и
/usr/lib/python3.3/site-packages/sphinx/objects.inv лежат идентичные
файлы, принадлежащие пакетам python-module-objects.inv и
python3-module-objects.inv, соответственно.
При этом
$ GET http://docs.python.org/dev/objects.inv | head -3
# Sphinx inventory version 2
# Project: Python
# Version: 3.6
Теперь придётся эту кривизну выпрямить.
--
ldv
[-- Attachment #2: Type: application/pgp-signature, Size: 819 bytes --]
next prev parent reply other threads:[~2016-03-01 22:19 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-03-01 0:46 Ivan Zakharyaschev
2016-03-01 1:04 ` Ivan Zakharyaschev
2016-03-01 22:05 ` Igor Vlasenko
2016-03-01 22:19 ` Dmitry V. Levin [this message]
2016-03-01 22:45 ` Igor Vlasenko
2016-03-02 2:06 ` Dmitry V. Levin
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20160301221940.GA8367@altlinux.org \
--to=ldv@altlinux.org \
--cc=devel@lists.altlinux.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
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