Correcciones a Javadoc

Author: sio2sio2

docs/98.apendices/99.tools/10-vscode.html

@@ -923,7 +923,7 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
 Además, <a class="reference internal" href="#code-runner"><span class="std std-ref">Code Runner</span></a> no atenderá a la jerarquía de  directorios creados por
 <a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-dependency">Project Manager for Java</a>.</p>
 </div>
-<p>Además de estas extensiones puede interesarnos añadir configuración adicional:</p>
+<p id="vscode-java-settings">Además de estas extensiones puede interesarnos añadir configuración adicional:</p>
 <div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
 <span class="w">   </span><span class="nt">&quot;files.exclude&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
 <span class="w">      </span><span class="nt">&quot;bin/&quot;</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">           </span><span class="c1">// No vemos el directorio de compilaciones (Project Manager)</span>
@@ -1055,7 +1055,8 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
 <div class="admonition note">
 <p class="admonition-title">Nota</p>
 <p>Y, posiblemente, también nos interese modificar el valor de
-<cite>files.exclude</cite> para incluir <code class="file docutils literal notranslate"><span class="pre">target/</span></code></p>
+<cite>files.exclude</cite> en <a class="reference internal" href="#vscode-java-settings"><span class="std std-ref">settings.json</span></a> para
+incluir <code class="file docutils literal notranslate"><span class="pre">target/</span></code></p>
 </div>
 <p>Además, es probable que queramos en algún momento generar documentación del
 proyecto con <a class="reference external" href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html">Javadoc</a> para ello debemos añadir al archivo <code class="file docutils literal notranslate"><span class="pre">pom.xml</span></code> el
@@ -1067,6 +1068,10 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
 <span class="w">            </span><span class="nt">&lt;artifactId&gt;</span>maven-javadoc-plugin<span class="nt">&lt;/artifactId&gt;</span>
 <span class="w">            </span><span class="cm">&lt;!-- La última versión puede consultarse en el repositorio de Maven --&gt;</span>
 <span class="w">            </span><span class="nt">&lt;version&gt;</span>3.10.0<span class="nt">&lt;/version&gt;</span>
+<span class="w">            </span><span class="nt">&lt;configuration&gt;</span>
+<span class="w">               </span><span class="nt">&lt;source&gt;</span>23<span class="nt">&lt;/source&gt;</span><span class="w"> </span><span class="cm">&lt;!-- Versión de Java. En mi caso, OpenJDK 23 --&gt;</span>
+<span class="w">               </span><span class="nt">&lt;show&gt;</span>private<span class="nt">&lt;/show&gt;</span><span class="w"> </span><span class="cm">&lt;!-- Muestra los atributos privados --&gt;</span>
+<span class="w">            </span><span class="nt">&lt;/configuracion&gt;</span>
 <span class="w">        </span><span class="nt">&lt;/plugin&gt;</span>
 <span class="w">    </span><span class="nt">&lt;/plugins&gt;</span>
 <span class="nt">&lt;/build&gt;</span>
@@ -1077,6 +1082,14 @@ <h2>Perfiles de desarrollo<a class="headerlink" href="#perfiles-de-desarrollo" t
 </pre></div>
 </div>
 <p>Se almacenará dentro de <code class="file docutils literal notranslate"><span class="pre">target/</span></code>.</p>
+<div class="admonition caution">
+<p class="admonition-title">Prudencia</p>
+<p>Si comprueba que la documentación no refleja algún cambio que se
+haya hecho en los comentarios, puede ejecutar a mano:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>mvn<span class="w"> </span>clean
+</pre></div>
+</div>
+</div>
 <div class="admonition seealso">
 <p class="admonition-title">Ver también</p>
 <p>Para más información, consulte <a class="reference external" href="https://maven.apache.org/plugins/maven-javadoc-plugin/usage.html">las explicaciones de Maven al

docs/_sources/98.apendices/99.tools/10-vscode.rst.txt

@@ -916,6 +916,8 @@ mientras que en *Windows* podemos utilizar los instalables que nos ofrece
    Además, :ref:`Code Runner <code-runner>` no atenderá a la jerarquía de  directorios creados por
    `Project Manager for Java`_.
 
+.. _vscode-java-settings:
+
 Además de estas extensiones puede interesarnos añadir configuración adicional:
 
 .. code-block:: json
@@ -1069,7 +1071,8 @@ este modo:
       }
 
    .. note:: Y, posiblemente, también nos interese modificar el valor de
-      `files.exclude` para incluir :file:`target/`
+      `files.exclude` en :ref:`settings.json <vscode-java-settings>` para
+      incluir :file:`target/`
 
    Además, es probable que queramos en algún momento generar documentación del
    proyecto con Javadoc_ para ello debemos añadir al archivo :file:`pom.xml` el
@@ -1084,6 +1087,10 @@ este modo:
                   <artifactId>maven-javadoc-plugin</artifactId>
                   <!-- La última versión puede consultarse en el repositorio de Maven -->
                   <version>3.10.0</version>
+                  <configuration>
+                     <source>23</source> <!-- Versión de Java. En mi caso, OpenJDK 23 -->
+                     <show>private</show> <!-- Muestra los atributos privados -->
+                  </configuracion>
               </plugin>
           </plugins>
       </build>
@@ -1096,6 +1103,13 @@ este modo:
 
    Se almacenará dentro de :file:`target/`.
 
+   .. caution:: Si comprueba que la documentación no refleja algún cambio que se
+      haya hecho en los comentarios, puede ejecutar a mano:
+
+      .. code-block:: console
+
+         $ mvn clean
+
    .. seealso:: Para más información, consulte `las explicaciones de Maven al
       respecto <https://maven.apache.org/plugins/maven-javadoc-plugin/usage.html>`_.
 

docs/objects.inv

@@ -916,6 +916,8 @@ mientras que en *Windows* podemos utilizar los instalables que nos ofrece
    Además, :ref:`Code Runner <code-runner>` no atenderá a la jerarquía de  directorios creados por
    `Project Manager for Java`_.
 
+.. _vscode-java-settings:
+
 Además de estas extensiones puede interesarnos añadir configuración adicional:
 
 .. code-block:: json
@@ -1069,7 +1071,8 @@ este modo:
       }
 
    .. note:: Y, posiblemente, también nos interese modificar el valor de
-      `files.exclude` para incluir :file:`target/`
+      `files.exclude` en :ref:`settings.json <vscode-java-settings>` para
+      incluir :file:`target/`
 
    Además, es probable que queramos en algún momento generar documentación del
    proyecto con Javadoc_ para ello debemos añadir al archivo :file:`pom.xml` el
@@ -1084,6 +1087,10 @@ este modo:
                   <artifactId>maven-javadoc-plugin</artifactId>
                   <!-- La última versión puede consultarse en el repositorio de Maven -->
                   <version>3.10.0</version>
+                  <configuration>
+                     <source>23</source> <!-- Versión de Java. En mi caso, OpenJDK 23 -->
+                     <show>private</show> <!-- Muestra los atributos privados -->
+                  </configuracion>
               </plugin>
           </plugins>
       </build>
@@ -1096,6 +1103,13 @@ este modo:
 
    Se almacenará dentro de :file:`target/`.
 
+   .. caution:: Si comprueba que la documentación no refleja algún cambio que se
+      haya hecho en los comentarios, puede ejecutar a mano:
+
+      .. code-block:: console
+
+         $ mvn clean
+
    .. seealso:: Para más información, consulte `las explicaciones de Maven al
       respecto <https://maven.apache.org/plugins/maven-javadoc-plugin/usage.html>`_.