magit; gendoc: emacs y nnn, index

archivos-gendoc/00_Emacs.html

@@ -12,7 +12,7 @@
   <div class="frame content">
     <input type="radio" name="page" id="_" checked><input type="radio" name="page" id="_la_organizacion_de_la_pantalla"><input type="radio" name="page" id="_tipo_de_entradas_de_los_usuarios"><input type="radio" name="page" id="_teclas_comandos"><input type="radio" name="page" id="_entrar_y_salir_de_emacs"><input type="radio" name="page" id="_comandos_basicos_de_edicion"><input type="radio" name="page" id="_el_minibufer"><input type="radio" name="page" id="_ejecutar_comandos_por_nombres"><input type="radio" name="page" id="_ayuda_help"><input type="radio" name="page" id="_la_marca_y_la_region"><input type="radio" name="page" id="_matar_y_mover_texto"><input type="radio" name="page" id="_registros"><input type="radio" name="page" id="_control_de_la_pantalla"><input type="radio" name="page" id="_busqueda_y_reemplazo"><input type="radio" name="page" id="_macros_de_teclado"><input type="radio" name="page" id="_manejo_de_archivos"><input type="radio" name="page" id="_usando_multiples_buffers"><input type="radio" name="page" id="_ventanas_multiples"><input type="radio" name="page" id="_marcos_y_pantallas_graficas"><input type="radio" name="page" id="_soporte_de_juegos_de_caracteres_internacionales"><input type="radio" name="page" id="_modos_mayores_y_menores"><input type="radio" name="page" id="_sangria"><input type="radio" name="page" id="_comandos_para_lenguajes_humanos"><input type="radio" name="page" id="_edicion_de_programas"><input type="radio" name="page" id="_compilacion_y_prueba_de_programas"><input type="radio" name="page" id="_mantener_programas_grandes"><input type="radio" name="page" id="_abreviaturas"><input type="radio" name="page" id="_dired_el_editor_de_directorios"><input type="radio" name="page" id="_el_calendario_y_la_agenda"><input type="radio" name="page" id="_envio_de_correo"><input type="radio" name="page" id="_leer_el_correo_con_rmail"><input type="radio" name="page" id="_correo_electronico_y_noticias_de_usenet_con_gnus"><input type="radio" name="page" id="_seguridad_en_el_host"><input type="radio" name="page" id="_seguridad_de_la_red"><input type="radio" name="page" id="_visualizacion_de_documentos"><input type="radio" name="page" id="_ejecutar_comandos_de_la_shell_desde_tt_emacs_tt"><input type="radio" name="page" id="_uso_de_emacs_como_servidor"><input type="radio" name="page" id="_impresion_de_copias_en_papel"><input type="radio" name="page" id="_ordenar_el_texto"><input type="radio" name="page" id="_edicion_de_imagenes"><input type="radio" name="page" id="_edicion_de_archivos_binarios"><input type="radio" name="page" id="_guardar_sesiones_de_emacs"><input type="radio" name="page" id="_niveles_de_edicion_recursiva"><input type="radio" name="page" id="_funciones_de_hipervinculo_y_navegacion_web"><input type="radio" name="page" id="_juegos_y_otras_diversiones"><input type="radio" name="page" id="_paquetes_emacs_lisp"><input type="radio" name="page" id="_personalizacion">
     <nav class="side nav"><div>
-      <div class="title"><a href="./00_Emacs.html">GNU Emacs 28.2</a><div class="version">Revisión: 1.75</div><input id="_q" class="search" type="text" required="required" onkeyup="s(this.value);"></div>      <div id="_s" class="nav"></div>
+      <div class="title"><a href="./00_Emacs.html">GNU Emacs 28.2</a><div class="version">Revisión: 1.76</div><input id="_q" class="search" type="text" required="required" onkeyup="s(this.value);"></div>      <div id="_s" class="nav"></div>
       <div id="_t" class="nav">
         <p>Conceptos Generales Importantes</p>
         <ul>
