This is an automated email from the ASF dual-hosted git repository.
vieiro pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-netbeans-website.git
The following commit(s) were added to refs/heads/master by this push:
new 675bc77 Updated numbering and formatting (#338)
675bc77 is described below
commit 675bc77f001e86c7b56a8fbe2b57ca9f661be996
Author: Brian Cowell <18...@users.noreply.github.com>
AuthorDate: Sat Mar 16 20:07:26 2019 +1100
Updated numbering and formatting (#338)
* Updated numbering and formatting
Corrected step numbering and formatting.
Added :experimental: attribute for keyboard graphics
* Removed top anchors
Removed top anchors <<top,top>>
---
.../kb/docs/java/editor-inspect-transform.asciidoc | 133 ++++++++++-----------
1 file changed, 63 insertions(+), 70 deletions(-)
diff --git a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc
index 6205a4d..4df1ec9 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc
@@ -28,6 +28,7 @@
:toc-title:
:description: Refactoring with Inspect and Transform in the NetBeans IDE Java Editor - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Refactoring with Inspect and Transform in the NetBeans IDE Java Editor
+:experimental:
The NetBeans IDE Java Editor features an Inspect and Transform feature, which is a refactoring tool for running various inspections and transformations on the selected scope of files at once. It also enables a user to define a custom inspection.
@@ -42,7 +43,7 @@ image::images/proj.png[]
== Running Inspections
-The Single Inspection option in the Inspect and Transform dialog box (Refactor > Inspect and Transform) offers a big variety of inspections related to particular refactoring transformations. The complete list of such operations is available in the Manage Inspections dialog box after clicking the Browse button to the right of the Single Inspection option.
+The *Single Inspection* option in the *Inspect and Transform* dialog box (*Refactor > Inspect and Transform*) offers a big variety of inspections related to particular refactoring transformations. The complete list of such operations is available in the *Manage Inspections* dialog box after clicking the *Browse* button to the right of the *Single Inspection* option.
[.feature]
--
@@ -56,26 +57,24 @@ The Search field enables you to check if a required inspection is available usin
image::images/search-small.png[role="left", link="images/search.png"]
--
-Every inspection is provided with a description available either in the Description field in the Manage Inspection dialog box.
+Every inspection is provided with a description available either in the Description field or in the *Manage Inspection dialog* box.
-*To run an inspection and apply an existing Inspection:*
+==== To run an inspection and apply an existing Inspection:
-1. In the Projects window, select the ``InspectTransform.java`` file.
-2. Choose Refactor > Inspect and Transform from the IDE's menu.
-3. In the Inspect and Transform dialog box, select the Single Inspection option and click Browse.
-4. In the Manage Inspections dialog box, choose the ``Assignment replaceable with operator-assignment`` inspection in the Assignment Issues node.
-5. Click OK to close the Manage Inspections dialog box.
-6. Click Inspect in the Inspect and Transform dialog box.
+. In the *Projects* window, select the `InspectTransform.java` file.
+. Choose *Refactor > Inspect and Transform* from the IDE's menu.
+. In the *Inspect and Transform* dialog box, select the *Single Inspection* option and click *Browse.*
+. In the *Manage Inspections* dialog box, choose the `Assignment replaceable with operator-assignment` inspection in the Assignment Issues node.
+. Click *OK* to close the *Manage Inspections* dialog box.
+. Click *Inspect* in the *Inspect and Transform* dialog box.
The suggested refactoring changes display in the preview panel.
-
++
[.feature]
--
image::images/single-inspection-small.png[role="left", link="images/single-inspection.png"]
--
-
-7. Click Do Refactoring to apply the changes if required.
-
-<<top,top>>
++
+. Click *Do Refactoring* to apply the changes if required.
== Using Configurations
@@ -97,7 +96,7 @@ The ``Migrate to JDK 5`` configuration available in the IDE by default incorpo
image::images/jdk5-conf-small.png[role="left", link="images/jdk5-conf.png"]
--
-NOTE: The list of refactorings in the configuration can be modified in the Inspections list of the Manage Inspections dialog box by selecting and deselecting the items under the ``JDK Migration Support`` node.
+NOTE: The list of refactorings in the configuration can be modified in the Inspections list of the *Manage Inspections* dialog box by selecting and deselecting the items under the `JDK Migration Support` node.
=== Migrate to JDK 7
@@ -108,22 +107,22 @@ The ``Migrate to JDK 7`` configuration available in the IDE by default incorpo
image::images/jdk7-conf-small.png[role="left", link="images/jdk7-conf.png"]
--
-NOTE: The list of refactorings in the configuration can be modified in the Inspections list of the Manage Inspections dialog box by selecting and deselecting the items under the ``JDK Migration Support`` node.
+NOTE: The list of refactorings in the configuration can be modified in the Inspections list of the *Manage Inspections* dialog box by selecting and deselecting the items under the `JDK Migration Support` node.
-*To run and apply the default ``Migrate to JDK 7`` configuration:*
+==== To run and apply the default ``Migrate to JDK 7`` configuration:
-1. In the Projects window, select the ``PredefinedSet.java`` file.
-2. Choose Refactor > Inspect and Transform from the IDE's menu.
-3. In the Inspect and Transform dialog box, select the Configuration option and choose the ``Migrate to JDK 7`` set of inspections from the drop-down list.
-4. Click Inspect.
+. In the *Projects* window, select the `PredefinedSet.java` file.
+. Choose *Refactor > Inspect* and *Transform* from the IDE's menu.
+. In the *Inspect and Transform* dialog box, select the *Configuration* option and choose the `Migrate to JDK 7` set of inspections from the drop-down list.
+. Click *Inspect*.
Changes that convert the code to JDK 7 syntax display in the preview panel.
-
++
[.feature]
--
image::images/jdk7-ref-small.png[role="left", link="images/jdk7-ref.png"]
--
-
-5. Click Do Refactoring to apply the changes if required.
++
+. Click *Do Refactoring* to apply the changes if required.
=== Migrate to JDK 8
@@ -134,7 +133,7 @@ The ``Migrate to JDK 8`` configuration available in the IDE by default incorpo
image::images/jdk8-conf-small.png[role="left", link="images/jdk8-conf.png"]
--
-NOTE: The list of refactorings in the configuration can be modified in the Inspections list of the Manage Inspections dialog box by selecting and deselecting the items under the ``JDK Migration Support`` node.
+NOTE: The list of refactorings in the configuration can be modified in the Inspections list of the *Manage Inspections* dialog box by selecting and deselecting the items under the `JDK Migration Support` node.
=== Organize Imports
@@ -142,91 +141,85 @@ The ``Organize Imports`` configuration enables you to inspect the way import s
NOTE: To configure the code style rules for import statements:
-1. Choose Tools > Options > Editor > Formatting in the main IDE toolbar.
-2. Select Java in the Language drop-down list.
-3. Select Imports in the Category drop-down list.
-4. Specify the available options as required.
-
+. Choose *Tools > Options > Editor > Formatting* in the main IDE toolbar.
+. Select *Java* in the Language drop-down list.
+. Select *Imports* in the *Category* drop-down list.
+. Specify the available options as required.
++
[.feature]
--
image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
--
++
+. Click *OK* to save your edits.
-5. Click OK to save your edits.
-
-*To run and apply the default ``Organize Imports `` configuration:*
-
-1. In the Projects window, select the ``Imports.java`` file.
-2. Choose Refactor > Inspect and Transform from the IDE's menu.
-3. In the Inspect and Transform dialog box, select the Configuration option and choose the ``Organize Imports`` item.
-4. Click Inspect.
-The preview panel displays one occurrence proposed for the Import section of the ``Imports.java`` file to make it aligned with the specified code style rules.
+==== To run and apply the default ``Organize Imports `` configuration:
+. In the *Projects* window, select the `Imports.java` file.
+. Choose *Refactor > Inspect and Transform* from the IDE's menu.
+. In the *Inspect and Transform* dialog box, select the Configuration option and choose the `Organize Imports` item.
+. Click *Inspect*.
+The preview panel displays one occurrence proposed for the Import section of the `Imports.java` file to make it aligned with the specified code style rules.
++
[.feature]
--
image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
--
-
-5. Click Do Refactoring to apply the changes if necessary.
-
-<<top,top>>
++
+. Click *Do Refactoring* to apply the changes if necessary.
== Managing Custom Inspections
A custom inspection can be created to instruct the IDE what code structures are to be found and how to transform them.
-NOTE: To avoid adding a duplicate inspection to the IDE, choose Refactor > Inspect and Transform from the main menu, click either Manage or Browse, and, in the Manage Inspections dialog box, use the Search field to look for the required inspection prior to creating a new inspection.
+NOTE: To avoid adding a duplicate inspection to the IDE, choose *Refactor > Inspect and Transform* from the main menu, click either *Manage* or *Browse*, and, in the *Manage Inspections* dialog box, use the *Search* field to look for the required inspection prior to creating a new inspection.
*To create a custom inspection:*
-1. Choose Refactor > Inspect and Transform from the IDE's menu.
-2. In the Inspect and Transform dialog box, click either Manage or Browse.
-3. In the Manage Inspections dialog box, click New.
-A ``Custom > Inspection`` node is created in the Inspections list.
-
+. Choose *Refactor > Inspect* and *Transform* from the IDE's menu.
+. In the *Inspect and Transform* dialog box, click either *Manage* or *Browse*.
+. In the *Manage Inspections* dialog box, click *New*.
+A `Custom > Inspection` node is created in the Inspections list.
++
[.feature]
--
image::images/custom-hint-small.png[role="left", link="images/custom-hint.png"]
--
-
-4. (Optional) Right-click ``Inspection`` , choose Rename from the popup menu, specify the name required for your custom inspection (for example, ``MyCustomInspection`` ), and press Enter.
-5. Click Edit Script. The Script text area displays.
-
++
+. (Optional) Right-click ``Inspection`` , choose Rename from the popup menu, specify the name required for your custom inspection (for example, ``MyCustomInspection`` ), and press Enter.
+. Click Edit Script. The Script text area displays.
++
[.feature]
--
image::images/script-small.png[role="left", link="images/script.png"]
--
-
-6. Type the inspection description and code in the Script text area or click Open in Editor and specify the same in the ``MyCustomInspection.hint`` file.
-
++
+. Type the inspection description and code in the Script text area or click Open in Editor and specify the same in the ``MyCustomInspection.hint`` file.
++
[.feature]
--
image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
--
-
-7. Click Save below the Script text area or press Ctrl-S in the Editor to save your edits.
-8. Click OK to close the Manage Inspections dialog box or close the ``MyCustomInspection.hint`` file in the Editor.
++
+. Click *Save* below the Script text area or press kbd:[Ctrl] + kbd:[S] in the Editor to save your edits.
+. Click *OK* to close the *Manage Inspections* dialog box or close the ``MyCustomInspection.hint`` file in the Editor.
Your custom inspection is done and ready to be applied.
*To run the custom inspection you created:*
-1. Choose Refactor > Inspect and Transform from the IDE's menu.
-2. In the Inspect list of the Inspect and Transform dialog box, specify a file, package, or project(s) to be inspected. Alternatively, click the button to the right to open the Custom Scope dialog box and specify the custom code to be inspected.
-3. Select the Single Inspection option and choose the ``MyCustomInspection`` inspection.
-
+1. Choose *Refactor > Inspect and Transform* from the IDE's menu.
+2. In the Inspect list of the *Inspect and Transform* dialog box, specify a file, package, or project(s) to be inspected. Alternatively, click the button to the right to open the *Custom Scope* dialog box and specify the custom code to be inspected.
+3. Select the *Single Inspection* option and choose the `MyCustomInspection` inspection.
++
[.feature]
--
image::images/mycustomhint-small.png[role="left", link="images/mycustomhint.png"]
--
-
-4. Click Inspect.
++
+4. Click *Inspect*.
The suggested refactoring changes display in the preview panel.
-5. Click Do Refactoring to apply the changes if required.
-
-<<top,top>>
+5. Click *Do Refactoring* to apply the changes if required.
== Summary
This tutorial covers most frequent usages of the Inspect and Transform feature. Please note that with the Inspect and Transform functionality you can also perform custom refactoring at project scope, or apply particular refactoring configurations to several projects open in the IDE, etc.
-
-<<top,top>>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists