home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / utilities / hypertext / iv2ag / iv2ag.doc < prev    next >
Encoding:
Text File  |  1994-06-22  |  1.6 KB  |  61 lines
  1. iv2ag
  2. =====
  3.  
  4. GNU InfoView to AmigaGuide database converter V1.02
  5.  
  6. by Alexander Rawass (a_rawass@informatik.uni-kl.de)
  7.  
  8.  
  9.  
  10. With this utility, you can convert *.info files from the GNU InfoView
  11. format into an AmigaGuide database.
  12.  
  13. So you can read those manuals witout using the InfoView interface, but
  14. you can use the AmigaGuide GUI instead.
  15.  
  16. iv2ag will properly process nodes found in the info files, along with
  17. menus and notes found in the text.
  18.  
  19. The nodes from InfoView will convert into nodes for AmigaGuide,
  20. the notes and menus from InfoView will convert into links for
  21. AmigaGuide (which will appear as gadgets in AmigaGuide).
  22.  
  23. To browse through the text, you should better not use the gadgets
  24. at the top of AmigaGuide, but the Up: Next: Prev: gadgets in the
  25. text instead.
  26.  
  27. If you want to convert a whole bunch of InfoView files (like the
  28. whole gcc:info/gcc.info-* manuals, you have to do the following:
  29.  
  30. Convert all *.info-* into different AmigaGuide databases, then
  31. you can join them together to one large file, which will be a
  32. properly database.
  33.  
  34. I use the csh for this, I do it like this:
  35.  
  36.     cd gcc:info
  37.     foreach i ( gcc.info* ) "iv2ag $i t:$i.guide"
  38.     join t:*info-*.guide t:gcc.guide
  39.     delete t:*info-*.guide
  40.  
  41. The AmigaGuide database will then be t:gcc.guide.
  42.  
  43. To convert the cpp files, type in the normal shell:
  44.  
  45. iv2ag cpp.info-1 t:cpp-1
  46. iv2ag cpp.info-2 t:cpp-2
  47. iv2ag cpp.info-3 t:cpp-3
  48. join t:cpp-1 t:cpp-2 t:cpp-3 as t:cpp.guide
  49. delete t:cpp-1 t:cpp-2 t:cpp-3
  50.  
  51. The database will be t:cpp.guide
  52.  
  53.  
  54. Usage:
  55. ------
  56.  
  57. iv2ag <InfoView-file> <AmigaGuide-database>
  58.  
  59. <InfoView-file> is the original InfoView file,
  60. <AmigaGuide-database> is the AmigaGuide database to be written.
  61.