|
5 | 5 | > "Creating a Viable Open Source Alternative to |
6 | 6 | > Magma, Maple, Mathematica, and MATLAB" |
7 | 7 |
|
8 | | -> Copyright (C) 2005-2020 The Sage Development Team |
| 8 | +> Copyright (C) 2005-2021 The Sage Development Team |
9 | 9 |
|
10 | 10 | https://www.sagemath.org |
11 | 11 |
|
@@ -37,10 +37,14 @@ or ask on [ask.sagemath.org](https://ask.sagemath.org). |
37 | 37 | Supported Platforms |
38 | 38 | ------------------- |
39 | 39 |
|
40 | | -Sage fully supports all major Linux distributions, recent versions of |
| 40 | +Sage attempts to support all major Linux distributions, recent versions of |
41 | 41 | macOS, and Windows (using Cygwin, Windows Subsystem for Linux, or |
42 | 42 | using virtualization). |
43 | 43 |
|
| 44 | +Detailed information on supported platforms for a specific version of Sage |
| 45 | +can be found in the section "Availability and installation help" of the |
| 46 | +[release tour](https://wiki.sagemath.org/ReleaseTours) for this version. |
| 47 | + |
44 | 48 | We highly appreciate contributions to Sage that fix portability bugs |
45 | 49 | and help port Sage to new platforms; let us know at the [sage-devel |
46 | 50 | mailing list](https://groups.google.com/group/sage-devel). |
@@ -234,8 +238,10 @@ Guide](https://doc.sagemath.org/html/en/installation). |
234 | 238 | [debian.txt](build/pkgs/_prereq/distros/debian.txt) |
235 | 239 | (also for Ubuntu, Linux Mint, etc.), |
236 | 240 | [fedora.txt](build/pkgs/_prereq/distros/fedora.txt) |
237 | | - (also for Red Hat, CentOS), and |
238 | | - [slackware.txt](build/pkgs/_prereq/distros/slackware.txt). |
| 241 | + (also for Red Hat, CentOS), |
| 242 | + [opensuse.txt](build/pkgs/_prereq/distros/opensuse.txt) |
| 243 | + [slackware.txt](build/pkgs/_prereq/distros/slackware.txt), and |
| 244 | + [void.txt](build/pkgs/_prereq/distros/void.txt). |
239 | 245 |
|
240 | 246 | 7. Optional: It is recommended that you have both LaTeX and the |
241 | 247 | ImageMagick tools (e.g. the "convert" command) installed since some |
@@ -349,54 +355,72 @@ Simplified directory layout (only essential files/directories): |
349 | 355 | SAGE_ROOT Root directory (sage-x.y.z in Sage tarball) |
350 | 356 | ├── build |
351 | 357 | │ └── pkgs Every package is a subdirectory here |
352 | | -│ ├── 4ti2 |
| 358 | +│ ├── 4ti2/ |
353 | 359 | │ … |
354 | | -│ └── zn_poly |
| 360 | +│ └── zn_poly/ |
355 | 361 | ├── configure Top-level configure script |
356 | 362 | ├── COPYING.txt Copyright information |
357 | 363 | ├── pkgs Source trees of Python distribution packages |
358 | 364 | │ ├── sage-conf |
359 | 365 | │ │ ├── sage_conf.py |
360 | 366 | │ │ └── setup.py |
361 | 367 | │ ├── sage-docbuild |
362 | | -│ │ ├── sage_docbuild |
| 368 | +│ │ ├── sage_docbuild/ |
| 369 | +│ │ └── setup.py |
| 370 | +│ ├── sage-setup |
| 371 | +│ │ ├── sage_setup/ |
363 | 372 | │ │ └── setup.py |
364 | 373 | │ ├── sage-sws2rst |
365 | | -│ │ ├── sage_sws2rst |
| 374 | +│ │ ├── sage_sws2rst/ |
366 | 375 | │ │ └── setup.py |
367 | 376 | │ └── sagemath-standard |
368 | | -│ ├── bin |
369 | | -│ ├── sage |
| 377 | +│ ├── bin/ |
| 378 | +│ ├── sage -> ../../src/sage |
370 | 379 | │ └── setup.py |
371 | | -├── local (SAGE_LOCAL) Compiled packages are installed here |
| 380 | +├── local (SAGE_LOCAL) Installation hierarchy for non-Python packages |
372 | 381 | │ ├── bin Executables |
373 | 382 | │ ├── include C/C++ headers |
374 | | -│ ├── lib Shared libraries |
| 383 | +│ ├── lib Shared libraries, architecture-dependent data |
375 | 384 | │ ├── share Databases, architecture-independent data, docs |
376 | 385 | │ │ └── doc Viewable docs of Sage and of some components |
377 | 386 | │ └── var |
378 | | -│ ├── lib/sage List of installed packages |
379 | | -│ └── tmp/sage Temporary files when building Sage |
| 387 | +│ ├── lib/sage |
| 388 | +│ │ ├── installed/ |
| 389 | +│ │ │ Records of installed non-Python packages |
| 390 | +│ │ ├── scripts/ Scripts for uninstalling installed packages |
| 391 | +│ │ └── venv-python3.9 (SAGE_VENV) |
| 392 | +│ │ │ Installation hierarchy (virtual environment) |
| 393 | +│ │ │ for Python packages |
| 394 | +│ │ ├── bin/ Executables and installed scripts |
| 395 | +│ │ ├── lib/python3.9/site-packages/ |
| 396 | +│ │ │ Python modules/packages are installed here |
| 397 | +│ │ └── var/lib/sage/ |
| 398 | +│ │ └── wheels/ |
| 399 | +│ │ Python wheels for all installed Python packages |
| 400 | +│ │ |
| 401 | +│ └── tmp/sage/ Temporary files when building Sage |
380 | 402 | ├── logs |
381 | 403 | │ ├── dochtml.log Log of the documentation build |
382 | 404 | │ ├── install.log Full install log |
383 | 405 | │ └── pkgs Build logs of individual packages |
384 | 406 | │ ├── alabaster-0.7.12.log |
385 | 407 | │ … |
386 | 408 | │ └── zn_poly-0.9.2.log |
387 | | -├── m4 M4 macros for configure |
| 409 | +├── m4 M4 macros for generating the configure script |
388 | 410 | │ └── *.m4 |
389 | 411 | ├── Makefile Running "make" uses this file |
| 412 | +├── prefix -> SAGE_LOCAL Convenience symlink to the installation tree |
390 | 413 | ├── README.md This file |
391 | 414 | ├── sage Script to start Sage |
392 | 415 | ├── src Monolithic Sage library source tree |
393 | | -│ ├── bin Scripts that Sage uses internally |
394 | | -│ ├── doc Sage documentation sources |
395 | | -│ └── sage The Sage library source code |
| 416 | +│ ├── bin/ Scripts that Sage uses internally |
| 417 | +│ ├── doc/ Sage documentation sources |
| 418 | +│ └── sage/ The Sage library source code |
396 | 419 | ├── upstream Source tarballs of packages |
397 | 420 | │ ├── Babel-2.9.1.tar.gz |
398 | 421 | │ … |
399 | 422 | │ └── zn_poly-0.9.2.tar.gz |
| 423 | +├── venv -> SAGE_VENV Convenience symlink to the virtual environment |
400 | 424 | └── VERSION.txt |
401 | 425 | ``` |
402 | 426 | For more details see [our Developer's Guide](https://doc.sagemath.org/html/en/developer/coding_basics.html#files-and-directory-structure). |
|
482 | 506 | 1. To make a binary distribution with your currently installed packages, |
483 | 507 | visit [sagemath/binary-pkg](https://github.com/sagemath/binary-pkg). |
484 | 508 |
|
485 | | -2. (**Obsolete, probably broken**) To make your own source tarball of Sage, type: |
| 509 | +2. To make your own source tarball of Sage, type: |
486 | 510 |
|
487 | | - $ sage --sdist |
| 511 | + $ make dist |
488 | 512 |
|
489 | 513 | The result is placed in the directory `dist/`. |
490 | 514 |
|
|
0 commit comments