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