home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / docx2_01.zip / readme.os2 < prev   
Text File  |  1997-08-12  |  3KB  |  107 lines
  1. =====================================================================
  2. DOC++ v3.01 -- OS/2 port release 0.1                      6. AUG 1997
  3. =====================================================================
  4.  
  5. GENERAL:
  6. --------
  7.  
  8. This is my OS/2 port of DOC++ 3.01. I have used the famous GNU-C
  9. emx 0.9c (fix03). If you have some problems with the OS/2 port,
  10. just drop me a line. I can be reached by eMail. See the end of
  11. the file!
  12.  
  13. At this time, I would like to thanks Eberhard Mattes for his EMX
  14. compiler and Roland Wunderling / Malte Zöckler for DOC++!
  15.  
  16. DOC++ is (c) Copyright by Malte Zöckler and Roland Wunderling.
  17. The original sources are located at
  18.  
  19.     http://www.zib.de/Visual/software/doc++/index.html
  20.  
  21.  
  22. The home of the OS/2 port is:
  23.  
  24.     http://home.t-online.de/home/Joerg.Desch/index.html
  25.  
  26. Here you can find the links to the current release.
  27.  
  28.  
  29.  
  30. INSTALLATION:
  31. -------------
  32.  
  33. This is really simple. Just copy the EXE to a directory in the PATH.
  34. Copy the DOCXX.STY somewhere in the texinput directory tree. I'm
  35. using \emtex\texinput\jd\!
  36.  
  37.  
  38.  
  39. THE PORT:
  40. ---------
  41.  
  42. The port of DOC++ was really easy. ;-)
  43. To compile with emx, I have changed the following files:
  44.  
  45.   DOC.H MCDIRECTORY.H MAKEFILE
  46.  
  47. I use a #elif __EMX__ construction to separate the patches. I've
  48. stripped the makefile to an absolute minimum. Sorry ;)
  49.  
  50.  
  51.  
  52. EXTENSIONS:
  53. -----------
  54.  
  55. The extensions are only active, if you are using the LaTeX tags 
  56. inside the DOC++ comments. If you prefer the HTML tags, you have
  57. to use ä instead of "a or ä. One more 'sorry' ;)
  58.  
  59. DOC++ supports the LaTeX notation for the germam 'Umlaute'. Writing
  60. \"a instead of ä is really awkward. So I added the shortcuts of the
  61. package 'german.sty'. Now you can use "a or "s and DOC++ will
  62. produce correct (HTML) output.
  63.  
  64. Nevertheless, I want to have direct support of the codepage 850.
  65. The current release of the port have a new commandline parameter
  66. to enable the PC character set. With -P DOC++ will convert the
  67. german 'Umlaute' for the HTML output. For LaTeX-Output, this
  68. option add the line '\usepackage[cp850]{inputenc}'.
  69.  
  70. So, to get a german LaTeX document, commandline should look like
  71. this: "docxx -t -P -ep german.sty ...."
  72.  
  73. SUM UP: DOC++ could convert the following LaTeX tags to HTML
  74.         \"s "a "o "u "A "O "U "s ä ö ü Ä Ö Ü ß
  75.  
  76.  
  77.  
  78. I've extended the following files:
  79.  
  80.   DOC2HTML.L DOC2TEX.L, TEX2GIF.CPP and MAIN.CPP
  81.  
  82.  
  83.  
  84. SOME NOTES:
  85. -----------
  86.  
  87. The modification are tested under OS/2 Warp-4. There's no reason
  88. why the modifications shouldn't run on the remaining DOC++ platforms.
  89. Just try it. ;)
  90.  
  91. EmTeX have some problems with DOCXX.STY. You can ignore the messages.
  92. The output is correct. I'm no TEX guru, so I have no idea, how to
  93. fix this. Roland Wunderling told me, that some LaTeX ports have
  94. problems this control characters inside TEX commands.
  95. Don't ask me. ;)
  96.  
  97.  
  98. Good Luck...
  99.  
  100. Joerg Desch
  101. jd@gelnhausen.net
  102.  
  103. - Team OS/2 Germany (#1082) -
  104.  
  105. =====================================================================
  106.  
  107.