Updating ImoLatE (Update mechanism v1.2, 2006jan6) This file (InstallImolate-Update-README) describes how to update ImoLatE (the IMO LaTeX Environment) from an older version to the current one. (If you want to install for the first time, see the companion file InstallImolate-New-README in the .tgz package you got this file from.) The source file you should have (and may have unpacked) is a tar-gzip file. It is called imolate-.tgz, where is the version you are updating to (i.e. the new one), e.g. imolate-v2.4.00.tgz . If you have a choice of versions, you should normally choose the most recent (highest number) one. VERSION NUMBER CONVENTIONS The is of the form v.., e.g. v2.4.00. I am adopting the Linux convention that odd-number minor versions are development versions and even-number ones are stable releases. Thus you will normally have an even . BEFORE YOU START! The software that guides the installation process attempts not to damage your user data, i.e. the papers you are editing. But no software is perfect, and I have 30 years experience of writing bugs so I am very good at it! Make sure your entire ImoLatE system is backed up before you start. WHERE TO USE THE .tgz FILE You should move (using cd) to the root of your ImoLatE area. For instance, if you keep it in /home/valodija/astro/imolate, you should cd here, not higher or lower in the directory tree. This area is the one with subdirectories for all publications you use, e.g. wgn or imc. HOW TO USE THE .tgz FILE Copy the file to this area. Unpack it with the command tar -xzf imolate-.tgz e.g. tar -xzf imolate-v2.4.00.tgz This should produce several files and one directory. They should not over-write anything (except perhaps older versions of themselves from an earlier update). To help you manage them, they all begin with the stem "InstallImolate", so `dir' lists them together. They are: InstallImolate-New-README README file for a new installation. InstallImolate-Update-README README file for an update. This is the file you are reading now. InstallImolate-Update Shell script to perform the updating. (NB- there is no equivalent for a new installation as it is so simple.) InstallImolate-NewVersionNo Text file with the version number and release date of the version being installed. InstallImolate-Files Directory with the source of all the material to install or update. Before you perform the update, you may first want to read the notes "What will change", below. To perform the update, execute the update shellscript with the command InstallImolate-Update If your directory path ($PATH) does not include `dot', i.e. the current directory, you will have to use ./InstallImolate-Update NOTE, HOWEVER, that the current version of ImoLatE assumes you have dot in the path, so you would probably be unable to use anything anyway ;-) The update shellscript will first make some checks; even if they are passed, it will ask you before it goes ahead and makes any changes. When directories (and some of the files) are replaced by new ones, the old ones are left on the disk but renamed. The new name is the old one with an addition of the old version number (i.e. the one you are updating from). E.g., if your old version is v1.2.34, the directory Software will be renamed Software-v1.2.34. These can be deleted when you are sure they are no longer needed. Unless you are short of disk space, it may be sensible to leave them for several months in case you find some problem. One of the files that is renamed in this way is ImolateVersion, which contains the version number. If you leave all these undeleted, they will grow into a record of which updates you have installed. You must decide whether it is worth keeping this information. The update software also creates a logfile called InstallImolate-Update.log. It is up to you whether you keep this, but if you report a problem please send the logfile with the problem report. After you have performed the update, all the InstallImolate* files and the .tgz file can be removed if you wish. It does no harm if you leave them there (though the InstallImolate-Files directory takes tens of MByte of space). Finally, I would be grateful if you send me an email to tell me you've installed it, unless I already know. I would like to keep a list of people using it so I can inform them of changes. Please email me at c.trayner@leeds.ac.uk . -------------------------------------------------------------------------- The following is a summary: for details, see Imolate-Changelog.txt -------------------------------------------------------------------------- WHAT WILL CHANGE updating to v2.4.08 1. From the user's point of view. Improvements to bibtex style: www type, url and language field, etc. Minor tidyings-up, e.g. contents page. RMS and IMC styles brought into line with what the Editors are using. Bug fix for annoying bash 'feature' in 'cd'. NOTE- other changes are imminent, but a release is needed in a hurry. 2. From the system (i.e. computer) point of view. Changes to the files: imolate/Standard/imo2.sty (minor tidyings-up) imolate/imc/Standard/imc2.sty imolate/rms/Standard/rms2.sty imolate/imc/BlankIssue/UsualPapers/ContentsPage.tex Ditto for rms imolate/rms/BlankIssue/UsualPapers/ - used IMCpaper, now corrected to RMSpaper imolate/Software/bin/MakeIssue & TidyUp Also, if your current version is earlier than v2.4.05, the changes below will be made. Chris Trayner 2006 Jun 22 -------------------------------------------------------------------------- WHAT WILL CHANGE updating to v2.4.05 1. From the user's point of view. Outline: A new publication rms, for the Proceedings of the Radio Meteor School, has been added. The layout of imc (Proc. IMC) is now correct. The layout of rms is the same as imc. Detail: The changes are listed in the file Imolate-Changelog.txt. The new version, which lists the changes you are about to install, is in the InstallImolate- Files subdirectory. This can be examined with an editor or with more InstallImolate-Files/Imolate-Changelog.txt Entries are in reverse chronological order, so you should read down until you get to your current version. 2. From the system (i.e. computer) point of view. A new directory rms has been added at the root level of ImoLatE (i.e. at the same level as wgn and imc) to accomodate the Radio Meteor School. Also, if your current version is earlier than v2.4.00, the changes below will be made. Chris Trayner 2006 Jan 16 .......................................................................... WHAT WILL CHANGE updating to v2.4.00 1. From the user's point of view. The changes are listed in the file Imolate-Changelog.txt. The new version, which lists the changes you are about to install, is in the InstallImolate- Files subdirectory. 2. From the system (i.e. computer) point of view. In the following description, the root of the imolate system is called "imolate". You may have called it something else. 1. The following entire trees (i.e. directories and everything within them) are replaced: imolate/BlankIssue imolate/BlankYear imolate/HelpFiles imolate/Software imolate/Standard imolate/SubsidiaryProductsSources imolate/UsefulInfo imolate//BlankIssue imolate//BlankYear where is a publication, e.g. wgn or imc. These two subdirectories are replaced in any subdirectories you have for publications. These replacements should not matter unless you have added any of your own files (e.g. software), in which you will have to copy them to the new areas after the update has finished. Note that your old directories are left but renamed, as described above. 2. The following entire trees are replaced with the exception of certain files which are left: imolate//Standard where is a publication, e.g. wgn or imc. This subdirectory is replaced in any subdirectories you have for publications. The files which are not replaced are: 2.sty (e.g. imc2.sty, wgn2.sty) These are the style files for the publication. ispell_dict.hash This is the dictionary built up as you use the program SpellCheck. It contains non-standard words that you regard as correct, e.g. IMO, Perseid. 3. Two files are replaced: ImolateVersion Imolate-Changelog.txt 4. Three junk files are deleted: ImcContents-IMCstyle.pdf, ImcContents-WGNstyle.pdf: these are junk and should never have been distributed. Problems.txt: these are notes to myself; the problems have been fixed. Chris Trayner 2005 November 27