#11793: autogenerate doc directories in sage-maketest
--------------------------+-------------------------------------------------
Reporter: jhpalmieri | Owner: mvngu
Type: defect | Status: needs_review
Priority: major | Milestone: sage-4.7.2
Component: doctest | Keywords:
Work_issues: | Upstream: N/A
Reviewer: | Author: John Palmieri
Merged: | Dependencies:
--------------------------+-------------------------------------------------
Old description:
> The script `sage-maketest` is supposed to test everything in the Sage
> library, but it says
> {{{
> "$SAGE_ROOT"/sage -t -sagenb "$@" "$SAGE_ROOT"/devel/sage/doc/common
> "$SAGE_ROOT"/devel/sage/doc/en "$SAGE_ROOT"/devel/sage/doc/fr
> "$SAGE_ROOT"/devel/sage/sage 2>&1 | tee -a "$SAGE_TEST_LOG"
> }}}
> The relatively new directories .../doc/de and .../doc/ru are not there.
> We should autogenerate this list. The same goes for the script `sage-
> apply-ticket`.
New description:
The script `sage-maketest` is supposed to test everything in the Sage
library, but it says
{{{
"$SAGE_ROOT"/sage -t -sagenb "$@" "$SAGE_ROOT"/devel/sage/doc/common
"$SAGE_ROOT"/devel/sage/doc/en "$SAGE_ROOT"/devel/sage/doc/fr
"$SAGE_ROOT"/devel/sage/sage 2>&1 | tee -a "$SAGE_TEST_LOG"
}}}
The relatively new directories .../doc/de and .../doc/ru are not there.
We should autogenerate this list. The same goes for the script `sage-
apply-ticket`.
-------
Apply
- [attachment:trac_11793.v2.patch] to the scripts repo
- [attachment:trac_11793-makefile.patch] to the root repo
--
Comment(by jhpalmieri):
Thanks for the suggestions. I think using `[a-z][a-z]` is clear and
definitely accomplishes what we want. I think I'll change that in the
`Makefile`, too. New patches attached.
As far as testing, I think we need to make sure to test everything, every
time. This is one of the underlying philosophies of Sage. For example,
if we don't test the Russian documentation by default, it might get tested
very rarely, and not on a wide variety of platforms, and so failures might
slip through. As you probably know, the documentation in the different
languages is not very well synchronized, so testing the different
languages may actually run different tests. It's also not bad to make
sure testing keeps working with unicode files. Also, there isn't much
documentation not in English right now, so this won't slow things down
much.
For building, it doesn't take long to build the non-English documentation.
If the reference manual ever gets translated, then it would make a lot of
sense to only build the appropriate versions, but the rest of the docs are
quick to build. Regardless, I don't want to address this here.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/11793#comment:8>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
