diff --git a/basics/action_system.md b/basics/action_system.md index cf890c95a..c9aea4552 100644 --- a/basics/action_system.md +++ b/basics/action_system.md @@ -35,11 +35,11 @@ The ```AnActionEvent``` instance is also passed to the ```actionPerformed``` met ## Registering Actions -There are two main ways to register an action: either by listing it in the \ section of the plugin.xml file, or through Java code. +There are two main ways to register an action: either by listing it in the `` section of the plugin.xml file, or through Java code. ### Registering Actions in plugin.xml -Registering actions in plugin.xml is demonstrated in the following example. The example section of plugin.xml demonstrates all elements which can be used in the \ section, and describes the meaning of each element. +Registering actions in plugin.xml is demonstrated in the following example. The example section of plugin.xml demonstrates all elements which can be used in the `` section, and describes the meaning of each element. ```xml @@ -149,7 +149,7 @@ public class MyPluginRegistration implements ApplicationComponent { Note, that the sample ```TextBoxes``` class is described in [Getting Started with Plugin Development](/basics/getting_started.html). -To ensure that your plugin is initialized on IDEA start-up, make the following changes to the \ section of the plugin.xml file: +To ensure that your plugin is initialized on IDEA start-up, make the following changes to the `` section of the plugin.xml file: ```xml diff --git a/basics/architectural_overview/file_view_providers.md b/basics/architectural_overview/file_view_providers.md index c025f9731..233300052 100644 --- a/basics/architectural_overview/file_view_providers.md +++ b/basics/architectural_overview/file_view_providers.md @@ -35,7 +35,7 @@ bean class. To access this extension point, create a Java class that implements the [FileViewProviderFactory](https://github.com/JetBrains/intellij-community/blob/master/platform/core-api/src/com/intellij/psi/FileViewProviderFactory.java) interface, and in this class, override the ```createFileViewProvider``` method. -To declare the extension to the _fileType.fileViewProviderFactory_ extension point, to the \ section of the plugin.xml file, add the following syntax: +To declare the extension to the _fileType.fileViewProviderFactory_ extension point, to the `` section of the plugin.xml file, add the following syntax: ``` diff --git a/basics/getting_started/deploying_plugin.md b/basics/getting_started/deploying_plugin.md index e11a8f9f6..b50131d39 100644 --- a/basics/getting_started/deploying_plugin.md +++ b/basics/getting_started/deploying_plugin.md @@ -9,7 +9,7 @@ To deploy a plugin: * Make your project by invoking **Build \| Make Project**. * Prepare your plugin for deployment. - In the main menu, select **Build \| Prepare Plugin Module \ for Deployment**. + In the main menu, select **Build \| Prepare Plugin Module `` for Deployment**. ![Prepare Plugin for Deployment](deploying_plugin/img/prepare_plugin_for_deployment.png) diff --git a/basics/indexing_and_psi_stubs/file_based_indexes.md b/basics/indexing_and_psi_stubs/file_based_indexes.md index 8d80bf0d2..3134925df 100644 --- a/basics/indexing_and_psi_stubs/file_based_indexes.md +++ b/basics/indexing_and_psi_stubs/file_based_indexes.md @@ -26,7 +26,7 @@ Refer to it as an example to understand this topic better. Each specific index implementation is a class extending [FileBasedIndexExtension](https://github.com/JetBrains/intellij-community/blob/master/platform/indexing-api/src/com/intellij/util/indexing/FileBasedIndexExtension.java). -A file-base index should be registered in the \ extension point. +A file-base index should be registered in the `` extension point. The implementation of a file-based contains of the following main parts: diff --git a/basics/plugin_structure/plugin_components.md b/basics/plugin_structure/plugin_components.md index 36d83b170..4185f1e9a 100644 --- a/basics/plugin_structure/plugin_components.md +++ b/basics/plugin_structure/plugin_components.md @@ -43,7 +43,7 @@ The name of a component is returned by its ```getComponentName()``` method. ### Components Naming Notation -It is recommended to name components in \.\ form. +It is recommended to name components in `.` form. ### Application Level Components @@ -115,7 +115,7 @@ Note that module-level components must be registered in the ``` section of the `plugin.xml` file. +The IDEA interface will help you declare the module component's implementation class, and will automatically make appropriate changes to the `` section of the `plugin.xml` file. *To create and register a module component* @@ -158,9 +158,9 @@ For more information and samples, refer to ### Defaults -The defaults (components' predefined settings) should be placed in the *\.xml* file. +The defaults (components' predefined settings) should be placed in the `.xml` file. Place this file in the plugin's classpath in the folder corresponding to the default package. -The ```readExternal()``` method will be called on the \ root tag. +The ```readExternal()``` method will be called on the `` root tag. If a component has defaults, the ```readExternal()``` method is called twice: diff --git a/basics/plugin_structure/plugin_dependencies.md b/basics/plugin_structure/plugin_dependencies.md index a4e0dd7e8..c855ef55a 100644 --- a/basics/plugin_structure/plugin_dependencies.md +++ b/basics/plugin_structure/plugin_dependencies.md @@ -8,11 +8,11 @@ In order to do so, you need to perform the following two steps: * Add the jars of the plugin you're depending on to the classpath of your *IntelliJ Platform SDK*. **Note**: Don't add the plugin jars as a library: this will fail at runtime because IntelliJ Platform will load two separate copies of the dependency plugin classes. -* Add a \ tag to your plugin.xml, adding the ID of the plugin you're depending on as the contents of the tag. +* Add a `` tag to your plugin.xml, adding the ID of the plugin you're depending on as the contents of the tag. For example: ```xml org.jetbrains.idea.maven ``` -To find out the ID of the plugin you're depending on, locate the META-INF/plugin.xml file inside its jar and check the contents of the \ tag. +To find out the ID of the plugin you're depending on, locate the META-INF/plugin.xml file inside its jar and check the contents of the `` tag. diff --git a/basics/plugin_structure/plugin_extensions_and_extension_points.md b/basics/plugin_structure/plugin_extensions_and_extension_points.md index 5d84b7c9e..d54e6205d 100644 --- a/basics/plugin_structure/plugin_extensions_and_extension_points.md +++ b/basics/plugin_structure/plugin_extensions_and_extension_points.md @@ -56,17 +56,17 @@ public class MyBeanClass1 extends AbstractExtensionPointBean { } ``` -Note that to declare an extension designed to access the MyExtensionPoint1 extension point, your plugin.xml file must contain the \ tag with the "key" and "implementationClass" attributes set to appropriate values (see the sample plugin.xml file below). +Note that to declare an extension designed to access the MyExtensionPoint1 extension point, your plugin.xml file must contain the `` tag with the "key" and "implementationClass" attributes set to appropriate values (see the sample plugin.xml file below). *To declare an extension* -1. For the \ element, set the *xmlns* (deprecated) or *defaultExtensionNs* attribute to one of the following values: +1. For the `` element, set the *xmlns* (deprecated) or *defaultExtensionNs* attribute to one of the following values: * _com.intellij_, if your plugin extends the IDEA core functionality. * _ID of a plugin_, if your plugin extends a functionality of another plugin. -2. Add a new child element to the \ element. +2. Add a new child element to the `` element. The child element name must match the name of the extension point you want the extension to access. 3. Depending on the type of the extension point, do one of the following: @@ -97,7 +97,7 @@ To clarify this procedure, consider the following sample section of the plugin.x ## How to Get the Extension Points List? -To get a list of extension points available in the *IntelliJ Platform* core, consult the _\_ section of the following XML configuration files: +To get a list of extension points available in the *IntelliJ Platform* core, consult the `` section of the following XML configuration files: * [LangExtensionPoints.xml](https://github.com/JetBrains/intellij-community/blob/master/platform/platform-resources/src/META-INF/LangExtensionPoints.xml) diff --git a/basics/plugin_structure/plugin_services.md b/basics/plugin_structure/plugin_services.md index 8f9e40f83..3e284571f 100644 --- a/basics/plugin_structure/plugin_services.md +++ b/basics/plugin_structure/plugin_services.md @@ -23,7 +23,7 @@ To declare a service, you can use the following extension points in the IDEA cor *To declare a service:* -1. Add the appropriate child element (\, \ or \) to the \ section of the plugin.xml file. +1. Add the appropriate child element (``, `` or ``) to the `` section of the plugin.xml file. 2. For the newly added child element, set the following attributes: diff --git a/basics/project_structure.md b/basics/project_structure.md index 31e167902..eef833f86 100644 --- a/basics/project_structure.md +++ b/basics/project_structure.md @@ -35,7 +35,7 @@ A _library_ is an archive of compiled code (such as JAR files) that your modules * **Project Library**: the library classes are visible within the project and the library information is recorded in the project \*.ipr file or in _.idea/libraries_. -* **Global Library**: the library information is recorded in the _applicationLibraries.xml_ file into the \/.IntelliJIdea/config/options_ directory. Global libraries are similar to project libraries, but are visible for the different projects. +* **Global Library**: the library information is recorded in the _applicationLibraries.xml_ file into the `/.IntelliJIdea/config/options` directory. Global libraries are similar to project libraries, but are visible for the different projects. For more information about libraries, refer to [Library](http://www.jetbrains.com/idea/webhelp/library.html). diff --git a/basics/run_configurations/run_configuration_management.md b/basics/run_configurations/run_configuration_management.md index 33de17ebb..a45d5913a 100644 --- a/basics/run_configurations/run_configuration_management.md +++ b/basics/run_configurations/run_configuration_management.md @@ -127,7 +127,7 @@ In your implementation of ```getRefactoringElementListener()```, you need to che Many plugins support automatic creation of run configurations from context, so that the user can click, for example, on an application or test class and automatically run it using the correct run configuration type. In order to support that, you need to provide an implementation of the [RunConfigurationProducer](https://github.com/JetBrains/intellij-community/blob/master/platform/lang-api/src/com/intellij/execution/actions/RunConfigurationProducer.java) -interface and to register it as \ in your plugin.xml. +interface and to register it as `` in your plugin.xml. (Note that this API has been redesigned in IntelliJ IDEA 13; ```RuntimeConfigurationProducer``` is an older and much more confusing version of the same API). The two main methods that you need to implement are: diff --git a/drafts/project_model.md b/drafts/project_model.md index 1db202abf..d2165d400 100644 --- a/drafts/project_model.md +++ b/drafts/project_model.md @@ -32,7 +32,7 @@ IntelliJ IDEA supports three types of libraries: * **Module Library**: the library classes are visible only in this module and the library information is recorded in the module *.iml file. * **Project Library**: the library classes are visible within the project and the library information is recorded in the project *.ipr file or in .idea/libraries. -* **Global Library**: the library information is recorded in the applicationLibraries.xml file into the \/.IntelliJIdea/config/options directory. Global libraries are similar to project libraries, but are visible for the different projects. +* **Global Library**: the library information is recorded in the applicationLibraries.xml file into the `/.IntelliJIdea/config/options` directory. Global libraries are similar to project libraries, but are visible for the different projects. For more information about libraries, refer to [Library] (http://www.jetbrains.com/idea/webhelp/library.html). diff --git a/reference_guide/frameworks_and_external_apis/external_builder_api.md b/reference_guide/frameworks_and_external_apis/external_builder_api.md index e5979eb32..63acb5382 100644 --- a/reference_guide/frameworks_and_external_apis/external_builder_api.md +++ b/reference_guide/frameworks_and_external_apis/external_builder_api.md @@ -50,7 +50,7 @@ mechanism to support plugins. There are several service interfaces (e.g. `Builde ### Registering a plugin for External Builder -Sources of a plugin for External Builder should be put in a separate module. By convention such module has name '...-jps-plugin' and its sources are placed under 'jps-plugin' directory in the main plugin directory. Use \ extension to add the plugin to classpath of external build process, the plugin jar should be named \.jar. 'Build' | 'Prepare Plugin Module for deployment' action will automatically pack 'jps-plugin' part to a separate jar accordingly. +Sources of a plugin for External Builder should be put in a separate module. By convention such module has name '...-jps-plugin' and its sources are placed under 'jps-plugin' directory in the main plugin directory. Use `` extension to add the plugin to classpath of external build process, the plugin jar should be named `.jar`. 'Build' | 'Prepare Plugin Module for deployment' action will automatically pack 'jps-plugin' part to a separate jar accordingly. ### Debugging a plugin for External Builder @@ -73,7 +73,7 @@ The build process has built-in self-cpu-profiling capabilities. To enable them d 3. Make sure automatic make is turned off -After this every build process run should result in a CPU snapshot stored in \/Snapshots directory. +After this every build process run should result in a CPU snapshot stored in ``/Snapshots directory. Snapshots are named like "ExternalBuild\-\{date\}.snapshot". Specifying `-Dprofiling.mode=false` will turn profiling off. diff --git a/reference_guide/project_model/library.md b/reference_guide/project_model/library.md index a221a3a7d..c8624a384 100644 --- a/reference_guide/project_model/library.md +++ b/reference_guide/project_model/library.md @@ -7,7 +7,7 @@ IntelliJ IDEA supports three types of libraries: * **Module Library**: the library classes are visible only in this module and the library information is recorded in the module *.iml file. * **Project Library**: the library classes are visible within the project and the library information is recorded in the project *.ipr file or in .idea/libraries. -* **Global Library**: the library information is recorded in the applicationLibraries.xml file into the \/.IntelliJIdea/config/options directory. Global libraries are similar to project libraries, but are visible for the different projects. +* **Global Library**: the library information is recorded in the applicationLibraries.xml file into the `/.IntelliJIdea/config/options` directory. Global libraries are similar to project libraries, but are visible for the different projects. For more information about libraries, refer to [Library](http://www.jetbrains.com/idea/webhelp/library.html). diff --git a/tutorials/action_system/grouping_action.md b/tutorials/action_system/grouping_action.md index ef84590a1..01ac6c97d 100644 --- a/tutorials/action_system/grouping_action.md +++ b/tutorials/action_system/grouping_action.md @@ -7,7 +7,7 @@ In this case the group will be available as a top-level menu item, action will b ### 2.1. Creating simple action groups -Grouping can be done by extending adding *\* attribute to *\* +Grouping can be done by extending adding `` attribute to `` [plugin.xml](https://github.com/JetBrains/intellij-sdk/blob/master/code_samples/register_actions/META-INF/plugin.xml) file. @@ -181,7 +181,7 @@ public class BaseActionGroup extends ActionGroup { ### 2.12. Registering variable action group -To register the group *\* attribute needs to be placed in the *\* section of +To register the group `` attribute needs to be placed in the *``* section of [plugin.xml](https://github.com/JetBrains/intellij-sdk/blob/master/code_samples/register_actions/META-INF/plugin.xml): ```xml @@ -194,7 +194,7 @@ To register the group *\* attribute needs to be placed in the *\* attribute contains any static action definition an exception will be thrown. +If `` attribute contains any static action definition an exception will be thrown. For statically defined group of action use [DefaultActionGroup.java](https://github.com/JetBrains/intellij-community/blob/master/platform/platform-api/src/com/intellij/openapi/actionSystem/DefaultActionGroup.java) diff --git a/tutorials/action_system/working_with_custom_actions.md b/tutorials/action_system/working_with_custom_actions.md index 31be87178..96c8fae4f 100644 --- a/tutorials/action_system/working_with_custom_actions.md +++ b/tutorials/action_system/working_with_custom_actions.md @@ -41,7 +41,7 @@ public class SimpleAction extends AnAction { ### 1.3. Registering actions -To register a newly created action, *\* attribute should be added to the *\* section of the plugin configuration file +To register a newly created action, `` attribute should be added to the `` section of the plugin configuration file [plugin.xml](https://github.com/JetBrains/intellij-sdk/blob/master/code_samples/register_actions/META-INF/plugin.xml). IntelliJ IDEA has an embedded inspection that spots unregistered actions. !["Action never used" inspection](img/action_never_used.png) @@ -54,7 +54,7 @@ visual position of the menu item the action is bound to, and a shortcut for invo In our case the action will be available in the **Tools Menu**, it will be placed on top, and will have no shortcuts. !["Register action" quick fix](img/new_action.png) -After filling the **New Action** form and applying the changes *\* section of our +After filling the **New Action** form and applying the changes `` section of our [plugin.xml](https://github.com/JetBrains/intellij-sdk/blob/master/code_samples/register_actions/META-INF/plugin.xml) file will look like this: diff --git a/tutorials/editor_basics/working_with_text.md b/tutorials/editor_basics/working_with_text.md index 38cfac92a..1f5768ac8 100644 --- a/tutorials/editor_basics/working_with_text.md +++ b/tutorials/editor_basics/working_with_text.md @@ -23,7 +23,7 @@ public class EditorIllustration extends AnAction { ### 1.1.2. Registering an action -To register the action we should add a corresponding attribute to the *\* section of the plugin configuration file +To register the action we should add a corresponding attribute to the `` section of the plugin configuration file [plugin.xml](https://github.com/JetBrains/intellij-sdk/blob/master/code_samples/editor_basics/resources/META-INF/plugin.xml) diff --git a/tutorials/framework.md b/tutorials/framework.md index b320879d3..268c7adac 100644 --- a/tutorials/framework.md +++ b/tutorials/framework.md @@ -18,7 +18,7 @@ public class DemoFramework extends FrameworkTypeEx { ## 2. Registering framework -The newly created framework should be registered as an extension point by putting *framework.type* attribute into *\* section of +The newly created framework should be registered as an extension point by putting *framework.type* attribute into `` section of [plugin.xml](https://github.com/JetBrains/intellij-sdk/blob/master/code_samples/framework/META-INF/plugin.xml) configuration file: