[sage-devel] Re: sphinx, texinfo and emacs

2016-10-22 Thread 'Martin R' via sage-devel
the key is what gets written into conf.py by class SingleFileBuilder(DocBuilder) from docbuild/__init__py. what would be a good naming scheme for the files? I assume something like the name of the python source directory, right? Martin Am Samstag, 22. Oktober 2016 17:42:42 UTC+2 schrieb Marti

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-22 Thread 'Martin R' via sage-devel
apparently the name sagereferencemanualstandardcommutativerings.info is autogenerated by sphinx and could be customized somehow, just I do not know how yet. See http://www.sphinx-doc.org/en/1.4.8/config.html (options for texinfo output). Martin Am Samstag, 22. Oktober 2016 13:52:13 UTC+2 schr

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-22 Thread Sho Takemori
Yes. It would be better if it also could provide the info node. But I can search class, function or method names by "Info-search" inside the file. For example, I can find the document for the method "factor" for an instance of "sage.rings.integer.Integer" as follows. (progn (Info-find-node

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-22 Thread 'Martin R' via sage-devel
I guess you need more than the filename, you also need the info node, no? Martin -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegrou

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-22 Thread Sho Takemori
Hi. I am the mantainer of sage-shell-mode and I need a function that receive an object and returns the corresponding info file name. For example it should return "sagereferencemanualstandardcommutativerings.info" for the object ZZ. Does anyone know how to implement such a funciton? Sho Takmeor

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-21 Thread 'Martin R' via sage-devel
Am Freitag, 21. Oktober 2016 23:51:18 UTC+2 schrieb Matthias Koeppe: > > > We already have makeinfo as part of the autotools package. > great! one further question: I noticed that there may also be other files such as pictures (in .png) format which "sage -docbuild DOCUMENT texinfo" puts into

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-21 Thread Matthias Koeppe
On Friday, October 21, 2016 at 1:18:48 PM UTC-7, John H Palmieri wrote: > > On Friday, October 21, 2016 at 12:31:01 PM UTC-7, Martin R wrote: >> >> >> 3.) building info files requires that makeinfo is installed. What is the >> proper way to deal with this? >> > > Check whether it's installed in s

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-21 Thread John H Palmieri
On Friday, October 21, 2016 at 1:46:02 PM UTC-7, Martin R wrote: > > > > Am Freitag, 21. Oktober 2016 22:18:48 UTC+2 schrieb John H Palmieri: >> >> >> >> On Friday, October 21, 2016 at 12:31:01 PM UTC-7, Martin R wrote: >>> >>> Eli Zaretskii from the texinfo team helped me with two problems I had

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-21 Thread 'Martin R' via sage-devel
Am Freitag, 21. Oktober 2016 22:18:48 UTC+2 schrieb John H Palmieri: > > > > On Friday, October 21, 2016 at 12:31:01 PM UTC-7, Martin R wrote: >> >> Eli Zaretskii from the texinfo team helped me with two problems I had, >> and texinfo documentation is now almost ready to go. I need help with >

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-21 Thread John H Palmieri
On Friday, October 21, 2016 at 12:31:01 PM UTC-7, Martin R wrote: > > Eli Zaretskii from the texinfo team helped me with two problems I had, and > texinfo documentation is now almost ready to go. I need help with three > things, which I report here, because trac is down. > > 1.) for some reaso

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-21 Thread 'Martin R' via sage-devel
Eli Zaretskii from the texinfo team helped me with two problems I had, and texinfo documentation is now almost ready to go. I need help with three things, which I report here, because trac is down. 1.) for some reason, it is necessary that makeinfo is called with "--footnote-style separate". H

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-20 Thread 'Martin R' via sage-devel
this is now https://trac.sagemath.org/ticket/21734 help is much appreciated -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.co

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-20 Thread 'Martin R' via sage-devel
after patching and doing ./sage -docbuild reference texinfo I get many *.texi files, and in each directory a makefile. After installing makeinfo (sudo apt-get install info), and doing make, I get very nice looking info files, and at least the top one seems to work very well. Even in the unlike

[sage-devel] Re: sphinx, texinfo and emacs

2016-10-20 Thread 'Martin R' via sage-devel
as a first step to answering (2), I just applied the patch below, and it seems to build the reference in texinfo format. diff --git a/src/sage_setup/docbuild/__init__.py b/src/sage_setup/docbuild/__init__.py index 0bd52a6..9ddf7d4 100644 --- a/src/sage_setup/docbuild/__init__.py +++ b/src/sage_s