[sage-devel] Re: Error in documentation: location of `constants.py`
Hi, I have opened https://trac.sagemath.org/ticket/33571 for this purpose. I have also pushed the changes on my branch as I had pointed out. Anything else I can help in? On Saturday, March 26, 2022 at 11:28:10 PM UTC+5:30 Adarsh Kishore wrote: > Certainly, I will read up on the process of opening a new ticket (this is > my first time :) > > On Saturday, March 26, 2022 at 11:14:45 PM UTC+5:30 Eric Gourgoulhon wrote: > >> Hi, >> >> Thanks for spotting these errors in the documentation. Would you open a >> ticket to fix them? >> See https://doc.sagemath.org/html/en/developer/trac.html >> >> Best wishes, >> >> Eric. >> >> Le vendredi 25 mars 2022 à 13:12:28 UTC+1, adarsh.k...@gmail.com a >> écrit : >> >>> Apart from this, the documentation is outdated in several other places >>> also. For example, on the same website, for an example on free modules it >>> is mentioned that >>> ``` >>> the following is from the >>> file SAGE_ROOT/sage/sage/modules/free_module_element.pyx >>> ``` >>> >>> However the same is actually now at >>> ``` >>> SAGE_ROOT/src/sage/modules/free_module_element.pyx >>> ``` >>> >>> Also, while explaining the `_matrix_` method, an example is given as >>> >>> [image: Screenshot from 2022-03-25 17-37-40.png] >>> >>> However, this class is now at >>> ``` >>> SAG_ROOT/src/sage/graphs/generic_graph.py >>> ``` >>> >>> [image: Screenshot from 2022-03-25 17-41-13.png] >>> >>> and I believe several other inconsistencies would be existing. >>> On Friday, March 25, 2022 at 1:21:23 PM UTC+5:30 Adarsh Kishore wrote: >>> Hi everyone, I am running Sage v9.6.beta4 on Ubuntu 20.04 LTS. I was going through the online documentation of Sage and I came across this line on https://doc.sagemath.org/html/en/developer/coding_in_python.html ``` Here is an example of the _latex_ and _repr_ functions for the Pi class. It is from the file SAGE_ROOT/src/sage/functions/constants.py ``` [image: Screenshot from 2022-03-25 11-54-44.png] However, there is no constants.py in the mentioned directory. Instead, I found it on my Sage in ``` SAGE_ROOT/src/sage/symbolic/constants.py ``` [image: Screenshot from 2022-03-25 11-52-01.png] [image: Screenshot from 2022-03-25 11-53-58.png] I think the documentation should be updated to reflect this. >>> -- 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.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/55fe7fe1-820d-473b-8f34-f7e2a0066f04n%40googlegroups.com.
[sage-devel] Re: Error in documentation: location of `constants.py`
Certainly, I will read up on the process of opening a new ticket (this is my first time :) On Saturday, March 26, 2022 at 11:14:45 PM UTC+5:30 Eric Gourgoulhon wrote: > Hi, > > Thanks for spotting these errors in the documentation. Would you open a > ticket to fix them? > See https://doc.sagemath.org/html/en/developer/trac.html > > Best wishes, > > Eric. > > Le vendredi 25 mars 2022 à 13:12:28 UTC+1, adarsh.k...@gmail.com a écrit : > >> Apart from this, the documentation is outdated in several other places >> also. For example, on the same website, for an example on free modules it >> is mentioned that >> ``` >> the following is from the >> file SAGE_ROOT/sage/sage/modules/free_module_element.pyx >> ``` >> >> However the same is actually now at >> ``` >> SAGE_ROOT/src/sage/modules/free_module_element.pyx >> ``` >> >> Also, while explaining the `_matrix_` method, an example is given as >> >> [image: Screenshot from 2022-03-25 17-37-40.png] >> >> However, this class is now at >> ``` >> SAG_ROOT/src/sage/graphs/generic_graph.py >> ``` >> >> [image: Screenshot from 2022-03-25 17-41-13.png] >> >> and I believe several other inconsistencies would be existing. >> On Friday, March 25, 2022 at 1:21:23 PM UTC+5:30 Adarsh Kishore wrote: >> >>> Hi everyone, >>> I am running Sage v9.6.beta4 on Ubuntu 20.04 LTS. I was going through >>> the online documentation of Sage and I came across this line on >>> https://doc.sagemath.org/html/en/developer/coding_in_python.html >>> ``` >>> Here is an example of the _latex_ and _repr_ functions for the Pi class. >>> It is from the file SAGE_ROOT/src/sage/functions/constants.py >>> ``` >>> [image: Screenshot from 2022-03-25 11-54-44.png] >>> >>> However, there is no constants.py in the mentioned directory. Instead, I >>> found it on my Sage in >>> ``` >>> SAGE_ROOT/src/sage/symbolic/constants.py >>> ``` >>> >>> [image: Screenshot from 2022-03-25 11-52-01.png] >>> >>> [image: Screenshot from 2022-03-25 11-53-58.png] >>> >>> I think the documentation should be updated to reflect this. >>> >> -- 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.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/aa4d0912-2bd6-4cdf-8845-044f8e96f287n%40googlegroups.com.
[sage-devel] Re: Error in documentation: location of `constants.py`
Hi, Thanks for spotting these errors in the documentation. Would you open a ticket to fix them? See https://doc.sagemath.org/html/en/developer/trac.html Best wishes, Eric. Le vendredi 25 mars 2022 à 13:12:28 UTC+1, adarsh.k...@gmail.com a écrit : > Apart from this, the documentation is outdated in several other places > also. For example, on the same website, for an example on free modules it > is mentioned that > ``` > the following is from the > file SAGE_ROOT/sage/sage/modules/free_module_element.pyx > ``` > > However the same is actually now at > ``` > SAGE_ROOT/src/sage/modules/free_module_element.pyx > ``` > > Also, while explaining the `_matrix_` method, an example is given as > > [image: Screenshot from 2022-03-25 17-37-40.png] > > However, this class is now at > ``` > SAG_ROOT/src/sage/graphs/generic_graph.py > ``` > > [image: Screenshot from 2022-03-25 17-41-13.png] > > and I believe several other inconsistencies would be existing. > On Friday, March 25, 2022 at 1:21:23 PM UTC+5:30 Adarsh Kishore wrote: > >> Hi everyone, >> I am running Sage v9.6.beta4 on Ubuntu 20.04 LTS. I was going through the >> online documentation of Sage and I came across this line on >> https://doc.sagemath.org/html/en/developer/coding_in_python.html >> ``` >> Here is an example of the _latex_ and _repr_ functions for the Pi class. >> It is from the file SAGE_ROOT/src/sage/functions/constants.py >> ``` >> [image: Screenshot from 2022-03-25 11-54-44.png] >> >> However, there is no constants.py in the mentioned directory. Instead, I >> found it on my Sage in >> ``` >> SAGE_ROOT/src/sage/symbolic/constants.py >> ``` >> >> [image: Screenshot from 2022-03-25 11-52-01.png] >> >> [image: Screenshot from 2022-03-25 11-53-58.png] >> >> I think the documentation should be updated to reflect this. >> > -- 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.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/39ecd91d-81f1-4ce9-b932-a122d76de273n%40googlegroups.com.
[sage-devel] Re: Error in documentation: location of `constants.py`
Apart from this, the documentation is outdated in several other places also. For example, on the same website, for an example on free modules it is mentioned that ``` the following is from the file SAGE_ROOT/sage/sage/modules/free_module_element.pyx ``` However the same is actually now at ``` SAGE_ROOT/src/sage/modules/free_module_element.pyx ``` Also, while explaining the `_matrix_` method, an example is given as [image: Screenshot from 2022-03-25 17-37-40.png] However, this class is now at ``` SAG_ROOT/src/sage/graphs/generic_graph.py ``` [image: Screenshot from 2022-03-25 17-41-13.png] and I believe several other inconsistencies would be existing. On Friday, March 25, 2022 at 1:21:23 PM UTC+5:30 Adarsh Kishore wrote: > Hi everyone, > I am running Sage v9.6.beta4 on Ubuntu 20.04 LTS. I was going through the > online documentation of Sage and I came across this line on > https://doc.sagemath.org/html/en/developer/coding_in_python.html > ``` > Here is an example of the _latex_ and _repr_ functions for the Pi class. > It is from the file SAGE_ROOT/src/sage/functions/constants.py > ``` > [image: Screenshot from 2022-03-25 11-54-44.png] > > However, there is no constants.py in the mentioned directory. Instead, I > found it on my Sage in > ``` > SAGE_ROOT/src/sage/symbolic/constants.py > ``` > > [image: Screenshot from 2022-03-25 11-52-01.png] > > [image: Screenshot from 2022-03-25 11-53-58.png] > > I think the documentation should be updated to reflect this. > -- 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.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/5445a003-e183-4dff-97eb-b91142e916efn%40googlegroups.com.