home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / xfld085s.zip / changelog.txt < prev    next >
Text File  |  1999-03-15  |  16KB  |  469 lines
  1.  
  2. General Notes
  3. =============
  4.  
  5. The following files change with practically every XFolder
  6. version:
  7.  
  8. --  in /001/inf.001:
  9.     notices_41thanks.html
  10.     notices_42credits.html
  11.     vers_2history.html
  12.  
  13.     Since I do not add version information to those files,
  14.     I therefore do not recommend translating those. Simply
  15.     always use the current English original.
  16.  
  17. For all other source files for the HLP and INF files, I try
  18. to always add HTML comments ("<!-- ... -->") to signal what
  19. has changed in a source file. I recommend having some "grep"
  20. utility handy to be able to search for strings like "V0.84".
  21. \OS2\APPS\PMSEEK.EXE should do also.
  22.  
  23.  
  24. Changes for V0.85
  25. =================
  26.  
  27.     xfldr001.inf:
  28.         not too many changes this time, except for the
  29.         new documentation of WPS boot logos.
  30.         As always, "grep" the new INF.001 directory for
  31.         "V0.85" strings, which should lead you to the
  32.         separate paragraphs which might have changed.
  33.  
  34.     instl001.cmd: fixed a bug in line 49/50.
  35.  
  36.  
  37. Changes for V0.84
  38. =================
  39.  
  40.     National Language Support
  41.     -------------------------
  42.  
  43.     I have converted the various information in the NLS.TXT
  44.     and README.TXT files into a proper INF book and updated
  45.     lots of stuff. Please read through that thing and check
  46.     what's new.
  47.  
  48.     Note: The files in /TOOLS have been partly updated.
  49.           Please use the newer versions.
  50.           HTML2IPF has been moved into a separate directory
  51.           in /001/TOOLS so that I can keep the different
  52.           NLS versions that you have created apart. The
  53.           makefiles in /INF.001 and HELP.001 have been
  54.           updated accordingly. The HTML2IPF environment
  55.           variable is no longer needed.
  56.  
  57.     xfldr001.rc:
  58.         I have removed the xfldr1.ico and xfldr2.ico files.
  59.         Since the corresponding dlg id's are no longer defined
  60.         in dlgids.h, please remove the following two lines from
  61.         the top of xfldr001.rc:
  62.             POINTER ID_ICON1 LOADONCALL MOVEABLE DISCARDABLE xfldr1.ico
  63.             POINTER ID_ICON2 LOADONCALL MOVEABLE DISCARDABLE xfldr2.ico
  64.         or you'll get errors from the resource compiler.
  65.  
  66.     xfldr001.inf:
  67.         As always, do a global search in the new INF.001
  68.         directory for "V0.84" strings, which should
  69.         lead you to the separate paragraphs which
  70.         might have changed. As always, I have marked
  71.         the changed items with HTML comments. You can
  72.         then update your translation.
  73.         Additional remarks can be found in the HTML
  74.         source files themselves.
  75.  
  76.         Be aware that I've rearranged all the status bar
  77.         pages, because all the codes on that one page
  78.         were hard to overlook. The text really hasn't
  79.         changed much, except for two panels.
  80.         Do the following:
  81.         1)  copy and execute /001/ren084.cmd, which will rename
  82.             a couple of files and update links;
  83.         2)  remove the links as specified in 0632intro_folders.html;
  84.         3)  copy the new 0632intro_statbars.html to your translation
  85.             directory and update the "root" file (xfldr001.html);
  86.         4)  copy all the new stat_*.html files to your translation
  87.             directory; for the two files which are reported to exist
  88.             already, choose "rename existing" (if you're using the
  89.             XFolder replacement dialog);
  90.         5)  translate these files. These have been composed from the
  91.             the old status bar documentation, so there's little to
  92.             actually translate. You can simply copy your old
  93.             translations to the new files. See the notes in those files
  94.             for details.
  95.  
  96.         Also, I have integrated the NetscDDE documentation into the
  97.         main INF file. Copy all nsd_* files into /inf.001 and also
  98.         netscape.gif.
  99.  
  100.     xfldr001.hlp:
  101.         "set_11replicons.html" has been altered to reflect
  102.         the new icon features.
  103.  
  104.     xfldr001.sgs:
  105.         two more pages were inserted into the SmartGuide script, as
  106.         suggested by Roger Lindmark, Sweden. Look for "V0.84" strings
  107.         again.
  108.  
  109.     xfcls001.txt:
  110.         changed a few more class descriptions. See the
  111.         notes at the bottom of that file.
  112.  
  113.  
  114.     /MAIN
  115.     -----
  116.  
  117.     Oh, just lots of stuff. Separated more files into more files
  118.     again, and lots of little changes. I was too lazy to document
  119.     all this any more.
  120.  
  121.  
  122. Changes for V0.83
  123. =================
  124.  
  125.     National Language Support
  126.     -------------------------
  127.  
  128.     xfldr001.inf:
  129.         I have rearranged the panels in the table
  130.         of contents to make the documentation a
  131.         bit clearer, because it was getting difficult
  132.         to overlook what was where. You will need to
  133.         change the following:
  134.  
  135.         1) use the updated root file (xfldr001.html)
  136.            because the level-1 entries have changed;
  137.         2) put "/tools/strrpl.exe" on your PATH;
  138.         3) execute "/inf.001/ren083.cmd" on your
  139.            existing translation to have all your files
  140.            renamed and links updated automatically.
  141.            I have written this to aid you in the
  142.            process of rearranging the documentation;
  143.            this should also help for future updates,
  144.            because every time I change something, it
  145.            makes me feel bad since this is additional
  146.            work for you. ;-)
  147.  
  148.         Then do a global search in the new INF.001
  149.         directory for "V0.83" strings, which should
  150.         lead you to the separate paragraphs which
  151.         might have changed. As always, I have marked
  152.         the changed items with HTML comments. You can
  153.         then update your translation.
  154.  
  155.     /HELPERS
  156.     --------
  157.  
  158.     -- new stringh.* files which contain all the
  159.        string helper functions previously located
  160.        in dosh.*, which didn't make much sense.
  161.        These funcs have the "strh*" prefix.
  162.  
  163.     /MAIN
  164.     -----
  165.  
  166.     Reworked xfldr.mak so that the /HELPERS .OBJ
  167.     files are created in /MAIN too. That's because
  168.     my other software uses the helper functions too,
  169.     and might need different compiler options for
  170.     them, so we need different .OBJ files. Also, this
  171.     makes the makefiles a bit clearer.
  172.  
  173.     Also, there were a few false shaky compiler
  174.     options in the makefiles for V0.82, which made
  175.     XFolder refuse to work sometimes. That was just
  176.     if you tried to compile it for yourself.
  177.  
  178.  
  179. Changes for V0.82
  180. =================
  181.  
  182.     National Language Support
  183.     -------------------------
  184.  
  185.     Just a few corrections and additions. Note that
  186.     XFolder V0.82 will work with V0.81 NLS support,
  187.     so changing the following stuff is not required
  188.     to make V0.82 work.
  189.  
  190.     xfcls001.txt:
  191.     --  added a few more class descriptions.
  192.  
  193.     xfldr001.hlp:
  194.     --  I've updated a few help panels because they
  195.         contained outdated information. To update
  196.         your translations, see the notes for
  197.         xfldr001.hlp for V0.81 below.
  198.  
  199.     xfldr001.inf:
  200.     --  Updated a panels here also.
  201.     --  Split up the "FAQ" section across several
  202.         pages and added more questions.
  203.  
  204.     xfldr001.dlg:
  205.     --  first "Context menu" page had "Widerrufen"
  206.         and "Hilfe" buttons. That's German for "Undo"
  207.         and "Help", in case you didn't find out. ;-)
  208.         Changed this to the English counterparts.
  209.         (That's the ID_XSD_SET25ADDMENUS template
  210.         again.) This is just a bug in the English
  211.         support, so don't worry.
  212.     --  There was a slight bug in ID_XSD_SETTINGS_DTP1.
  213.         The "1.1" entry should have had an ID of
  214.         "ID_XSDI_SD_APMVERSION"; replace the "-1" with
  215.         that string.
  216.  
  217.     /HELPERS
  218.     --------
  219.  
  220.     -- procstat.*: changed all the function
  221.        prefixes to "prc".
  222.  
  223.     -- eas.*: dramatic speed increase (up to
  224.        300%) for querying size of EAs for a file.
  225.  
  226.     -- winh.*: new function winhAssertWarp4Notebook
  227.        to make buttons Warp-4-notebook compatible.
  228.  
  229.     /MAIN
  230.     -----
  231.  
  232.     Major changes to many files.
  233.     See the XFolder Revision history in the INF files.
  234.  
  235.  
  236.     Miscellaneae
  237.     ------------
  238.  
  239.     repclass.c: made the text output a bit more lucid.
  240.  
  241.     treesize.*: now using faster /helpers/eas.* code,
  242.         more options, etc. See "Revision history" in
  243.         the INF file.
  244.  
  245.  
  246. Changes for V0.81
  247. =================
  248.  
  249.     National Language Support
  250.     -------------------------
  251.  
  252.     Sorry, I promised not to change anything, but the
  253.     problems which have arised with V0.80 forced me
  254.     to redesign a number of things. Also, a few users
  255.     complained about outdated or incomplete help panels,
  256.     so I changed a number of those also.
  257.  
  258.     If you are currently working on the translation
  259.     of XFolder to your language, don't worry. You won't
  260.     have to re-translate everything. See the notes
  261.     below.
  262.  
  263.     HOWEVER, please mind the following notes, especially
  264.     because "main/dlgids.h" has changed.
  265.  
  266.     *.ipf: I have removed these files from the source
  267.         package, because you can easily create them
  268.         yourself and I'm running out of web space.
  269.         Run "make.cmd" to have them created, if you
  270.         need them.
  271.  
  272.     html2ipf.cmd: I have made more changes to that
  273.         excellent utility to make it more
  274.         HTML-compliant. I suggest using the newer
  275.         version. Put it on your PATH somewhere
  276.         See NLS.TXT for details.
  277.  
  278.     xfldr001.hlp:
  279.         - reworked various menu-item help panels to
  280.           display additional information where this
  281.           menu item can be configured.
  282.         - changed help panels for "Context menu"
  283.           page, because that page has also changed.
  284.  
  285.         To keep your existing translation efforts
  286.         intact, do the following:
  287.  
  288.         1) open the _new_ HELP.001 directory (I
  289.            recommend using small icons)
  290.         2) sort everything by "last write date"
  291.         3) delete all the files that are older
  292.            than the release date of the old
  293.            XFolder source package, i.e. Oct. 1,
  294.            1998.
  295.         4) Copy all the files from the _old_ HELP.001
  296.            directory into the _new_ directory. When
  297.            the WPS asks you whether to replace a
  298.            file, always select "Cancel" for that
  299.            file so that it's not replaced.
  300.  
  301.         As a result, you should now have an updated
  302.         HELP.001 directory. For the remaining files,
  303.         i.e. those which I have changed, look into
  304.         the .HTML files where I have inserted comments
  305.         about what has changed. Most of the time,
  306.         it's only one paragraph, so you can use your
  307.         translation and update it.
  308.  
  309.         Sorry for the hassle.
  310.  
  311.     xfldr001.inf:
  312.         - updated "Comments" page.
  313.         - combined "Known limitations" and "Tips&Tricks"
  314.           into a new and updated "FAQ" section. That is,
  315.           "vers_3limit.html" and "070tips.html" have
  316.           been removed. Instead, there's now "070faq.html".
  317.         - updated outdated link descriptions which
  318.           now refer to the "Workplace Shell" object.
  319.  
  320.         Apply the same procedure as with the .HLP files
  321.         described above.
  322.  
  323.     xfldr001.rc:
  324.         - one listbox item was still called "Insert",
  325.           but it should have been "Paste".
  326.  
  327.     xfldr001.dlg:
  328.         - the "Add context menu items" page was
  329.           redesigned. It is at the very bottom of
  330.           the .DLG text file (ID_XSD_SET25ADDMENUS)
  331.  
  332.         NOTE: If you have already translated parts of
  333.         the dialog resources, do not simply copy stuff
  334.         around and then open the .RES file with the
  335.         dialog editor, because the dlgids.h file has
  336.         changed. This will blow up all the dialog ID's,
  337.         rendering your NLS DLL unusable.
  338.  
  339.         Instead, do the following:
  340.  
  341.         1) delete the ID_XSD_SET25ADDMENUS dialog
  342.            template from your old .DLG file (all the
  343.            stuff between "DLGTEMPLATE ID_XSD_SET25ADDMENUS"
  344.            and the "END" statement on the same level)
  345.         2) copy the same template from the new .DLG file
  346.            to the bottom of your old .DLG file
  347.         3) copy the old .DLG file into the new \001
  348.            directory
  349.         4) re-make the NLS DLL to have the .RES file
  350.            updated.
  351.  
  352.         You can _then_ open the .RES file with the
  353.         dialog editor.
  354.  
  355.     dlgid's.h (in the \MAIN directory):
  356.         - changed a number of dialog ID's. This affects
  357.           the dialog templates, as described above.
  358.  
  359.  
  360.     Main Module
  361.     -----------
  362.  
  363.     Looks like we have much more source code, but actually
  364.     we have less. ;-) I have added a lot more files though
  365.     and spread the code across these new files to make it
  366.     easier to find certain functions.
  367.  
  368.     Check the new section in readme.txt about the new
  369.     function prefixes which will allow you to determine
  370.     the source file from the function name.
  371.  
  372.     Also removed some dead code from all the files.
  373.  
  374.     New source files:
  375.         - all the files in the new /HELPERS directory;
  376.           I have extracted the helper functions from the
  377.           various source files which should be possible
  378.           to compile without XFolder and put all these
  379.           in here. Check the header files for a
  380.           description of what these do.
  381.         - /main/menus.* for all the menu functions formerly
  382.           in xfldr.c
  383.         - /main/module.* for DLL initialization/termination
  384.         - /main/statbars.* for status bar mnemonic logic which
  385.           was previously done using SOM multiple inheritance
  386.  
  387.     Renamed xfsort.* to cnrsort.* so that it does not
  388.     look like SOM code any more.
  389.  
  390.     Renamed objdlgs.* to classlst.* and made it contain
  391.     only the "WPS class list" code.
  392.  
  393.     all xf*.* files:
  394.         - SOM hierarchy changed
  395.         - multiple inheritance removed
  396.         - removed xfclsQueryModule methods and calls thereto
  397.           and replaced these with calls to the new module.c
  398.           functions
  399.  
  400.     Replacement class XFldProgram removed.
  401.  
  402.     common.*:
  403.         - moved animation code to /helpers/animate.*.
  404.         - moved XFldObject::xfCreateFromTemplate to
  405.           cmnCreateFromTemplate into this file; added
  406.           more error checking
  407.  
  408.     classlst.h:
  409.         - changed all function prefixes to cls*.
  410.         - moved "Object Internals" to xfobj.c,
  411.           where it makes more sense
  412.  
  413.     dlgids.h:
  414.         see NLS section below.
  415.  
  416.     xfldr.c:
  417.         - removed several SOM methods.
  418.         - moved all the menu functions into the new
  419.           menus.c file.
  420.  
  421.     xfdesk.c:
  422.         - changed all the animations to use the new
  423.           improved animation code in /helpers/animate.c.
  424.  
  425.     xfdisk.c:
  426.         - changed those xfQuery* funcs to work on non-
  427.           removeable drives only.
  428.  
  429.     xffsys.c:
  430.         - removed several SOM methods.
  431.         - moved all the "settings" menu functions into
  432.           the new menus.c file.
  433.  
  434.     xfobj.c:
  435.         - removed several SOM methods.
  436.         - moved all the "settings" menu functions into
  437.           the new menus.c file.
  438.  
  439.     xfsys.c:
  440.         - fixed a few bugs in CONFIG.SYS handling
  441.         - changed dlg* functions to stg*
  442.         - changed replaced WPSystem methods so that
  443.           XFldWPS now inherits WPSystem pages, while
  444.           XFldSystem ("OS/2 Kernel") does not.
  445.  
  446.     xfldr.mak:
  447.         - inference rules updated (incomplete in V0.80).
  448.         - new dependencies on /helpers/helpers.mak.
  449.         - made icc produce separate precompiled header
  450.           files for each .C file.
  451.  
  452.     xfldr.rc:
  453.         - removed that dull menu template which kept
  454.           XFolder from building properly.
  455.  
  456.     install.cmd:
  457.         - deregistering old / registering new classes
  458.  
  459.     inst*.msg:
  460.         - install *.msg files updated for this
  461.  
  462.     crobj*.cmd:
  463.         - moved code for non-config-folder objects into
  464.           new scripts "instl*.cmd" which are only
  465.           executed after installation.
  466.  
  467.  
  468.  
  469.