[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