"Fossies" - the Fresh Open Source Software Archive

Member "unicore-ucc-8.0.2/extras/emacs-mode/README" (18 May 2020, 2622 Bytes) of package /linux/misc/unicore-ucc-8.0.2.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 ========
    2 ucc-mode
    3 ========
    4 
    5 
    6 Prerequisites
    7 =============
    8 
    9 It is recommended to use ucc-mode with GNU Emacs 22 or later. 
   10 
   11 However, it will run with GNU Emacs 21 as well, but be aware that you
   12 will miss some features. We have tested ucc-mode with GNU Emacs 21, 22
   13 and 23 on both Linux and Windows XP, other Emacsen or operating
   14 systems may or may not work. ;-)
   15 
   16 
   17 Quick start
   18 ===========
   19 
   20 In order to use ucc-mode, you have to configure a few lines in your
   21 .emacs file. First, you have to tell emacs where it can find the
   22 ucc-*.el files. For example, if you put them in ~/elisp, add the
   23 line::
   24 
   25   (add-to-list 'load-path "~/elisp")
   26 
   27 Now let Emacs load the files::
   28 
   29   (require 'ucc-mode)
   30 
   31 This will not activate ucc-mode, it only makes Emacs aware of the
   32 commands the mode provides. Now tell Emacs where to find your ucc
   33 executable, e.g.:
   34 
   35   (setq ucc-command "~/bin/ucc")
   36 
   37 That's it, now you can access the ucc-* commands. For example, type::
   38 
   39   M-x ucc-connect
   40 
   41 There's also a minor-mode which gives you a nice menu and keybord
   42 shortcuts for the ucc-* commands, activate it like this:
   43 
   44   M-x ucc-mode
   45 
   46 
   47 Further configuration
   48 =====================
   49 
   50 If you want Emacs to load ucc-mode automatically for all files ending
   51 with .u, add the following line to you .emacs file:
   52 
   53   (add-to-list 'auto-mode-alist '("\\.u$" . ucc-mode))
   54 
   55 If you want Emacs to load xml-mode *and* ucc-mode automatically for all
   56 files ending with .swf, add the following line to you .emacs file:
   57 
   58 (add-to-list 'auto-mode-alist '("\\.swf$" . (lambda ()
   59 					      (xml-mode)
   60 					      (ucc-mode t))))
   61 
   62 
   63 Here are examples of further configuration, see the online help of the
   64 respective variables for documentation:
   65 
   66   (setq ucc-flags "-v")
   67   (setq ucc-flags "-v -c ~/.ucc/my_preferences")
   68   (setq ucc-flags "") ;; The default
   69 
   70   (setq ucc-reuse-buffer nil)
   71   (setq ucc-reuse-buffer t) ;; The default
   72 
   73   (set-face-foreground 'ucc-epr "blue")
   74   (set-face-foreground 'ucc-epr-mouse "blue")
   75   (set-face-background 'ucc-epr-mouse nil)
   76 
   77 Note that ucc-mode provides its own group, you can customize all the
   78 variables via:
   79 
   80   M-x customize-group ucc
   81 
   82 instead.
   83 
   84 
   85 Compiling
   86 =========
   87 
   88 You can byte-compile the ucc-*.el files to speed up loading and usage
   89 of the ucc-* commands. However, since the ucc executable itself is
   90 the slowest part in the chain, the effect may be rather small. Use
   91 the following lines for byte-compiling:
   92 
   93   (byte-compile-file "ucc-mode.el")
   94   (byte-compile-file "ucc-output-mode.el")
   95   (byte-compile-file "ucc-localfilelist-mode.el")
   96 
   97 If you are viewing this file in Emacs, you can just mark the above
   98 lines and invoke:
   99 
  100   M-x eval-region