From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on sa.local.altlinux.org X-Spam-Level: X-Spam-Status: No, score=-1.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DNS_FROM_AHBL_RHSBL,RCVD_IN_DNSWL_NONE, RP_MATCHES_RCVD,SPF_PASS autolearn=no autolearn_force=no version=3.4.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=imath.kiev.ua; s=hydra; t=1456869926; bh=5V7V/p6xPuQnINlkukwY3NjkqLYA+0xwABVi1Y5I318=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=Di2O+nOju4T/lERhJ8drj8a+nCEdSZ9UxkYpLtUEnqWj7CDiRfR0gd602UsXM4HWm Mz4V3h3h5J0oLu1djHR0rvpKjKPq7xFEEKrYdPddAUS5UED+S1O3ZVlBhEGoZmkqPM sp35q8UYpzQ0uf1DRbxQzAOYgTJpgX+JeKUAwyKk= X-Virus-Scanned: amavisd-new at imath.kiev.ua DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=imath.kiev.ua; s=hydra; t=1456869922; bh=5V7V/p6xPuQnINlkukwY3NjkqLYA+0xwABVi1Y5I318=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=k/B/dWc4Ys/1uDEH89ElX6XxMVmPAbdc3cLl9fBY216FWEvalPh/3h8woAXfQSfx4 Ab5NY9zLrOjJKOeRNm+jokymsgeJvoqH48SCoJsiEk5My5Cn07x48dyCAZ6b3eo0CT kppRkE8sJ0m+buSHTU1qAN3I9s8P5KXMWcLbxeiA= Date: Wed, 2 Mar 2016 00:05:21 +0200 From: Igor Vlasenko To: ALT Linux Team development discussions Message-ID: <20160301220520.GA9565@dad.imath.kiev.ua> References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.5.23 (2014-03-12) Cc: Ivan Zakharyaschev Subject: Re: [devel] Q: is python-module-sphinx build-recursion OK? X-BeenThere: devel@lists.altlinux.org X-Mailman-Version: 2.1.12 Precedence: list Reply-To: ALT Linux Team development discussions List-Id: ALT Linux Team development discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Mar 2016 22:05:29 -0000 Archived-At: List-Archive: List-Post: 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