[Commits] python.it commit r233 - python/python/Doc/branches/2.4.3/mac

commit a svn.python.it commit a svn.python.it
Gio 9 Nov 2006 20:30:21 CET


Author: eriol
Date: Thu Nov  9 20:30:14 2006
New Revision: 233

Modified:
   python/python/Doc/branches/2.4.3/mac/libframework.tex
   python/python/Doc/branches/2.4.3/mac/libmacfs.tex
   python/python/Doc/branches/2.4.3/mac/libmacic.tex
   python/python/Doc/branches/2.4.3/mac/libmacos.tex
   python/python/Doc/branches/2.4.3/mac/libmacostools.tex
   python/python/Doc/branches/2.4.3/mac/scripting.tex
   python/python/Doc/branches/2.4.3/mac/undoc.tex
Log:
Aggiornamenti di Federico Corazza

Modified: python/python/Doc/branches/2.4.3/mac/libframework.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/mac/libframework.tex	(original)
+++ python/python/Doc/branches/2.4.3/mac/libframework.tex	Thu Nov  9 20:30:14 2006
@@ -31,7 +31,8 @@
 %[- MARK -] END DIFF
 sovrascrivere  completamente la gestione dell'evento.
 
-Il \module{FrameWork} è perennemente in lavorazione, la documentazione
+Il lavoro sul \module{FrameWork} è quasi finito, ora che il \module{PyObjC} è
+disponibile  per un completo accesso a Cocoa da Python, e la documentazione
 descrive solo le funzionalità più importanti, e non nella maniera più
 logica che può.  Esaminare i sorgenti o gli esempi per i dettagli.  Di
 seguito dei punti di vista trovati sul newsgroup MacPython sui punti

Modified: python/python/Doc/branches/2.4.3/mac/libmacfs.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/mac/libmacfs.tex	(original)
+++ python/python/Doc/branches/2.4.3/mac/libmacfs.tex	Thu Nov  9 20:30:14 2006
@@ -26,7 +26,8 @@
 Il modulo macfs. Si utilizzino i moduli \module{Carbon.File} o
 \refmodule{Carbon.Folder} per la gestione di \class{FSSpec}, \class{FSRef}
 e \class{Alias}. Si usi il modulo \refmodule{EasyDialogs} per le finestre
-di dialogo file.}
+di dialogo file. Inoltre è noto che questo modulo non lavora correttamente con
+partizioni UFS.}
 
 Questo modulo fornisce l'accesso alla gestione in Macintosh di
 \class{FSSpec}, di Alias Manager, degli alias del \program{finder} e

Modified: python/python/Doc/branches/2.4.3/mac/libmacic.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/mac/libmacic.tex	(original)
+++ python/python/Doc/branches/2.4.3/mac/libmacic.tex	Thu Nov  9 20:30:14 2006
@@ -28,14 +28,8 @@
 \modulesynopsis{Accesso ad Internet Config.}
 
 
-Questo modulo fornisce l'accesso al package Macintosh Internet
-Config\index{Internet Config}, che memorizza le preferenze dei
-programmi Internet, come indirizzo di posta, homepage predefinita,
-etc.  Inoltre, Internet Config contiene un insieme particolareggiato
-di associazioni, derivanti dai codici creatore/tipo Macintosh, alle
-estensioni dei nomi di file sconosciute, in più, informazioni sul modo
-di trasferimento dei file (binario, ascii, etc).  Il modulo, fin dal
-MacOS 9, è un pannello di controllo chiamato Internet.  
+Questo modulo fornisce accesso ai vari gruppi di preferenze relative a Internet
+da \program{System Preferences} o da \program{Finder}.
 
 Le funzionalità base di accesso a Internet Config sono fornite da un
 attinente modulo di basso livello,
@@ -151,7 +145,7 @@
 \begin{methoddesc}{mapfile}{file}
 Restituisce la voce mappata del file dato, \var{file}, che può essere
 passato o come nome di file o come un risultato
