From: Igor Vlasenko <vlasenko@imath.kiev.ua>
To: ALT Linux Team development discussions <devel@lists.altlinux.org>
Cc: Ivan Zakharyaschev <imz@altlinux.org>
Subject: Re: [devel] Q: is python-module-sphinx build-recursion OK?
Date: Wed, 2 Mar 2016 00:05:21 +0200
Message-ID: <20160301220520.GA9565@dad.imath.kiev.ua> (raw)
In-Reply-To: <alpine.LFD.2.20.1603010353260.19380@imap.altlinux.org>
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.
--
I V
next prev parent reply other threads:[~2016-03-01 22:05 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 [this message]
2016-03-01 22:19 ` Dmitry V. Levin
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=20160301220520.GA9565@dad.imath.kiev.ua \
--to=vlasenko@imath.kiev.ua \
--cc=devel@lists.altlinux.org \
--cc=imz@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