Hi mentors,
I have a package [1] that builds its doc using sphinx [2] and the
intersphinx extension [3].
Intersphinx attempts to download "objects.inv" files to generate links
to external documentation.

Packages should be self-contained so trying to access the net can be
considered a polycy violation, anyway even in absence of network
connection the package builds successfully (download errors are ignored).

The question is: which is the best way to address the issue?
a. disable interspinx
b. point to local objects.inv files (this implies to add an additional
   dependency from another -doc package (at least python-doc in this
   case)
c. just ignore the problem

Is there a common practice for cases like this?


[1] http://packages.qa.debian.org/p/pyepr.html
[2] http://sphinx-doc.org
[3] http://sphinx-doc.org/ext/intersphinx.html


best regards

-- 
Antonio Valentino


-- 
To UNSUBSCRIBE, email to debian-mentors-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/5266b1a1.8040...@tiscali.it

Reply via email to