home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsf / jfshared / Modules / ExtraKeys / !Help < prev    next >
Encoding:
Text File  |  1995-09-23  |  4.4 KB  |  112 lines

  1.                                    ExtraKeys
  2.                                    =========
  3.  
  4. Version 1.07 (24 Jul 1995)
  5.      
  6. Introduction
  7. ------------
  8.    Sometimes it it useful to be able to get curly quotes in programs which
  9. don't easily allow them. For example, Impression; this is not quite true,
  10. because I discovered about a week ago that you can use Ctrl ] and ctrl \ (or
  11. something like that), but the reasoning remains. If you don't like me using
  12. Impression as an example, read writable icons instead.
  13.    
  14.    So, here is an easy way to enter a couple of useful characters and strings.
  15.  
  16. Usage
  17. -----
  18.    Run the !Create file. That's it.
  19.    Hopefully, the code will be assembled with no errors and all that in
  20. future will be required is the running of the !Run code file.
  21.  
  22.     
  23. How it works
  24. ------------
  25. Well, without being boring about this I can say that I can't remember. It's
  26. now 23rd September 1995 (entered using shift-ctrl-D !) and that means that
  27. since v1.00 about a year has elapsed.
  28.  
  29. Generally, it uses the key transition event to determine when particular
  30. combinations of keys are pressed and if they are it then uses a CallBack to
  31. insert keys into the buffer. This is complicated by the fact that if you use
  32. alt-' and follow with certain keys you get hat symbols. To get around this,
  33. certain insert combinations are flagged and a trap on the character insert
  34. vector traps the keyboard handler inserting these silly keys and converts
  35. them to their base keys before passing them on. See KeyCombine for details of
  36. which keys have changed.
  37.  
  38. It's all a bit naffly written, but it works; some of the time. Sometimes
  39. Alt-D gives the funny D with aline through it, but I can't see why. Sorry,
  40. but it is quite rare, so I'm not really sure how to fix it - thoughts anyone?
  41.  
  42. Key combinations
  43. ----------------
  44. Alt-' (ie unshifted) gives “ or ”
  45. Alt-" (ie shifted) gives ‘ or ’
  46.       The reason for the reasoning behind the reversal is that double curly
  47.       quotes are used more often so should have the easier key combinations.
  48.       You'll find it second nature to use Alt-' instead of Shift-' with a
  49.       little practice.
  50. Alt-d (unshifted) gives the date in it's short form, ie 23 Sep 1995. This is
  51.       always of the same length.
  52. Alt-D (shifted) gives the date in it's more readable form, ie 23rd September
  53.       1995. This is therefore of variable length
  54. Alt-t (unshifted) gives the time in it's fixed length form, ie 20:57.14
  55. Alt-T (shifted) gives the time in it's more readable form, ie 8:57 pm
  56. Alt-. (unshifted) gives elipsis (…) used where a quoted section has bits
  57.       missing, or a sentance continues over a line. I use it in code, where
  58.       one comment runs over a few lines which are all described. It's easier
  59.       than typing ... !
  60. Alt-Q (either) gives my address. Well, at the moment it does, but by changing
  61.       the program you can insert any string you like. Do watch the top bit
  62.       set characters, as these must be preceeded by 0 or they will be
  63.       processed as extended keys (ie f keys). The string must be terminated
  64.       by code 2.
  65.  
  66.  
  67. Disclaimer
  68. ----------
  69.   The author accepts no responsibility for any problems which this
  70. application may cause or loss of data resulting in its use. This application
  71. is Public Domain. This means that it may be distributed, so long as no charge
  72. other than copying costs are charged for it.
  73.   
  74.  
  75. Source code
  76. -----------
  77.    This program requires the !JFPatch pre-assembler to make the code. This is
  78. a simple text-to-basic assembler which takes a text assembler file, makes a
  79. basic program from it to assemble, assembles it and returns any errors.
  80. Currently, it is under development and requires a lot of work before it will
  81. be released in any form. As such, the patch file is mostly useless, but must
  82. be distributed with the resultant module.
  83.    All source code an the resultant module must be distributed together.
  84.  
  85.  
  86. Contact                
  87. -------
  88. Any comments, queries, donations or bug reports can be sent to :
  89.  
  90. Fidonet NetMail :  Justin Fletcher at Arcade (0181 655 4412) [2:254/27]
  91. E-Mail : Gerph@arcade.demon.co.uk
  92.  
  93. Snail Mail :
  94.     Justin Fletcher
  95.     “Galadriel”
  96.     17b Cromwell Road,
  97.     Weeting,
  98.     Brandon,
  99.     Suffolk.
  100.     IP27 0QT
  101.  
  102. History
  103. -------
  104. Version 1.01 : 06 Aug 1994
  105. Version 1.02 : 10 Sep 1994
  106. Version 1.03 : 10 Sep 1994
  107. Version 1.04 : 05 Feb 1995
  108. Version 1.05 : 08 Apr 1995
  109. Version 1.06 : 02 Jun 1995
  110. Version 1.07 : 24 Jun 1995
  111.                Real release version. !Help file written, turned into Auto-app.
  112.