Add a deprecation message at the top of most sage.server.* files

[qed777]

To avoid confusion, we should add a message to the top of each old Sage notebook .py file stating that one should work on SageNB instead.

This should be a patch to the core Sage library.

CC: @TimDumol @williamstein

Component: notebook

Author: Tim Dumol

Reviewer: Mike Hansen

Merged: sage-4.3.rc1

Issue created by migration from https://trac.sagemath.org/ticket/7534

[qed777]

comment:1

How about

This file is part of the OLD Sage notebook and is NOT actively developed,
maintained, or supported.  As of Sage v4.1.2, all notebook development has
moved to the separate Sage Notebook project:

http://nb.sagemath.org/

The new notebook is installed in Sage as a spkg (e.g., sagenb-0.3.spkg).

Please visit the project's home page for more information, including directions on
obtaining the latest source code.  For notebook-related development and support,
please consult the sage-notebook discussion group:

http://groups.google.com/group/sage-notebook

?

[qed777]

comment:2

See sage-notebook.

[TimDumol]

Adds the recommended deprecation message (with typo correction)

[TimDumol]

comment:3

Attachment: trac_7534-deprecation-message.gz

This should do the job.

[mwhansen]

comment:4

This causes some failures in tests in sage/server/

[mwhansen]

Author: Tim Dumol

[mwhansen]

Reviewer: Mike Hansen

[mwhansen]

comment:5

{{{ sage -t devel/sage-main/sage/server/notebook/notebook_object.py # 4 doctests failed
}}}

[williamstein]

comment:6

Replying to @mwhansen:

{{{ sage -t devel/sage-main/sage/server/notebook/notebook_object.py # 4 doctests failed
}}}

Since the code isn't being run and is officially "deprecated", one option is to put a nodoctest.py file in the directory (or #nodoctest at the top of the file) so that the code isn't tested.

[qed777]

Adds nodoctest.py files. Replacement patch.

[qed777]

comment:7

Attachment: trac_7534-deprecation-message_v2.patch.gz

V2 suppresses doctesting for the "deprecated" files.

[williamstein]

comment:8

Looks good to me now.

[mwhansen]

Merged: sage-4.3.rc1