[ python-Bugs-1395511 ] Please document pyc format guarantees

[SourceForge.net]

Bugs item #1395511, was opened at 2006-01-02 19:27
Message generated for change (Comment added) made by piman
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1395511&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: None
>Status: Closed
>Resolution: Works For Me
Priority: 5
Submitted By: Joe Wreschnig (piman)
Assigned to: Nobody/Anonymous (nobody)
Summary: Please document pyc format guarantees

Initial Comment:
There's conventional wisdom that .pyc files are
compatible within a single minor revision of Python,
but I can't find any documentation that says this
explicitly.

This assumption is important to Debian's Python
packaging policy, so if it's true, could it be
documented somewhere (probably the marshal or
compileall module documentation)?

Thanks.

----------------------------------------------------------------------

>Comment By: Joe Wreschnig (piman)
Date: 2006-01-05 06:19

Message:
Logged In: YES 
user_id=796

Yes, PEP 6 is great, thank you! Sorry that I forgot to check
there.

----------------------------------------------------------------------

Comment By: Neal Norwitz (nnorwitz)
Date: 2006-01-05 05:52

Message:
Logged In: YES 
user_id=33168

It is documented here: http://www.python.org/peps/pep-0006.html

Is that sufficient?

It's also effectively documented here:
http://svn.python.org/projects/python/trunk/Python/import.c

That is a list of all magic numbers which denote the python
revision.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1395511&group_id=5470