home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 September (IDG) / Sep99.iso / Shareware World / Utilities / Text Processing / Alpha / Help / Readme < prev    next >
Encoding:
Text File  |  1999-04-20  |  9.3 KB  |  179 lines  |  [TEXT/ALFA]
  1. Alpha version 7.2, using AlphaTcl library version 7.2
  2.  
  3. International users: select your keyboard in the international preferences 
  4. dialog (Config->Preferences->International) to ensure the menus contain 
  5. key-bindings suitable for your keyboard.  Users of MacOS 8.5: the OS now 
  6. 'captures' the Cmd-Tab key combination and uses it to switch applications.  
  7. That combination is also used by default inside Alpha: you must either 
  8. redefine Alpha's key-combo (Config->Special Keys…) or change the MacOS's 
  9. key-combo.
  10.  
  11. Remember, Alpha has a Home Page, from which you can check for new versions 
  12. of Alpha, as well as the many modes and packages which have been written.  
  13. If you wish to download those things directly you can get them from 
  14. <ftp://alpha.olm.net/pub/packages/>, but Alpha contains menu items to allow 
  15. you to check for and/or download and install updated items automatically.  
  16. Many packages are also available from: <ftp://ftp.ucsd.edu/pub/alpha/>.  If 
  17. you check both locations, Alpha will keep track of which contains the most 
  18. recent one for you.  For those from Europe, you may wish to try the mirror: 
  19. <ftp://anu.theologie.uni-halle.de/comp/mac/Alpha>
  20.  
  21. Alpha's documentation is currently a little out-of-date.  It is undergoing 
  22. a complete overhaul.  To check on the status of that overhaul, or to 
  23. download a pre-release version of the new documentation go to 
  24. <http://www.theophys.kth.se/~jl/Alpha/newdocs.html>.  In the mean-time, you 
  25. may look at the current Manual, a shorter Quick Start (<-- click on it!)  
  26. document, and many other help files.  You can access the help files under 
  27. the system help menu.  If you have recently updated Alpha you may wish to 
  28. read the 'Changes' file.  
  29.  
  30. Much of Alpha's functionality is implemented in 'packages' or 'extensions',
  31. and many additional packages are available to extend Alpha further.  You
  32. may read and download from the packages listed below; more may be available
  33. from one of Alpha's internet sites.  The 'Config->Preferences->Menus And
  34. Features' and 'Config->Mode Prefs->Menus and Features' menu items let you
  35. see which items are installed, and lets you turn them on and off.  The
  36. 'Config->Package Prefs' menu allows you to update modes, menus, and
  37. extensions quickly and easily by downloading small update files from the
  38. internet.  For those used to Emacs, a 'mode' in Alpha is like a 'major
  39. mode' in Emacs, an 'extension' or 'feature' in Alpha is like a 'minor mode'
  40. in Emacs.
  41.  
  42. PLEASE use the Alpha-D mailing list to discuss problems, suggestions 
  43. etc with this release.  To subscribe, email <LISTSERV@LISTSERV.SYR.EDU> 
  44. and, in the text of your message (not the subject line), write: 
  45. 'SUBSCRIBE ALPHA-D'.  There are a number of known bugs which will hopefully
  46. be corrected in a future release.  PLEASE read the 'Bug Reports and Debugging' 
  47. file for a list of known bugs, and for how to give an informative bug 
  48. report, without which it is unlikely any bug you found can be fixed.
  49.  
  50. Alpha stores its preferences in a folder called 'Alpha-v7' in your 
  51. preferences folder.  Do not just copy over your old preferences (if you 
  52. used Alpha before the 7.0 release).  Alpha has undergone sufficient changes 
  53. that it will probably be incompatible with many existing preferences files.  
  54. See the end of this document for instructions on copying over your 
  55. preferences.
  56.  
  57. Scroll down to read a brief description of some of the current packages, 
  58. and click on the hyper-links to retrieve them from one of Alpha's package 
  59. archive sites.  You may also use the 'Config' menu, (select 'Package 
  60. Prefs->Internet Updates') to download and install them.  Since most web 
  61. browsers take so long to startup, it may be better to start them up before 
  62. clicking on any link below (prevents time-out problems).
  63.  
  64. Click here to update Alpha's list of remote packages via the internet.
  65. (you may need to do that so Alpha knows about the following packages)
  66.  
  67. ===============================================================================
  68. Current extension packages for Alpha include:
  69.  
  70. Smart Paste --- when cutting and pasting code-segments, 'paste' will
  71.     automatically indent the code it pastes to match the surrounding code.
  72.     <get smartPaste.tcl>
  73. TeX mode --- powerful editing features for single or multi-part LaTeX 
  74.     documents.  Integrates well with all current TeX implementations.
  75.     <get TeXmode>
  76. HTML mode --- for editing and manipulating suites of Web pages, allowing
  77.     entire site maintenance from within Alpha.
  78.     <get HTMLmode>
  79. Perl mode --- for editing Perl documents
  80.     <get Perlmode>
  81. BibToHtml --- conversion scripts for bibtex files.
  82.     <get BibToHtml.tcl>
  83. LaTeX Accents --- conversion from LaTeX control sequences to real
  84.     accented characters and vice versa.
  85.     <get latexAccents.tcl>
  86. LaTeX MathBB --- quicker typing of blackboard-bold symbols.
  87.     <get latexMathbb.tcl>
  88. Emacs --- makes many of Alpha's key sequences mimic those of the popular
  89.     Unix editor 'Emacs'
  90.     <get Emacs>                     
  91. Macros --- allows you to record, save and replay keyboard macros.
  92.     <get macros.tcl>                    
  93. Diff mode --- powerful side-by-side comparison and patching between files or
  94.     directories.
  95.     <get DiffMode>
  96. Programmer's Menus --- menus for interacting with Symantec, Metrowerks and 
  97.     other common programming environments (primarily C, C++)
  98.     <get programmersMenus>
  99. Printer choices --- creates a printer sub-menu, allowing you to print using
  100.     Enscriptor, Kodex, Drop•ps or PrettyC as well as directly from Alpha.
  101.     <get printerChoicesMenu>        
  102. Ftp menu --- interaction with any of the popular Ftp clients.
  103.     <get ftpMenu.tcl>                   
  104. Vince's Additions --- a large suite of packages, used by many
  105.     Electric completions --- speeds up editing of C++, TeX, Java, Tcl 
  106.         documents with template insertions and sophisticated 'complete-
  107.         what-I-just-typed' features.
  108.     Electric menu --- to give menu access to some of the electric features.
  109.     Bib engine --- sophisticated interaction with Vince's port of BibTeX.
  110.     Bib convert --- conversion of Inspec and Hollis records to .bib format.
  111.     Mode search paths --- declare where you keep files/headers for different
  112.         modes so Alpha can find your files more easily.  Especially useful
  113.         for C++ programmers (finds those header files).
  114.     Document projects --- declare the projects your are working on, the
  115.         default document structures you use, and Alpha handles the rest.
  116.     File utils --- adds a few simple file utilities to Alpha's menus
  117.     <get VinceAdditions>           
  118. Voodoo menu --- interaction with the version control software 'Voodoo'
  119.     <get voodooMenu>                
  120. Copy ring --- maintain more than one piece of copied text for pasting.
  121.     <get copyRing.tcl>
  122. Compare windows --- find the next difference between two windows, very quickly,
  123.     and unobtrusively.
  124.     <get compareWindows.tcl> 
  125. Developer utilities --- to help you write new packages for Alpha.
  126.     <get developerUtilities.tcl>        
  127. Frontier menu --- interaction with Frontier.
  128.     <get frontierMenu>              
  129. Eudora menu --- interaction with Eudora; you can write your email in Alpha.
  130.     <get eudoraMenu>                
  131. Internet config menu --- interaction with Internet Config, and hence all of
  132.     your internet applications.
  133.     <get internetConfigMenu>        
  134. Recent Files --- maintains a menu of recently used files, for quick access.
  135.     <get recentFilesMenu.tcl>           
  136. Switch To --- keeps a menu of commonly used applications, for quick 
  137.     switching.
  138.     <get switchToMenu.tcl>              
  139. New Document --- instead of opening blank 'untitled' documents with cmd-N,
  140.     this package allow you to select a document type or template (if used
  141.     with the Document Projects package).  You can directly start an email
  142.     message, browse an ftp site, or create a new C++ class template.
  143.     <get newDocument.tcl>               
  144. Smarter Source --- allows you selectively to over-ride parts of Alpha's
  145.     core Tcl code without making changes to the core files (easier for you
  146.     to upgrade Alpha, keeping your changes intact).
  147.     <get smarterSource.tcl>             
  148.  
  149.  
  150.                      
  151. ===============================================================================
  152. Copying over old preferences:
  153.  
  154. Alpha stores most preferences in the 'defs.tcl' and 'arrdefs.tcl' files in 
  155. your preferences folder.  The preferences folder is in the standard system 
  156. preferences folder, and is named 'Alpha' (for versions < 7.0) or Alpha-v7
  157. for version 7 (and will be called Alpha-v8 when version 8.0 is released at 
  158. some point in the future...)
  159.  
  160. Some of your old preferences will be incompatible/irrelevant to the new 
  161. Alpha version when you upgrade from 6.x to 7.x therefore you shouldn't just 
  162. copy the two prefs files from one folder to the other.
  163.  
  164. Here's how to copy over just a few preferences: open the old 'defs.tcl' or 
  165. 'arrdefs.tcl' and examine them for lines you wish to copy.  Open the new 
  166. 'defs.tcl' and 'arrdefs.tcl'.  Alpha opens them in read-only mode, but you 
  167. can command-click on the 'lock' icon in the window to make the windows 
  168. modifiable.  Now copy and paste as you desire.  Finally save the windows and 
  169. quit and restart Alpha.  If you get an error on startup, you probably copied 
  170. over incompatible preferences and you'll have to delete the files and start 
  171. over (hence it may be a good idea to make a backup copy of the originals 
  172. before you start).
  173.  
  174. Note: if you don't wish to use a System-Folder prefs folder, create a folder
  175. called 'AlphaPrefs' next to the Alpha application.  Alpha will use that
  176. folder preferentially if it exists.
  177.  
  178.  
  179.