-\function{macfs.FSSpec()}, di cui non esiste la necessità.
+\function{FSSpec()}, di cui non esiste la necessità.
 
 La voce mappata viene restituita come tupla \code{(\var{version}, 
 \var{type}, \var{creator}, \var{postcreator}, \var{flags},
@@ -194,7 +188,7 @@
 
 \begin{methoddesc}{settypecreator}{file}
 Dato un \var{file} esistente, specificato o come nome di file oppure
-come un risultato \function{macfs.FSSpec()}, imposta correttamente il
+come un risultato \function{FSSpec()}, imposta correttamente il
 suo creatore e tipo in base alla sua estensione.  Il finder viene
 informato del cambiamento, per cui l'icona del finder verrà
 rapidamente aggiornata. 

Modified: python/python/Doc/branches/2.4.3/mac/libmacos.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/mac/libmacos.tex	(original)
+++ python/python/Doc/branches/2.4.3/mac/libmacos.tex	Thu Nov  9 20:30:14 2006
@@ -50,11 +50,10 @@
 una lunga storia. 
 
 \begin{datadesc}{runtimemodel}
-Sia \code{'carbon'} che \code{'macho'}.  Questo specifica se Python
-usa uno stile compatibile con Mac OS X e Mac OS 9 CarbonLib oppure
-solamente con lo stile Mach-O di Mac OS X.  Nelle versioni precedenti
+Sempre \code{'macho'}, da Python 2.4 in su . Nelle versioni precedenti
 di Python il valore può essere anche \code{'ppc'} per il modello
-runtime del classico Mac OS 8.
+runtime classico di Mac OS 8 o \code{'carbon'} per il modello
+runtime di Mac OS 9 .
 \end{datadesc}
 
 \begin{datadesc}{linkmodel}
@@ -63,8 +62,9 @@
 package possono usare questa informazione per fornire dei messaggi di
 errore comprensibili.  Il valore è \code{'static'} per un Python
 collegato staticamente, \code{'framework'} per Python in un framework
-Mac OS X, \code{'shared'} per Python in una libreria condivisa in
-standard \UNIX{} e \code{'cfm'} per Python compatibile con Mac OS 9. 
+Mac OS X, \code{'shared'} per Python in una libreria standard condivisa unix.
+Versioni di Python più vecchie possono avere il valore
+\code{'cfm'} per Python compatibile con Mac OS 9. 
 \end{datadesc}
 
 \begin{excdesc}{Error}
@@ -172,95 +172,11 @@
 %[- MARK -] END DIFF
 \end{excdesc}
 
-\begin{funcdesc}{SetEventHandler}{handler}
-Python, mediante l'iterazione dell'interprete interno, ogni tanto
-verificherà la presenza di eventi, a meno che venga disabilitato
-mediante \function{ScheduleParams()}.  Con questa funzione si può
-passare una funzione event-handler (gestore di eventi) che dovrà
-essere chiamata nel caso si verifichi un evento.  L'evento viene
-passato come parametro e la funzione deve restituire non-zero se
-l'evento è stato interamente elaborato, altrimenti l'elaborazione
-dell'evento continua (per esempio, passando l'evento alla console del
-package window).
-
-Si richiami \function{SetEventHandler()} senza parametri per liberare
-il gestore dell'evento.  \`E sbagliato impostare un gestore d'evento
-quando ne è già stato impostato uno.
-
-Disponibilità: MacPython-OS9.
-\end{funcdesc}
-
-\begin{funcdesc}{SchedParams}{\optional{doint\optional{, evtmask\optional{,
-                              besocial\optional{, interval\optional{,
-                              bgyield}}}}}}
-Influenza la gestione degli eventi iterata dall'interprete
-interno. \var{Interval} precisa quanto spesso (in secondi, virgola
-mobile) l'interprete deve eseguire il codice di elaborazione
-dell'evento.  Quando è vero, \var{doint} provoca l'esecuzione del
-controllo di interrupt (command-dot).  \var{evtmask} dice
-all'interprete di effettuare l'elaborazione degli eventi riguardanti
-la maschera (ridisegno, pressioni del mouse per passare ad altre
-applicazioni, ecc).  L'opzione \var{besocial} fornisce agli altri
-processi una occasione per essere eseguiti.  Questi ultimi sono
-concessi in esecuzione minimale quando Python è in primo piano, mentre
-\var{bgyield} secondi per \var{interval} quando Python viene eseguito
-in background. 
-
-Tutti i parametri sono facoltativi e predefiniti al valore corrente.
-Il valore restituito da questa funzione è una tupla con i vecchi
-valori di queste opzioni.  I valori predefiniti iniziali sono quelli
-in cui tutte le elaborazioni sono attive, il controllo viene fatto
-ogni quarto di secondo ed il processore, quando è in background,
-smette di lavorare per un quarto di secondo. 
-
-Il caso più frequente è chiamare \code{SchedParams(0, 0)} per
-disabilitare completamente la gestione degli eventi nell'iterazione
-dell'interprete. 
-
-Disponibilità: MacPython-OS9.
-\end{funcdesc}
-
-\begin{funcdesc}{HandleEvent}{ev}
-Trasferisce il record dell'evento \var{ev} al ciclo di gestione eventi
-di Python, o possibilmente al gestore della finestra \code{sys.stdout}
-(fondato sul compilatore utilizzato per costruire Python).  Questo
-permette ai programmi Python, nella gestione dei propri eventi, di
-avere ancora proprietà di ``comandi-punto'' e di
-``scambio-finestre''. 
-
-Si ottiene un'eccezione se si tenta la chiamata a questa funzione da
-un gestore di eventi impostato mediante \function{SetEventHandler()}. 
-
-Disponibilità: MacPython-OS9.
-\end{funcdesc}
-
-\begin{funcdesc}{GetErrorString}{errno}
-Restituisce il descrittore testuale del codice d'errore MacOS
-\var{errno}. 
-\end{funcdesc}
-
-\begin{funcdesc}{splash}{resid}
-Questa funzione dispone sullo schermo una schermata di presentazione
-dell'applicazione, con specificato \var{resid} come contenuto della
-risorsa DLOG.  La chiamata della funzione con argomento zero rimuove
-la schermata di presentazione.  Questa funzione è utile quando si
-vuole che un'applet avvii una schermata di presentazione prima
-dell'inizializzazione, senza aver prima caricato i numerosi moduli di
-estensione dell'applicazione. 
-
-Disponibilità: MacPython-OS9.
-\end{funcdesc}
-
 \begin{funcdesc}{DebugStr}{message \optional{, object}}
-In Mac OS 9, tocca il più basso livello del debugger con il messaggio
-\var{message}.  L'argomento facoltativo \var{object} non viene usato,
-ma può facilmente essere esaminato dal debugger.  In Mac OS X la
-stringa è semplicemente inviata sullo stderr.
-
-Occorre usare questa funzione con estrema cautela: se non è installato
-nessun debugger di basso livello come MacsBug, questa chiamata manderà
-in crash il sistema operativo.  Si rivolge principalmente agli
-sviluppatori di estensioni dei moduli Python. 
+In Mac OS X la stringa è semplicemente inviata su stderr (nei sistemi Mac OS
+più datati era presente una funzionalità più accurata),
+ma ciò fornisce una utile posizione per attaccare un breakpoint in un debugger
+a basso livello come \program{gdb}.
 \end{funcdesc}
 
 \begin{funcdesc}{SysBeep}{}
@@ -312,6 +228,4 @@
 Quando uno script, eseguito da un pacchetto applicativo, è stato
 mandato in esecuzione mediante \program{pythonw} invece di
 \program{python}, oppure come applet. 
-
-In Mac OS 9 il metodo restituisce sempre \code{True}.
 \end{funcdesc}

Modified: python/python/Doc/branches/2.4.3/mac/libmacostools.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/mac/libmacostools.tex	(original)
+++ python/python/Doc/branches/2.4.3/mac/libmacostools.tex	Thu Nov  9 20:30:14 2006
@@ -26,7 +26,8 @@
 Questo modulo contiene alcune procedure utili per la manipolazione
 dei file in Macintosh. Tutti i parametri relativi ai file possono
 essere specificati come nomi di percorso e oggetti \class{FSRef} o
-\class{FSSpec}. 
+\class{FSSpec}.  Questo modulo si aspetta un filesystem che supporti file a forchette
+multiple, pertanto non dovrebbe essere usato in partizioni UFS.
 
 Il modulo \module{macostools} definisce le seguenti funzioni:
 

Modified: python/python/Doc/branches/2.4.3/mac/scripting.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/mac/scripting.tex	(original)
+++ python/python/Doc/branches/2.4.3/mac/scripting.tex	Thu Nov  9 20:30:14 2006
@@ -18,10 +18,11 @@
 %[- MARK -] END DIFF
 \chapter{Moduli OSA MAcPython \label{scripting}}
 
-Python implementa quasi del tutto l'Open Scripting Architecture (OSA,
-anche comunemente denominato AppleScript), permettendo da Python
-stesso, il controllo nella stesura di applicazioni, con un'interfaccia
-conforme allo stile di Python. 
+Questo capitolo descrive la attuale implementazione della Open Scripting Architecture
+(OSA, comunemente rivolta a Applescript) per Python, permettendo a voi il controllo
+di applicazioni con supporto allo script dal vostro programma Python , con una
+con un'interfaccia conforme allo stile di Python.
+Lo sviluppo di questo set di moduli è fermo, e una sostituzione è attesa in Python 2.5. 
 
 Si consulti la documentazione Apple, per una descrizione dei diversi
 componenti di AppleScript e OSA, oltre che per comprendere la sua

