[Numpy-discussion] coding style: citations
Tue Jan 13 13:46:50 CST 2009
On Tue, Jan 13, 2009 at 13:36, Alan G Isaac <email@example.com> wrote:
> On 1/13/2009 1:55 PM Tim Michelsen apparently wrote:
>> Please have a look at:
>> And the example Sphinx project at:
>> #3 -
>> I would appreciate very much to receive any feedback on my approach.
> If I understand, you are using bib4txt.py to do this?
> Then I can offer to help if you run into problems.
> Note that bib4txt can do citation reference substitution.
> I cannot tell if you are doing that separately.
> You did not say specifically what the docstring problem
> is, but the obvious difficulty is the following:
> in a document a reference points to a citation *in that document*,
> while in a docstring it is not clear whether you want that.
> (I.e., should the citation text be in the docstring or
> in a file of citations from all the docstrings?)
In the docstring.
"I have come to believe that the whole world is an enigma, a harmless
enigma that is made terrible by our own mad attempt to interpret it as
though it had an underlying truth."
-- Umberto Eco
More information about the Numpy-discussion