[Pythonmac-SIG] My stab at a new page

[Ronald Oussoren]

On 9-feb-2006, at 21:25, Bill Janssen wrote:

>> 1. Link to the "Macintosh Library Module": A lot of that stuff  
>> will be
>> rendered obsolete the minute Bob releases the universal build of
>> MacPython. PythonIDE, Package Manager, etc.: not gonna be  
>> included. At a
>> minimum, you should note that this stuff is "legacy." Also, who  
>> writes
>> this stuff and where should a bug be filed?
>>
>> 2. Ditto for "Apple Events." Does anyone use gensuitemodule or  
>> even know
>> what it means? (I don't.) I don't use appscripting, but I do know  
>> enough
>> to know that it's pretty much the standard way (by now) of accessing
>> Apple Events? has, what do you think?
>
> Hey, I'm linking to the official documentation.  That's what people
> will use, till it changes.  All this other stuff scattered around is
> blue-sky wild-ass future, till it's documented.

Eeks, are you linking to http://docs.python.org/mac/mac.html?

Most of that is empty and of no use to users.
>
> You can file documentation bugs at http://sourceforge.net/bugs/? 
> group_id=5470.

But that is of little use unless you volunteer to write the  
documentation as well. Jack seems to be the only one of the core  
python developers that knows enought about the mac specific modules  
to write documentation, and he left the documentation empty by  
design: it should be easy enough to fetch information from Apple's  
documentation for the C API.

Ronald

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 2157 bytes
Desc: not available
Url : http://mail.python.org/pipermail/pythonmac-sig/attachments/20060211/5fa1c54c/attachment.bin