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