.\" Translated into Spanish on Mon Apr, 12 1999 by
.\"	Marcos Snchez Provencio <rapto@arrakis.es>
.\"
.TH PYTHON 1 "10 Abril 1998" "Python 1.5.1"
.SH NOMBRE
python \- lenguaje de programacin orientado a objetos interactivo e
interpretado
.SH SINOPSIS
.B python
[
.B \-d
]
[
.B \-i
]
[
.B \-O
]
[
.B \-S
]
[
.B \-t
]
[
.B \-u
]
[
.B \-v
]
.br
       [
.B \-x
]
[
.B \-X
]
[
.B \-c
.I orden
|
.I script
|
\-
]
.br
       [
.I argumentos
]
.SH DESCRIPCIN
Python es un lenguaje de programacin orientado a objetos interactivo e
interpretado que combina una considerable potencia con una sintaxis muy clara.
Vea la Gua de aprendizaje de Python para conseguir informacin del lenguaje
de programacin.
La Referencia de Biblioteca de Python documenta los tipos, constantes,
funciones y mdulos internos y estndares.
Finalmente, el Manual de Referencia de Python describe la sintaxis y semntica
del ncleo del lenguaje en detalle (exhaustivo).
.PP
La potencia base de Python se puede extender con mdulos escritos en C o C++.
En la mayora de los sistemas dichos mdulos se pueden cargar dinmicamente.
Python se puede adaptar tambin como lenguaje de extensin (macros) de
aplicaciones existentes.
Consulte la documentacin interna del producto para obtener ms informacin.
.SH OPCIONES DE LNEA DE RDENES
.TP
.B \-d
Activar la salida de depuracin del 
.I parser
(slo para genios, dependiente de opciones de compilacin).
.TP
.B \-i
Cuando se pasa un script como primer argumento o se utiliza la opcin
\fB\-c\fP, entrar en el modo interactivo tras ejecutar el script u orden.
No lee el archivo $PYTHONSTARTUP. Es til para inspeccionar variables globales
o una traza de la pila cuando un script hace saltar una excepcin.
.TP
.B \-O
Activar optimizaciones bsicas. Hace que la extensin del fichero compilado
(a bytecode) de 
.I .pyc
a
.IR pyo .
.TP
.B \-S
Evitar importar el mdulo 
.I site
y las manipulaciones dependientes de la instalacin de
.I sys.path
que conlleva.
.TP
.B \-t
Activar una alarma cuando un fichero fuente mezcla tabuladores y espacios
para el sangrado de modo tal que lo haga depender del valor del tabulador en
espacios. Activar un error si la opcin se duplica.
.TP
.B \-u
Forzar que los flujos de entrada, salida y errores estndares (stdin, stdout,
stderr) no utilicen tampn (buffer).
.TP
.B \-v
Mostrar un mensaje cada vez que se inicializa un mdulo, mostrando el lugar
(nombre de fichero o mdulo interno) del que se carga.
.TP
.B \-x
Saltarse la primera lnea de cdigo fuente. Slo se utiliza para una trampa
especfica de DOS. Ojo: Los nmeros de lnea se desplazarn una unidad.
.TP
.B \-X
Hacer que las excepciones estndar sean cadenas en lugar de clases. Se utiliza
slo por compatibilidad con cdigo antiguo.
.BI "\-c " orden
Especifica la orden que hay que ejecutar (ver la siguiente seccin).
Esto finaliza la lista de opciones (las siguientes opciones se pasan como
argumentos de la orden).
.SH INTERFAZ DEL INTRPRETE
La interfaz del intrprete se parece a la de la shell de UNIX: Cuando se
invoca con la entrada estndar conectada a un dispositivo tty, indica que
espera rdenes y las ejecuta hasta que se lee un EOF. Cuando se invica con un
argumento que es un nombre de fichero o con un fichero como entrada estndar,
le y ejecuta un 
desde ese fichero. Cuando se le llama con 
.B \-c
.IR orden ,
ejecuta la(s) sentencias dadas como 
.IR orden .
Aqu
.I orden
puede contener mltiples sentencias separadas por saltos de lnea. El espacio
al principio es significativo en las sentencias Python!
En modo no-interactivo, se analiza la entrada completa antes de ejecutarla.
.PP
Si est disponible, el nombre del script y los argumentos posteriores a ste
se pasan al script en la variable Python 
.IR sys.argv ,
que es una lista de cadenas (hay que hacer
.I import sys
para acceder a esta variable).
Si no se da nombre de script,
.I sys.argv
est vaco. Si se utiliza
.B \-c
.I sys.argv[0]
contiene la cadena \fB\-c\fP. Observe que las opciones interpretadas por el propio intrprete no se colocan
en
.IR sys.argv .
.PP
En modo interactivo, el indicador primario es `>>>'; 
el indicador secundario (que aparece cuando una orden no est completa) es
`...'.
Se pueden cambiar los indicadores mediante asignacin a 
.I sys.ps1
o a
.IR sys.ps2 .
El intrprete termina cuando lee un EOF (fin de fichero). Cuando ocurre una
excepcin no gestionadad, se presenta una traza de la pila y el control vuelve
al indicador principal. En modo no interactivo, el intrprete termina tras
presentar la traza de la pila.
La seal de interrupcin activa la excepcin
\fIKeyboardInterrupt\fP; no se capturan (excepto SIGPIPE, que se ignora a veces, a favor de una
excepcin
\fIIOError\fP).  Los mensajes de error se imprimen por stderr.
.SH FICHEROS Y DIRECTORIOS
stos dependen de las convenciones de la instalacin local:
.IP /usr/local/bin/python
Ubicacin recomendada para el intrprete.
.IP /usr/local/lib/python<version>
Ubicacin recomendada para el directorio que contiene los mdulos estndar.
.SH VARIABLES DE ENTORNO
.IP PYTHONHOME
Cambiar la ubiciacin de las bibliotecas Python estndar. Por omisin, se
buscan las bibliotecas en <prefix>/lib/python<version> y
<exec_prefix>/lib/python<version>, en donde <prefix> y <exec_prefix>
dependen de la instalacin concreta (por omisin, /usr/local).
Cuando el valor de $PYTHONHOME es un directorio slamente, reemplaza a 
<prefix> y a <exec_prefix>. Para especificar valores diferentes para 
stos, ponga $PYTHONHOME a <prefix>:<exec_prefix>.
.IP PYTHONPATH
se aade a la ruta de bsqueda de mdulos inicial. El formato es el mismo que
la variable $PATH de la shell: Uno o ms directorio separados por el carcter
dos puntos.
Los directorios que no existen son omitidos en silencio.
La ruta de squeda depende de la isntalacin, pero por lo general empiezaq por
<prefix>/lib/python<version> (ver PYTHONHOME arriba).
La ruta de bsqueda por omisin siempre se aade a $PYTHONPATH.
Si se da un script como argumento, el directorio que contiene el script se
inserta en la ruta por delante de $PYTHONPATH.
La ruta de bsqueda puede manipularse desde un programa Python, usando la
variable
\fIsys.path\fP.
.IP PYTHONSTARTUP
Si es el nombre de un fichero legible, se ejecutan las rdenes de Python
de ese fichero antes de que aparezca el indicador en modo interactivo.
Estos comandos se ejecutan en el mismo
espacio nominal que los comandos, para que los objetos definidos o
mdulos importados se puedan usar sin necesidad de cualificarlos en la
sesin interactiva.
Tambin se pueden cambiar los indicadores
.I sys.ps1
y
.I sys.ps2
mediante este fichero.
.IP PYTHONDEBUG
Si tiene un valor diferente de la cadena vaca equivale a especificar la
opcin \fB\-d\fP.
.IP PYTHONINSPECT
Si tiene un valor diferente de la cadena vaca equivale a especificar la 
opcin \fB\-i\fP.
.IP PYTHONUNBUFFERED
Si tiene un valor diferente de la cadena vaca equivale a especificar la 
opcin \fB\-u\fP.
.IP PYTHONVERBOSE
Si tiene un valor diferente de la cadena vaca equivale a especificar la 
opcin \fB\-v\fP.
.SH VASE TAMBIN
Gua de aprendizaje de Python
.br
Referencia de las libreras de Python
.br
Manual de referencia de Python
.SH AUTOR
.nf
Guido van Rossum
CNRI
1895 Preston White Drive
Reston, VA 20191
EE UU
.PP
E-mail: guido@cnri.reston.va.us, guido@python.org
.fi
.PP
Y un elenco de miles de personas.
.SH REFERENCIAS EN INTERNET
Pgina web principal: http://www.python.org
.br
Servidor de FTP principal: ftp://ftp.python.org
.br
Grupo de debate: comp.lang.python
.SH COPYRIGHT
Copyright 1991-1995 por el Stichting Mathematisch Centrum, Amsterdam,
Pases Bajos.
.IP " "
All Rights Reserved/Todos los derechos reservados
.PP
Por la presente se otorga el permiso para usar, copiar, modificar y distribuir
este software y su documentacin para cualquier intencin y sin cargo,
siempre que aparezca la nota de copyright superior en todas las copias y que
tanto la nota de copyright y este permiso aparezcan en la documentacin de
apoyo y que no se utlizacen los nombres del Stichting Mathematisch Centrum,
CWI o de la Corporation for National Research Initiatives o CNRI para
publicidad relzativa a la distribucin del software su permiso previo, por
escrito y especfico.

Aunque CWI es la fuente inicial de este software, se hace disponible una
versin modificada en la Corporation for National Research Initiatives
(CNRI) en la direccin de Internet ftp://ftp.python.org.

STICHTING MATHEMATISCH CENTRUM Y CNRI NIEGAN CUALQUIER GARANTA RESPECTO A
ESTE SOFTWARE, INCLUIDA CUALQUIER GARANTA IMPLICITA DE COMERCIALIDAD O
ADECUACIN. DE NINGN MODO SE HARN RESPONSABLES STICHTING MATHEMATISCH
CENTRUM O CNRI POR CUALQUIER DAO ESPECIAL, INDIRECTO O SOBREVENIDO O DAO DE
NINGN TIPO, QUE CAUSEN PRDIDA DE USO, DATOS O BENEFICIOS, TANTO POR ACCIONES
POR CONTRATO, COMO POR NEGLIGENCIA U OTRA ACCIN ESPREA, CAUSADA POR O EN
CONEXIN CON EL USO O CAPACIDADES DE ESTE SOFTWARE.