[rules-dev] A checklist for Configuring Eclipse/IntelliJ is in the README.txt file

[Wolfgang Laun]

Hi Geoffrey,

I'm an absolute dummy when confronted with Eclipse. Thanks to your detailed
recipe, I found all the right buttons, tabs and what not, exactly as
described by you, but tabbing  didn't go away until I established a "project
specific setting" for Java -> CodeStyle -> Formatter, giving it a new name
("Drools" - what else), etc. Idiots like me might need an additional hint to
that effect.

-W


On 13 September 2010 14:43, Geoffrey De Smet <ge0ffrey.spam at gmail.com>wrote:

> I've documented a checklist for configuring eclipse and/or IntelliJ in
> the trunk/README.txt file. Feel free to change or expand it as you see fit.
>
> Please take a moment of your time to check this stuff, so you can avoid
> the following headaches:
> - tabs VS spaces (not just in java but also in XML): merge problems
> - encoding: wierd bugs (especially with translated text that contains ë,
> ç or €) + merge problems
> - line endings: wierd bugs (with regex find/replaces, ...) + merge problems
> - license correctly: legally
>
> Configuring Eclipse
> ===================
>
> Code style
> ----------
>
> Correct number of spaces for tabs:
> - Open menu "Window", menu item "Preferences".
> - Open tree item "Java", tree item "Code Style", tree item "Formatter".
> -- If you imported the trunk/eclipse-formatter.xml file,
>    you don't need to set it here,
>    but you do need to set it for XML anyway!
> -- Click button "Edit" of the active profile
> -- Tab "Indentation"
> --- Combobox "Tab policy": spaces only
> --- Indentation size: 4
> --- Tab size: 4
> -- If it is a build in profile, you need to change its name with the
> textfield on top
> - Open tree item "XML", tree item "XML Files", tree item "Editor".
> -- Radio button "Indent using space": on
> -- Indentation size: 2
>
> Correct file encoding (UTF-8 except for properties files) and EOL (unix):
> - Open menu "Window", menu item "Preferences".
> - Open tree item "General", tree item "Workspace".
> -- Label "Text file encoding", radiobutton "Other", combobox "UTF-8"
> -- Label "New text file delimiter", radiobutton "Other", combobox "Unix"
> - Open tree item "XML", tree item "XML Files".
> -- Combobox "Encoding": ISO 10646/Unicode(UTF-8)
> - Open tree item "CSS", tree item "CSS Files".
> -- Combobox "Encoding": ISO 10646/Unicode(UTF-8)
> - Open tree item "HTML", tree item "HTML Files".
> -- Combobox "Encoding": ISO 10646/Unicode(UTF-8)
> - Note: i18n properties files must be in ISO-8859-1 as specified by the
> java ResourceBundle contract.
>
> License header
> --------------
>
> Eclipse JEE Helios currently has no build-in support of license headers,
> but you can configure it for new files.
> - Open menu "Window", menu item "Preferences".
> - Open tree item "Java", tree item "Code Style", tree item "Copy
> templates".
> -- Open tree item "Comments", tree item "Files".
> -- Replace the text area with this:
> /*
>  * Copyright 2010 JBoss Inc
>  *
>  * Licensed under the Apache License, Version 2.0 (the "License");
>  * you may not use this file except in compliance with the License.
>  * You may obtain a copy of the License at
>  *
>  *       http://www.apache.org/licenses/LICENSE-2.0
>  *
>  * Unless required by applicable law or agreed to in writing, software
>  * distributed under the License is distributed on an "AS IS" BASIS,
>  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
>  * See the License for the specific language governing permissions and
>  * limitations under the License.
>  */
> -- Do not start or end with a newline character
> -- Update the year (2010) every year.
>
> Configuring IntelliJ
> ====================
>
> Code style
> ----------
>
> Correct number of spaces for tabs:
> - Open menu "File", menu item "Settings".
> - Open tree item "Code Style", tree item "General".
> - Open tab "Java"
> -- Checkbox "Use tab character": off
> -- Textfield "Tab size": 4
> -- Textfield "Indent": 4
> -- Textfield "Continuation indent": 8
> - Open tab "XML"
> -- Checkbox "Use tab character": off
> -- Textfield "Tab size": 2
> -- Textfield "Indent": 2
> -- Textfield "Continuation indent": 4
>
> Correct file encoding (UTF-8 except for properties files) and EOL (unix):
> - Open menu "File", menu item "Settings".
> - Open tree item "Code Style", tree item "General".
> -- Combobox "Line seperator (for new files)": Unix
> - Open tree item "File Encodings".
> -- Combobox "IDE Encoding": "UTF-8"
> -- Combobox "Default encoding for properties files": ISO-8859-1
>
> License header
> --------------
>
> - Open menu "File", menu item "Settings".
> - Open tree item "Copyright", tree item "Copyright profiles".
> - Add Copyright profile
> -- Textfield name: JBoss Inc
> -- Fill this into the text area:
> Copyright $today.year JBoss Inc
>
> Licensed under the Apache License, Version 2.0 (the "License");
> you may not use this file except in compliance with the License.
> You may obtain a copy of the License at
>
>       http://www.apache.org/licenses/LICENSE-2.0
>
> Unless required by applicable law or agreed to in writing, software
> distributed under the License is distributed on an "AS IS" BASIS,
> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
> See the License for the specific language governing permissions and
> limitations under the License.
> -- Do not start or end with a newline character
> - Open tree item "Copyright"
> -- Combobox "Default project copyright": JBoss Inc
>
> --
> With kind regards,
> Geoffrey De Smet
>
> _______________________________________________
> rules-dev mailing list
> rules-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/rules-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/rules-dev/attachments/20100915/b20ddefd/attachment-0001.html