Modified: python/python/Doc/branches/2.4.3/mac/undoc.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/mac/undoc.tex	(original)
+++ python/python/Doc/branches/2.4.3/mac/undoc.tex	Thu Nov  9 20:30:14 2006
@@ -46,18 +46,7 @@
 %[- MARK -] END DIFF
                 macfreeze.}
 
-
-\section{\module{py_resource} --- Risorse provenienti da codice Python}
-\declaremodule[pyresource]{standard}{py_resource}
-  \platform{Mac}
-\modulesynopsis{Un aiuto per creare risorse \texttt{'PYC~'} per
-  applicazioni compilate.}
-
-Questo modulo viene usato principalmente come un modulo di aiuto per
-\program{BuildApplet} e \program{BuildApplication}.  \`E capace di
-immagazzinare codice Python compilato in un file come risorsa
-\texttt{'PYC~'}. 
-
+\deprecated{2.4}
 
 \section{\module{cfmfile} --- Modulo risorsa per la frammentazione del codice}
 \declaremodule{standard}{cfmfile}
@@ -83,6 +72,7 @@
 %[- MARK -] END DIFF
 plugin in un singolo eseguibile. 
 
+\deprecated{2.4}
 
 \section{\module{icopen} --- Rimpiazzo del Config Internet per \method{open()}}
 \declaremodule{standard}{icopen}
@@ -220,36 +210,12 @@
 MacPython o sotto OSX Python.
 
 \section{\module{Nav} --- Chiamate NavServices}
-\declaremodule{standard}{Nac}
+\declaremodule{standard}{Nav}
   \platform{Mac}
 \modulesynopsis{Un'interfaccia per i Navigation Services.}
 
 Un'interfaccia di basso livello per i Navigation Services. 
 
-\section{\module{mkcwproject} --- Realizzatore di progetti CodeWarrior}
-\declaremodule{standard}{mkcwproject}
-  \platform{Mac}
-\modulesynopsis{Realizzatore di progetti CodeWarrior.}
-
-\refmodindex{distutils}
-\module{mkcwproject} crea i file progetto per l'ambiente di sviluppo
-Metrowerks CodeWarrior.  \`E un modulo di aiuto per
-\module{distutils} ma può essere usato separatamente per maggiore
-controllo. 
-
-
-\section{\module{nsremote} --- Wrapper per moduli Netscape OSA}
-\declaremodule{standard}{nsremote}
-  \platform{Mac}
-\modulesynopsis{Wrapper per moduli Netscape OSA.}
-
-\module{nsremote} è un wrapper dei moduli Netscape OSA che permette di
-indirizzare facilmente il vostro navigatore verso le URL digitate.  Un
-modulo strettamente collegato che può interessare è il modulo
-\module{webbrowser}, documentato nella
-\citetitle[../lib/lib.html]{Libreria di riferimento di Python}.  
-
-
 \section{\module{PixMapWrapper} --- Wrapper per oggetti PixMap}
 \declaremodule{standard}{PixMapWrapper}
   \platform{Mac}
@@ -259,44 +225,6 @@
 che permette l'accesso ai campi per nome.  
 Ha anche un metodo per convertire i campi da e per immagini \module{PIL}.
 
-
-\section{\module{preferences} --- Gestore delle applicazioni preferite}
-\declaremodule{standard}{preferences}
-  \platform{Mac}
-\modulesynopsis{Gestore delle applicazioni preferite con il supporto
-  per quelle predefinite.} 
-
-Il modulo \module{preferences} permette la conservazione delle
-preferenze dell'utente nella cartella di sistema delle preferenze, con
-le entrate predefinite dell'applicazione stessa e la possibilità di
-sovrascrivere preferenze per situazioni specifiche. 
-
-
-\section{\module{pythonprefs} --- Gestore dei preferiti per Python}
-\declaremodule{standard}{pythonprefs}
-  \platform{Mac}
-\modulesynopsis{Gestore specializzato dei preferiti per l'interprete
-  Python.} 
-
-Questo modulo è una specializzazione del modulo
-\refmodule{preferences} che permette la lettura e la scrittura dei
-preferiti per l'interprete Python. 
-
-
-\section{\module{quietconsole} --- Invisibile standard output}
-\declaremodule{standard}{quietconsole}
-  \platform{Mac}
-\modulesynopsis{Bufferizzato, invisibile standard output.}
-
-\module{quietconsole} permette di prendere l'output dello stdio e
-metterlo in un buffer senza mostrarlo (o senza mostrare la finestra
-dello stdout insieme, se impostate con \program{EditPythonPrefs}), a
-meno che non proviate a leggere dallo stdin o disabilitiate la
-bufferizzazione, a quel punto tutto l'output salvato verrà inviato
-alla finestra.  \`E utile per programmi con interfacce grafiche che
-vogliono mostrare il loro output quando incorrono in un crash. 
-
-
 \section{\module{videoreader} --- Leggere i filmati QuickTime}
 \declaremodule{standard}{videoreader}
   \platform{Mac}


Maggiori informazioni sulla lista Commits