[Commits] python.it commit r218 - python/python/Doc/branches/2.4.3/lib

[commit a svn.python.it]

Author: manlio
Date: Fri Sep 22 21:03:56 2006
New Revision: 218

Modified:
   python/python/Doc/branches/2.4.3/lib/libcgi.tex
   python/python/Doc/branches/2.4.3/lib/libcmath.tex
   python/python/Doc/branches/2.4.3/lib/libcmd.tex
Log:
aggiornamento di Antonio Vitale

Modified: python/python/Doc/branches/2.4.3/lib/libcgi.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/libcgi.tex	(original)
+++ python/python/Doc/branches/2.4.3/lib/libcgi.tex	Fri Sep 22 21:03:56 2006
@@ -56,7 +56,7 @@
 in Python.  Fornisce anche un certo numero di utilità che aiutano
 nell'analisi ed il debugging degli script, e l'aggiunta più recente è
 il supporto per l'upload del file da una form (se il browser lo
-supporta --- Grail 3.0 e Netscape 2.0 lo fanno). 
+supporta).
 
 Il risultato dello script CGI consiste di due sezioni, separate da una
 riga vuota.  La prima sezione contiene un certo numero di header che
@@ -190,21 +190,16 @@
 lista di queste istanze. Analogamente, in questa situazione,
 \samp{form.getvalue(\var{chiave})} potrebbe restituire una lista di
 stringhe. 
-Se ci si aspetta questa possibilità (quando la propria form HTML
-contiene campi multipli con lo stesso nome), utilizzare la funzione
-built-in \function{isinstance()} per determinare quando si ha a che
-fare con singole istanze o liste di istanze.  Per esempio questo
+Se ci si aspetta questa possibilità (quando la propria form HTML contiene campi
+multipli con lo stesso nome), utilizzare la funzione \function{getlist()} che
+restituisce sempre una lista di valori (così non c'è bisogno di trattare come
+caso speciale il caso di un singolo elemento della lista). Per esempio questo
 codice concatena un numero imprecisato di campi nomeutente, separati
 da una virgola: 
 
 \begin{verbatim}
-value = form.getvalue("nomeutente", "")
-if isinstance(value, list):
-    # Campi multipli nomeutente specificati
-    usernames = ",".join(value)
-else:
-    # Singolo o nessun campo nomeutente specificato
-    usernames = value
+value = form.getlist("username")
+usernames = ",".join(value)
 \end{verbatim}
 
 Se il campo rappresenta un file caricato via upload, l'accesso al

Modified: python/python/Doc/branches/2.4.3/lib/libcmath.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/libcmath.tex	(original)
+++ python/python/Doc/branches/2.4.3/lib/libcmath.tex	Fri Sep 22 21:03:56 2006
@@ -90,10 +90,12 @@
 %[- MARK -] END DIFF
 \end{funcdesc}
 
-\begin{funcdesc}{log}{x}
-Restituisce il logaritmo naturale di \var{x} 
+\begin{funcdesc}{log}{x\optional{, base}}
+Restituisce il logaritmo in base \var{base} di \var{x}.
+Se non viene specificata \var{base}, ritorna il logaritmo naturale di \var{x}.
 Esiste un ramo di funzione da 0 a -\infinity lungo l'asse reale 
-negativa, continuo dall'alto. 
+negativa, continuo dall'alto.
+\versionchanged[\var{base} argument added]{2.4}
 \end{funcdesc}
 
 \begin{funcdesc}{log10}{x}
@@ -168,7 +170,7 @@
 
 \begin{seealso}
   \seetext{Kahan, W:  Branch cuts for complex elementary functions;
-           or, Much ado about nothings's sign bit.  In Iserles, A.,
+           or, Much ado about nothing's sign bit.  In Iserles, A.,
            and Powell, M. (eds.), \citetitle{The state of the art in
            numerical analysis}. Clarendon Press (1987) pp165-211.}
 \end{seealso}

Modified: python/python/Doc/branches/2.4.3/lib/libcmd.tex
==============================================================================
--- python/python/Doc/branches/2.4.3/lib/libcmd.tex	(original)
+++ python/python/Doc/branches/2.4.3/lib/libcmd.tex	Fri Sep 22 21:03:56 2006
@@ -46,7 +46,7 @@
 %[- MARK -] END DIFF
 \var{sys.stdout}.
 
-\versionchanged[Aggiunti i parametri \var{stdin} e \var{stdout}.]{2.3}
+\versionchanged[Aggiunti i parametri \var{stdin} e \var{stdout}]{2.3}
 \end{classdesc}
 
 \subsection{Oggetti Cmd}
@@ -97,6 +97,10 @@
 %[- MARK -] END DIFF
 inizia con il carattere \character{!}.
 
+Tale metodo restituirà il suo argomento quando il metodo \method{postcmd()}
+restituisce un valore true. L'argomento \var{stop} del metodo method{postcmd()}
+è il valore restituito dal corrispondente comando del metodo \method{do_*()}
+
 Se il completamento è abilitato, verrà eseguito
 automaticamente il completamento dei comandi, e in particolare avverrà chiamando la funzione
 \method{complete_foo()} con gli argomenti \var{text}, \var{line},
@@ -139,7 +143,10 @@
 prompt.  Può essere sovrascritto, ma normalmente non dovrebbe essere necessario; si
 considerino in proposito i metodi \method{precmd()} e \method{postcmd()}
 per delle tipologie utili di esecuzione.  Il valore restituito è un'opzione
-che indica se l'interpretazione dei comandi si debba o meno fermare.
+che indica se l'interpretazione dei comandi si debba o meno fermare. Se esiste
+un metodo \method{do_*()} per il comando \var{str}, viene restituito il suo
+valore di ritorno, altrimenti viene restituito quello del metodo
+\method{default()}.
 \end{methoddesc}
 
 \begin{methoddesc}{emptyline}{}