1 |
Just a precision. Using bin-html or html means that LINGUAS=“en” must be |
2 |
set. The mean reason for that is two fold. |
3 |
1) if LINGUAS is not set at all, no html documentation would be installed |
4 |
2) the “en” language is the reference documentation and the only one to be |
5 |
complete. No other language has a translation of the reference documentation. |
6 |
Only some tutorials and/or “tour of sage”. |
7 |
|
8 |
And also one of main point of getting the html documentation is to make |
9 |
it available in the sage-notebook and because only the English version |
10 |
has the complete reference I won’t work on getting the notebook to default |
11 |
to another language. |
12 |
|
13 |
Francois |
14 |
|
15 |
> On 27/07/2015, at 14:01, François Bissey <frp.bissey@×××××.com> wrote: |
16 |
> |
17 |
> And sage-on-gentoo has undergone a substantial change |
18 |
> during the development phase.... |
19 |
> |
20 |
> So what is different: |
21 |
> this is a monolithic ebuild, in the past we had split sage |
22 |
> in various components, the scripts, the sage-clib sage and |
23 |
> the documentation. Over the last year or two only the |
24 |
> separation of sage-clib was strictly necessary. |
25 |
> |
26 |
> sage-clib being gone upstream we had an opportunity to house |
27 |
> everything under one roof. The separation was always |
28 |
> arbitrary as there is not much you can do with the scripts |
29 |
> without sage itself. Possibly you could have used sage from |
30 |
> python without needing the scripts (strictly speaking a couple |
31 |
> of files would probably need to be moved from one ebuild to |
32 |
> the other for it to work 100%). |
33 |
> |
34 |
> The only things that are still separate are things that are |
35 |
> split in a different package upstream, sage-data packages. |
36 |
> Most of them cannot be used without sage and at least one is |
37 |
> needed for sage to start. |
38 |
> |
39 |
> So when you move to sage-6.8 the following ebuilds will need |
40 |
> to go: |
41 |
> sage-baselayout |
42 |
> sage-clib |
43 |
> sage-doc or sage-doc-bin |
44 |
> |
45 |
> Special notes: |
46 |
> * ntl 9.3.0: this version of sage moves to the latest version |
47 |
> of ntl. It is probably a good idea to rebuild the packages |
48 |
> depending on ntl (flint, singular, libsingular, eclib). Automatic |
49 |
> rebuild of some of them could have been triggered but I forgot to |
50 |
> add the subslot to the ntl ebuild that would have allowed that to |
51 |
> happen before it was pushed to the main tree by Thomas Kahle. |
52 |
> |
53 |
> * x86 users will need to do some extra keywording for sage and sci-mathematics/rw. sci-mathematics/rw was kindly added to |
54 |
> the tree by Michael Orlitzky but it was only added with ~amd64 |
55 |
> keyword. I know there are x86 users out there (https://github.com/cschwan/sage-on-gentoo/issues/352), so you can request the keyword |
56 |
> to be added the normal way in bugzilla. Once it is done, I'll keyword |
57 |
> sage ~x86 again (and repoman will let me do it). |
58 |
> |
59 |
> - Yes, I know - those two problems would be easily solved if I |
60 |
> was a full blown Gentoo-dev. |
61 |
> |
62 |
> * ~arch users. The recommended useflags for documentation are |
63 |
> "+bin-html -html -pdf". In the past we have encouraged people to |
64 |
> use sage-doc-bin rather than sage-doc. These flags reproduce |
65 |
> that particular set up. ~arch user in particular should adopt these |
66 |
> because the documentation will not build with sphinx 1.3. |
67 |
> There is a sage ticket to move to sphinx 1.3 but it is not ready |
68 |
> for inclusion yet. |
69 |
> |
70 |
> * numpy 1.9 can be used to build sage but it causes doctest failures |
71 |
> and some behavior are not as expected, be cautious that things can happen if your are using numpy 1.9. It is merely allowed so it doesn't |
72 |
> block other packages wanting numpy 1.9 while I am working with upstreams |
73 |
> (both sage and numpy) to solve the various problems. |
74 |
> |
75 |
> Happy upgrading. |
76 |
> |
77 |
> Francois Bissey |
78 |
> |