Importing the Apache Format Template
+Return-Path:
+Provide a package specification with links to package wide specifications and APIs, that will +be helpful when reviewing the contained code. +
+Also provide pointers to external architecture/detailed design documents.
+ ++<html> +<!-- + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to you 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. +--> + +<!-- $Id: package.html 464373 2007-01-08 03:11:32Z ole $ --> + +<body> +<h2>Summary</h2> + +<p>This package contains Daemon scope <code>Runtime</code> implementations +that may be useful during the <code>startup</code> or <code>shutdown</code> +command execution of ApacheDS.</p> + +<h2>Package Specification</h2> +(Just an example - TODO More daemon appropriate example) +http://www.ipa.go.jp/security/rfc/RFC3377EN.html + +</body> +</html> ++ +]]> +
+/** + * @author <a href="mailto:dev@directory.apache.org">Apache Directory Project</a> + * + * The Daemon Class enables ApacheDS to run as a daemon on the UNIX like OSs. + * + */ +public class Daemon +{ + //Daemon code ... +} ++]]> +
+ /** + * Create a default trigger for the entry. + * Note that the method uses an anonymous inner class + * <code>DefaultTrigger<code> create the trigger. + * Override this method with your own trigger + * implementation to assign a custom trigger to the entry. + */ + public void createDefaultTrigger(){ + ... + } ++]]> +
+ /** + * Returns the current number of daemon threads + * @return int + */ + public int getThreads() { + return this.threads; + } + + /** + * Sets the number of Daemon processing threads + * + * @param int number of threads + */ + public void setThreads(int threads) { + this.threads = threads; + } + + /** + * Runs the Daemon + * + * @throws MonkeyWrenchException + * @todo Switch the implementation to <code>commons-exec</code> once it reaches the 1.0 release. + */ + public void run() throws MonkeyWrenchException { + + if(isMonkeyWrenchInCode() ) + throw new MonkeyWrenchException(monkeyWrench); + ...; + } + ++]]> +
+ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++]]> +
+ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++]]> +
+Provide a package specification with links to package wide specifications and APIs, that will +be helpful when reviewing the contained code. +
+Also provide pointers to external architecture/detailed design documents.
+ ++<html> +<!-- + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to you 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. +--> + +<!-- $Id: package.html 464373 2007-01-08 03:11:32Z ole $ --> + +<body> +<h2>Summary</h2> + +<p>This package contains Daemon scope <code>Runtime</code> implementations +that may be useful during the <code>startup</code> or <code>shutdown</code> +command execution of ApacheDS.</p> + +<h2>Package Specification</h2> +(Just an example - TODO More daemon appropriate example) +http://www.ipa.go.jp/security/rfc/RFC3377EN.html + +</body> +</html> ++ +]]> +
+ /** + * @author <a href="mailto:dev@directory.apache.org">Apache Directory Project</a> + * + * The Daemon Class enables ApacheDS to run as a daemon on the UNIX like OSs. + * + */ + public class Daemon + { + //Daemon code ... + } ++ ]]> +
+ /** + * Create a default trigger for the entry. + * Note that the method uses an anonymous inner class + * <code>DefaultTrigger<code> create the trigger. + * Override this method with your own trigger + * implementation to assign a custom trigger to the entry. + */ + public void createDefaultTrigger(){ + ... + } ++ ]]> +
+ /** + * Returns the current number of daemon threads + * @return int + */ + public int getThreads() { + return this.threads; + } + + /** + * Sets the number of Daemon processing threads + * + * @param int number of threads + */ + public void setThreads(int threads) { + this.threads = threads; + } + + /** + * Runs the Daemon + * + * @throws MonkeyWrenchException + * @todo Switch the implementation to <code>commons-exec</code> once it reaches the 1.0 release. + */ + public void run() throws MonkeyWrenchException { + + if(isMonkeyWrenchInCode() ) + throw new MonkeyWrenchException(monkeyWrench); + ...; + } + ++ ]]> +
+ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++ ]]> +
+ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++ ]]> +
+ + + + | +Import Format Template | +
+ + + + | +Import Code Template | +
+ + + + | +Package Level | +
+ + + + | +Class Level | +
+ + + + | +Anonymous Inner Classes | +
+ + + + | +Methods | +
+ + + + | +Constructors | +
+ + + + | +Fields | +
+ + + + | +Methods | +
+ + + + | +Constructors | +
+ + + + | +Fields | +
Importing the Apache Format Template
++ Window > Preferences > Java > Code Style > Formatter > Import +
++
Here is a link to the formatting.xml file formatting.xml
+ + ++ + + + | +Importing the Apache Code Template | +
Importing the Apache Code Template
++ Window > Preferences > Java > Code Style > Code Templates > Import. +
++
Here is a link to the codetemplates.xml file codetemplates.xml +
+ ++ + + + | +Importing the Apache Format Template | +
Creating a Package Level Javadoc Comment
++ Provide a description of what the package is used for and place it in package.html, along with the source files contained by the package. +
++ +
+Create a summary of the various classes contained in this package and their relationships. +
++Provide a package specification with links to package wide specifications and APIs, that will +be helpful when reviewing the contained code. +
+Also provide pointers to external architecture/detailed design documents.
+ ++<html> +<!-- + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to you 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. +--> + +<!-- $Id: package.html 464373 2007-01-08 03:11:32Z ole $ --> + +<body> +<h2>Summary</h2> + +<p>This package contains Daemon scope <code>Runtime</code> implementations +that may be useful during the <code>startup</code> or <code>shutdown</code> +command execution of ApacheDS.</p> + +<h2>Package Specification</h2> +(Just an example - TODO More daemon appropriate example) +http://www.ipa.go.jp/security/rfc/RFC3377EN.html + +</body> +</html> ++
Creating a Class Level Javadoc Comment
++ Provide a description of what this class is used for, and place it right above the code that declares the class. +
++ +
Include an author tag. See the code box below for an example. Note that the author tag should be copied as is in the code box. This is so that the code base stays "Neutral" with respect to various contributors working on it.
+ ++ /** + * @author <a href="mailto:dev@directory.apache.org">Apache Directory Project</a> + * + * The Daemon Class enables ApacheDS to run as a daemon on the UNIX like OSs. + * + */ + public class Daemon + { + //Daemon code ... + } ++ + + +
Creating Anonymous Inner Class Javadoc Comments
++ + Describe the use of the anonymous inner class in the javadoc comments of methods that use the inner class. + +
++ +
+ Javadoc ignores Anonymous inner class documentation. + If you are using anonymous inner classes, describe + the use of the anonymous inner class in the javadoc + comments of the methods that make use of the inner class. +
+ ++ /** + * Create a default trigger for the entry. + * Note that the method uses an anonymous inner class + * <code>DefaultTrigger<code> create the trigger. + * Override this method with your own trigger + * implementation to assign a custom trigger to the entry. + */ + public void createDefaultTrigger(){ + ... + } ++ + + +
Creating Method Javadoc Comments
++ Provide a description of what this method is used for, and place it right above the code that declares the method. +
++ +
+ Below are some examples. Note the use of: +
+ /** + * Returns the current number of daemon threads + * @return int + */ + public int getThreads() { + return this.threads; + } + + /** + * Sets the number of Daemon processing threads + * + * @param int number of threads + */ + public void setThreads(int threads) { + this.threads = threads; + } + + /** + * Runs the Daemon + * + * @throws MonkeyWrenchException + * @todo Switch the implementation to <code>commons-exec</code> once it reaches the 1.0 release. + */ + public void run() throws MonkeyWrenchException { + + if(isMonkeyWrenchInCode() ) + throw new MonkeyWrenchException(monkeyWrench); + ...; + } + ++ + + +
Creating Constructor Javadoc Comments
++ Provide a description of what the constructor is used for, and place it right above the code that declares the constructor. +
++ +
+ TODO +
+ ++ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++ + + +
Creating Field Javadoc Comments
++ Provide a description of what the Field is used for, and place it right above the code that declares the constructor. +
++ +
+ TODO +
+ ++ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++ + + +
February 12, 2007
++All content ("Content") in this plug-in is made available +by the The Apache Software Foundation. The Content is provided +under the terms and conditions of the Apache Public License Version 2.0 ("ASL") +unless otherwise indicated. A copy of the ASL can be obtained via the URL +http://www.apache.org/licenses/LICENSE-2.0.html. +
+ ++If the Content was obtained from a party other than the Apache Software Foundation, the Content is +being redistributed by that party ("Redistributor") and different terms and conditions may +apply to your use of any object code in the Content. +Contact the Redistributor or check the Redistributor's license if one was +provided with the Content. Unless otherwise +expressed below, the conditions and terms of the ASL still apply to any source code in the Content +and such source code may be obtained at http://www.apache.org. +
+ + + Added: directory/sandbox/oersoy/documentation.checklist.parent/documentation.checklist.test1/plugin.xml URL: http://svn.apache.org/viewvc/directory/sandbox/oersoy/documentation.checklist.parent/documentation.checklist.test1/plugin.xml?view=auto&rev=510342 ============================================================================== --- directory/sandbox/oersoy/documentation.checklist.parent/documentation.checklist.test1/plugin.xml (added) +++ directory/sandbox/oersoy/documentation.checklist.parent/documentation.checklist.test1/plugin.xml Wed Feb 21 17:54:52 2007 @@ -0,0 +1,14 @@ + + ++Provide a package specification with links to package wide specifications and APIs, that will +be helpful when reviewing the contained code. +
+Also provide pointers to external architecture/detailed design documents.
+ ++<html> +<!-- + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to you 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. +--> + +<!-- $Id: package.html 464373 2007-01-08 03:11:32Z ole $ --> + +<body> +<h2>Summary</h2> + +<p>This package contains Daemon scope <code>Runtime</code> implementations +that may be useful during the <code>startup</code> or <code>shutdown</code> +command execution of ApacheDS.</p> + +<h2>Package Specification</h2> +(Just an example - TODO More daemon appropriate example) +http://www.ipa.go.jp/security/rfc/RFC3377EN.html + +</body> +</html> ++
+ /** + * @author <a href="mailto:dev@directory.apache.org">Apache Directory Project</a> + * + * The Daemon Class enables ApacheDS to run as a daemon on the UNIX like OSs. + * + */ + public class Daemon + { + //Daemon code ... + } ++ ]]> +
+ /** + * Create a default trigger for the entry. + * Note that the method uses an anonymous inner class + * <code>DefaultTrigger<code> create the trigger. + * Override this method with your own trigger + * implementation to assign a custom trigger to the entry. + */ + public void createDefaultTrigger(){ + ... + } ++ ]]> +
+ /** + * Returns the current number of daemon threads + * @return int + */ + public int getThreads() { + return this.threads; + } + + /** + * Sets the number of Daemon processing threads + * + * @param int number of threads + */ + public void setThreads(int threads) { + this.threads = threads; + } + + /** + * Runs the Daemon + * + * @throws MonkeyWrenchException + * @todo Switch the implementation to <code>commons-exec</code> once it reaches the 1.0 release. + */ + public void run() throws MonkeyWrenchException { + + if(isMonkeyWrenchInCode() ) + throw new MonkeyWrenchException(monkeyWrench); + ...; + } + ++ ]]> +
+ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++ ]]> +
+ /** + * Default constructor for Daemon + * Sets the initial number of threads to 10. + */ + public Daemon() { + this.threads = 10; + } ++ ]]> +