Update docs to match implementation of $build_and_dump_html_index
[maxima.git] / doc / info / es / Miscellaneous.es.texi
blob569d0883e58011d2aeffa57a5dc85e000cbf2dce
1 @c English version 2013-08-03
2 @menu
3 * Introducción a la miscelánea de opciones::  
4 * Share::  
5 * Funciones y variables para la miscelánea de opciones::
6 @end menu
8 @node Introducción a la miscelánea de opciones, Share, Miscelánea de opciones, Miscelánea de opciones
10 @section Introducción a la miscelánea de opciones
12 En esta sección se comentan varias opciones que tienen un efecto global sobre le comportamiento
13 de Maxima. También se comentan varias listas, como la de las funciones definidas por el usuario.
23 @node Share, Funciones y variables para la miscelánea de opciones, Introducción a la miscelánea de opciones, Miscelánea de opciones
25 @section Share
27 El directorio "share" de Maxima contiene programas y ficheros de interés para
28 los usuarios de Maxima, pero no forman parte del núcleo de Maxima. Estos programas 
29 se cargan en memoria con llamadas a las funciones @code{load} o @code{setup_autoload}.
31 El código @code{:lisp *maxima-sharedir*} muestra la localización del directorio 
32 "share" dentro del sistema de ficheros del usuario.
34 El código @code{printfile ("share.usg")} muestra una lista actualizada de paquetes 
35 en "share". Los usuarios pueden encontrar más información accediendo directamente
36 a los contenidos del directorio "share".
46 @node Funciones y variables para la miscelánea de opciones,  , Share, Miscelánea de opciones
47 @section Funciones y variables para la miscelánea de opciones
50 @defvr {Variable del sistema} askexp
51 Cuando se invoca a @code{asksign}, la expresión que se va 
52 a analizar es precisamente @code{askexp}.
54 @end defvr
58 @defvr {Variable optativa} genindex
59 Valor por defecto: @code{i}
61 La variable @code{genindex} es el prefijo alfabético utilizado para generar la siguiente variable de sumación en caso de necesidad.
63 @end defvr
67 @defvr {Variable optativa} gensumnum
68 Valor por defecto: 0
70 La variable @code{gensumnum} es el sufijo numérico utilizado para generar la siguiente variable de sumación. Si vale  @code{false} entonces el índice consistirá solamente de  @code{genindex}, sin sufijo numérico.
71 @end defvr
76 @deffn  {Función} gensym ()
77 @deffnx {Función} gensym (@var{x})
79 @code{gensym()} crea y devuelve una nueva símbolo o
80 variable sin valor asignado.
82 El nombre del nuevo símbolo está formado por la
83 concatenación de un prefijo, cuyo valor por defecto es "g", y de
84 un sufijo, el cual es la representación decimal de un número que
85 coincide, por defecto, con el valor de un contador interno de Lisp.
87 En caso de suministrar el argumento @var{x}, siendo este una cadena,
88 se utilizará como prefijo en lugar de "g", lo cual tendrá efecto
89 sólo para esta llamada a @code{gensym}·
91 En caso de suministrar el argumento @var{x}, siendo este un número
92 entero, se utilizará como sufijo en lugar del contador interno de
93 Lisp, lo cual tendrá efecto sólo para esta llamada a @code{gensym}·
95 Si no se suministra el sufijo en forma explícita, y sólo
96 en este caso, el contador interno sufrirá un incremento después de
97 haber sido utilizado.
99 Ejemplos:
101 @c ===beg===
102 @c gensym();
103 @c gensym("new");
104 @c gensym(123);
105 @c ===end===
106 @example
107 (%i1) gensym();
108 (%o1)                         g887
109 (%i2) gensym("new");
110 (%o2)                        new888
111 (%i3) gensym(123);
112 (%o3)                         g123
113 @end example
114 @end deffn
118 @defvr {Variable opcional} packagefile
119 Valor por defecto: @code{false}
121 Los autores de paquetes que utilizan @code{save} o @code{translate}
122 para crear librerías para otros usuarios pueden hacer la asignación
123 @code{packagefile: true} para prevenir que se añada información a las listas
124 con información del sistema de Maxima, como @code{values} o @code{functions}.
125 @end defvr
129 @deffn {Función} remvalue (@var{nombre_1}, ..., @var{nombre_n})
130 @deffnx {Función} remvalue (all)
132 Elimina del sistema los valores de las variable de usuario @var{nombre_1}, ..., @var{nombre_n} (incluso las que tienen subíndices).
134 La llamada @code{remvalue (all)} elimina los valores de todas las variables en @code{values}, la lista de todas las variables a las que el usuario a dado algún nombre, pero no de aquéllas a las que Maxima asigna automáticamente un valor.
136 Véase también @code{values}.
138 @end deffn
142 @deffn {Función} rncombine (@var{expr})
144 Transforma @var{expr} combinando todos los términos de @var{expr} que tengan denominadores idénticos o que difieran unos de otros por factores numéricos. Su comportamiento es diferente al de la función @code{combine}, que combina términos con iguales denominadores.
146 Haciendo @code{pfeformat: true} y utilizando @code{combine} se consiguen resultados similares a aquéllos que se pueden obtener con  @code{rncombine}, pero @code{rncombine} realiza el paso adicional de multiplicar denominadores numéricos. Esto da como resultado expresiones en las que se pueden reconocer algunas cancelaciones.
148 Antes de utilizar esta función ejecútese @code{load("rncomb")}.
149 @end deffn
155 @deffn {Función} setup_autoload (@var{nombre_fichero}, @var{función_1}, ..., @var{función_n})
157 Especifica que si alguna de las funciones @var{function_1}, ..., @var{function_n} es referenciada pero todavía no ha sido definida, se cargará @var{nombre_fichero} mediante una llamada a @code{load}. El @var{nombre_fichero} normalmente contendrá las definiciones de las funciones especificadas, aunque esto no es imperativo.
159 La función @code{setup_autoload} no opera con arreglos de funciones.
161 La función @code{setup_autoload} no evalúa sus argumentos.
163 Ejemplo:
165 @example
166 (%i1) legendre_p (1, %pi);
167 (%o1)                  legendre_p(1, %pi)
168 (%i2) setup_autoload ("specfun.mac", legendre_p, ultraspherical);
169 (%o2)                         done
170 (%i3) ultraspherical (2, 1/2, %pi);
171 Warning - you are redefining the Macsyma function ultraspherical
172 Warning - you are redefining the Macsyma function legendre_p
173                             2
174                  3 (%pi - 1)
175 (%o3)            ------------ + 3 (%pi - 1) + 1
176                       2
177 (%i4) legendre_p (1, %pi);
178 (%o4)                          %pi
179 (%i5) legendre_q (1, %pi);
180                               %pi + 1
181                       %pi log(-------)
182                               1 - %pi
183 (%o5)                 ---------------- - 1
184                              2
185 @end example
187 @end deffn
191 @deffn  {Función} tcl_output (@var{list}, @var{i0}, @var{skip})
192 @deffnx {Función} tcl_output (@var{list}, @var{i0})
193 @deffnx {Función} tcl_output ([@var{list_1}, @dots{}, @var{list_n}], @var{i})
195 Imprime los elementos de una lista encerrándolos con llaves @code{@{ @}},
196 de forma apropiada para ser utilizado en un programa en el lenguaje Tcl/Tk.
198 @code{tcl_output (@var{list}, @var{i0}, @var{skip})}
199 imprime @var{list}, empezando por el elemento @var{i0} siguiendo luego con los
200 elementos @code{@var{i0} + @var{skip}}, @code{@var{i0} + 2 @var{skip}}, etc.
202 @code{tcl_output (@var{list}, @var{i0})}
203 equivale a @code{tcl_output (@var{list}, @var{i0}, 2)}.
205 @code{tcl_output ([@var{list_1}, ..., @var{list_n}], @var{i})}
206 imprime los @var{i}-ésimos elementos de @var{list_1}, @dots{}, @var{list_n}.
208 Ejemplos:
210 @c EXAMPLE INPUT
211 @c tcl_output ([1, 2, 3, 4, 5, 6], 1, 3)$
212 @c tcl_output ([1, 2, 3, 4, 5, 6], 2, 3)$
213 @c tcl_output ([3/7, 5/9, 11/13, 13/17], 1)$
214 @c tcl_output ([x1, y1, x2, y2, x3, y3], 2)$
215 @c tcl_output ([[1, 2, 3], [11, 22, 33]], 1)$
217 @c EXAMPLE OUTPUT: CLISP
218 @c OUTPUT IS OK FOR FIRST TWO, BROKEN FOR OTHERS
219 @c GCL OUTPUT: SAME FOR FIRST TWO
220 @c GCL FAILS ON OTHERS (IN EACH CASE COMPLAINING ELEMENTS ARE "not of type (OR RATIONAL LISP:FLOAT)"
221 @example
222 (%i1) tcl_output ([1, 2, 3, 4, 5, 6], 1, 3)$
224  @{1.000000000     4.000000000     
225  @}
226 (%i2) tcl_output ([1, 2, 3, 4, 5, 6], 2, 3)$
228  @{2.000000000     5.000000000     
229  @}
230 (%i3) tcl_output ([3/7, 5/9, 11/13, 13/17], 1)$
232  @{((RAT SIMP) 3 7) ((RAT SIMP) 11 13) 
233  @}
234 (%i4) tcl_output ([x1, y1, x2, y2, x3, y3], 2)$
236  @{$Y1 $Y2 $Y3 
237  @}
238 (%i5) tcl_output ([[1, 2, 3], [11, 22, 33]], 1)$
240  @{SIMP 1.000000000     11.00000000     
241  @}
242 @end example
243 @end deffn