Differences

This shows you the differences between two versions of the page.

--- en:docs:tk:som:sc:ug [2025/05/29 14:55] – [2. Appendix 2. Terminology changes] prokushev
+++ en:docs:tk:som:sc:ug [2025/06/05 12:39] (current) – prokushev
@@ Line 6: / Line 6: @@
 somFree Compiler and Emitter Framework is a free open source binary compatible reimplementation of IBM SOM Compiler and Emitter Framework. It is tries to be as compatible as possible on API and ABI level.
 ===== somFree Compiler =====
@@ Line 474: / Line 472: @@
 todo: add info about internal structures like in http://www.edm2.com/index.php/OS/2_Application_Binary_Interface_for_PowerPC_(32-bit)   http://www.os2site.com/sw/dev/info/abippc32.pdf
-===== 2. Appendix 2. Terminology changes =====
+===== 2. Appendix 2. Terminology changes and syntax construct evolution =====
 During SOM compiler evolution, some terms were changed and/or obsolete. Here is a table with terms mapping.
-| SOM 1.0 | SOM 2.0 | somFree |
+^ SOM 1.0 ^ SOM 2.0 ^ somFree ^
 | attribute | modifier | annotation |
 | group     | {obsolete} | {obsolete} |
-====== Список литературы ======
+IBM SOM 1.0 introduced Object Interface Definition Language (OIDL) which predates Interface Definition Language (IDL). It was a simple language which provided simple objects description. IBM SOM 2.0 switched to SOM IDL, which was an extended version of OMG IDL. SOM Compiler provided OIDL to IDL conversion tools. Because of moving to IDL, ''attribute'' were renamed to ''modifier'' and ''group'' obsolete. SOM IDL extensions mostly ''implementation'' section. Also ''#pragma'' statement was added. Modifiers now can be declared via ''#pragma modifier''. Some modifiers were only defined via ''#pragma''.
+somFree supports SOM IDL as found in IBM SOM 3.0.
+osFree somFree compiler tries to implement current IDL 4.2 Specification. It supports ''@annotation''. So, many constructions can be (and must be) implemented via standard and somFree specific annotations.
+OIDL
+<code>
+include <somobj.csc>;
+class Hello;
+method:
+  sayHello(string msg);
+passthru C:
+#define DEFAULT_MSG "Hello!"
+endpassthru;
+</code>
+SOM IDL
+<code idl>
+#include <somobj.idl>
+interface Hello
+{
+  implementation
+  {
+  }
+}
+</code>
+IDL 4.2
+<code idl>
+#include <somobj.idl>
+interface Hello
+{
+}
+</code>
+====== Bibliography ======
@@ Line 487: / Line 526: @@
   - IBM, "OS/2 2.0 Technical Library. System Object Model Guide and Reference. First Edition, 1991"  Available: https://www.os2museum.com/files/docs/os220tl/os2-2.0-som-1991.pdf
   - Object Management Group, "The Common Object Request Broker: Architecture and Specification. Revision 1.1, 1991" Available: https://www.omg.org/spec/CORBA/1.1
+  - Object Management Group, "Interface Definition Language™. Version 4.2, 2018" Available: https://www.omg.org/spec/IDL/4.2