From 57177e12e5682c74b8f977f4b3a2f5aececc4b52 Mon Sep 17 00:00:00 2001 From: Niclas Eklund Date: Thu, 4 Feb 2010 13:45:20 +0000 Subject: Removed the usage of the codeinclude tag in the documentation. --- lib/cosEvent/doc/src/CosEventChannelAdmin.xml | 26 ++-- lib/cosEvent/doc/src/notes.xml | 18 ++- lib/cosEvent/vsn.mk | 3 +- lib/orber/doc/src/CosNaming.xml | 26 ++-- lib/orber/doc/src/Makefile | 11 +- lib/orber/doc/src/ch_example.xml | 170 -------------------------- lib/orber/doc/src/example_part.xml | 25 ++-- lib/orber/doc/src/make.dep | 9 +- lib/orber/doc/src/notes.xml | 6 + lib/orber/doc/src/part.xml | 7 +- lib/orber/vsn.mk | 3 +- 11 files changed, 67 insertions(+), 237 deletions(-) delete mode 100644 lib/orber/doc/src/ch_example.xml diff --git a/lib/cosEvent/doc/src/CosEventChannelAdmin.xml b/lib/cosEvent/doc/src/CosEventChannelAdmin.xml index 25f2dc805b..c599a92ff1 100644 --- a/lib/cosEvent/doc/src/CosEventChannelAdmin.xml +++ b/lib/cosEvent/doc/src/CosEventChannelAdmin.xml @@ -4,23 +4,21 @@
- 1997 - 2007 - Ericsson AB, All Rights Reserved + 19972010 + Ericsson AB. All Rights Reserved. - The contents of this file are subject to the Erlang Public License, - Version 1.1, (the "License"); you may not use this file except in - compliance with the License. You should have received a copy of the - Erlang Public License along with this software. If not, it can be - retrieved online at http://www.erlang.org/. + The contents of this file are subject to the Erlang Public License, + Version 1.1, (the "License"); you may not use this file except in + compliance with the License. You should have received a copy of the + Erlang Public License along with this software. If not, it can be + retrieved online at http://www.erlang.org/. - Software distributed under the License is distributed on an "AS IS" - basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See - the License for the specific language governing rights and limitations - under the License. + Software distributed under the License is distributed on an "AS IS" + basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See + the License for the specific language governing rights and limitations + under the License. - The Initial Developer of the Original Code is Ericsson AB. CosEventChannelAdmin @@ -73,8 +71,6 @@ SupplierAdmin EventChannel -

IDL specification for CosEventChannelAdmin:

- diff --git a/lib/cosEvent/doc/src/notes.xml b/lib/cosEvent/doc/src/notes.xml index 8cd7b9dd48..78299a38dc 100644 --- a/lib/cosEvent/doc/src/notes.xml +++ b/lib/cosEvent/doc/src/notes.xml @@ -4,7 +4,7 @@
- 19992009 + 19992010 Ericsson AB. All Rights Reserved. @@ -13,12 +13,12 @@ compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. - + Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. - + cosEvent Release Notes @@ -35,6 +35,18 @@
cosEvent 2.1.8 +
+ Improvements and New Features + + +

+ Removed the usage of the codeinclude tag in the documentation.

+

+ Own Id: OTP-8409 Aux Id:

+ + +
+
Fixed Bugs and Malfunctions diff --git a/lib/cosEvent/vsn.mk b/lib/cosEvent/vsn.mk index 7c908d1c5d..8915903bbe 100644 --- a/lib/cosEvent/vsn.mk +++ b/lib/cosEvent/vsn.mk @@ -1,7 +1,8 @@ COSEVENT_VSN = 2.1.8 -TICKETS = OTP-8355 +TICKETS = OTP-8355 \ + OTP-8409 TICKETS_2.1.7 = OTP-8201 diff --git a/lib/orber/doc/src/CosNaming.xml b/lib/orber/doc/src/CosNaming.xml index db087aedb1..e8c639b59a 100644 --- a/lib/orber/doc/src/CosNaming.xml +++ b/lib/orber/doc/src/CosNaming.xml @@ -4,23 +4,21 @@
- 1997 - 2007 - Ericsson AB, All Rights Reserved + 19972010 + Ericsson AB. All Rights Reserved. - The contents of this file are subject to the Erlang Public License, - Version 1.1, (the "License"); you may not use this file except in - compliance with the License. You should have received a copy of the - Erlang Public License along with this software. If not, it can be - retrieved online at http://www.erlang.org/. + The contents of this file are subject to the Erlang Public License, + Version 1.1, (the "License"); you may not use this file except in + compliance with the License. You should have received a copy of the + Erlang Public License along with this software. If not, it can be + retrieved online at http://www.erlang.org/. - Software distributed under the License is distributed on an "AS IS" - basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See - the License for the specific language governing rights and limitations - under the License. + Software distributed under the License is distributed on an "AS IS" + basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See + the License for the specific language governing rights and limitations + under the License. - The Initial Developer of the Original Code is Ericsson AB. CosNaming @@ -66,8 +64,6 @@ typedef sequence BindingList; NamingContext BindingIterator -

