version 1.8, 2001/12/27 16:56:49
|
version 1.14, 2001/12/31 13:13:57
|
|
|
| |
|
|
1. Indent four spaces (not three and not tabs). | 1. Indent four spaces (not three and not tabs). |
| |
2. Literals used (other than 0 or 1). | 2. Literals used (other than 0 or 1). |
|
|
| |
"+++++ passed all tests" | "+++++ passed all tests" |
| |
|
SOME TESTS TAKE A LONG TIME TO RUN AND NEED TO PRINT IMTERMEDIATE OUTPUT SO THE |
|
DEVELOPER DOES NOT THINK THE TEST IS HANGED. |
|
|
Extraneous output should be removed. | Extraneous output should be removed. |
| |
7. All defined constants must begin with "PEGASUS_". | 7. All defined constants must begin with "PEGASUS_". |
|
|
8. All method must use the form myMethodName(). Many places | 8. All method must use the form myMethodName(). Many places |
have my_method_name() (with underscores). | have my_method_name() (with underscores). |
| |
9. Avoid use of (void). Use () instead. |
9. Avoid use of (void). Use () instead. WHY? |
| |
10. Either get rid of throw() declarations or use them | 10. Either get rid of throw() declarations or use them |
everywhere (perhaps they are not supported by some compilers). | everywhere (perhaps they are not supported by some compilers). |
| |
11. Avoid indenting "private:", "public:" and "protected". Use this | 11. Avoid indenting "private:", "public:" and "protected". Use this |
style: |
style: WHY? |
| |
class X | class X |
{ | { |
|
|
public: | public: |
}; | }; |
| |
12. Use "Type* x" rather than "Type *x". |
12. Use "Type* x" rather than "Type *x". WHY? |
| |
13. Use "if (" rather than "if(". |
13. Use "if (" rather than "if(". WHY? |
| |
14. Avoid use of spaces around the condition: |
14. Avoid use of spaces around the condition: WHY? |
| |
if( cond ) | if( cond ) |
| |
15. Keep all lines within 80 columns. | 15. Keep all lines within 80 columns. |
| |
16. Build fails on many Linux system (threading support problems). |
16. Build fails on many Linux system (threading support problems). WHICH ONES ? |
| |
17. SSL is the default on Linux (is this okay?). | 17. SSL is the default on Linux (is this okay?). |
| |
|
|
| |
21. Get rid of CIMIndication class. | 21. Get rid of CIMIndication class. |
| |
22. Revise licensing headers on all files. |
22. Revise licensing headers on all files. BE CAREFUL NOT TO CHANGE LICENSE AGREEMENT |
| |
23. Add $Log$ |
23. Add Log CVS directives. |
23. Add Revision 1.8 2001/12/27 16:56:49 mike |
|
23. Add Added more review comments. |
|
23. Add CVS directives to each file. |
|
| |
24. Avoid inlining of large functions. | 24. Avoid inlining of large functions. |
| |
25. FInd decent code formatter. |
25. Find decent code formatter. |
|
|
|
26. Revisit use of bit masks in provider interfaces. |
|
|
|
27. Revisit provider loading/manager etc. |
|
|
|
28. Consolidate CIMOM handles. |
|
|
|
29. Get rid of directories containing .old extensions. |
|
|
|
30. Use constant global queue ids as described in MessagQueue.h |
|
docs. USE META DISPATCHER TO FIND QUEUES. CONSTANT IDS LIMIT QUEUES |
|
TO ONE OF EACH PREDEFINED TYPE. |
|
|
|
31. Is the Facade class necessary. |
|
|
|
32. Response handler need not have to action methods (for single |
|
and multiple objects). WHY CREATE AN ARRAY OBJECT THAT WILL ONLY HOLD ONE CIM OBJECT? |
|
TOO MUCH OVERHEAD. HAVING A DUAL INTERFACE IS AN IMPORTANT OPTIMIZATION. |
|
|
|
33. Clean up warnings on NT. |
|
|
|
34. Use Linkage.h files everywhere. |
|
|
|
35. Need to add notifiers (using message queue observer scheme). USE META DISPATCHER INSTEAD |
|
|
|
36. Need to define services's interface to CIMOM. |
|
|
|
37. Finalize the client interface (SDK). |
|
|