home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / a / backthrow / !backthrow_!Readme < prev    next >
Encoding:
Text File  |  1993-02-07  |  4.9 KB  |  114 lines
  1. !Readme - file for !backthrow 0.2
  2. =================================
  3.  
  4. This package contains:
  5.  
  6.    !backthrow                  - the application directory
  7.    !backthrow.!Help            - simple Help file
  8.    !backthrow.!Run
  9.    !backthrow.!Runimage
  10.    !backthrow.!Sprites
  11.    !backthrow.Templates
  12.    !backthrow.Messages           - messages file for the desklib message system.
  13.    !backthrow.!Readme          - this file
  14.    !backthrow.c.main           - source code, the wimp interface.
  15.    !backthrow.c.backthrow      - backthrow routines source code
  16.    !backthrow.c.throwback      - source code, library with throwback SWI interf.
  17.    !backthrow.h.throwback      - header file for ^^^
  18.    !backthrow.h.backthrow      - header file for backthrow.c
  19.    !backthrow.Makefile         - the makefile
  20.    !backthrow.o                - object file directory
  21.  
  22.  
  23. What and whatfor
  24. ================
  25.   This is a program that takes the files you get when you save the contents
  26. of the output windows of !cc, !pc, !find, and probably others, and feeds
  27. them back to the throwback system of the ddeutils module, so that you can
  28. work with these as if they were the throwback windows from said applica-
  29. tions.
  30.   I wrote it because when I port large programs, I first run them through
  31. amu with errors ignored, so that I get a list of all errors CR4 finds in the
  32. ported program, and then fix them all in one go rather than compiling
  33. source module by source module... But if I do so, I loose the ability to use
  34. throwback, if I don't want to leave the computer on until the port is done.
  35. So here's the solution: it allows me to reuse the contents of the standard
  36. output windows from these programs, by feeding them to the throwback system
  37. when I need to.
  38.  
  39. Input file format
  40. =================
  41.   Currently !Backthrow assumes the following format on input files:
  42. Every line holds one message, and has the format:
  43. "path.name", line 123: error: dis is da message
  44. , where error is one of 'Warning:', 'Error:' or 'Serious error:', or
  45. "path.name", line 123: dis is da message
  46.   The first line will be 'thrown back' as an error message, the second line
  47. as an info message. Lines that do not have this format are ignored.
  48.   These formats are generated by the C compiler (at least the release 4
  49. one), DDE pascal, and by DDE !Find.
  50.  
  51. Rebuilding the program
  52. ====================
  53.   You get source code of the program. To build it, get and install
  54. Desklib (preferrably a bugfixed version...), and the Menus-library for
  55. Desklib. You may have to alter the makefile, but after that you should
  56. be able to just start amu, then drag the makefile inside the applica-
  57. tion directory to amu, wait, and go. 
  58.  
  59. Use
  60. ===
  61.   When you start the application, it installs an icon on the iconbar.
  62. If you click with select on this icon, a dialog box opens which has a
  63. writable icon, and an OK and a CANCEL button. There are no additional
  64. options, the only things you pass to the program are the names of the
  65. files whose contents you wish to be fed to the throwback system. You
  66. just drag them to either the iconbar icon or the setup dialog box of
  67. !Backthrow. Multiple input files are supported.
  68.   You start the throwback process by clicking the OK button. A throw-
  69. back server (for example !srcedit or !zap) should open throwback
  70. window, and start filling it with information from the input files,
  71. you can then use this throwback window as usual. However, you may have
  72. to make the directory, where the source is, the CSD, if the pathnames
  73. in the backthrow input file are not full pathnames.
  74.  
  75. Caveats
  76. =======
  77.   Everything seems to work fine. Of course, there are zillions of
  78. bugs, but as I wrote the program, they will not occur to me. A known
  79. problem arises when you use !backthrow with zap under RO2: as zap
  80. opens one window for every throwback_processing message it receives, 
  81. it may happen that you get a 'too many windows' message under RO2.
  82. As far as I know, this is fixed under RO3.
  83.  
  84. Copyright status
  85. ================
  86.   The !Backthrow application is freeware. You may not sell it, but apart
  87. from this you may do anything with it provided that you keep my name in it.
  88.   The throwback SWI interface (throwback.c, throwback.h) is public domain.
  89. This means you may do anything with it, that is, you may sell it, use it in
  90. your programs, produce a hexdump of it and pin it to your toilet wall, or
  91. even claim you wrote it.
  92.  
  93. I hope you find this a useful program.
  94.  
  95. Suggestions, donations, bugs
  96. ============================
  97.   Send all of the above to
  98.         gunnar@fasel.robin.de             or
  99.         zoetl@isa.informatik.th-darmstadt.de
  100.  
  101. History
  102. =======
  103.  
  104. Version:
  105. --------
  106. 0.3         Awful, awful... yes, there were some bugs. Hope I got them
  107.             all...
  108. 0.2         Wrote a new desktop frontend with desklib. The frontend is
  109.             still kinda crappy, because I could not figure out how to
  110.             do some things, but it works, and does not add too much to
  111.             the code. The throwbacking does not yet multitask, but
  112.             this does not matter too much as it is rather fast.
  113. 0.1        Just a small program with a DDE frontend.
  114.