home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / edis201d.zip / edis.inf (.txt) < prev    next >
OS/2 Help File  |  1996-10-02  |  33KB  |  884 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. About the EDis Project ΓòÉΓòÉΓòÉ
  3.  
  4. Welcome to... 
  5.  
  6. EDis V 2.0 for OS/2 (PM and OpenDoc version)
  7. -----------------------------------------------------
  8. released: 16.09.1996 as FULL and DEMO version
  9.  
  10. This chapter gives you an overview of the EDis project and what is it useful 
  11. for. 
  12.  
  13. For further informations about EDis V 2.0 take a look at the official EDis 
  14. homepage: 
  15.  
  16. http://www.informatik.tu-muenchen.de/~schwarma/edis.html 
  17.  
  18. There are two versions of the program, a demo version and a full version. 
  19.  
  20.      The full version can be bought from me or from an online warehouse. Send 
  21.       me an email or go to the EDis homepage to get further informations, where 
  22.       to get the full version. Note This software has to be licensed for every 
  23.       workstation (host) it is used on. 
  24.  
  25.      The demo version can be copied and shared freely without payment. It is 
  26.       fully functional except the fact that SAVING OF TEXT IS DISABLED. 
  27.       Academic staff and students may obtain a free registration number from me 
  28.       by sending me an email with name, address and academic grade or 
  29.       profession. By submitting the registration number inside the registry 
  30.       dialog, saving of text is enabled. Note Registering the software is only 
  31.       for academic useage due to the fact, that this program is also part of a 
  32.       academic project. All other people who want a full version of the program 
  33.       have to buy it. 
  34.  
  35.  
  36. ΓòÉΓòÉΓòÉ 1.1. What is the EDis Project ΓòÉΓòÉΓòÉ
  37.  
  38. The EDis project realizes a distributed multiuser editor allowing some users to 
  39. edit the same text at the same time synchonized, protecting all changes against 
  40. each other and transfering changes made by one user to every other user of the 
  41. text, cross a network and (planned) cross different platforms such as OS/2 and 
  42. Windows (95/NT). 
  43.  
  44. The editor is divided into an editor client and an editor (text) server. The 
  45. editor server handles the text storing and managing and is implemented as a 
  46. collection of DSOM-classes executed by a DSOM-Server-Program. The editor client 
  47. handles the local version of the text and communicates all changes made with 
  48. the server. Till now, two clients exists, a PM client running on on OS/2 Warp 
  49. (3 and 4) and an OpenDoc client part running on OS/2 Warp 3 with Fixpack 17 and 
  50. OpenDoc from Devcon 10 or OS/2 Warp 4. This two clients share about 90% of the 
  51. code needed for local text managament, only about 10% implement the code for 
  52. the different environments. There will be a Windows 95/NT/OLE2 client and also 
  53. a Windows 95/NT server, betaing end of october. 
  54.  
  55. This project serves both as a technologie demo demonstrating the power of 
  56. combining SOM, DSOM and OpenDoc into a software project and as a real world 
  57. application which lets you edit text (ASCII). 
  58.  
  59. Please try version and send me your opinions, found errors and questions 
  60. appeared during the use of this application. It will be improves due to your 
  61. needs and requests, it is still an open project. 
  62.  
  63. This project is part of a graduate paper about compound document frameworks, 
  64. comparing OLE and OpenDoc and the following todays frameworks: 
  65.  
  66.  CDF             Compound Document Framework,  IBM,  OS/2  and Windows 
  67.  
  68.  ODF             OpenDoc Development Framework, Apple, MacOS and Windows 
  69.  
  70.  MFC             Microsoft Foundation Classes,  MS,   Windows 
  71.  
  72.  This graduate paper is written at IBM Deutschland GmbH, Germany set by the 
  73.  'Institut f╨ær Informatik' at TU-M╨ænchen, professorship 'Softwaretechnik' of 
  74.  Prof. Dr. Albert Endres. 
  75.  
  76.  This graduate paper was guided by Christoph Hofmann (TU-M╨ænchen) and Scott 
  77.  Davis (IBM Ehningen). 
  78.  
  79.  If you show interest in this graduate paper, it shall be completed till 
  80.  15.11.1996. It will then be available as HTML and PS text via my homepage. 
  81.  (But sorry to say only in german language). 
  82.  
  83.  
  84. ΓòÉΓòÉΓòÉ 1.2. What is it used for ΓòÉΓòÉΓòÉ
  85.  
  86. There are at least four possible usability situations for a distributed 
  87. multiuser editor: 
  88.  
  89.      As a technology demo for the power of combining CORBA and OpenDoc and the 
  90.       use of software components. 
  91.  
  92.      Due to the separation of text editing and text managing (storing) into 
  93.       two separated pocesses on two machines, the text is very safe. If a 
  94.       client breaks up, (could happen expecially in the current OpenDoc 1.0 
  95.       environment), the text server stays up and running, just start the client 
  96.       again and relog to the text server. All the changes made are still 
  97.       present and no work is lost. 
  98.  
  99.      The simultanous processing of text is very useful in larger enterprises 
  100.       for communication and text editing. Some users can join together onto a 
  101.       project, everybody sees what is done and where changes appear. Even 
  102.       messages between users can be effectively transmitted. 
  103.  
  104.      Within tutorial sessions while scholars work on their jobs (e.g. tests) a 
  105.       teacher is able to join in the test, follow the work of the scholars and 
  106.       give hints or corrections in place. 
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 1.3. About this release ΓòÉΓòÉΓòÉ
  110.  
  111. This is the first commercial version of this program, so it has been tested 
  112. well and seems to be quite stable. 
  113.  
  114. There are two versions of the program, a demo version and a full version. 
  115.  
  116.      The full version can be bought from me or from an online warehouse. Send 
  117.       me an email or go to the EDis homepage to get further informations, where 
  118.       to get the full version. Note This software has to be licensed for every 
  119.       workstation (host) it is used on. 
  120.  
  121.      The demo version can be copied and shared freely without payment. It is 
  122.       fully functional except the fact that SAVING OF TEXT IS DISABLED. 
  123.       Academic staff and students may obtain a free registration number from me 
  124.       by sending me an email with name, address and academic grade or 
  125.       profession. By submitting the registration number inside the registry 
  126.       dialog, saving of text is enabled. Note Registering the software is only 
  127.       for academic useage due to the fact, that this program is also part of a 
  128.       academic project. All other people who want a full version of the program 
  129.       have to buy it. 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 1.4. About the author ΓòÉΓòÉΓòÉ
  133.  
  134. This program has been written by Martin Schwarz for IBM Informationssysteme 
  135. GmbH and TU-M╨ænchen. 
  136.  
  137. (c) 1996 by Computer-Software-Entwicklung
  138.       Martin Schwarz
  139.       Meisenweg 5
  140.       84544 Aschau a. Inn
  141.       Germany
  142.  
  143.       E-MAIL: schwarma@informatik.tu-muenchen.de
  144.       WWW: http://www.informatik.tu-muenchen.de/~schwarma/
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  148.  
  149. Before installation you have to decide whether the editor should work on a 
  150. single worksstation or in a network and whether you want to use the PM-Client, 
  151. the OpenDoc-Client or both. 
  152.  
  153. First take a look on the hardware and software requirements and decide which 
  154. options you take and then continue with the basic installation. 
  155.  
  156.  
  157. ΓòÉΓòÉΓòÉ 2.1. Hardware requirements ΓòÉΓòÉΓòÉ
  158.  
  159.      An OS/2 Warp powered 386 PC or higher with at least 8 MB RAM 
  160.  
  161.      TCP/IP Network for Multiple Workstations 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 2.2. Software requirements ΓòÉΓòÉΓòÉ
  165.  
  166.      Single Workstation / PM-Client: 
  167.  
  168.         -  OS/2 Warp 3 or 4 
  169.  
  170.      Single Workstation / OpenDoc Client: 
  171.  
  172.         -  OS/2 Warp 3 + Fixpack 17 + OpenDoc 1.0 from DevCon 10 or 
  173.  
  174.         -  OS/2 Warp 4 
  175.  
  176.      Multiple Workstations / Workgroup 
  177.  
  178.         -  Single Workstation requirements 
  179.  
  180.         -  TCP/IP Network (e.g. LAN Server + MPTN) 
  181.  
  182.         -  DSOM Workgroup Enabler for OS/2 on every workstation 
  183.  
  184.  
  185. ΓòÉΓòÉΓòÉ 2.3. Basic installation ΓòÉΓòÉΓòÉ
  186.  
  187. Even if you use the editor on multiple workstation, it has to be installed on 
  188. your local harddrive. (At least the file EDis.IR has to be local to fulfill the 
  189. Interface Repository). 
  190.  
  191. During installation you can choose between installing 
  192.  
  193.      Server and PM-Client or 
  194.  
  195.      Server, PM-Client and OpenDoc-Client. 
  196.  
  197.  For the basic installation process start the IBM Software Installer 
  198.  install.exe. It will 
  199.  
  200.      Copy and decompress the following files in one directory on your lacal 
  201.       disk 
  202.  
  203.         -  Server and PM-Client related files: 
  204.  
  205.            EDISSRV.DLL    editor server library 
  206.  
  207.            EDIOCL1.DLL    IBM Visual Age Compiler Library (cppom30) 
  208.  
  209.            EDIOCL2.DLL    IBM Open Class Library (cppoob3) 
  210.  
  211.            EDIOCL3.DLL    IBM Open Class Library (cppoou3) 
  212.  
  213.            EDISRES.DLL    editor client resources 
  214.  
  215.            EDISCLI.DLL    editor client common text management library 
  216.  
  217.            EDISPM.EXE     editor PM-Client frontend 
  218.  
  219.            EDIS.HLP       edior client online help file 
  220.  
  221.            EDIS.INF       this Users'Guide 
  222.  
  223.            EDIS.IR        Interface Repository used by EDis V2.0 
  224.  
  225.         -  OpenDoc-Client related files: 
  226.  
  227.            EDISPART.DLL    editor client OpenDoc part handler library 
  228.  
  229.            EDISUPRT.DLL    user display OpenDoc part handler library 
  230.  
  231.            EDISREG.EXE    program for creating OpenDoc part templates 
  232.  
  233.            EDBASE.DLL     parent class used by the OpenDoc parts 
  234.  
  235.      Add the following statements to your CONFIG.SYS 
  236.  
  237.       LIBPATH              the installation directory will be added 
  238.  
  239.       SET PATH             the installation directory will be added 
  240.  
  241.       SET HELP             the installation directory will be added 
  242.  
  243.       SET SOMIR            the entry %installation directory%\EDIS.IR will be 
  244.                            added 
  245.  
  246.      A desktop folder named EDis V 2.0 will be created with the following 
  247.       files 
  248.  
  249.       PM-Client:           Program Reference to the file EDISPM.EXE 
  250.  
  251.       EDIS.INF             Shadow Object of the file EDIS.INF 
  252.  
  253.       Register OpenDoc-Client   Program Reference to the file EDISREG.EXE 
  254.  
  255.  If you want to install from disks, copy the files on two disks and change disk 
  256.  and press retry everytime an error message apears. (The above file sort order 
  257.  will help you). 
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ 2.4. DSOM installation ΓòÉΓòÉΓòÉ
  261.  
  262. The installation and configuration of the DSOM environment can be very tricky. 
  263. In the following I gave you a few hints for the correct installation. 
  264.  
  265.  
  266. ΓòÉΓòÉΓòÉ 2.4.1. Workplace DSOM ΓòÉΓòÉΓòÉ
  267.  
  268. The normal DSOM environment included in OS/2 Warp 3 or 4 will be all you need. 
  269.  
  270. If not already done, add statments for hostname and username to the CONFIG.SYS 
  271. (e.g. SET HOSTNAME=GigaPower  SET USER=Martin). 
  272.  
  273.  
  274. ΓòÉΓòÉΓòÉ 2.4.2. Workgroup DSOM ΓòÉΓòÉΓòÉ
  275.  
  276. This program has been tested on an OS/2 Lan Server 4.0 driven network. 
  277.  
  278. The following informations will help you in your installation process. 
  279.  
  280.      The network must be TCP/IP enabled, hostnames and TCP/IP addresses must 
  281.       be set for every host. 
  282.  
  283.      Hostname and username has to be set in the CONFIG.SYS of every host. 
  284.  
  285.      The IBM DSOM Workgroup Enabler must be installed on every host, you can 
  286.       get it from http://www.software.ibm.com/objects/somobjects. 
  287.  
  288.      The file EDISSRV.DLL contains the DSOM classes 
  289.  
  290.         -  EDSService, 
  291.  
  292.         -  EDSText, 
  293.  
  294.         -  EDSLine, 
  295.  
  296.         -  EDDAServer, 
  297.  
  298.         -  EDSAServer 
  299.  
  300.      The information required for the Interface Repository is contained in the 
  301.       file EDIS.IR which is set in the SOMIR path during installation. 
  302.  
  303.      The Implementation Repository must be located in a shared directory! The 
  304.       entrys for the text servers are dynamically created and deleted and must 
  305.       be available for every client from every host. Set the statement SET 
  306.       SOMDDIR in the CONFIG.SYS to a shared directory on your network. 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 2.5. OpenDoc installation ΓòÉΓòÉΓòÉ
  310.  
  311. To run the OpenDoc-Client, the class EDisPart included in the file EDISPART.DLL 
  312. and the class EDisUserPart included in the file EDISUPRT.DLL has to be 
  313. registered to OpenDoc to create templates. 
  314.  
  315. To accomplish that let run the included program EDISREG.EXE which will do just 
  316. that. 
  317.  
  318. You can also use the commands: 
  319.  
  320.      ODINST -cEDisPart -dedispart 
  321.  
  322.      ODINST -cEDisUserPart -dedisuprt 
  323.  
  324.  
  325. ΓòÉΓòÉΓòÉ 2.6. If installation fails ΓòÉΓòÉΓòÉ
  326.  
  327. Send me an email or contact me via my address. I will then try to fix your 
  328. problem and eventually update the product. 
  329.  
  330.  
  331. ΓòÉΓòÉΓòÉ 3. Using EDis ΓòÉΓòÉΓòÉ
  332.  
  333. Both editor clients (PM and OpenDoc) are completely online help enabled. Press 
  334. F1 to get context information or choose an menu help entry. 
  335.  
  336. The EDis editor consists of two separate executed parts communicating with each 
  337. other: 
  338.  
  339.      Editor (text) server: Manages an ASCII textfile synchonizing the requests 
  340.       of a number of editor clients. 
  341.  
  342.      Editor client: Edits a lokal version of the text and communicates the 
  343.       changes made line by line with the editor server. The local version of 
  344.       the text is updated regularly with the central version hold by the editor 
  345.       server. 
  346.  
  347.  A editor client can read single lines from the server and lock them for 
  348.  exclusive usage so that no other client is able to lock or write this line, 
  349.  reading is allowed. Further more every line has a version number which is 
  350.  counting up during every update. If the version number of a line before 
  351.  writing or locking is higher than the current local line version number, lock 
  352.  or write is not allowed. 
  353.  
  354.  Made changed are saved in a eventlist. The clients fetch this eventlist 
  355.  regularly and apply these events to the local version of the text (Update). 
  356.  The update frequence can be set in the setting dialog from 1 to 1000 seconds. 
  357.  Clients must register itself to the server by a unique username during 
  358.  server-logon. This username is used to mark lines as locked. All currently 
  359.  registered usernamed can be viewed inside the user window of the editor. 
  360.  
  361.  
  362. ΓòÉΓòÉΓòÉ 3.1. Start of the program ΓòÉΓòÉΓòÉ
  363.  
  364. The DSOM Environment has to be available and ready. The DSOM-Demon SOMDD.EXE 
  365. will be started automatically by the Editor client during startup as a process 
  366. of the Workplace Shell if not already running. 
  367.  
  368. Start either the PM-Client or the OpenDoc-Client. 
  369.  
  370.      In order to run the PM-Client start the program "PM-Client" in the "EDis 
  371.       V 2.0" folder or type EDisPM inside a command window. You can submit up 
  372.       to two parameters: 
  373.  
  374.         -  Username: Set your logon username during startup. 
  375.  
  376.         -  Textalias: Immediately logon to the given text server during 
  377.            startup. 
  378.  
  379.       If there is an existing profile called (EDISPM.INI) in your working 
  380.       directory, settings, username and textalias will be loaded from it. You 
  381.       can override the this by submitting the parameters username and "NO" for 
  382.       the textalias. 
  383.  
  384.      To start the OpenDoc-Client drag the "Distributed Editor Part" template 
  385.       to either the desktop for creating a root part or a container part for 
  386.       creating an embedded part or start a previous created OpenDoc document 
  387.       including the OpenDoc-Client. If this Client was closed while logged on 
  388.       to a text, the text will immeadiatly be loaded during startup. 
  389.  
  390.  During the start of any EDis client the DSOM environment is tested and 
  391.  started. If any errors occure then first check the DSOM environment, e.g. if 
  392.  the DSOM-Daemon somdd.exe is started. IF the client hangs during startup, try 
  393.  to set the statement SET SOMDTIMEOUT= to a value of 15 seconds. If a timeout 
  394.  occures, a message box will display with a SOM/DSOM-error code. 
  395.  
  396.  NoteDuring initialisation, the message "initializing, please wait..." is 
  397.  displayed inside the program window until the it it completed and the message 
  398.  "ready to logon..." appears. While initialisation is in progress, the Logon 
  399.  menu entry is disabled. But most other functions are available because the 
  400.  initialisation is separated into a own thread. 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ 3.2. Text management ΓòÉΓòÉΓòÉ
  404.  
  405. There are two basic servers managing and administrating different text: 
  406.  
  407.      A text administration server managing text server information where on 
  408.       which host the text server is started and from which text file it should 
  409.       load. The information is stored in the profile (EDIS.INI). This profile 
  410.       is placed in the directory where the SOMDDIR environment variable is 
  411.       pointed to. (Look for the SET SOMDDIR= statment in your CONFIG.SYS). 
  412.  
  413.      A text server manages the text. It is started with the first client 
  414.       logging on to a unique text alias for which currently no text server 
  415.       exists. During startup the text is loaded from a given file (if the file 
  416.       does not exist, a new one is created). After startup, the text server is 
  417.       ready for clients to log on that text. With the last client logging off 
  418.       from the text server, the text server is terminated after the text has 
  419.       been saved to given filepath. 
  420.  
  421.  Clients can 
  422.  
  423.      Logon to a text server by selecting the logon entry from one of the menus 
  424.       or by specification of a second parameter during client startup. 
  425.       Remember: Text are referenced by a unique text alias. With the text 
  426.       alias, clients are able to request the hostname and the filepath for that 
  427.       alias. Inside the logon dialog, all currently registered text are 
  428.       displayed with the text alias, hostname, filepath and the status 
  429.       displaying "active" when a text server is running for the alias and 
  430.       "------" when not. You can add, delete or change the entrys from within 
  431.       that dialog. By choosing an entry, logging on to that text proceeds. 
  432.  
  433.       Note If the program is in demo mode (no valid registration number has 
  434.       been submitted in the registry dialog) during logon an informational 
  435.       message will appear and the text server either switched to demo mode, 
  436.       that means saving of text is not allowed, or the editor client allowes 
  437.       only viewing of the text. 
  438.  
  439.      Logoff from a text server by selecting the logoff entry from one of the 
  440.       menus. Logoff also takes place when a client is closed. 
  441.  
  442.      Save text to the currently defined filepath. 
  443.  
  444.      Change the currently defined filepath and save the text to the new 
  445.       filepath. Remember that the filepath roots on the host the text server is 
  446.       running (determined by hostname), not always on your local host. You can 
  447.       change the hostname the text server should be executed within the logon 
  448.       dialog, but only if the text server is currently not active. 
  449.  
  450.      Import text from file. You can choose a local text within a file dialog, 
  451.       read that text and transfer it to the text server. 
  452.  
  453.      Export the local text to a file. Choose a filename to store within the 
  454.       save as dialog and proceed. 
  455.  
  456.  Servers are DSOM objects which are executed by the standard DSOM server 
  457.  program somdsvr.exe. These servers are automatically started by the client if 
  458.  the somdd.exe is running. Every single text refered by a unique text alias is 
  459.  managed by one text server. 
  460.  
  461.  
  462. ΓòÉΓòÉΓòÉ 3.3. Text editing ΓòÉΓòÉΓòÉ
  463.  
  464. Changes are only valid onto locked lines. 
  465.  
  466. Lockes are requested before an edit action goes actually to the edit window. If 
  467. a line could not be locked, edit actions for that line are surpressed. 
  468.  
  469. In the status line, the locked status is displayed. 
  470.  
  471.  Key             Function 
  472.  
  473.  Cursor          Move the text cursor. If the cursor leaves a locked line, this 
  474.                  line is released and written to the editor server. The new 
  475.                  line information with the actual cursor position is shown in 
  476.                  the status line. 
  477.  
  478.  Pos 1           Set the text cursor to the first position in the current line. 
  479.                  The new line information with the actual cursor position is 
  480.                  shown in the status line. 
  481.  
  482.  Ende            Set the text cursor to the last position in the current line. 
  483.                  The new line information with the actual cursor position is 
  484.                  shown in the status line. 
  485.  
  486.  Ctrl+Pos 1      Set the text cursor to the first line of the text. If the 
  487.                  cursor leaves a locked line, this line is released and written 
  488.                  to the editor server. The new line information with the actual 
  489.                  cursor position is shown in the status line. 
  490.  
  491.  Strg+Ende       Set the text cursor to the first line of the text. If the 
  492.                  cursor leaves a locked line, this line is released and written 
  493.                  to the editor server. The new line information with the actual 
  494.                  cursor position is shown in the status line. 
  495.  
  496.  Insert          Toggles the insert mode between insert/overwrite. 
  497.  
  498.  Delete          If the current cursor line is not already locked, a lock will 
  499.                  be questioned to the server. If the lock is valid, the 
  500.                  character in behind the text cursor is deleted. If the text 
  501.                  cursor is at the end of the line, the next line will be locked 
  502.                  and appended onto the current line. 
  503.  
  504.  Enter           If the current cursor line is not already locked, a lock will 
  505.                  be questioned to the server. If the lock is valid, a new line 
  506.                  will be inserted after the current line and the text after the 
  507.                  text cursor is clipped to the new inserted line. After the 
  508.                  operation, the text cursor is placed in the new inserted line 
  509.                  which is locked for you. 
  510.  
  511.  Backspace       If the current cursor line is not already locked, a lock will 
  512.                  be questioned to the server. If the lock is valid, the 
  513.                  character in front of the text cursor is deleted. If the text 
  514.                  cursor is in the first position of the line, the line will be 
  515.                  deleted and appended onto the line before as long as the 
  516.                  locking of the line before is valid. 
  517.  
  518.  Ctrl+Backspace  If the current cursor line is not already locked, a lock will 
  519.                  be questioned to the server. If the lock is valid, the line is 
  520.                  deleted. 
  521.  
  522.  Character       If the current cursor line is not already locked, a lock will 
  523.                  be questioned to the server. If the lock is valid, the 
  524.                  character is inserted at the cursor position. 
  525.  
  526.  Mouse operations: 
  527.  
  528.  Click the mouse inside the edit window to set the cursor position. You can 
  529.  mark a block of text with the mouse. If you click a mouse button while a block 
  530.  is marked, the block is demarked. 
  531.  
  532.  Block operations: 
  533.  
  534.  Cut, Copy and Paste are supported for single lines and blocks. Before deleting 
  535.  or inserting a block, the action is certainly validated with the text server 
  536.  if this action is currently possible. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ 3.4. Configuring the program ΓòÉΓòÉΓòÉ
  540.  
  541. There are three basic options dialogs: 
  542.  
  543.      Username: Change the username used to register yourself to a text server. 
  544.       The default is "anonymous". 
  545.  
  546.      Fonts: Change the font used in text and user window. 
  547.  
  548.      Settings: Change colors, update frequency, border size, tab size and 
  549.       toggle horizontal and vertcal splitting of edit and user windows. 
  550.  
  551.      Userlist: Toggle the user window on and off. 
  552.  
  553.      Scrollbars: Toggle the scrollbars of the edit window on and off. 
  554.  
  555.  
  556. ΓòÉΓòÉΓòÉ 3.5. Exiting the program ΓòÉΓòÉΓòÉ
  557.  
  558. Close the program. Settings are saved to a profile (EDIS.INI) in your working 
  559. directory (that is not always the program directory). 
  560.  
  561. This gives you the opportunity to have several different customized versions 
  562. with different settings, username and textalias by starting the program from 
  563. different directories. 
  564.  
  565.  
  566. ΓòÉΓòÉΓòÉ 3.6. Special OpenDoc features ΓòÉΓòÉΓòÉ
  567.  
  568. The EDis OpenDoc-Client consists of a part handler based on the 
  569. jmBaseNonContainerPart class inheriting its functionality. 
  570.  
  571. Inside the frame border, some OpenClassLibrary Window classes managing the 
  572. display of the editor. 
  573.  
  574. There are popup and pulldown menues available if the editor part is selected. 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ 3.6.1. Storage information ΓòÉΓòÉΓòÉ
  578.  
  579. By closing the EDis OpenDoc-Client (part), the current username, the text name 
  580. (if already logged on to a text) and the layout informations are saved and 
  581. restoring during the next opening of the part. 
  582.  
  583.  
  584. ΓòÉΓòÉΓòÉ 3.6.2. Clipboard usage ΓòÉΓòÉΓòÉ
  585.  
  586. The EDis OpenDoc-Client is clipboard enabled, so you can cut, copy and paste 
  587. text in and out of the editor window. 
  588.  
  589.  
  590. ΓòÉΓòÉΓòÉ 3.6.3. Drag and Drop ΓòÉΓòÉΓòÉ
  591.  
  592. The EDis OpenDoc-Client is Drag and Drop enabled, you can mark a text, press 
  593. the right mousebutton over it and drag the maked ASCII text information to 
  594. either inside the editor part or outside to a text part. 
  595.  
  596. If you holf the CONTROL key during dragging, the text is copied else the text 
  597. is deleted from the old position. 
  598.  
  599.  
  600. ΓòÉΓòÉΓòÉ 3.6.4. Draft versioning control ΓòÉΓòÉΓòÉ
  601.  
  602. Draft versioning simply do not work in the current version of OpenDoc (1.0 GA) 
  603. but should do with OS/2 Warp 4. 
  604.  
  605.  
  606. ΓòÉΓòÉΓòÉ 3.6.5. User Display Part ΓòÉΓòÉΓòÉ
  607.  
  608. The Distributed User Part serves as a OpenDoc part handler for displaying the 
  609. users currently logged on to a text (server). 
  610.  
  611. The part is not directly connected to the text server, it gets the user 
  612. informations from the Distributed Editor Part via a link. 
  613.  
  614. After creation and opening of this part, its empty until you specify a link 
  615. between one (or more) Distributed Editor Part(s) and this part. 
  616.  
  617. There are two ways to create a link: 
  618.  
  619.      Select Copy from the Distributed Editor Part's menu to copy the linkage 
  620.       information to the clipboard and then select Paste as link from this part 
  621.       to actually create the link. 
  622.  
  623.      Drag and Drop Press the right mouse button somewhere over the Distributed 
  624.       Editor Part and drag the document image into this part's window. This way 
  625.       the linkage information will pass to this part and the link will be 
  626.       actually created. 
  627.  
  628.  The link is saved while closing the document and will be restored the next 
  629.  time you open the document. 
  630.  
  631.  As an update of the userlist of the Distributed Editor Part occures, the data 
  632.  will be send via the link to this part and be displayed. 
  633.  
  634.  Note The OpenDoc linkgage mechanism requires the avsshell.exe to be up and 
  635.  running (it will be started by the parts). This programm is based on the DSOM 
  636.  environment. If the linking goes wrong, check the DSOM environment and delete 
  637.  the file avlsrvr.bto and the avlsrvr.bak from the /os2 folder. Then start 
  638.  somdd.exe (if not alread running) and the avsshell.exe. If both are running, 
  639.  the linking shall be no problem. 
  640.  
  641.  
  642. ΓòÉΓòÉΓòÉ 4. Copyright and additional informations ΓòÉΓòÉΓòÉ
  643.  
  644. The copyright and additional informations about the EDis project. 
  645.  
  646. There is a homepage about the EDis project available: 
  647.  
  648. http://www.informatik.tu-muenchen.de/~schwarma/edis.html 
  649.  
  650.  
  651. ΓòÉΓòÉΓòÉ 4.1. Copyright ΓòÉΓòÉΓòÉ
  652.  
  653. (c) 1996 by Computer-Software-Entwicklung
  654.       Martin Schwarz
  655.       Meisenweg 5
  656.       84544 Aschau a. Inn
  657.       Germany
  658.  
  659.       E-MAIL: schwarma@informatik.tu-muenchen.de
  660.       WWW: http://www.informatik.tu-muenchen.de/~schwarma/
  661.  
  662. I am a student of computer science with theoretical medicine as my minor 
  663. subject. My main interests are in operating systems and databases. 
  664.  
  665. My most fovorite computer operating system is OS/2 Warp, sometimes I also have 
  666. to put up with systems like WINDOWS (3.1/95/NT) or even more terrible DOS 
  667. (aaarrrggghhh). 
  668.  
  669. Among some other stuff I sign responsible for the wellknown OS/2 software 
  670. PMxEyes. Besides I have already released an OpenDoc version of the PMxEyes to 
  671. get used to OpenDoc (ODxEyes), which I regard as a good technologie to stand 
  672. the OLE2 hype. 
  673.  
  674. As a project for my studies, I implemented a distributed editor with the 
  675. SOM/DSOM technologie. Documentation, sources and the program are available via 
  676. my homepage as a HTML-text but only in german language. 
  677.  
  678.  
  679. ΓòÉΓòÉΓòÉ 4.2. Technical information ΓòÉΓòÉΓòÉ
  680.  
  681. Informations about the two technical bases EDis sets on: 
  682.  
  683.      SOM/DSOM 
  684.  
  685.      OpenDoc 
  686.  
  687.  
  688. ΓòÉΓòÉΓòÉ 4.2.1. SOM/DSOM ΓòÉΓòÉΓòÉ
  689.  
  690. SOM/DSOM implements a CORBA compliant object request broker which allows 
  691. applications to create, delete and access objects through a network as if they 
  692. where in th local processroom of the computer. 
  693.  
  694.  
  695. ΓòÉΓòÉΓòÉ 4.2.2. OpenDoc ΓòÉΓòÉΓòÉ
  696.  
  697. OpenDoc serves as a compound document architecture which is develloped by IBM 
  698. and Apple for the platforms MacOS, Windows, OS/2, AIX and more to come. The key 
  699. feature of the compound document architectures is the idea to build an 
  700. application lego-wise out of more parts from different vendors which plug 
  701. together to a well fit application suite. 
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 4.3. Changes since EDisPM V1.0 ΓòÉΓòÉΓòÉ
  705.  
  706. EDisPM V1.0 was released on 30.09.1995 as part of a studies paper giving 
  707. overwiev and insides about CORBA, SOM and DSOM and demostrating its power with 
  708. this application. 
  709.  
  710. EDisPM V1.1 was released on 25.06.1996 as part of a SOM/DSOM programming 
  711. tutorial called SOMObjects-Programming puplished in the german magazin OS/2 
  712. Inside volume 6/96 to 8/96. 
  713.  
  714. EDis V2.0 was released on 16.09.1996 as part of a graduate paper about compound 
  715. document frameworks, demostrating the integration of a software product into 
  716. the OpenDoc environment and the power of combinating OpenDoc with SOM and DSOM. 
  717.  
  718. Changes 
  719.  
  720.      now for OpenDoc 1.0 GA, 
  721.      improvements in OpenDoc functionality, 
  722.      complete redesigned. 
  723.  
  724.  
  725. ΓòÉΓòÉΓòÉ 4.4. License Agreement ΓòÉΓòÉΓòÉ
  726.  
  727. SOFTWARE LICENSE AGREEMENT
  728.  
  729.           Computer-Software-Entwicklung
  730.              Martin Schwarz
  731.               Meisenweg 5
  732.              84544 Aschau
  733.                Germany
  734.        email: schwarma@informatik.tu-muenchen.de
  735.       http://www.informatik.tu-muenchen.de/~schwarma/
  736.  
  737. Read carefully the following terms and conditions.  Use of this product 
  738. constitutes your acceptance of these terms and conditions and your agreement to 
  739. abide by them. 
  740.  
  741. This is a legal agreement between you, the end user, and Computer- 
  742. Software-Entwicklung Martin Schwarz ("MS-CSE").  By using this package, you are 
  743. agreeing to be bound by the terms of this agreement.  If you do not agree to 
  744. the terms of this agreement and you purchased this package directly from 
  745. MS-CSE, promptly return the disk package and the accompanying items (including 
  746. written materials and binders or other containers) within thirty (30) days to 
  747. MS-CSE for a refund, less the shipping and handling charges.  Returns are 
  748. subject to a 20% restocking fee.  If you obtained the software through a 
  749. reseller, dealer or distributor, consult them for their return policy. 
  750.  
  751. This software comes in two versions, a freeware demo version and a commercial 
  752. full version. If you do not exactly know, which version you have got, start the 
  753. any client (e.g. EDISPM.EXE) and go to the "Product Information" dialog. If the 
  754. application title say "EDis 'version' (demo)" you have a demo version and are 
  755. bound to the demo version license agreement, if the application title say "EDis 
  756. 'version'", you are bound to the full version license agreement. If the title 
  757. say "EDis 'version' (reg.)", you have got a registered demo license and are 
  758. bound to the registered demo license agreement. 
  759.  
  760. (License) 
  761.  
  762.      Demo version license: The demo version is a full functional version 
  763.       except that SAVING OF TEXT IS DISBALED. You may use this demo version for 
  764.       an unlimited evaluation period; make as many copies of this demo version 
  765.       software and documentation as you wish; give exact copies of the original 
  766.       including this license.txt to anyone; and distribute this demo version 
  767.       software and documentation in its unmodified form including this 
  768.       license.txt via electronic means. There is no charge for any of the 
  769.       above. 
  770.  
  771.      Registered demo version license: By receiving and submitting a 
  772.       registration number, the demo version is altered into an registered demo 
  773.       version with the complete functionality of the full version. You may not 
  774.       use a registration number on more than one computer (i.e.  a single CPU) 
  775.       at the same time.  You may not sell or rent or lease or transfer the 
  776.       registration number. The software itself applies still to the demo 
  777.       version license. 
  778.  
  779.      Full version license: You, the original purchaser, are granted a 
  780.       nonexclusive license to use the Software under the terms stated in this 
  781.       Agreement.  You may not use the Software on more than one computer (i.e. 
  782.       a single CPU) at the same time.  You may copy the software for backup. 
  783.       You may not rent or lease the Software, but you may transfer it on a 
  784.       permanent basis if the person receiving it agrees to the terms of the 
  785.       Agreement.  If the Software is an update, any transfer must include the 
  786.       update and all prior versions. 
  787.  
  788.      Common license: You may not: use, copy, modify, merge, or transfer copies 
  789.       of the program except as provided in this license; alter, reverse 
  790.       assemble or reverse compile the program; or sublicense, rent, lease, or 
  791.       assign the program. 
  792.  
  793.       Title to the Software is not transferred to User.  Ownership of the 
  794.       Software is vested in MS-CSE subject to the rights granted in this 
  795.       Agreement. 
  796.  
  797.  (Limited Warranty) 
  798.  
  799.  THE SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT 
  800.  WARRANTY OF ANY KIND. THE ENTIRE RISK AS TO RESULTS AND PERFORMANCE OF THE 
  801.  SOFTWARE IS ASSUMED BY YOU. 
  802.  
  803.  MS-CSE will not be liable for any special, incidental, consequential, indirect 
  804.  or similar damages due to the loss of data, loss of business profits, business 
  805.  interruption or any other reason, even if MS-CSE or an agent of MS-CSE has 
  806.  been advised of the possibility of such damages.  In no event shall MS-CSE's 
  807.  liability for any damages ever exceed the price paid for the license to use 
  808.  the software, regardless of the form of the claim. 
  809.  
  810.  MS-CSE warrants that the medium upon which the Software is provided by MS-CSE 
  811.  to User shall be free from defects in materials and workmanship under normal 
  812.  use for a period of sixty (60) days from the date of receipt. 
  813.  
  814.  MS-CSE's entire liability and your exclusive remedy shall be at MS-CSE's 
  815.  option, either to:  a.) replace of any defective medium upon its return to 
  816.  MS-CSE within the warranty period; or b.) refund of the license fee paid by 
  817.  User. 
  818.  
  819.  Because laws may vary between jurisdictions, you may have different or other 
  820.  legal rights regarding this matter. If any provision of this Agreement is 
  821.  found void, invalid or unenforceable, it will not affect the validity of the 
  822.  balance of this Agreement, which shall remain valid and enforceable according 
  823.  to its terms. 
  824.  
  825.  (Support) 
  826.  
  827.  On-line support for registered users is available via Internet (email). These 
  828.  will be answered on a "best effort" basis. 
  829.  
  830.  (General) 
  831.  
  832.  You may terminate your license at any time, MS-CSE may terminate your license 
  833.  if you fail to comply with the terms and conditions of this license.  In 
  834.  either event, you must destroy all your copies of the Program. 
  835.  
  836.  You are responsible for payment of any taxes, including personal taxes, 
  837.  resulting from this license. 
  838.  
  839.  Neither party may bring an action, regardless of form, more than two years 
  840.  after the cause of action arose. 
  841.  
  842.  If you acquired the Program in the United States, this license is governed by 
  843.  the laws of the State of New York.  If you acquired the Program in Canada, 
  844.  this license is governed by the laws of the Province of Ontario.  Otherwise, 
  845.  this license is governed by the law of the country in which you acquired the 
  846.  Program. 
  847.  
  848.  
  849. ΓòÉΓòÉΓòÉ 5. Where can I get more informations ΓòÉΓòÉΓòÉ
  850.  
  851. Here are some WWW-Links to informational pages of different subjects. 
  852.  
  853. The official EDis homepage: 
  854.  
  855.      http://www.informatik.tu-muenchen.de/~schwarma/edis.html 
  856.  
  857.  You can reach Martin Schwarz via WWW: 
  858.  
  859.      http://www.informatik.tu-muenchen.de/~schwarma/ 
  860.  
  861.  You can reach the TU-M╨ænchen (Technical University, Munich, Germany) via WWW: 
  862.  
  863.      http://www.leo.org 
  864.  
  865.      http://www.informatik.tu-muenchen.de 
  866.  
  867.  You can reach IBM via WWW: 
  868.  
  869.      http://www.ibm.com 
  870.  
  871.      http://www.ibm.de 
  872.  
  873.  You can get information about SOM/DSOM via WWW: 
  874.  
  875.      http://www.software.ibm.com/objects/somobjects/ 
  876.  
  877.      http://www.informatik.tu-muenchen.de/~schwarma/corba.html 
  878.  
  879.  You can get information about OpenDoc via WWW: 
  880.  
  881.      http://www.cilabs.org 
  882.  
  883.      http://www.software.ibm.com/clubopendoc/ 
  884.