IDL specification for CosNaming:

- diff --git a/lib/orber/doc/src/Makefile b/lib/orber/doc/src/Makefile index c82db49c9b..b8e26d5ba3 100644 --- a/lib/orber/doc/src/Makefile +++ b/lib/orber/doc/src/Makefile @@ -1,19 +1,19 @@ # # %CopyrightBegin% -# -# Copyright Ericsson AB 1997-2009. All Rights Reserved. -# +# +# Copyright Ericsson AB 1997-2010. All Rights Reserved. +# # The contents of this file are subject to the Erlang Public License, # Version 1.1, (the "License"); you may not use this file except in # compliance with the License. You should have received a copy of the # Erlang Public License along with this software. If not, it can be # retrieved online at http://www.erlang.org/. -# +# # Software distributed under the License is distributed on an "AS IS" # basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See # the License for the specific language governing rights and limitations # under the License. -# +# # %CopyrightEnd% # # @@ -74,7 +74,6 @@ XML_CHAPTER_FILES = \ ch_ifr.xml \ ch_install.xml \ ch_idl_to_erlang_mapping.xml \ - ch_example.xml \ ch_naming_service.xml \ ch_stubs.xml \ ch_security.xml \ diff --git a/lib/orber/doc/src/ch_example.xml b/lib/orber/doc/src/ch_example.xml deleted file mode 100644 index f2ccfcc7e1..0000000000 --- a/lib/orber/doc/src/ch_example.xml +++ /dev/null @@ -1,170 +0,0 @@ - - - - -
- - 19972009 - Ericsson AB. All Rights Reserved. - - - The contents of this file are subject to the Erlang Public License, - Version 1.1, (the "License"); you may not use this file except in - compliance with the License. You should have received a copy of the - Erlang Public License along with this software. If not, it can be - retrieved online at http://www.erlang.org/. - - Software distributed under the License is distributed on an "AS IS" - basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See - the License for the specific language governing rights and limitations - under the License. - - - - Orber Examples - - - 1997-05-20 - A - ch_example.xml -
- -
- A Tutorial on How to Create a Simple Service - -
- Interface Design -

This example uses a very simple stack server. The specification - contains two interfaces: the first is the Stack itself and the - other is the StackFactory which is used to create new stacks. - The specification is in the file stack.idl.

- -
- -
- Generating Erlang Code -

Run the IDL compiler on this file by calling the ic:gen/1 function

- - 1> ic:gen("stack"). - -

This will produce the client stub and server skeleton. Among other files a stack API module named StackModule_Stack.erl - will be produced. - This will produce among other files a stack API module called - StackModule_Stack.erl which contains the client stub and - the server skeleton.

-
- -
- Implementation of Interface -

After generating the API stubs and the server skeletons it is time to - implement the servers and if no special options are sent - to the IDL compiler the file name should be - _impl.erl]]>, in our case - StackModule_Stack_impl.erl.

- -

We also have the factory interface which is used to create new stacks - and that implementation is in the file - StackModule_StackFactory_impl.erl.

- -

To start the factory server one executes the function - StackModule_StackFactory:oe_create/0 which in this - example is done in the module stack_factory.erl where - the started service is also registered in the name service.

- -
- -
- Writing a Client in Erlang -

At last we will write a client to access our service.

- -
- -
- Writing a Client in Java -

To write a Java client for Orber you must have another - ORB that uses IIOP for client-server communication and supports a - Java language mapping. It must also have support for - IDL:CosNaming/NamingContext or IDL:CosNaming/NamingContextExt. - If the client ORB support Interoperable Naming Service the Java Client - can look like:

- - -

If an ORB does not support CosNaming at all the cos_naming.idl - file must be compiled and imported.

- -
- -
- Building the Example -

To build the example for access from a Java client you need a Java - enabled ORB (e.g. JavaIDL). The example below is based on JDK-1.4.

