home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / dcmos213.zip / README.TXT < prev    next >
Text File  |  1996-10-21  |  16KB  |  420 lines
  1.       Document Conversion Manager for OS/2 Warp  Release 1.3
  2.       ======================================================
  3.  
  4.                      LIMITED USE VERSION
  5.                      ===================
  6.  
  7.  
  8.      Authors : Pembroke International Ltd      
  9.                15 Edmund Road
  10.                Hastings   East Sussex
  11.                U.K.
  12.                TN35 5JY
  13.  
  14.      Telephone / fax : +44 (0)1424-460803
  15.               E-mail : frank@pembroke-int.com
  16.                  Web : http://www.ftech.net/~pembroke
  17.              Contact : Frank Sheldon
  18.  
  19.      Please report any errors by e-mail.
  20.      Problem documents can be sent to the same address as either
  21.      UUENCODED or MIME mail.
  22.  
  23.  
  24.      Please contact us if you have any problems at all. Thank you.
  25.      
  26. ====================================================================
  27.  
  28.  
  29. Software files provided (26) :
  30. ------------------------------
  31.  
  32.          INSTALL.EXE     DCMAMPR.DLL      CDFFONT.INI
  33.           DCMDDE.EXE     DCMRFTW.DLL      AMPLANG.INI
  34.         DCMFOLDR.DLL     DCMDOCR.DLL     RFTPRINT.INI
  35.          DCMFONT.DLL     DCMAMPW.DLL       README.TXT 
  36.           DCMINI.DLL     DCMCDFW.DLL      LICENCE.TXT
  37.           DCMOBJ.DLL     DCMKERN.DLL      INSTALL.TXT
  38.          DCMTYPE.DLL    DCMFOLDO.ICO     NOTE-V13.TXT
  39.             DCML.DLL     DOCFONT.INI        ORDER.TXT
  40.           DCMPRG.DLL     AMPFONT.INI      
  41.                
  42.  
  43.  
  44. Example DCA/RFT test files (14) supplied by :
  45. ---------------------------------------------
  46.  
  47. IBM Germany  TESTFI94.RFT  -  Character set, tables, columns, indents
  48.                               typestyle changes, outline, header/footer 
  49.                               use, IOCA graphics.
  50.              10003760.RFT  -  Indents, header/footer, tables
  51.  
  52. IBM Dallas        A3X.RFT  -  AS/400 controls
  53.                   A7V.RFT  -  DW370 controls
  54.               BACK-51.RFT  -  Backspace/ZICR    
  55.              SOFTCR-A.DOC  -  Soft returns
  56.               TRAVERS.DOC  -  Right alignment using tabs
  57.               DENS-50.DOC  -  Changes in line-density
  58.                TOP-51.DOC  -  Header/footer changes
  59.              CODES-01.DOC  -  Logical placement of Header/footer
  60.                               Header/footer suppression, outline,
  61.                               Logical/physical page no's.
  62.  
  63. IBM UK       DW5-2UTP.DOC  -  DW5 Outline numbering
  64.              PDTSETD3.DOC  -  DW3 printer test document
  65.  
  66. IBM Denmark  31240779.RFT  -  Proportional fonts, header/footer
  67.              31240787.RFT  -      "          "      "      "
  68.  
  69.  
  70. ====================================================================
  71.  
  72. OVERVIEW
  73. --------
  74.  
  75. Document Conversion Manager for OS/2 is a SOM object whose
  76. purpose is to provide seamless, accurate document translation
  77. services. 
  78.  
  79. This release is fully enabled for DisplayWrite DOC and
  80. RFT, and Ami Pro document exchange.
  81.  
  82. ===========================================================
  83. The Lotus Notes RTF-CD format creation modules are first 
  84. release alpha - and only just made it into this release for
  85. the Merlin applications Sampler CD. The retained funtionality
  86. is minimal. Paragraph text should be maintained, and should
  87. view and import OK, tables are created and should view OK, 
  88. but there are problems with import. 
  89.  
  90. Please watch our web site - www.ftech.net/~pembroke - for 
  91. information on further releases of the CDF modules. 
  92.  
  93. If you want to be notified when we have updates available
  94. please send e-mail to frank@pembroke-int.com 
  95. ============================================================
  96.  
  97. Users need to be able to work with data - document objects -
  98. without being concerned where or by what they were created.
  99. Document Conversion Manager provides users with the ability
  100. to work with document objects by providing seamless transformation
  101. of documents at the system level. The desktop intelligently provides
  102. translation services to applications on a need basis.
  103.  
  104.  
  105. There is a requirement for three levels of conversion :
  106.  
  107. No roundtrip required - DCA/RFT storage.
  108. - Ami Pro to DCA/RFT where the DCA/RFT document is comprised
  109.   of a single fixed pitch font with column margins set for 
  110.   use by a dumb terminal, with text reformatted for those 
  111.   margins and the document fully repaginated.
  112.  
  113. Roundtrip required
  114. - Ami Pro to DCA/RFT with complete font mapping which requires
  115.   each environment to have complimentary fonts.
  116.  
  117. Roundtrip required
  118. - Ami Pro to DCA/RFT where the DCA/RFT document is comprised
  119.   of a group of fixed pitch fonts of equal size, with column 
  120.   margins set for use by a dumb terminal, with text reformatted
  121.   for those margins and the document fully repaginated. 
  122.   DCA/RFT to Ami Pro where each DCA typestyle maps to a specific
  123.   face and point size, eg :
  124.   Courier 10pt = Typestyle 85
  125.   Tmns Rmn 12pt= typestyle 86
  126.   Helvetic 16pt= typestyle 87
  127.  
  128.  
  129. This version shows how :
  130.  
  131.  - Ami Pro and DisplayWrite/RFT documents can be co-existed.
  132.  - DisplayWrite/RFT documents can be effectively migrated 
  133.    to Ami Pro.
  134.  
  135.  
  136. ====================================================================
  137.  
  138. Using Document Conversion Manager for OS/2
  139. ------------------------------------------
  140.  
  141. Use and setup of DCM is handled through the Conversion Folders.
  142.  
  143. Conversion is effected by either :
  144.  
  145. - Dropping documents onto the Conversion Folders.
  146.   - Dropping an Ami Pro document onto the "Convert to DisplayWrite"
  147.     folder will produce a DisplayWrite/RFT document in that folder.
  148.   - Dropping a DisplayWrite ".DOC" or DCA/RFT document onto the 
  149.     "Convert to Ami Pro" folder will produce an Ami Pro document in
  150.     that folder.
  151.  
  152. - Dropping documents onto the receiving application icon.
  153.   - Dropping a DisplayWrite/RFT document onto the Ami Pro icon will
  154.     convert the document into Ami Pro format.
  155.  
  156. In both the above cases, if the Command-line or DDE option has been 
  157. enabled through the Set Application page of the Conversion Folder 
  158. notebook, the target application will be loaded - if not already 
  159. running - with the converted document. 
  160.  
  161. - Opening the target Conversion Folder and selecting a document 
  162.   using the file-selection facility.
  163.  
  164.  
  165. ====================================================================
  166.  
  167.           Configuring Document Conversion Manager for OS/2
  168.           ------------------------------------------------
  169.  
  170. MODIFY SETTINGS
  171. ---------------
  172.  
  173. These controls mainly determine how converted text looks, and where
  174. on the paper the text is to be presented.
  175.  
  176. Output file extension      No change
  177.                            Fixed as 
  178.                            Numeric incrementing from 
  179. Display units              Inches
  180.                            Centimeters
  181.                            Points
  182.  
  183. Printer                    The choice of printer may dictate 
  184.                            available fonts and form sizes/orientations.
  185.                            Different font and paper mapping may be done
  186.                            for each printer.
  187. Output paper               Source form or any other paper size 
  188.                            available.
  189.  
  190. Top crop area              Initial values will be obtained from the  
  191. Bottom crop area           selected printer. If text margins infringe 
  192. Left crop area             these values, text will be repositioned at 
  193. Right crop area            the crop area. Any value up to a total of 
  194.                            1/3 of the paper width may be input.
  195.  
  196. Set margins                This will fix the document margins at the 
  197.                            values set in the crop areas.
  198. Linedraw action            Replace linedraw characters with spaces 
  199.                            (ie strip); with bar characters, or with a
  200.                            font containing the linedraw character set.
  201. Linedraw font              Select the linedraw font.
  202. Maintain text position     Causes text positioned by required backspace
  203.                            and ZICR controls to be positioned within
  204.                            a frame.
  205. Maintain formatted text    Causes text generated by controls to be 
  206.                            converted as body text. The control 
  207.                            generating the text is stripped.
  208. Body text adjustment       Enables the last typing line in a DCA/RFT
  209.                            document to be increased in 1/100" 
  210.                            increments, which can stop Ami Pro breaking
  211.                            pages too early.
  212. Page breaks                Forces all pages to be terminated with a 
  213.                            required page break.
  214. Set absolute tabs          Sets DCA/RFT tabs with respect to the 
  215.                            page edge rather than to the left margin.
  216. Use tables only            Translates Ami Pro multi-column text as 
  217.                            tables.
  218. Set prompted stops         Translates Ami Pro bookmarks as single and
  219.                            multibyte controls to maintain the comment
  220.                            portion into DW370. The dual control is 
  221.                            picked up by the DisplayWrite READER as a
  222.                            single control on the round-trip to re-create
  223.                            the bookmark with comment.
  224. Use space above/below      Translates space above/below as either 
  225.                            RCR or sub/superscript controls, or 
  226.                            ignores any value.
  227. Stops for bullets          Translates all Ami Pro bullet characters to 
  228.                            DCA periods.
  229. Use counter controls       Translates Ami Pro numeric bullets to DCA
  230.                            counter controls, or the text equivalent of
  231.                            the control. 
  232. Sonoran width scaling      Allows the average character width to be 
  233.                            scaled accurately relative to the effective
  234.                            pitch.
  235. Strip Non-Text Objects     If you are not using protocol driven 
  236.                            printers, graphics may cause printing 
  237.                            problems. Use this control to strip 
  238.                            graphics from your documents
  239.                            when converting to DCA-RFT.
  240. Ignore Right Indents       This control causes any right indention
  241.                            to be ignored when converting to DCA-RFT,
  242.                            to reduce the number of LineFormatChanges.
  243. Map Extended Character     If your DW370, environment does not 
  244.   Set                      support graphics/extended character set, 
  245.                            then any character that would have had a 
  246.                            match in that set can be mapped to a 
  247.                            default character.
  248.  
  249.  
  250. ====================================================================
  251.  
  252.  
  253. FONT MAPPING
  254. ============
  255.  
  256. Converting from Ami Pro to DCA-RFT
  257. ----------------------------------
  258.  
  259. Select the type of mapping required and optionally set the DisplayWrite
  260. column margins. Text will be fully reformatted between the selected 
  261. column margins. Go to the selected Font Map page and set up your map.
  262.  
  263.  
  264. Map Type 1
  265. ----------
  266. Standard Font Map -  Convert Ami Pro fonts to complementary DCA-RFT 
  267.                      typestyles. Use this map if for every incoming
  268.                      font there is a matching DCA-RFT typestyle.
  269.  
  270. The Available Input Fonts are DisplayWrite typestyles. 
  271. DOCFONT.INI is the source for this list box. 
  272. The Source font is the Ami Pro font which is to be mapped to one
  273. or more DCA typestyles. 
  274.  
  275. An Ami Pro scaleable font will need to be mapped to multiple
  276. typestyles. eg Ami Pro font Courier will need to be mapped to 
  277. typestyles 10,85 & 223 in the event that font Courier is used
  278. at 12pt, 10pt and 8pt. The conversion process will map the 
  279. incoming font to a typestyle that gives the nearest match.
  280.  
  281.                       Press SAVE to form the map.
  282.  
  283. OR
  284.  
  285. Map Type 2
  286. ----------
  287. Custom Font Map   -  Convert Ami Pro fonts to a range of typestyles
  288.                      of equal width ie 12 pitch. Use this map to 
  289.                      create uniform output for DCA-RFT. Map specific
  290.                      fonts and sizes to exact DCA-RFT typestyles,
  291.                      which can then be re-mapped to the correct
  292.                      Ami Pro font and size for the roundtrip in the 
  293.                      Convert to Ami Pro Conversion Folder.
  294.  
  295. The source font is the Ami Pro document font at a specified size
  296. which will map to a DCA Typestyle.
  297.  
  298.                      Press SAVE to form the map.
  299.  
  300. OR
  301.  
  302. Map Type 3
  303. ----------
  304. Single output font - Convert all Ami Pro fonts to a single DCA-RFT
  305.                      typestyle. 
  306.  
  307.                      Press SAVE to form the map.
  308.  
  309.  
  310. NOTE
  311. ----
  312. A Conversion Folder can have only one active font map. 
  313. If you need multiple mappings set up additional Conversion Folders
  314. through the Conversion Templates
  315.  
  316.  
  317.  
  318. Defaults
  319. ========
  320. Unmapped incoming fonts will convert to a nearest match typestyle. 
  321.  
  322.  
  323.  
  324.  
  325. Converting from DisplayWrite/RFT to Ami Pro
  326. ===========================================
  327.  
  328. Standard Font Map
  329. -----------------
  330. The Unmapped Input Fonts are DisplayWrite typestyles. 
  331. The Target font is the required Ami Pro font. 
  332. Multiple typestyles can be mapped to a single Target font.
  333.  
  334. To map a typestyle, select the typestyle(s) and press the MAP
  335. button. The selection(s) will appear in the Mapped typestyle box.
  336.  
  337.  
  338. Custom Font Map
  339. ---------------
  340. The Unmapped Input Fonts are DisplayWrite typestyles. 
  341. The Target font is the required Ami Pro font. 
  342. Point size is the height of the required Ami Pro font.
  343.  
  344. To map a typestyle, select the typestyle and the required Ami Pro
  345. font and point size and press the MAP button. The selection will
  346. appear in the Mapped typestyle box.
  347.  
  348.  
  349.  
  350. Defaults
  351. --------
  352. Unmapped fixed pitch typestyles map to font Courier.
  353. Unmapped proportional spaced serifed/sans serifed typestyles will 
  354. map to Times Roman and Helv respectively.
  355.  
  356.  
  357. ====================================================================
  358.  
  359.  
  360. ADD FONT
  361. --------
  362. Documents may contain fonts that are not included in the default
  363. font list. Use this page to enable these fonts for mapping. 
  364. The notebook will need to be closed and reopened for the font map
  365. list to be updated.
  366.  
  367. ====================================================================
  368.  
  369.  
  370. SET APPLICATION
  371. ---------------
  372.  
  373. This page defines an application association for the current 
  374. Conversion Folder. An application name with full path must be 
  375. entered for the association to be formed. 
  376. If the application supports command line launching, tick the box.
  377. If the application can respond to DDE instructions, enter the DDE
  378. information on the sub-page.
  379.  
  380. Ami Pro DDE information is automatically entered during folder 
  381. instantiation.
  382.  
  383. If the application accepts drag/drop then the icon is enabled for 
  384. conversion.
  385.  
  386. ====================================================================
  387.  
  388. TEMPLATES
  389. ---------
  390.  
  391. Templates allow multiple definitions of conversion set-up.
  392. Each implementation of the DisplayWrite editor has different properties.
  393. Some may have scaleable fonts, or may not support numbered lists,
  394. or use of stop and prompted-stop codes, or line-draw. These features
  395. may need to be handled differently when documents are shared across a
  396. divers organisation
  397.  
  398.  
  399. Example : 
  400. An organisation has DW370, DW5 and Ami Pro. Line-draw is used 
  401. in DW5 and Ami Pro but not in DW370.
  402.  
  403. Drag two DisplayWrite/RFT templates to the DCM folder or the desktop.
  404. Select one of the Conversion Folders and open the notebook at "Modify Settings", and change the Line-draw option to "Use bar characters", 
  405. change the folder title to "Convert to DW370" and exit.
  406. Select the other Conversion Folder and at the "Modify Settings" page 
  407. choose "Use extended char. set", change the folder title to 
  408. "Convert to DW5" and exit.
  409.  
  410. When converting documents decide which conversion is appropriate and 
  411. use that folder. The same thing can be done for Ami Pro, which allows
  412. line-draw to be stripped or converted as bar characters or spaces.
  413.  
  414. Because multiple definitions are allowed multiple applications can be 
  415. seamlessly enabled for conversion services. Each Conversion Folder 
  416. controls the shape of the information passed to a defined application.
  417.  
  418.  
  419. END
  420.