sftemplateswizard/com.nokia.s60tools.templates.tests/data/templates/r_class_header_template.h
changeset 0 61163b28edca
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sftemplateswizard/com.nokia.s60tools.templates.tests/data/templates/r_class_header_template.h	Tue Jan 12 13:17:53 2010 -0600
@@ -0,0 +1,185 @@
+/*
+* ============================================================================
+*  Name        : ?filename.h
+*  Part of     : ?Subsystem_name / ?Module_name       *** Info from the SWAD
+*  Description : ?Description
+*  Version     : %version: % << Don't touch! Updated by Synergy at check-out.
+*
+*  Copyright © ?year-?year Nokia Corporation and/or its subsidiary(-ies).
+*  All rights reserved.
+*  This component and the accompanying materials are made available
+*  under the terms of the License "?License"
+*  which accompanies this distribution, and is available
+*  at the URL "?LicenseUrl".
+*
+*  Initial Contributors:
+*  ?Company_name - initial contribution.
+*
+*  Contributors:
+* 
+* ============================================================================
+* Template version: 4.2
+*/
+
+*** INSTRUCTIONS TO THE TEMPLATE USER:
+
+*** This template follows the S60 coding conventions
+*** (S60_Coding_Conventions.doc).  Remove all unneeded declarations
+*** and definitions before checking the file in!  Also remove the
+*** template's usage instructions, that is, everything that begins
+*** with "***".
+
+*** The copyright years should be < the year of the file's creation >
+*** - < the year of the file's latest update >.
+
+*** Words that begin with "?" are for you to replace with your own
+*** identifiers, filenames, or comments.  ?IMPORT_C means either the
+*** IMPORT_C visibility directive, or nothing, depending on whether
+*** the function is to be exported or not.
+
+*** To support building on Linux, use only forward slashes in include
+*** directives.  Also, all filenames and pathnames must be completely
+*** in lowercase.
+
+*** Indent four spaces per step, using spaces, not tabs, to display
+*** the code consistently across different editors.
+
+*** An R class denotes a client-side handle to a resource, owned typically by
+*** a Symbian OS server elsewhere on the device.  Generally R classes are
+*** instantiated either on the stack, or nested within C classes, then opened
+*** in some way, usually to a call such as Open() or Connect().  When they
+*** are finished with, it is essential to use the appropriate function to
+*** dispose of the class, usually Close().  An R class will derive from zero
+*** or one other R classes.
+
+
+#ifndef ?R_CLASSNAME_H
+#define ?R_CLASSNAME_H
+
+
+*** system include files go here:
+
+#include <?include_file>
+
+*** user include files go here:
+
+#include "?include_file"
+
+*** forward declarations go here:
+
+class ?forward_classname;
+
+*** external data types go here:
+
+/**  ?description */
+extern ?data_type;
+
+*** constants go here:
+
+/**  ?description */
+const ?type ?constant_var = ?constant;
+
+
+*** the class declaration goes here:
+
+/**
+ *  ?one_line_short_description
+ *
+ *  ?more_complete_description
+ *  @code
+ *   ?good_class_usage_example(s)
+ *  @endcode
+ *
+ *  @lib ?library
+ *  @since S60 ?S60_version *** for example, S60 v3.0
+ */
+class ?classname : public ?base_class_list
+    {
+
+*** friend classes go here:
+
+    friend class ?class1;
+    friend class ?class2;
+
+public:
+
+*** data types go here:
+
+    /**  ?description */
+    enum ?declaration
+
+    /**  ?description */
+    typedef ?declaration
+
+*** C++ constructors go here, starting with the default constructor:
+
+    ?classname();
+
+    /**
+     * Constructor.
+     *
+     * @since S60 ?S60_version
+     * @param ?arg1 ?description
+     * @param ?arg2 ?description
+     * @return ?description
+     */
+    ?classname( ?type1 ?arg1, ?type2 ?arg2 );
+
+*** member functions go here:
+
+    /**
+     * ?description
+     *
+     * @since S60 ?S60_version
+     * @param ?arg1 ?description
+     * @param ?arg2 ?description
+     * @return ?description
+     */
+    ?IMPORT_C ?type ?member_function( ?type1 ?arg1, ?type2 ?arg2 );
+
+// from base class ?base_class
+
+*** declarations of functions derived from base_class are grouped
+*** together here:
+
+    /**
+     * From ?base_class.
+     * ?description
+     *
+     * @since S60 ?S60_version
+     * @param ?arg1 ?description
+     */
+    ?IMPORT_C ?type ?member_function( ?type ?arg1 );
+
+protected:
+
+*** function declarations as above
+
+// from base class ?base_class
+
+*** function declarations as above
+
+private:
+
+*** private, non-derived functions go here; function declarations as above
+
+
+*** avoid the use of public or protected data; data should nearly
+*** always be accessed through getter and setter functions
+
+private: // data
+
+    /**
+     * ?description_of_member
+     */
+    ?type ?member_name;
+
+    };
+
+
+*** put the inline functions, if any, in a file included here:
+
+#include "?include_file.inl"
+
+
+#endif // ?R_CLASSNAME_H