home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / developer / makelanguage.1.0.README < prev    next >
Encoding:
Text File  |  1995-12-08  |  3.2 KB  |  102 lines
  1. makelanguage - automatic ProjectBuilder 'make'
  2. of multiple language versions in a single run
  3.  
  4.  
  5. WHO'S IT FOR? Everyone who develops multi-language, localized applications.
  6.  
  7. WHY THE NEED? Suppose you have edited some nib files or help files
  8. both in, say, English.lproj and German.lproj. In ProjectBuilder, you then
  9. have to 'make' the stuff in one language, then change to the 'Attributes'
  10. section, enter the name of the other language into the 'Language'
  11. text field, save the project, change back to the 'Builder' section,
  12. then 'make' again, and so on and so forth...  This is disgusting.
  13.  
  14. WHAT DOES makelanguage DO? It compiles multiple language versions
  15. (i.e. copies nib files and triggers compresshelp as needed) in a
  16. single 'make' run, without the need to change back and forth between
  17. ProjectBuilder's 'Attributes' and 'Builder' sections.
  18.  
  19. HOW DO I PUT IT TO WORK? All you have to do is to compile the supplied
  20. makelanguage.c, place it in any of your standard paths, and do some
  21. very small editing of your makefiles. See below on how to set things up.
  22.  
  23.  
  24. THE makelanguage UTILITY IS FREEWARE, SUPPLIED "AS IS".
  25. USE IT TO YOUR LIKING, BUT DON'T BOTHER ME IF SOMETHING
  26. GOES WRONG.
  27.  
  28. For suggestions of any kind,
  29. you're welcome to contact me at <stefan@ping.at>.
  30.  
  31. Have fun,
  32.  
  33. - Stefan
  34.  
  35. ------------------------------
  36. Stefan Schneider
  37. Lerchenfelder St. 85/6
  38. A-1070 Vienna, Austria, Europe
  39. <stefan@ping.at>
  40. ------------------------------
  41.  
  42.  
  43.  
  44. Now here's what you have to do:
  45.  
  46.  
  47. 1) Compile the source file makelanguage.c into an executable
  48. and place it somewhere in your standard paths. For instance:
  49.  
  50. cc makelanguage.c -o ~/Apps/makelanguage
  51.  
  52.  
  53. 2) In file /NextDeveloper/Makefiles/app/app.make,
  54. change (as root) the line 
  55.  
  56. project::   $(INITIAL_TARGETS) toplevel_subcomponents
  57. resources $(PRODUCT)
  58.  
  59. to
  60.  
  61. project::   $(INITIAL_TARGETS) toplevel_subcomponents
  62. resources $(PRODUCT) $(LATE_TARGETS)
  63.  
  64. Note: both of the above two-liners are, in reality, a single
  65. line. In Dev3.3, this is line #123. What you have to do is
  66. to append " $(LATE_TARGETS)" to the end of that line.
  67.  
  68. This modification adds a LATE_TARGETS entry to be built after
  69. everything else. The modification does no harm at all - if a
  70. project doesn't contain a LATE_TARGETS entry, then simply
  71. nothing additionally happens.
  72.  
  73.  
  74. 3) in your project's Makefile.preamble file,
  75. add the following lines:
  76.  
  77. LATE_TARGETS = make_other_languages
  78.  
  79. make_other_languages::
  80.     @(makelanguage German $(PRODUCT_ROOT))
  81.     @(makelanguage French $(PRODUCT_ROOT))
  82.  
  83. In this example, both the German and the French version will be
  84. built after the English one (that is, if English is the language
  85. that you have set in ProjectBuilder's 'Attributes' section).
  86.  
  87. You can add as many invocations of makelanguage as required,
  88. for as many different language versions you are maintaining.
  89.  
  90. A single invocation of makelanguage makes a single language version.
  91.  
  92. Keep in mind that the 'main' language - the one set in the
  93. 'Attributes' section - is built by ProjectBuilder, and that all
  94. 'additional' ones are built by makelanguage.
  95.  
  96. Steps (1) and (2) have to be performed once only.
  97. Step (3) has to be performed once per project.
  98.  
  99. One final hint: don't forget to touch the TableOfContents.rtf file
  100. after having edited some help files deeper down the help dir tree,
  101. or else compresshelp won't do its job.
  102.