@@ -693,6 +693,8 @@
           <li class="h2"><a href="#variables">Variables</a></li>
           <li class="h3"><a href="#examinar_y_ajustar_las_variables">Examinar y ajustar las variables</a></li>
           <li class="h3"><a href="#ganchos">Ganchos</a></li>
+          <li class="h3"><a href="#variables_locales">Variables locales</a></li>
+          <li class="h3"><a href="#variables_locales_en_archivos">Variables locales en archivos</a></li>
         </ul></li>
         </ul>
       </div>
@@ -29491,6 +29493,81 @@ en la variable hook. Puede borrar las funciones individuales llamando a <samp>re
 <p>
 Si la variable hook es buffer-local, se utilizará esta variable en lugar de la variable global. Sin embargo, si la variable buffer-local contiene el elemento <samp>t</samp>, la variable
 hook global se ejecutará también.
+</p>
+<h3 id="variables_locales">Variables locales<a href="#variables_locales"></a></h3>
+<dl>
+<dt><kbd>Alt</kbd>-<kbd>x</kbd> <samp>make-local-variable</samp> <kbd>RETURN</kbd> <i><samp>var</samp></i> <kbd>RETURN</kbd><br>(<samp>M-x make-local-variable RET</samp> <i><samp>var</samp></i>
+<samp>RET</samp>)</dt>
+<dd>
+Hace que la variable <i>var</i> tenga un valor local en el buffer actual.
+</dd>
+<dt><kbd>Alt</kbd>-<kbd>x</kbd> <samp>kill-local-variable</samp> <kbd>RETURN</kbd> <i><samp>var</samp></i> <kbd>RETURN</kbd><br>(<samp>M-x kill-local-variable RET</samp> <i><samp>var</samp></i>
+<samp>RET</samp>)</dt>
+<dd>
+Hace que la variable <i>var</i> utilice su valor global en el buffer actual.
+</dd>
+<dt><kbd>Alt</kbd>-<kbd>x</kbd> <samp>make-variable-buffer-local</samp> <kbd>RETURN</kbd> <i><samp>var</samp></i> <kbd>RETURN</kbd><br>(<samp>M-x make-variable-buffer-local RET</samp>
+<i><samp>var</samp></i> <samp>RET</samp>)</dt>
+<dd>
+Marca la variable <i>var</i> para que al establecerla se haga local en el buffer actual en ese momento.
+</dd>
+</dl>
+<p>
+Casi cualquier variable puede hacerse local a un búfer específico de <samp>Emacs</samp>. Esto significa que su valor en ese buffer es independiente de su valor en otros buffers. Unas
+pocas variables son siempre locales en cada buffer. Todas las demás variables del Editor tienen un valor global que está en vigor en todos los búferes que no han hecho local la
+variable.
+</p>
+<p>
+<kbd>Alt</kbd>-<kbd>x</kbd> <b><samp>make-local-variable</samp></b> (<samp>M-x make-local-variable</samp>) lee el nombre de una variable y la hace local en el buffer actual. El cambio de su
+valor posteriormente en este buffer no afectará a otros, y los cambios en su valor global no afectarán a este buffer.
+</p>
+<p>
+<kbd>Alt</kbd>-<kbd>x</kbd> <b><samp>make-variable-buffer-local</samp></b> (<samp>M-x make-variable-buffer-local</samp>) marca una variable para que se convierta en local automáticamente
+cada vez que se establezca. Más precisamente, una vez que una variable ha sido marcada de esta manera, las formas habituales de establecer la variable automáticamente primero hacen
+<samp>make-local-variable</samp>. A estas variables las llamamos variables <samp>per-buffer</samp>. Muchas variables en <samp>Emacs</samp> son normalmente per-buffer; la cadena de documento de
+la variable le dice cuando esto es así. El valor global de una variable por búfer normalmente no es efectivo en ningún búfer, pero sigue teniendo un significado: es el valor inicial
+de la variable para cada nuevo búfer.
+</p>
+<p>
+Los modos mayores (ver Modos Mayores) siempre hacen que las variables sean locales al buffer antes de establecer las variables. Por eso, cambiar los modos mayores en un búfer no
+tiene efecto en otros búferes. Los modos menores también funcionan estableciendo variables, normalmente, cada modo menor tiene una variable de control que no es nula cuando el modo
+está activado (ver Modos Menores). Para muchos modos menores, la variable de control es por búfer, y por lo tanto siempre es local al búfer. Si no, puede hacerla local en un búfer
+específico como cualquier otra variable.
+</p>
+<p>
+Unas pocas variables no pueden ser locales a un búfer porque siempre son locales a cada pantalla en su lugar (ver Múltiples pantallas). Si intenta hacer una de estas variables local
+en un buffer, obtendrá un mensaje de error.
+</p>
+<p>
+<kbd>Alt</kbd>-<kbd>x</kbd> <b><samp>kill-local-variable</samp></b> (<samp>M-x kill-local-variable</samp>) hace que una variable especificada deje de ser local al buffer actual. El valor
+global de la variable, a partir de ahora, está en vigor en este buffer. Al establecer el modo mayor se matan todas las variables locales del buffer excepto algunas variables
+especialmente marcadas como locales permanentes.
+</p>
+<p>
+Para establecer el valor global de una variable, independientemente de que la variable tenga un valor local en el buffer actual, se puede utilizar la construcción <samp>Lisp</samp>:
+<samp>setq-default</samp>. Esta construcción se utiliza igual que <samp>setq</samp>, pero establece los valores globales de las variables en lugar de sus valores locales (si los hay). Cuando
+el buffer actual tiene un valor local, el nuevo valor global puede no ser visible hasta que se cambie a otro buffer. He aquí un ejemplo:
+</p>
+<div class="pre"><pre>
+(setq-default fill-column 75)
+</pre></div>
+<p>
+<samp>setq-default</samp> es la única manera de establecer el valor global de una variable que ha sido marcada con <samp>make-variable-buffer-local</samp>.
+</p>
+<p>
+Los programas <samp>Lisp</samp> pueden utilizar <samp>default-value</samp> para consultar el valor por defecto de una variable. Esta función toma un símbolo como argumento y devuelve su
+valor por defecto. El argumento se evalúa; normalmente hay que citarlo explícitamente. Por ejemplo, así es como se obtiene el valor por defecto de <samp>fill-column</samp>:
+</p>
+<div class="pre"><pre>
+(default-value 'fill-column)
+</pre></div>
+<h3 id="variables_locales_en_archivos">Variables locales en archivos<a href="#variables_locales_en_archivos"></a></h3>
+<p>
+Un archivo puede especificar valores de variables locales para usar cuando se edita el archivo con <samp>Emacs</samp>. Al visitar el archivo o establecer un modo principal se comprueba
+si hay especificaciones de variables locales; automáticamente se convierten en variables locales del buffer y se establecen los valores especificados en el archivo.
+</p>
+<p>
+Las variables locales del archivo anulan las variables locales del directorio (ver Variables locales por directorio), si se especifica alguna para el directorio de un archivo.
 </p><br style="clear:both;"><label class="btn prev" accesskey="p" for="_paquetes_emacs_lisp" title="Paquetes Emacs Lisp">Anterior</label></div>
       <footer><hr><p>© Copyright Tano 2.023<br><small>Generated by <a href="https://gitlab.com/bztsrc/gendoc">gendoc</a> v1.0.0</small></p></footer>
     </div>

index.html

@@ -24,7 +24,7 @@
 <p>Trabajos <em>Finalizados:</em></p>
 <ul>
 <li>
-El Manejador de Ventanas <a href="./programas.html"><code>ì3</code></a>.
+Manejador de Ventanas <a href="./programas.html"><code>ì3</code></a>.
 </li><li>
 <a href="./archivos-gendoc/07_gendoc.html" target="_blank"><code>gendoc</code></a>: generador de Documentación.
 </li><li>