home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / misc / templed / templed_1 / !TemplEd / TechDocs < prev    next >
Text File  |  1997-04-24  |  14KB  |  298 lines
  1. Version history
  2. ---------------
  3. 1.34 Additions:
  4.       . Support for the Sculptrix module
  5.      Bugs fixed:
  6.       . Wouldn't load a Templates file at startup, if the WimpExt module
  7.         was used
  8.       . Sets TemplEd$Max* variables from !Run, instead of in the !RunImage
  9.         (which makes it easier to modify)
  10.  
  11. 1.33 (internal version, not released)
  12.  
  13. 1.32 Additions:
  14.       . New icons created by picking from Palette window, instead of a menu
  15.       . Possibility to put a frame around a selection of icons
  16.      Bugs fixed:
  17.       . !RunImage was not StrongARM compatible (because it was a self-
  18.         decompressing Absolute file, created with !Crunch)
  19.       . TemplEd expected strings in icons to be CR-terminated, when it should
  20.         be able to handle ctrl-terminated strings
  21.  
  22. 1.31 Additions:
  23.       . Export icon names. The name of an icon should be stored in the
  24.         validation string, in the 'N' command
  25.       . New interactive help data, can be run from the iconbar menu. To be
  26.         used with StrongHelp version 2
  27.      Bugs fixed:
  28.       . Text in title bar of 'Icon Edit' window was missing
  29.       . Error 'Unknown or missing variable' when doing a Save from the
  30.         'Save/Discard/Cancel' box
  31.  
  32. 1.30 Bugs fixed:
  33.       . 'Pane' flag of templates could be messed up when deleting a template
  34.       . 'Divide by zero' error when moving an action button of type 'Click/Drag'
  35.      Additions:
  36.       . Option 'Min. size: Ignore desktop font'. When calculating the minimum
  37.         icon size, and this is on, the desktop outline font is ignored; text
  38.         width is calculated for the System font (which is usually wider). This
  39.         is of course only useful on RiscOS 3.5 and later.
  40.  
  41. 1.29 Bugs fixed:
  42.       . Did not check for proper file type when trying to load sprite file
  43.         called 'Sprites'
  44.       . Weird behaviour when clicking all mouse buttons above Statistics
  45.         window
  46.       . WindowEdit window showed flags for 'Scroll events' wrongly (when
  47.         'repeat' button was on, the '1' flag was set, and vice versa);
  48.         flags were set correctly, though
  49.      Additions:
  50.       . Export templates as text file
  51.       . Loads sprite file 'Sprites22' or 'Sprites23' instead of 'Sprites'
  52.         when present (and provided you have configured the appropiate
  53.         monitor type)
  54.  
  55. 1.28 Bugs fixed:
  56.       . Got error on startup when support for WimpExt was in Options file
  57.      Additions:
  58.       . Archive 'StyleGuide' in the 'Extras' directory, contains example
  59.         templates from the RiscOS 3 Style Guide
  60.       . New set of standard icons (in the 3D templates) by Neil Spellings.
  61.         These conform to the Style Guide and are suited for RiscOS 3.5.
  62.         Neil also provided an overview of the standard icons, as listed in
  63.         the Style Guide (see the file 'NewIcons' in the 'StyleGuide'
  64.         archive)
  65.       . Statistics window: choice of decimal/hex numbers saved in Options
  66.         file
  67.  
  68. 1.27 Bugs fixed:
  69.       . Deleting icons by dragging them outside a window had stopped
  70.         working (since v. 1.24)
  71.       . Gave error when trying to edit title bar with outline font in it
  72.       . Corrected calculation of minimum icon size for text+sprite icons
  73.         with empty text string
  74.      Additions:
  75.       . Fast resizing of work area, with Ctrl+Alt+Adjust
  76.  
  77. 1.26 NOTE: For this version the source code has been left out of the
  78.         distribution, because the archive was getting rather large.
  79.         (From version 1.27 on, the source is distributed separately.)
  80.      Bugs fixed:
  81.       . Decreased minimum size of drag-box when resizing icons. Old
  82.         minimum (16x32) made it difficult to create sliders.
  83.      Additions:
  84.       . Added support for the WimpExt module. Like the Interface and AEH
  85.         module, this contains a number of extensions to the Wimp (3D
  86.         buttons, pointer change), plus a lot of other support for Wimp
  87.         applications.
  88.       . Can use the OLESupport module: changes in the file with custom
  89.         sprites (e.g. with !Paint) are signalled by the module; TemplEd
  90.         then re-loads the sprite file. (So you don't need to select
  91.         'Re-load' from the menu)
  92.  
  93. 1.25 Bugs fixed:
  94.       . Move icons with cursor keys only (i.e. no drag) gave error if
  95.         you hadn't dragged any icons in the same window first
  96.       . Gave 'Mistake' when deleting a template (though deleting did work)
  97.       . 'Min size' on sprite icons: looks for sprite in Wimp area if not
  98.         found in custom area
  99.      Additions:
  100.       . 'Keep on Screen' and 'Ignore extent' window flags can be edited
  101.         (these flags are for RO3 only)
  102.       . 'Tidy icons' replaced by multiple options
  103.       . From Acorn's !NewLook: 3D sprites, and the BorderUtils module
  104.         (contains fix for the '3D-button bug')
  105.  
  106. 1.24 Bugs fixed:
  107.       . Font usage counting revised again. Version 1.23 might lose a font
  108.         while still in use for an icon, resulting in 'Illegal font handle'
  109.         error
  110.       . Incorrect PROC call within PROCsetworkarea. No one complained, so
  111.         apparently the line is rarely executed
  112.       . Gave an error if an icon resize-drag ended outside the template
  113.      Additions:
  114.       . Pressing the cursor keys moves the currently selected icons
  115.         (without needing to drag with Shift+Select)
  116.       . When editing multiple icons, you can now set just 1 aspect: click
  117.         with Menu on 'Update' or 'Update & Exit'; then choose which flags
  118.         you want to change. The other settings of the icons remain the same
  119.       . Menu items to View/Re-load/Reset the custom sprites. (The 'View'
  120.         item just Filer_Runs the sprite file; use 'Re-load' after editing
  121.         the sprites; 't would be nice if !Paint supported the External Edit
  122.         protocol...)
  123.       . (Due to popular demand:) Pointer changes above appropriate icons in
  124.         the Icon Edit and Window Edit windows (was: only if using the 3D
  125.         templates). Not for RiscOS 2
  126.       . To minimize the 'Max size' field, click with Adjust on the
  127.         'Max size' text icon (sets number to length of text + 1)
  128.      
  129. 1.23 Bugs fixed:
  130.       . PLEASE NOTE: Use of function keys in the Edit windows has changed:
  131.           F2 = Update
  132.           F3 = Update & Exit
  133.           F4 = Exit
  134.         F1 is for activating interactive help, be it !StrongHelp or RiscOS
  135.         !Help. (This also follows Acorn guidelines)
  136.       . If a drag-select ended with the pointer over another window, the
  137.         icons in that window were selected (instead of in the window where
  138.         the drag started ...)
  139.       . Input focus wasn't shown correctly for templates with 'Pane' bit set
  140.         (instead, the non-pane window that was last opened, was highlighted)
  141.       . Count of font usage not always correct; sometimes caused the
  142.         counting by the FontManager to be too high
  143.       . Extended icon info (via !Help) gave wrong ESG number
  144.      Additions:
  145.       . During icon move/resize, Icon info window shows coords of drag-box
  146.         (thanks to Paul Hobbs for showing that it can be done)
  147.         This means that for single icons you can see the new position and
  148.         size during the drag.
  149.       . Interactive help for Icon Edit and Window Edit windows: press F1
  150.         with pointer above a button, to get help on the flag that this
  151.         button represents (!StrongHelp and !TemplHlp must be loaded first)
  152.       . Double grid:
  153.           - 'Icon size' grid locks all corners of the icons
  154.           - 'Icon position' grid locks the bottomleft corner, leaving the
  155.             size unchanged
  156.       . 'Same size' for icon selections
  157.       . Cooperates in desktop save (RiscOS 3)
  158.       . TAB key can be used to move the caret in dialogue windows
  159.  
  160. 1.22 Bugs fixed:
  161.       . Copying templates caused an error, due to a brilliant new bug in
  162.         version 1.21
  163.       . Better calculation of minimum icon size
  164.       . Revised renumbering of icon selection
  165.      Additions:
  166.       . Filer-like browser window
  167.       . Hotkeys for Align, Space Out and for Copy Up/Down/Left/Right
  168.       . When editing title bar, you can set its colours from the Icon
  169.         Edit window (was: from Window Edit window only)
  170.       . Pressing Esc during a drag aborts it
  171.       . Moving icons to other templates is equivalent to copying
  172.       . Prevents desktop shutdown if data is changed & not saved
  173.       . Menus over Edit windows (Button type, ESG, Font etc.) pop up
  174.         when ANY mouse button is pressed (was: only for Menu button)
  175.  
  176. 1.21 Bugs fixed:
  177.       . Sprite area pointer of windows was not reset to 1 (Wimp area) when
  178.         saving
  179.       . Saving to other applications (via Wimp$Scrap) now properly supported
  180.         Now it is possible to exchange templates between 2 copies of TemplEd
  181.       . Another bug in Wimp_LoadTemplate (#$&$#%@!!!): it expects some
  182.         indirected data for an indirected non-text, non-sprite icon.
  183.         Although the indirected data is not used, it won't digest an
  184.         invalid pointer.
  185.      Additions:
  186.       . Uses DragASprite in save windows
  187.       . Hotkeys for some functions (^Z, ^X, ^C etc.)
  188.       . Windows can be centered to the screen
  189.       . Icons can be centered to the window
  190.       . Support for AEH module
  191.       . 'Minimize size' for icons
  192.       . Using cursor keys to move pointer now also works for moving/
  193.         resizing windows (when done using Ctrl+Select/Ctrl+Adjust)
  194.       . When loading a templates file called 'Templates', TemplEd
  195.         automatically loads the 'Sprites' file from same directory, if such
  196.         a file exists
  197.       . MaxFonts% limit removed: font menu can contain any number of font
  198.         families
  199.       . If browser window is closed, all template windows are closed, too
  200.  
  201. 1.20 Bugs fixed:
  202.       . Templates with deleted, indirected icons were saved without any
  203.         indirected data; Wimp_LoadTemplate gave an error when reading this,
  204.         because it expects some indirected data. (Weird...)
  205.       . TemplEd's own templates may now contain outline fonts (including
  206.         the custom icons for the 'Create icon' submenu)
  207.       . Would not run together with Joris Rölings !FontSelect utility; the
  208.         FontLister module did not like the way TemplEd (v1.11) reads the
  209.         font names.
  210.      Additions:
  211.       . Resizing of a selection of icons
  212.       . Reads 'Templates' and 'Sprites' file of an application when its icon
  213.         is dropped on the icon bar
  214.       . Renumbering of a selection of icons
  215.       . Moving the mouse pointer during icon move/resize: cursor keys move
  216.         the pointer 1 pixel, or 4 pixels when combined with the Shift key
  217.       . When creating standard icons (from the 'Create icon' submenu), you
  218.         can now create several icons with one click.
  219.         (NOTE: the way standard icons are defined has changed. If you
  220.         already have a set of custom icons, DON'T just copy them into the
  221.         Templates file. Read the section on customizing in the Manual.)
  222.       . Option 'Delete icons moved outside'
  223.       . Alternative sets of templates and sprites, with 3D look
  224.       . Possibility to resize icons when aligning
  225.       . Icon resizing now only in 1 dimension (x or y) at a time
  226.       . Double-click on icon, title bar or background opens the appropriate
  227.         Edit window
  228.       . Drag-selecting of templates in 'Templates' window
  229.       . Souped-up 'Templates' window: templates appear as sprite+name
  230.       . Direction (up/down/left/right) for copying of icons in menu
  231.       . Extended icon info, such as button type and validation string, is
  232.         sent to !Help (Acorn's interactive help application).
  233.       . Help files for !StrongHlp
  234.       . Possibility to set coordinates of topleft corner (min.X & max.Y) of
  235.         work area (were fixed to 0,0 in old version)
  236.  
  237. 1.11 Removed automatic minimizing of WimpSlot at startup, since it seemed
  238.      to give problems with RiscOS 2
  239.      Grid size now adapts to mode changes
  240.  
  241. 1.10 First distributed version
  242.  
  243. 1.00 Test version
  244.  
  245.  
  246. Known bugs
  247. ----------
  248.  
  249. * In some cases, you may find it difficult to click-select an icon:
  250.      - When its button type is 'Menu' (icon is deselected when pointer
  251.        moves away from the icon)
  252.      - When it has border type 'R5' in its validation string (icon is
  253.        deselected after a short delay)
  254.      - When the icon is shaded (no reaction to a click)
  255.      - When the icon is part of a selection group (ESG), and the 'Allow
  256.        adjust' flags are cleared (click-selecting with Adjust deselects
  257.        the other icons)
  258.   In all cases, you can drag-select the icon, or you can use 'Select all'
  259.   and deselect some other icons.
  260.  
  261. * Double-clicking on an icon to open the Icon Edit window does not work
  262. smoothly with all button types; the Wimp interferes with TemplEd's
  263. reactions to clicks. For the same reason, double-clicking on the title bar
  264. has the weird effect that the Icon Edit window is opened, and immediately
  265. the template window is re-opened on top. I have made the double-click thingy
  266. optional; if you don't like it, you can switch it off.
  267.  
  268.  
  269. Limitations
  270. -----------
  271.  
  272. * Limits on
  273.   - the number of templates (currently 100)
  274.   - the number of icons per template (currently 200)
  275.   - the amount of indirected data. (currently 8000 bytes)
  276.   This can be changed by setting environment variables TemplEd$Max*, in the
  277.   !Run file.
  278.  
  279. * TemplEd can't handle indirected strings longer than 255 bytes. You can set
  280. the maximum length above this limit, but TemplEd can't put more than 255
  281. characters in a text area.
  282.  
  283. * You can't set the sprite area for each icon separately; all sprites in a
  284. template are read from the same area.
  285.  
  286. * TemplEd is a single-file editor.
  287.  
  288.  
  289. Possible future additions
  290. -------------------------
  291.  
  292. Future versions MAY have one or more of the following features:
  293.  
  294. * Show grid
  295. * Multi-file editing
  296. * Grouping of icons
  297. * On fatal error, save templates in <Wimp$ScrapDir>
  298.