Change the Default Format Settings in Eclipse

Do you get tired on constantly having to re-format your programming code? With a single press of Control+Shift+F, Eclipse will format your entire document for you. Follow the below steps to change the way Eclipse will format your document to your personal preferences.

Steps

  1. Have the Eclipse program open. Click the Window option in the top tool bar and then click Preferences.
  2. On the left side of the box, expand the Java option, then expand Code Style and finally click Formatter.
  3. The active profile should be set to “Eclipse [built-in]” you cannot edit this setting, so we will make a new one by clicking the “New...” button underneath.
  4. In the “profile name” pick a name that is significant to you so that you will remember what it is. The “Initialize setting with the following profile” option should have “Eclipse [built-in]” selected. And the “Open the edit dialog now” should also be selected. Now click “OK” to create your new format settings.
  5. You are now presented with the “Profile ‘name you selected’” box. There will be 8 tabs, named as follows:
    • Indentation
    • Braces
    • White space
    • Blank lines
    • New lines
    • Control statements
    • Line wrapping
    • Comments
      There will be an “Apply” and “OK” button at the bottom. You should make sure that you hit the “Apply” button every time you make a change so that it will know it is definitely saved and applied to your format settings.
  6. Refer to the picture at the right to see the INDENTATION TAB. Indentation is very important because it makes a program more readable if done properly. In the General Settings area, you can change the size of the tab, which you can set depending on whether you want to save space or if you want to differentiate the different sections more easily. According to coding conventions, you should leave all the boxes in the Indent section checked (Empty lines box does not matter). Do not forget to click Apply.
  7. Click on the BRACES TAB, and refer to the picture to the right if necessary. The braces settings are fairly simple and are based on personal preference. Most people either use the “Same line” or “Next line” position. You should use the same position for every option. Do not forget to click Apply.
  8. Click the WHITE SPACE TAB. Use the picture to the right for reference. Once again, this tab is for personal preference and ease of reading. There are many options to expand, read through and then select or deselect according to your preference on where you want a space (means one click of the space bar) to be added or removed. Do not forget to look in the preview window to see the change and click Apply often, seeing as there are many options in this tab.
  9. Click the BLANK LINES TAB and use the picture as a reference. This tab allows you to specify the number of blanks lines before or after different declarations. The standard is usually either 0 or 1 depending on the option. If you use more than 1 blank line, it is just wasting space. Choose the options according to you preference. Do not forget to select Apply.
  10. Look at the picture to the right and then click on the NEW LINES TAB. This tab is purely for user preference, so choose options as you desire. Do not forget to click Apply.
  11. Once again, the CONTROL STATEMENTS TAB is for your personal preference. Refer to the picture to the right, while selecting the boxes. The document is easily read with or without the added space after a control statement. To limit the length of your document leave the boxes unchecked. Do not forget to click Apply.
  12. Click the LINE WRAPPING TAB and see the picture to the right. In the “Line width and indentation levels” section choose how many characters wide your document can be and how wide you want the indent to be for the wrapping of the line(s). Below, click each option and choose the “Line wrapping policy” and “Indentation policy” accordingly. You want your document to have the littlest amount of wrapping as possible, so that it is easy to read. Do not forget to select Apply often, since there are a lot of options.
  13. The COMMENTS TAB is the last tab to set and the picture to the right is for reference. The options that begin with “Enable...” should be selected. The other options can be selected for personal preference. I also recommend selecting all the options that will “Remove blank lines.” Do not forget to click Apply.
  14. As an example, to show you how the format will work, there is a sample program (click on the picture at the right) shown with the formatting distorted (i.e. wrong indentation, extra spaces, etc.).
  15. To format the currently selected document, click on Source in the top tool bar and then click Format or as a shortcut you can click “Control + Shift + F”.
  16. Again, click on the picture to the right. Here you can see that the indentation has been restored, excess space has been removed and brackets are placed as per my preference. You document will not, necessarily look like mine as it will be based on your personal coding style preference.

Tips

  • When you click or unclick a setting the preview screen to the right will show you the change it will make to the format setting.
  • You should not go any smaller than a tab size of 2.
  • Do not be afraid to make changes as you can always restore the default settings.

Warnings

  • If you do not select Apply before closing the profile box all changes will be lost.

Things You'll Need

  • Computer
  • Source code written by you
  • Eclipse (Version used for this article: Eclipse SDK 3.4.1)

Related Articles

Sources and Citations

  • Eclipse SDK. [Software Download]. Portland, OR: The Eclipse Foundation, 2008. Available: http://www.eclipse.org.