home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilst / wincount / !WinCount / !Help < prev    next >
Text File  |  1990-06-03  |  6KB  |  118 lines

  1. >!WinCount.!Help
  2.  
  3.                                  WinCount
  4.                                  ========
  5.  
  6.                             Free Window Counter
  7.  
  8.                  Package Version 0.02, Document Version 0.02
  9.  
  10.                      (C) Martyn S. Lovell 3rd June 1990
  11.  
  12. Contents
  13. ========
  14.  
  15. 1. Introduction
  16.  
  17. 2. Using WinCount
  18.  
  19.   2.1 Counting Free Windows
  20.   2.2 Checking an Application's Window Usage       
  21.   2.3 Some notes on usage
  22.  
  23. 3. Program Information
  24.  
  25.   3.1 Version history
  26.   3.2 Shareware information (Please read this)
  27.  
  28.  
  29. 1. Introduction
  30. ===============
  31.  
  32.     One evening I was fiddling with RISC OS loading and unloading tasks. I had previously ascertained that the maximum number of tasks available under RISC OS 2.00 was 32. However, this time when I loaded several tasks I got a 'Too Many Windows' error long before I was out of Tasks. I realised that one application I was loading must be taking an inordinate number of Window Handles.
  33.  
  34.     This program is designed to allow the number of free Window Handles to be counted. Using it you can both check up on what is available and check how many handles an application consumes.
  35.  
  36. 2. Using WinCount
  37. =================
  38.  
  39. 2.1 Counting Free Windows
  40. -------------------------
  41.  
  42.     To check the number of free windows simply select count from the WinCount menu (click menu on the WinCount icon to bring this menu up). The result of the count appears in the 'Result' submenu. Before a count has been performed, the result will be '?'.
  43.  
  44. 2.2 Checking an Application's Window Usage
  45. ------------------------------------------
  46.  
  47.      Load WinCount and check the number of free Windows. Then load the application. Select count again and subtract the new Result from the old. This is the number of Window Handles used by the application.
  48.                                                    
  49. 2.3 Some Notes on Usage
  50. -----------------------
  51.                                                          
  52.      If you load WinCount from the supervisor prompt when the desktop is not running you can count the number of windows available. Under RISC OS 2.00 you get 59. WinCount uses 1, giving 60 in total. I expect that the other 4 are used internally; 64 seems a likely number. This, incidentally allows for 2/task. This limit is presumably a trade-off between memory consumed (for 310, 400/1 owners) and handles available.                                        
  53.  
  54.      Some applications have been found by me to be particularly greedy. These are:
  55.          !C-Front 2.18   18-Nov-89    12 handles
  56.          !Spark   2.00   06-Sep-89     8 handles
  57.          !FormEd  1.01   23-May-89     8 handles
  58. Note that all the acorn standard applications consume *very* few handles.
  59.  
  60. 3. Program Information
  61. ======================
  62.  
  63. 3.1 Version history
  64. -------------------
  65.  
  66. Version 0.01 2nd June 1990
  67.   First Version
  68.   Quick 1 hour hack to check what took so many window handles.
  69.   Full Implementation.  
  70. Version 0.02 3rd June 1990
  71.   Fixed bug that made count 1 too low
  72.    
  73. 3.2 Sharware information
  74. ------------------------
  75.  
  76. This package contains:
  77. WinCount 0.02 (3rd June 1990): RISC OS application
  78.  
  79.    The software contained in this package is Shareware. The word 'Shareware' means many things to many people, so I'll explain what I mean. In fact, some people would call this 'freeware' or 'public domain software' but it hardly matters what you call it - your obligations are set out below.
  80.    The program is free. You may make any number of copies and give them away to anyone (subject to the condition that you give them ALL the files in the package). You may not sell this software, or use it otherwise for personal gain without my permission. If you wish to post it on your Bulletin Board or include it in your Shareware library then that, too, is fine.
  81.    If you want to add any part of the code or data to one of your programs for your own use, then that's fine too. If you want to add it to something you plan to sell, or otherwise release as copyright material (whether for gain or not) then you'll need my permission - I retain copyright on this program.
  82.    If you like this program and find it useful then I would appreciate a small donation of, say, 5 pounds (since this is the result of quite a lot of work). This donation is a voluntary contribution.
  83.    If you send a donation and say which version of the package you have then I will send you an update if there is one. This disc will also contain up-to-date copies of as much of my shareware as will fit, plus any other stuff I can fit. There may be no update, since this program is nearing completion. Thus I don't guarantee that, if you send me money, I'll send you a new version of the program. You will, however, get a disc with things on it. If you'd prefer to wait until there is a disc with a new version on it then please say so. In this case you'll get a thankyou note.
  84.    This program has been tested with RISC OS 2.00.  It is not suitable for Arthur 1.2.
  85.    This software carries no warranty, either express or implied. I've tested it and, to the best of my knowledge, there are no bugs. If you come across a bug then I'd be delighted if you got in touch with me. I can't guarantee to fix it but I'll probably have a good try.
  86. My address is:
  87.         Martyn Lovell
  88.         16, Fairwater Park,
  89.         Barnwood,
  90.         Gloucester.
  91.         GL4 7HF
  92. No telephone calls please.
  93. However, I can be contacted as:
  94. Cix:         MartynL                     
  95. UUCP:        MartynL@cix.UUCP
  96. UUCP:        MartynL@cix.cix.co.uk          (if the above won't work)
  97. Janet:       zceeb02@uk.ac.ucl.euclid
  98. Janet:       zceeb02@uk.ac.ucl.pyramid      (after June 1st 1990)
  99. Janet:       MLovell@uk.ac.ucl.cs           (preferred)
  100. Interspan:   Contact via Janet at above address
  101. Archive BBS: Martyn Lovell (112)
  102. Arcade BBS:  Martyn Lovell (112)
  103. Note that, during university terms, I read all this EMail sites regularly but
  104. in the holiday periods I may read them less regularly.
  105. For bug reports please send the following information:
  106.         Machine Type
  107.         OS Version
  108.         Software Version
  109.         Modules Installed
  110.         Modules Unplugged
  111.         Podules Installed
  112.         Drives Installed
  113.         RAM Available
  114.         Monitor Type
  115.         Other applications installed
  116.         Is the bug repeatable?
  117. and everything else that seems relevant.
  118.