- -fingolfin 127> erl -Erlang (BEAM) emulator version 5.5.4.3 [async-threads:0] [hipe] [kernel-poll:false] - -Eshell V5.5.4.3 (abort with ^G) -1> ic:gen(stack). -Erlang IDL compiler version 4.2.12 -ok -2> make:all(). -Recompile: StackModule_EmptyStack -Recompile: StackModule_Stack -Recompile: StackModule_StackFactory -Recompile: StackModule_StackFactory_impl -Recompile: StackModule_Stack_impl -Recompile: oe_stack -Recompile: stack_client -Recompile: stack_factory -up_to_date -3> -BREAK: (a)bort (c)ontinue (p)roc info (i)nfo (l)oaded - (v)ersion (k)ill (D)b-tables (d)istribution -a -fingolfin 128> idlj stack.idl -fingolfin 129> javac StackModule/*.java -fingolfin 130> javac *.java -fingolfin 131> cp StackClient.class StackModule/ - -
- -
- How to Run Everything -

Below is a short transcript on how to run Orber.

- - -fingolfin 143> erl -Erlang (BEAM) emulator version 5.5.4.3 [async-threads:0] [hipe] [kernel-poll:false] - -Eshell V5.5.4.3 (abort with ^G) -1> orber:jump_start([{interceptors, {native, [orber_iiop_tracer_silent]}}]). -ok -2> oe_stack:oe_register(). -ok -3> stack_factory:start(). -ok -4> stack_client:run(). -1 -1 -7 -4 -ok -5> - -

Before testing the Java part of this example generate and compile Java classes for - orber/examples/stack.idl as seen in the build example. - To run the Java client use the following command:

- - -fingolfin 38> java StackModule.StackClient "corbaname::localhost:4001#StackFactory" -1 -1 -7 -4 -Empty stack -fingolfin 39> - -
-
- - - diff --git a/lib/orber/doc/src/example_part.xml b/lib/orber/doc/src/example_part.xml index 2f549df888..9adb8fa7cf 100644 --- a/lib/orber/doc/src/example_part.xml +++ b/lib/orber/doc/src/example_part.xml @@ -4,23 +4,21 @@
- 2002 - 2007 - Ericsson AB, All Rights Reserved + 20022010 + Ericsson AB. All Rights Reserved. - The contents of this file are subject to the Erlang Public License, - Version 1.1, (the "License"); you may not use this file except in - compliance with the License. You should have received a copy of the - Erlang Public License along with this software. If not, it can be - retrieved online at http://www.erlang.org/. + The contents of this file are subject to the Erlang Public License, + Version 1.1, (the "License"); you may not use this file except in + compliance with the License. You should have received a copy of the + Erlang Public License along with this software. If not, it can be + retrieved online at http://www.erlang.org/. - Software distributed under the License is distributed on an "AS IS" - basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See - the License for the specific language governing rights and limitations - under the License. + Software distributed under the License is distributed on an "AS IS" + basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See + the License for the specific language governing rights and limitations + under the License. - The Initial Developer of the Original Code is Ericsson AB. Service Implementation @@ -32,7 +30,6 @@

This chapter describe how to implement Orber based CORBA services.

 - diff --git a/lib/orber/doc/src/make.dep b/lib/orber/doc/src/make.dep index f19cc18c90..cf5aad747d 100644 --- a/lib/orber/doc/src/make.dep +++ b/lib/orber/doc/src/make.dep @@ -12,7 +12,7 @@ book.dvi: CosNaming.tex CosNaming_BindingIterator.tex \ CosNaming_NamingContext.tex CosNaming_NamingContextExt.tex \ Module_Interface.tex any.tex book.tex ch_contents.tex \ - ch_debugging.tex ch_example.tex ch_exceptions.tex \ + ch_debugging.tex ch_exceptions.tex \ ch_idl_to_erlang_mapping.tex ch_ifr.tex ch_install.tex \ ch_interceptors.tex ch_introduction.tex ch_naming_service.tex \ ch_orber_kernel.tex ch_orberweb.tex ch_security.tex \ @@ -26,15 +26,8 @@ book.dvi: CosNaming.tex CosNaming_BindingIterator.tex \ # Source inlined when transforming from source to LaTeX # ---------------------------------------------------- -CosNaming.tex: ../../COSS/CosNaming/cos_naming.idl - book.tex: ref_man.xml -ch_example.tex: ../../examples/Stack/StackClient.java ../../examples/Stack/StackModule_StackFactory_impl.erl \ - ../../examples/Stack/StackModule_Stack_impl.erl \ - ../../examples/Stack/stack.idl ../../examples/Stack/stack_client.erl \ - ../../examples/Stack/stack_factory.erl - ch_contents.tex: ../../../../system/doc/definitions/term.defs ch_idl_to_erlang_mapping.tex: ../../../../system/doc/definitions/term.defs diff --git a/lib/orber/doc/src/notes.xml b/lib/orber/doc/src/notes.xml index 816ec77d61..c7a2dab617 100644 --- a/lib/orber/doc/src/notes.xml +++ b/lib/orber/doc/src/notes.xml @@ -44,6 +44,12 @@

Own Id: OTP-8374 Aux Id:

+ +

+ Removed the usage of the codeinclude tag in the documentation.

+

+ Own Id: OTP-8409 Aux Id:

+
diff --git a/lib/orber/doc/src/part.xml b/lib/orber/doc/src/part.xml index c23456deef..a131db0bad 100644 --- a/lib/orber/doc/src/part.xml +++ b/lib/orber/doc/src/part.xml @@ -4,7 +4,7 @@
- 19972009 + 19972010 Ericsson AB. All Rights Reserved. @@ -13,12 +13,12 @@ compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. - + Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. - + Orber User's Guide @@ -39,7 +39,6 @@ - diff --git a/lib/orber/vsn.mk b/lib/orber/vsn.mk index 8bfa13eb03..b56172d7cf 100644 --- a/lib/orber/vsn.mk +++ b/lib/orber/vsn.mk @@ -3,7 +3,8 @@ ORBER_VSN = 3.6.15 TICKETS = OTP-8353 \ OTP-8354 \ - OTP-8374 + OTP-8374 \ + OTP-8409 TICKETS_3.6.14 = OTP-8201 -- cgit v1.2.3