[Commits] python.it commit r213 -
python/python/Doc/branches/2.4.3/lib
commit a svn.python.it
commit a svn.python.it
Ven 8 Set 2006 11:41:00 CEST
Author: manlio
Date: Fri Sep 8 11:40:54 2006
New Revision: 213
Modified:
python/python/Doc/branches/2.4.3/lib/libbsddb.tex
python/python/Doc/branches/2.4.3/lib/libbz2.tex
python/python/Doc/branches/2.4.3/lib/libcalendar.tex
python/python/Doc/branches/2.4.3/lib/libcfgparser.tex
Log:
aggiornamenti di Antonio Vitale, con correzioni
Modified: python/python/Doc/branches/2.4.3/lib/libbsddb.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/libbsddb.tex (original)
+++ python/python/Doc/branches/2.4.3/lib/libbsddb.tex Fri Sep 8 11:40:54 2006
@@ -32,7 +32,7 @@
A partire da Python 2.3 il modulo \module{bsddb} richiede la libreria
Berkeley DB versione 3.2 o successiva (viene assicurato il
-funzionamento dalla 3.2 alla 4.2 al momento della scrittura di questo
+funzionamento dalla 3.2 alla 4.3 al momento della scrittura di questo
documento).
\begin{seealso}
@@ -142,8 +142,8 @@
devono essere preservati sul disco possono essere creati passando
\code{None} come \var{filename}. Il parametro facoltativo var{flag}
identifica il modo usato per aprire il file. Può essere \character{r}
-(sola lettura, valore predefinito), \character{w} (lettura e scrittura),
-\character{c} (lettura e scrittura - crea se necessario) o
+(sola lettura), \character{w} (lettura e scrittura),
+\character{c} (lettura e scrittura - crea se necessario; valore predefinito) o
\character{n} (lettura e scrittura - tronca la lunghezza zero). Gli
altri argomenti sono usati raramente e vengono passati solo alla
funzione di più basso livello \cfunction{dbopen()}. Consultare la
@@ -152,14 +152,14 @@
\begin{funcdesc}{btopen}{filename\optional{, flag\optional{,
mode\optional{, btflags\optional{, cachesize\optional{, maxkeypage\optional{,
-minkeypage\optional{, psize\optional{, lorder}}}}}}}}}
+minkeypage\optional{, pgsize\optional{, lorder}}}}}}}}}
Apre il file di formato btree chiamato \var{filename}. I file che non
devono essere preservati sul disco possono essere creati passando
\code{None} come \var{filename}. Il parametro facoltativo \var{flag}
identifica il modo usato per aprire il file. Può essere \character{r}
-(sola lettura, valore predefinito), \character{w} (lettura e scrittura),
-\character{c} (lettura e scrittura - crea se necessario) o
+(sola lettura), \character{w} (lettura e scrittura),
+\character{c} (lettura e scrittura - crea se necessario; valore predefinito) o
\character{n} (lettura e scrittura - tronca la lunghezza zero). Gli
altri argomenti sono usati raramente e vengono passati solo alla
funzione di più basso livello \cfunction{dbopen()}. Consultare la
@@ -167,15 +167,15 @@
\end{funcdesc}
\begin{funcdesc}{rnopen}{filename\optional{, flag\optional{, mode\optional{,
-rnflags\optional{, cachesize\optional{, psize\optional{, lorder\optional{,
+rnflags\optional{, cachesize\optional{, pgsize\optional{, lorder\optional{,
reclen\optional{, bval\optional{, bfname}}}}}}}}}}
Apre il file di formato DB record chiamato \var{filename}. I file che
non devono essere preservati sul disco possono essere creati passando
\code{None} come \var{filename}. Il parametro facoltativo \var{flag}
identifica il modo usato per aprire il file. Può essere \character{r}
-(sola lettura, valore predefinito), \character{w} (lettura e scrittura),
-\character{c} (lettura e scrittura - crea se necessario) o
+(sola lettura), \character{w} (lettura e scrittura),
+\character{c} (lettura e scrittura - crea se necessario; valore predefinito) o
\character{n} (lettura e scrittura - tronca la lunghezza zero). Gli
altri argomenti sono usati raramente e vengono passati solo alla
funzione di più basso livello \cfunction{dbopen()}. Consultare la
@@ -183,10 +183,6 @@
\end{funcdesc}
-\begin{seealso}
- \seemodule{dbhash}{Modulo dbhash Interfaccia stile DBM a \module{bsddb}}
-\end{seealso}
-
\begin{notice}
A partire dalla 2.3 alcune versioni \UNIX{} di Python possono
presentare un modulo \module{bsddb185}. Questi è presente \emph{solo}
@@ -195,6 +191,11 @@
\module{bsddb185} non dovrebbe mai essere usato nel nuovo codice.
\end{notice}
+
+\begin{seealso}
+ \seemodule{dbhash}{Modulo dbhash Interfaccia stile DBM a \module{bsddb}}
+\end{seealso}
+
\subsection{Oggetti Hash, BTree e Record \label{bsddb-objects}}
Una volta istanziati, gli oggetti hash, btree e record supportano gli
@@ -246,8 +247,8 @@
\begin{methoddesc}{first}{}
Imposta il cursore al primo elemento nel file DB e lo restituisce.
-L'ordine delle chiavi non è specificato, eccetto nel caso di database
-B-Tree.
+L'ordine delle chiavi non è specificato, eccetto nel caso di database B-Tree.
+Questo metodo, se il database è vuoto, solleva l'eccezione \exception{bsddb.error}.
\end{methoddesc}
\begin{methoddesc}{next}{}
@@ -281,7 +282,8 @@
Imposta il cursore all'ultimo elemento nel file DB e lo restituisce.
L'ordine delle chiavi non è specificato. Questo metodo non è
supportato nei database a tabella di hash (quelli aperti con
-\function{hashopen()}).
+\function{hashopen()}).
+Questo metodo, se il database è vuoto, solleva l'eccezione \exception{bsddb.error}.
\end{methoddesc}
\begin{methoddesc}{sync}{}
@@ -325,4 +327,4 @@
True
>>> db.sync()
0
-\end{verbatim}
\ No newline at end of file
+\end{verbatim}
Modified: python/python/Doc/branches/2.4.3/lib/libbz2.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/libbz2.tex (original)
+++ python/python/Doc/branches/2.4.3/lib/libbz2.tex Fri Sep 8 11:40:54 2006
@@ -106,7 +106,7 @@
\begin{methoddesc}[BZ2File]{xreadlines}{}
Per retrocompatibilità. L'oggetto \class{BZ2File} adesso include le
ottimizzazioni di performance precedentemente implementate nel modulo
-\refmodule{xreadlines}.
+\module{xreadlines}.
\deprecated{2.3}{Esiste solo per compatibilità con il metodo con
questo nome negli oggetti \class{file}, che è anch'esso
deprecato. Usate \code{for line in file} al suo posto.}
@@ -207,4 +207,4 @@
Decomprime i dati \var{data} in un solo colpo solo. Se volete invece
decomprimere i dati sequenzialmente, usate un'istanza di
\class{BZ2Decompressor}.
-\end{funcdesc}
\ No newline at end of file
+\end{funcdesc}
Modified: python/python/Doc/branches/2.4.3/lib/libcalendar.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/libcalendar.tex (original)
+++ python/python/Doc/branches/2.4.3/lib/libcalendar.tex Fri Sep 8 11:40:54 2006
@@ -78,6 +78,11 @@
%[- MARK -] END DIFF
\end{funcdesc}
+\begin{funcdesc}{weekheader}{n}
+Restituisce un header contenente i nomi dei giorni della settimana abbreviati.
+\var{n} specifica per il giorno della settimana la larghezza espressa in caratteri.
+\end{funcdesc}
+
\begin{funcdesc}{monthrange}{year, month}
Restituisce il giorno della settimana del primo giorno del mese ed il
numero di giorni nel mese, avendo specificato l'anno (\var{year}) ed il mese
Modified: python/python/Doc/branches/2.4.3/lib/libcfgparser.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/libcfgparser.tex (original)
+++ python/python/Doc/branches/2.4.3/lib/libcfgparser.tex Fri Sep 8 11:40:54 2006
@@ -275,9 +275,11 @@
\begin{methoddesc}{set}{section, option, value}
Se la sezione \var{section} esiste, assegna all'opzione \var{option} il valore
\var{value}; altrimenti solleva un'eccezione
-\exception{NoSectionError}. \var{value} deve essere una stringa
-(\class{str} o \class{unicode}); altrimenti viene sollevata
-un'eccezione \exception{TypeError}.
+\exception{NoSectionError}. Sebbene sia possibile l'utilizzo di \class{RawConfigParser}
+(oppure di \class{ConfigParser} con il parametro \var{raw} impostato a true) per
+la memorizzazione \emph{interna} di valori non-stringa, la funzionalità completa
+può essere raggiunta solamente usando valori stringa (compreso l'inserimento e
+l'output su file).
\versionadded{1.6}
\end{methoddesc}
@@ -335,8 +337,6 @@
La classe \class{ConfigParser} estende alcuni metodi dell'interfaccia
\class{RawConfigParser}, aggiungendo alcuni argomenti facoltativi.
-La classe \class{SafeConfigParser} implementa la medesima interfaccia
-estesa.
\begin{methoddesc}{get}{section, option\optional{, raw\optional{, vars}}}
Acquisisce il valore \var{option} per la sezione di nome
@@ -375,3 +375,17 @@
\method{get()}.
\versionadded{2.3}
\end{methoddesc}
+
+
+\subsection{Oggetti SafeConfigParser \label{SafeConfigParser-objects}}
+
+La classe \class{SafeConfigParser} implementa la medesima interfaccia estesa
+della classe \class{ConfigParser} con l'aggiunta di:
+
+\begin{methoddesc}{set}{section, option, value}
+Se la data sezione \var{section} esiste, assegna alla data opzione
+\var{option} il valore \var{value} specificato; altrimenti solleva un'eccezione
+\exception{NoSectionError}. Il valore \var{value} deve essere una
+stringa (\class{str} oppure \class{unicode}); in caso contrario viene
+sollevata un'eccezione \exception{TypeError}. \versionadded{2.4}
+\end{methoddesc}
Maggiori informazioni sulla lista
Commits