ASKSAGE: Sage Q&A Forum - RSS feedhttps://ask.sagemath.org/questions/Q&A Forum for SageenCopyright Sage, 2010. Some rights reserved under creative commons license.Tue, 22 Jun 2021 13:43:06 +0200Where to find older version documentation?https://ask.sagemath.org/question/57665/where-to-find-older-version-documentation/Hi! Where can one locate the documentation for older versions of Sage? (In particular I need to check the usage of range vs. srange in versions 9.1 vs. 9.2, so I googled for the 9.1 documentation and couldn't find it.) smbelcasTue, 22 Jun 2021 13:43:06 +0200https://ask.sagemath.org/question/57665/unavailable linkhttps://ask.sagemath.org/question/53190/unavailable-link/In the section "Geometry and Topology" on the page
- [https://doc.sagemath.org/pdf/en/reference/](https://doc.sagemath.org/pdf/en/reference/)
the first link is
:doc:`Euclidean Spaces and Vector Calculus`
which does not link to any file. Please fix this.danielvolinskiWed, 26 Aug 2020 20:13:12 +0200https://ask.sagemath.org/question/53190/building docs with sphinx-1.8.5https://ask.sagemath.org/question/50925/building-docs-with-sphinx-185/Hi I'll try this site before asking the developers mailing list. Please let me know if this is the wrong place for this sort of questions.
On my own git branch, after the last pull which happened after arch linux upgraded to sphinx-1.8.5 I hit this error on `sage --docbuild refernce html` even after a `make doc-clean`.
EDIT: this does not have to do with arch's sphinx, even after removing it and using the one shipped with Sage it still fails.
This looks like what's described in this ticket https://trac.sagemath.org/ticket/26451 but this is already applied in my branch
<pre><code>
# Sphinx version: 1.8.5
# Python version: 3.7.3 (CPython)
# Docutils version: 0.14
# Jinja2 version: 2.10
# Last messages:
# linking _static directory.
# copying extra files...
# done
# dumping search index in English (code: en) ...
# done
# dumping object inventory...
# done
# build succeeded, 1295 warnings.
#
# The HTML pages are in local/share/doc/sage/html/en/reference/references.
# Loaded extensions:
# sphinx.ext.mathjax (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/mathjax.py
# alabaster (0.7.12) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/alabaster/__init__.py
# inventory_builder (unknown version) from /home/user/Documents/code/sage/sage/src/sage_setup/docbuild/ext/inventory_builder.py
# multidocs (unknown version) from /home/user/Documents/code/sage/sage/src/sage_setup/docbuild/ext/multidocs.py
# sage_autodoc (1.8.5) from /home/user/Documents/code/sage/sage/src/sage_setup/docbuild/ext/sage_autodoc.py
# sphinx.ext.graphviz (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/graphviz.py
# sphinx.ext.inheritance_diagram (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/inheritance_diagram.py
# sphinx.ext.todo (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/todo.py
# sphinx.ext.extlinks (1.8.5) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/extlinks.py
# IPython.sphinxext.ipython_directive (unknown version) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/IPython/sphinxext/ipython_directive.py
# matplotlib.sphinxext.plot_directive (unknown version) from /home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/matplotlib/sphinxext/plot_directive.py
Traceback (most recent call last):
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/cmd/build.py", line 304, in build_main
app.build(args.force_all, filenames)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/application.py", line 369, in build
self.emit('build-finished', None)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/application.py", line 510, in emit
return self.events.emit(event, self, *args)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/events.py", line 80, in emit
results.append(callback(*args))
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/ext/graphviz.py", line 414, in on_build_finished
copy_asset(src, dst)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/util/fileutil.py", line 81, in copy_asset
ensuredir(destination)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/site-packages/sphinx/util/osutil.py", line 90, in ensuredir
os.makedirs(path)
File "/home/user/Documents/code/sage/sage/local/lib/python3.7/os.py", line 221, in makedirs
mkdir(name, mode)
FileExistsError: [Errno 17] File exists: '/home/user/Documents/code/sage/sage/local/share/doc/sage/html/en/reference/references/_static'
</code></pre>heluaniWed, 22 Apr 2020 19:30:28 +0200https://ask.sagemath.org/question/50925/I just built a Sage system. What files may I delete with impunity?https://ask.sagemath.org/question/47352/i-just-built-a-sage-system-what-files-may-i-delete-with-impunity/I have just built Sage 7.6 on an Apple iMac 8,1 running OS X version 10.11.6. I started with a download of a compressed source distribution from the Sage github repository (without cloning the repository itself, since I don't plan to contribute any development ideas or comments for awhile). Doctesting went very well, with only two failed tests out of the entire suite:
sage -t src/sage/doctest/test.py # 1 doctest failed
sage -t src/sage/modules/vector_rational_dense.pyx # 1 doctest failed
I also downloaded the equivalent binary distribution and doctested that, obtaining these results:
sage -t src/sage/calculus/calculus.py # 1 doctest failed
sage -t src/sage/doctest/test.py # 1 doctest failed
sage -t src/sage/graphs/digraph_generators.py # 3 doctests failed
sage -t src/sage/graphs/graph_generators.py # 5 doctests failed
sage -t src/sage/graphs/hypergraph_generators.py # 7 doctests failed
sage -t src/sage/modules/vector_rational_dense.pyx # 1 doctest failed
sage -t src/sage/tests/cmdline.py # Timed out after testing finished
I did expect my own build to do better, but the installation I ended up with is fully 2 GB larger than what came in the binary distribution. Much (more than 1/3) of the overage is in a directory
../sage-7.6/local/share/doc/sage/doctrees
which is not present in the binary distribution, and I assume it is only of interest to developers. Is that correct? I will trim my build by also removing two large files
../sage-7.6/src/build/temp.macosx.10.9...
../sage-7.6/src/build/lib.macosx.10.9...
but keep my log and upstream files in case I want to review the build or look at the sources. All this is pending any further advice I get in the next few days about files that are generally only of interest to developers.dyne2meterFri, 02 Aug 2019 21:03:57 +0200https://ask.sagemath.org/question/47352/Docstring docs and html docs are differenthttps://ask.sagemath.org/question/47317/docstring-docs-and-html-docs-are-different/If I try to type for example `factor?` in sage console It yields very detailed output with documentation based on dosctrings. But if I try to find `factor` in html\pdf docs (offline and [online](http://doc.sagemath.org/html/en/reference/search.html?q=factor&check_keywords=yes&area=default)) there is no such search results.
So two questions:
- How to get that complete docsrting help from outside sage console?
- Why they are different?
P.S. Example `factor?` output:
> **Signature:** `factor(n, proof=None, int_=False,
> algorithm='pari', verbose=0, **kwds)`
>
> **Docstring:** Returns the factorization of "n". The result
> depends on the type of "n".
>
> If "n" is an integer, returns the
> factorization as an object of type
> "Factorization".
>
> If n is not an integer,
> "n.factor(proof=proof, **kwds)" gets
> called. See "n.factor??" for more
> documentation in this case.
>
> Warning: This means that applying
> "factor" to an integer result
> of a symbolic computation will not factor the integer, because it
> is considered as an element of a larger symbolic ring.EXAMPLES:
>
> sage: f(n)=n^2
> sage: is_prime(f(3))
> False
> sage: factor(f(3))
> 9 ...petRUShkaWed, 31 Jul 2019 00:00:31 +0200https://ask.sagemath.org/question/47317/Offline docset for SageMathhttps://ask.sagemath.org/question/42435/offline-docset-for-sagemath/There are plenty of offline documentation tools like [Zeal](https://zealdocs.org/) (Linux, MacOS, Windows), [Dash](https://kapeli.com/dash) (MacOS) and [dasht](https://github.com/sunaku/dasht) (for terminal and with [Vim integration](https://github.com/sunaku/vim-dasht)). Most of them support Dash format of offline docs. There are hundreds of [pre-generated](https://kapeli.com/dash#docsets) docsets (including Python) and [even more](https://github.com/Kapeli/Dash-User-Contributions/tree/master/docsets) but Sage docset is missing.
There is a tool for [generating python docset](https://kapeli.com/docsets#python): [doc2dash](https://pypi.org/project/doc2dash/). It supports two doc formats: Sphinx and pydoctor. Unfortunately I'm not familiar with either of them neither with Sage docs.
So my question is: how to create SageMath docset with doc2dash? My goal is to have Sage offline documentation with editor integration.petRUShkaFri, 25 May 2018 21:20:42 +0200https://ask.sagemath.org/question/42435/How to configure jupyter for Sage-specific use?https://ask.sagemath.org/question/45025/how-to-configure-jupyter-for-sage-specific-use/I am an absolute beginner in using jupyter-notebooks.
Since SageMath version 8.5 the user is asked to be prepared for using jupyter as the standard notebook in the future.
So, in Linux I activate jupyter with ./ sage -n jupyter and do some experiments.
In this way, obviously, SageMath activates an internal jupyter package via an internal notebook-interface (and not via an external jupyter installation e.g. in anaconda).
I tried also to edit python code within a jupyter cell. I got some unexpected errors, so editing code in jupyter cells seems to be problematic. Also, I want to figure out, why editing python code within a jupyter cell changes the color marks of some 'if' statements to red? Sometimes, after re-opening a closed jupyter session appears as plain text only, i.e., without cells.
My simple question is therefore: Is there any documentation available for the sage-specific use of jupyter (e.g., meaning of color code for the elements of the python language, extra necessary import of additional sage objects for jupyter, configuration of jupyter, etc)?.
bekalphSat, 12 Jan 2019 18:00:58 +0100https://ask.sagemath.org/question/45025/Documentation erratumhttps://ask.sagemath.org/question/44859/documentation-erratum/In the official documentation: doc.sagemath.org/html/en/reference/calculus/sage/symbolic/expression.html
the section related to the command "full_simplify()" should be renamed as "simplify_full()". sagenotdeadThu, 03 Jan 2019 13:08:38 +0100https://ask.sagemath.org/question/44859/Good(new 2017+) Book/Tutorialhttps://ask.sagemath.org/question/40502/goodnew-2017-booktutorial/Is there a good and new Book or Tutorial for Sagemath? thethaSat, 06 Jan 2018 16:49:56 +0100https://ask.sagemath.org/question/40502/sagemath-8.1 windowshttps://ask.sagemath.org/question/42120/sagemath-81-windows/ In sagemath-8.1 windows native installation . Help files are poorly formatted, particularly in the Reference Documentation. They appear to not be accessing a .css file.
Do I have a faulty installation file, and if so how can I get a copy a non-faulty one?NormekSun, 22 Apr 2018 05:50:45 +0200https://ask.sagemath.org/question/42120/Commands that changed expressionhttps://ask.sagemath.org/question/41258/commands-that-changed-expression/Hello!
Following a recent question about the new expressions for "find_minimum/maximum_on_interval", I have a more general concern: are commands that changed name across versions documented and collected in some form? So that old documentation and books aren't rendered irremediably obsolete by Sage's evolution.isaia.ismaeleSun, 25 Feb 2018 14:35:22 +0100https://ask.sagemath.org/question/41258/Name of this project: Sage or Sagemath?https://ask.sagemath.org/question/39831/name-of-this-project-sage-or-sagemath/ Wikipedia writes
> SageMath (previously Sage or SAGE, "System for Algebra and Geometry Experimentation"[2]) is a mathematical software with features covering many aspects of mathematics...
However, I see that the names "Sage" and "Sagemath" are both used in the documentation files, without an apparent logic. Moreover, a few Google searches fail to return information on this name change.
Should I call this software "Sage" or "Sagemath"? Is one of the two names deprecated? Should we correct it when we see it used on the internet or on the documentation, or are both acceptable? Is there official information from the development team about this renaming?
FedericoTue, 28 Nov 2017 20:07:39 +0100https://ask.sagemath.org/question/39831/Unable to Use Array without Issue(s) bar turing redhttps://ask.sagemath.org/question/37715/unable-to-use-array-without-issues-bar-turing-red/
In my Sage/CoCalc article (Sage has recently merged with CoCalc), I am unable to create an Array without a red issue bar popping up. Morover, I am unable to cross out element in my array. The issue(s) is `PackageArrayError; illegal pream-token (1): PackageArrayError; illegal pream-token (2)`: ...... and so on.
The whole Document is below.
\documentclass{article}
% set font encoding for PDFLaTeX or XeLaTeX
\usepackage{ifxetex}
\ifxetex
\usepackage{fontspec}
\else
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{lmodern}
\fi
\usepackage{amssymb}
\usepackage{amsmath}
\usepackage{ragged2e}
\usepackage{graphicx}
\usepackage{breqn}
\usepackage{fixltx2e}
\usepackage{hyperref}
\usepackage{titlesec}
\usepackage{amsopn}
\usepackage{array}
\newcommand{\dd}[1]{\mathrm{d}#1}
% used in maketitle
\title{Regarding Your Version of Natural Density to Rationals}
\author{Aiyappan Nair}
\begin{document}
\maketitle
Your version of asymptotic density to rationals differs from my own version. It is not a simplification but rather a change in definition. And although it is much more simple there are flaws that I would like to mention.
\subsection{Counter-Example}
As mentioned earlier, if sets $T_1,T_2,T_p$ are subsets of $\mathbb{Q}$, a density $D$ should have the following qualities.
(1) If $T_1=T_2$ then $D(T_1)=D(T_2)$
(2) If $T_1\subset{T_2}$ then $D(T_1)\le D(T_2)$
In your new version of the density
$$D=\lim_{r\to\infty}\frac{\left|T_1\cap V(r)\right|}{|V(r)|}$$
Where
$$V(r)=\left\{\left.\frac{m}{n}\right|1<m<r,1<n<r,\gcd(m,n)=1\right\}$$
and $m,n,r\in\mathbb{Z}$
If we set $T_1=\left\{\left.\frac{m}{2n+1}\right|m,n\in\mathbb{Z}\right\}$ and $T_2=\left\{\left.\frac{m}{4n+2}\right|m,n\in\mathbb{Z}\right\}$, I found that $D(T_1)>D(T_2)$ even though $T_1\subset T_2$. Which breaks requirment (2).
\subsection{Proof of Counter Example}
Imagine $V(r)$ as an array of values, restricted by $r$. The numerator is from listed as columns each labelled from $[1,r]$ and the denominator is listed as row labelled from $[1,r]$.
\begin{array}{|l|col1 col2 col3 col4 col5 col6 col7 col8}
& 1 & 2 & 3 & 4 & 5 & .. & r\\
\hline
1 & 1/1 & 2/1 & 3/1 & 4/1 & 5/1 & ..& r/1\\
2 & 1/2 & \st{2/2} & 3/2 & 4/2 & 5/2 & ..& r/2\\
3 & 1/3 & 2/3 & 3/3 & 4/3 & 5/3 & ..& r/3\\
4 & 1/4 & 2/4 & 3/4 & 4/4 & 5/4 & ..& r/4\\
5 & 1/5 & 2/5 & 3/5 & 4/5 & 5/5 & ..& r/5\\
..& .. & .. & .. & .. & .. & ..& .. \\
r & 1/r & 2/r & 3/r & 4/r & 5/r & .. & r/r\\
\end{array}
\end{document}
I have never had this problem with SageMath before it merged with CoCalc. Please help.Krishnan ArbujaSat, 27 May 2017 03:26:21 +0200https://ask.sagemath.org/question/37715/how can i contribute to sage documentation v7.5?I have found a few glitches in documentationhttps://ask.sagemath.org/question/36649/how-can-i-contribute-to-sage-documentation-v75i-have-found-a-few-glitches-in-documentation/ I want to fix a few typos in the sage documentation v7.5. I would love to know where to make the changes.asutosh7hotaFri, 17 Feb 2017 13:35:43 +0100https://ask.sagemath.org/question/36649/Sage HTML Documentation LaTeX formattinghttps://ask.sagemath.org/question/32709/sage-html-documentation-latex-formatting/ When I view Sage's documentation pages online, all latex equations have a vertical bar | at the end of them. Has this happened for others? Why is it happening and how can it be fixed?
I'm using google chrome with some latex extensions. I tried deactivating/reactivating them, and nothing seemed to help.
Thanks for the helpmyje02@gmail.comFri, 04 Mar 2016 03:32:49 +0100https://ask.sagemath.org/question/32709/Documentation within a single filehttps://ask.sagemath.org/question/31076/documentation-within-a-single-file/ Sage documentation is segmented in [multiple pdf files](http://doc.sagemath.org/). Does the docs provide a single big file we can search in as it was the case some years ago? If not, is it possible to get all the doc files by downloading a single zip file in order to merge the various files with ad hoc pdf tools?candideThu, 26 Nov 2015 09:14:25 +0100https://ask.sagemath.org/question/31076/Sage 6.6 link to compressed docs file brokenhttps://ask.sagemath.org/question/26832/sage-66-link-to-compressed-docs-file-broken/Is there some other place to download the entire compressed archive of Sage 6.6 documentation?
The usual link "You can download the entire standard documentation as a compressed file: download." at http://www.sagemath.org/help.html#SageStandardDoc
is broken: that link just takes you to the page http://doc.sagemath.org/#download with all the individual file download links.murrayeThu, 14 May 2015 20:56:30 +0200https://ask.sagemath.org/question/26832/how to report typos in the documentation?https://ask.sagemath.org/question/26467/how-to-report-typos-in-the-documentation/Now and then I spot typos in the documentation. What is the appropriate way to report such typos?
E.g. in "Linear Codes -- Sage Reference Manual v6.2: Coding Theory" in the function
"redunadancy_matrix(C)"
instead of (in TeX)
$kimes(n-k)$ matrix
it should be
$k\times(n-k)$ matrix
best ThomasThRWed, 08 Apr 2015 18:48:29 +0200https://ask.sagemath.org/question/26467/single PDF of Sage Reference manual?https://ask.sagemath.org/question/26063/single-pdf-of-sage-reference-manual/Is there a PDF of the entire [Sage Reference Manual](http://www.sagemath.org/doc/reference/index.html), all in one PDF (not split up as [here](http://www.sagemath.org/pdf/en/reference/reference.pdf))?GeremiaSat, 07 Mar 2015 17:55:17 +0100https://ask.sagemath.org/question/26063/How to find the full argument list of a built-in function?https://ask.sagemath.org/question/25609/how-to-find-the-full-argument-list-of-a-built-in-function/My first use of Sage is utilizing its fantastic 3D plotting capabilities with Jmol. I am visualizing 3D curves from data points via line3d() and than using the show() method on the graphics objects. line3d? and show? give a short list of arguments such as color, thickness, radius for line3d, and frame for show. I know there are many more arguments, for example corner_cutoff for smoothing, but I only stumble upon them while browsing the Sage documentation. So far, I haven't found a source to list all the arguments for line3d or similar functions. I understand that these are Python wrappers and I tried things like dir() but I could not find more information than that given by line3d? Where am I going wrong? I am quite sure there are arguments controlling background color, the way frames and axes are labeled, etc. How can I find them? -Thanks.ikolTue, 27 Jan 2015 02:39:20 +0100https://ask.sagemath.org/question/25609/Unable to build documentation (ValueError: unknown locale: UTF-8)https://ask.sagemath.org/question/25089/unable-to-build-documentation-valueerror-unknown-locale-utf-8/ When I try to build the sage documentation I get an error. What am I doing wrong? The same error appears when I try
make doc-clean && make
Here is a transcript:
amri@as154:~/sage$ sage -docbuild
Traceback (most recent call last):
File "/home/amri/sage/src/doc/common/builder.py", line 16, in <module>
import sphinx.cmdline
File "/home/amri/sage/local/lib/python2.7/site-packages/Sphinx-1.2.2-py2.7.egg/sphinx/cmdline.py", line 18, in <module>
from docutils.utils import SystemMessage
File "/home/amri/sage/local/lib/python2.7/site-packages/docutils/utils/__init__.py", line 20, in <module>
import docutils.io
File "/home/amri/sage/local/lib/python2.7/site-packages/docutils/io.py", line 18, in <module>
from docutils.utils.error_reporting import locale_encoding, ErrorString, ErrorOutput
File "/home/amri/sage/local/lib/python2.7/site-packages/docutils/utils/error_reporting.py", line 47, in <module>
locale_encoding = locale.getlocale()[1] or locale.getdefaultlocale()[1]
File "/home/amri/sage/local/lib/python/locale.py", line 543, in getdefaultlocale
return _parse_localename(localename)
File "/home/amri/sage/local/lib/python/locale.py", line 475, in _parse_localename
raise ValueError, 'unknown locale: %s' % localename
ValueError: unknown locale: UTF-8AmriWed, 03 Dec 2014 08:13:52 +0100https://ask.sagemath.org/question/25089/some links cannot back Sage Reference Manualhttps://ask.sagemath.org/question/24641/some-links-cannot-back-sage-reference-manual/1
https://sage.epsevg.upc.edu:8000/doc/live/reference/plane_curves/sage/schemes/elliptic_curves/jacobian.html
when link below,no button to back to Sage Reference Manual
REFERENCES:
[WpJacobianVariety] http://en.wikipedia.org/wiki/Jacobian_variety
2
https://sage.epsevg.upc.edu:8000/doc/live/reference/plane_curves/sage/schemes/elliptic_curves/constructor.html
when link below,no button to back to Sage Reference Manual,it link to http://trac.sagemath.org/13100,but blank page...
there are more links like above troubles at other places in Sage Reference Manual,I meet several times
cjshMon, 27 Oct 2014 09:41:03 +0100https://ask.sagemath.org/question/24641/Trouble building documentation with the development version of Sagehttps://ask.sagemath.org/question/23827/trouble-building-documentation-with-the-development-version-of-sage/When I run
sage -docbuild reference/groups html
I get
Deleting empty directory /home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/common/static
Deleting empty directory /home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/en/reference/graphs/static
Deleting empty directory /home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/en/reference/graphs/templates
[groups ] WARNING: intersphinx inventory '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/game_theory/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/game_theory/objects.inv'
[groups ] WARNING: intersphinx inventory '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/modfrm_hecketriangle/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/modfrm_hecketriangle/objects.inv'
[groups ] WARNING: intersphinx inventory '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/repl/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/repl/objects.inv'
[groups ] WARNING: intersphinx inventory '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/quivers/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/quivers/objects.inv'
Error building the documentation.
Note: incremental documentation builds sometimes cause spurious
error messages. To be certain that these are real errors, run
"make doc-clean" first and try again.
Traceback (most recent call last):
File "/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/common/builder.py", line 1490, in <module>
getattr(get_builder(name), type)()
File "/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/common/builder.py", line 714, in _wrapper
getattr(DocBuilder, build_type)(self, *args, **kwds)
File "/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/common/builder.py", line 109, in f
execfile(sys.argv[0])
File "/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/common/custom-sphinx-build.py", line 210, in <module>
raise OSError(ERROR_MESSAGE)
OSError: [groups ] WARNING: intersphinx inventory '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/game_theory/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/home/amri/myfiles/myfiles/sage-6.0-i686-Linux/src/doc/output/html/en/reference/game_theory/objects.inv'
When I try
make doc-clean
I get
make: *** No rule to make target `doc-clean'. Stop.
Can someone explain what the problem is, and how to get around it? This was on a clean installation of 6.4.beta0
AmriTue, 19 Aug 2014 07:00:53 +0200https://ask.sagemath.org/question/23827/influence order of entries in function documentationhttps://ask.sagemath.org/question/23568/influence-order-of-entries-in-function-documentation/ The documentation output from Sphinx for my source code has the functions ordered alphabetically large caps first. I would like to have it alphabetically mixed caps in my file. How can I achieve this?
(It appears there is a Sphinx config option named autodoc_member_order that changes it for the whole project but maybe I'm missing something that was added by Sage)
**Update**: I tried to work around it by naming the lowercase function with initial cap, and making an alias to that but now the function docs are duplicated! Needless to say, I find the limited options in Sphinx very disappointing.rwsThu, 24 Jul 2014 15:59:35 +0200https://ask.sagemath.org/question/23568/the same function appears twice in the documentationhttps://ask.sagemath.org/question/11056/the-same-function-appears-twice-in-the-documentation/The functions base_field()/constant_base_field()/constant_field()/vector_space()/maximal_order()/random_element appear twice in the following document:
http://sagemath.org/doc/reference/function_fields/sage/rings/function_field/function_field.html
and what different with RationalFunctionField() and FunctionField()?cjshThu, 20 Feb 2014 00:16:02 +0100https://ask.sagemath.org/question/11056/Using live tutorial from local copy of Sagehttps://ask.sagemath.org/question/11066/using-live-tutorial-from-local-copy-of-sage/I'm trying to view the live (interactive) tutorial from my downloaded copy of Sage, but when I go to the help section and view the tutorial, the website isn't found. The address for this site is `http://localhost:8000/doc/live/tutorial/index.html`. When I replace `live` with `static`, however, I can view the non-interactive tutorial. Any ideas on how to view the interactive tutorial on a local copy of Sage? Thanks.bittenfigThu, 20 Feb 2014 22:30:27 +0100https://ask.sagemath.org/question/11066/build sage without documentationhttps://ask.sagemath.org/question/10993/build-sage-without-documentation/I see that sometimes when building sage with the commands
git pull
make
the majority of time is employed in building the documentation. Actually I'm not interested in building the documentation on my machine (I usually have an internet connection and I usually browse the documentation online).
Is it possible to ignore the documentation when building sage? How can I do that?
MicheleWed, 05 Feb 2014 07:02:57 +0100https://ask.sagemath.org/question/10993/Documentation for show involving ymin and ymaxhttps://ask.sagemath.org/question/10733/documentation-for-show-involving-ymin-and-ymax/I was reading the documentation on 2d plotting again and I noticed something that I find strange. In the [plot documentation](http://www.sagemath.org/doc/reference/plotting/sage/plot/plot.html#sage.plot.plot.plot), there is the following phrase:
>If you want to limit the plot along the horizontal axis in the final rendered figure, then pass the xmin and xmax keywords to the show() method. To limit the plot along the vertical axis, ymin and ymax keywords can be provided to either this plot command or to the show command.
Ok, so this feels pretty obvious and all is well and good. But then you get [other questions](http://ask.sagemath.org/question/1242/add-plots-with-different-ymin-ymax-parameters) that show that ymin and ymax don't behave naively, nor are they associated directly with plot. Instead, that [answer](http://ask.sagemath.org/question/1242/add-plots-with-different-ymin-ymax-parameters?answer=1957#1957) says that ymin and ymax are really just always passed to show, and so should be thought of as show arguments.
Hmm, so it's not so obvious. So we might go to the [show documentation](http://www.sagemath.org/doc/reference/plotting/sage/plot/graphics.html#sage.plot.graphics.Graphics.show) to better understand what is going on. Unfortunately, show does not mention anything about ymin or ymax, or what happens when they're added together.
As far as I can tell, there is nothing in any show documentation that mentions ymin or ymax. Is that correct? If so, is that by design?mixedmathWed, 13 Nov 2013 23:48:47 +0100https://ask.sagemath.org/question/10733/Searching local HTML Docs with Chrome browser doesn't find anything, everhttps://ask.sagemath.org/question/10118/searching-local-html-docs-with-chrome-browser-doesnt-find-anything-ever/Using locally generated documentation ("make doc" in install dir), the Chrome browser search feature doesn't ever find anything. It used to work, but I don't know when it broke.
My local browser URLs:
file:///usr/local/src/sage/sage-5.9/devel/sage/doc/output/html/en/reference/search.html?q=lfsr
file:///usr/local/src/sage/sage-5.9/devel/sage-main/doc/output/html/en/reference/search.html?q=lfsr
... only show `Searching ...` forever.
This URL returns with doc references quickly.
http://www.sagemath.org/doc/reference/search.html?q=lfsr
What could be blocking my local doc searches?
Where can I look to start debugging?
Interestingly, Firefox works fine.
Chrome's javascript console reports:
Failed to load resource: Origin null is not allowed by Access-Control-Allow-Origin. file:///usr/local/src/sage/sage-5.10/devel/sage-main/doc/output/html/en/reference/searchindex.js
XMLHttpRequest cannot load file:///usr/local/src/sage/sage-5.10/devel/sage-main/doc/output/html/en/reference/searchindex.js. Origin null is not allowed by Access-Control-Allow-Origin.rickhg12hsTue, 14 May 2013 10:01:54 +0200https://ask.sagemath.org/question/10118/How to see the documentation for a Sage functionhttps://ask.sagemath.org/question/10228/how-to-see-the-documentation-for-a-sage-function/I am looking for the documentation (i.e., the source code) of `invariant_degree()` in the [Weyl Character Rings](http://www.sagemath.org/doc/reference/combinat/sage/combinat/root_system/weyl_characters.html?highlight=invariant_degree)
module. I have looked through that website pretty extensively, but I think I am looking in the wrong place?JoshIzzardMon, 17 Jun 2013 16:02:36 +0200https://ask.sagemath.org/question/10228/