==============================================================================
===                                  Jmol                                  ===
==============================================================================


Jmol es un visor de molculas y un editor; es de cdigo abierto y est 
escrito en Java.

Toda la informacin est disponible en http://www.jmol.org/

Las preguntas o comentarios relativos a su uso deben enviarse a 
jmol-users@lists.sourceforge.net  (en ingls)

Las preguntas, comentarios y sugerencias relativos a su desarrollo deben
enviarse a jmol-developers@lists.sf.net  (en ingls)


Lista de archivos incluidos:
--------------------

- LEAME.txt
	Este archivo.
		
- README.txt
	La versin en ingls de este archivo.

- COPYRIGHT.txt
	Informacin sobre los derechos de copia.

- LICENSE.txt
	Los trminos de uso y distribucin de Jmol (licencia GNU LGPL).
		
- Jmol.jar
	  El archivo ejecutable de la aplicacin Jmol (un programa escrito en
	Java). Funciona como cualquier otro programa: se abre en su
	propia ventana, se puede redimensionar o minimizar, se puede arrastrar 
	y soltar archivos sobre l, tiene una barra superior de men, puede 
	abrir y grabar archivos, etc. Puede ejecutarse desde la lnea de comandos 
	(particularmente, usando los archivos por lotes que se describen a
	continuacin) pero, si Java est correctamente configurado en tu 
	sistema, normalmente basta con hacer doble clic en este archivo.

- jmol
	(Un tipo de archivo por lotes para iniciar la aplicacin Jmol)
	
- jmol.bat
	Archivo por lotes para iniciar la aplicacin en Windows.
		
- jmol.mac
	(Un tipo de archivo por lotes para iniciar la aplicacin Jmol)
		
- jmol.sh
	Un archivo de instrucciones para iniciar la aplicacin Jmol en
	sistemas de tipo Unix, por ejemplo Linux, BSD, Solaris o
	Cygwin para Windows.

- JmolApplet.jar
	  La miniaplicacin ("applet"), es decir, una versin del programa
	que slo funciona cuando est incrustada en una pgina web.
	  Se trata en este caso de un archivo "todo en uno" o "monoltico"
	que se mantiene principalmente por compatibilidad con pginas
	antiguas que lo invoquen explcitamente. El mtodo recomendado
	actualmente es el uso de la versin subdividida (JmolApplet0.jar etc.,
	descrita ms abajo). En particular, Jmol.js utiliza la versin subdividida.
	  Te puede interesar utilizar este archivo si quieres mantener
	sencillo tu sitio web, o si slo quieres actualizar un archivo jar
	cuando lleguen versiones nuevas de Jmol. Sin embargo, este Jmol se
	cargar algo ms lentamente que las versiones subdivididas, puesto 
	que es preciso que se descargue al equipo del usuario el programa 
	completo, con todos sus componentes, antes de que se pueda mostrar 
	una estructura.
	  Para llamar a JmolApplet.jar desde Jmol.js:
	a) ponlo en la misma carpeta que contiene la pgina HTML que lo
		requiere y no uses jmolInitialize()
	o bien
	b) identifcalo explcitamente en jmolInitialize(), por ejemplo:
		jmolInitialize("carpeta-que-contiene-los-archivos-jar", "JmolApplet.jar")

- JmolAppletSigned.jar
	  Una versin  equivalente de la miniaplicacin, pero en este caso
	es una miniaplicacin "firmada" o "confiable" (terminologa de seguridad
	en el lenguaje Java). Esto significa que para ejecutarse debe previamente
	ser autorizada por el usuario visitante de la pgina web y, de ser as,
	habr menos restricciones de seguridad para el acceso a archivos. Por 
	ejemplo, podr acceder a archivos en cualquier parte del ordenador del
	usuario y en cualquier otro servidor web.
	  Habitualmente, los usuarios recibirn un aviso prguntndoles si quieren
	"aceptar el certificado" o si "confan" en la miniaplicacin; sin embargo, 
	esta prestacin de seguridad no siempre est activada. Si decides usar 
	JmolAppletSigned.jar, debes tener esto en cuenta.
	  Aparte de la lectura de archivos, Jmol no utiliza ninguna otra capacidad
	de las miniaplicaciones firmadas, como acceder al portapapeles del sistema
	o grabar archivos. Usa la miniaplicacin firmada slo si sabes lo que ests
	haciendo y has tenido en cuenta las cuestiones de seguridad.
	  Para llamar a JmolAppletSigned.jar desde Jmol.js:
		jmolInitialize("carpeta-que-contiene-los-archivos-jar", "JmolAppletSigned.jar")
		                  
- Jmol.js
	  Esta es la bilioteca de funciones, escrita en el lenguaje JavaScript,
	que ayuda en la preparacin de pginas web que usen la miniaplicacin
	Jmol sin necesidad de conocer y escribir cdigo detallado especfico
	para la miniaplicacin.
	  Esta biblioteca usa por defecto la versin subdividida de la 
	miniaplicacin (firmada o no).
	  Est documentada en detalle en http://jmol.org/jslibrary/ 

- JmolApplet0.jar  y
  JmolApplet0(diversosSufijos).jar
	  La miniaplicacin se divide en varios trozos de acuerdo con su 
	funcionalidad, de modo que si una pgina no precisa determinado 
	componente,	ste no se descargar desde el servidor. Aun as, se
	recomienda que pongas todos los archivos JmolApplet0*.jar en el 
	servidor, incluso si tus pginas no usan sus prestaciones, pues 
	tanto el men emergente como la consola permiten a los usuarios
	acceder a funciones de Jmol que t no hayas previsto.
	  El conjunto de todos estos archivos es equivalente al archivo
	nico JmolApplet.jar.
	  Esta versin subdividida es la que se usa de forma predeterminada 
	si utilizas Jmol.js. Para ello, basta usar la forma ms simple de
	jmolInitialize(), indicando slo la carpeta que contiene el conjunto
	de archivos jar:
		jmolInitialize("carpeta-que-contiene-los-archivos-jar")
	por ejemplo,
		jmolInitialize(".")  
			(si los archivos jar estn en la misma carpeta que la pgina web)
		jmolInitialize("../jmol") 
			(si los archivos jar estn en una carpeta paralela, llamada 'jmol')
  
- JmolAppletSigned0.jar  y
  JmolAppletSigned0(diversosSufijos).jar
	  La versin firmada de la miniaplicacin subdividida. Esta versin 
	permite que el usuario acceda a archivos en cualquier parte de su
	ordenador y en cualquier servidor web.
	Habitualmente, los usuarios recibirn un aviso pidindoles que acepten 
	el certificado para **cada uno** de los archivos jar que se pueden cargar
	(actualmente, 16). Por esta razn, es probable que esta versin no
	sea de uso habitual.
	  El conjunto de todos estos archivos es equivalente al archivo
	nico JmolAppletSigned.jar.
	  Para llamar a esta versin desde Jmol.js:
	a) jmolInitialize("carpeta-que-contiene-los-archivos-jar", true)
	o bien
	b) jmolInitialize("carpeta-que-contiene-los-archivos-jar", "JmolAppletSigned0.jar")

---------------------------
Teniendo en cuenta las descripciones anteriores, observars que el paquete
de distribucin de Jmol contiene 4 copias completas de la miniaplicacin
(firmada or no, subdividida o no).
---------------------------
