view lispintro/INSTALL @ 71893:bb3316be643e

Require 'cl during byte-compilation/interactive load, for the `assert' macro. (allout-mode-deactivate-hook): New hook, is run when allout mode deactivates. (allout-developer): New allout customization subgroup. (allout-run-unit-tests-on-load): New allout-developer customization variable, when true allout unit tests are run towards end of file load/eval. (allout-inhibit-auto-fill): Disable auto-fill activity even during auto-fill-mode. (allout-resumptions): Removed, to be replaced by... (allout-add-resumptions): Register variable settings to be reinstated by `allout-do-resumptions'. The settings are made buffer-local, but the locality/globality of the suspended setting is restored on resumption. (allout-do-resumptions): Reinstate all settings suspended using `allout-add-resumptions'. (allout-test-resumptions): Unit tests (and intermediate variables) for resumptions. (allout-tests-globally-unbound, allout-tests-globally-true) (allout-tests-locally-true): Intermediate variables for resumptions unit tests. (allout-overlay-preparations): Replaces `allout-set-overlay-category'. (allout-exposure-category): Replaces 'allout-overlay-category variable. (allout-mode): Use `allout-add-resumptions' and `allout-do-resumptions' instead of retired `allout-resumptions'. For hook functions, use `local' parameter so hook settings are created and removed as buffer-local settings. Revise (resumptions) setting auto-fill-function so it is set only if already active. (The related fill-function settings are all made in either case, so that activating auto-fill-mode activity will have the custom allout-mode behaviors (hanging indent on topics, if configured for it). Also, remove all allout-exposure-category overlays on mode deactivation. (allout-hotspot-key-handler): New function extracted from `allout-pre-command-business', so the functionality can be used for other purposes, eg as a binding in an overlay. (allout-pre-command-business): Use new `allout-hotspot-key-handler'. (allout-auto-fill): Respect new `allout-inhibit-auto-fill' customization variable. (allout-run-unit-tests): Run the (currently quite small) repertoire of unit tests. Called just before the provide iff user has customized `allout-run-unit-tests-on-load' non-nil.

Basic Installation for  An Introduction to Programming in Emacs Lisp  version 2
==================

    # To see the table of contents of the emacs-lisp-intro-2.00.tar.gz
    # file, execute the following at your shell prompt:

    tar -tzvf emacs-lisp-intro-2.00.tar.gz

    # To uncompress and untar the file, execute the following:

    tar -xzvf emacs-lisp-intro-2.00.tar.gz

    # The file will untar into a subdirectory called emacs-lisp-intro-2.00
    # That directory will contain the Texinfo source for the book, the
    # Info files and various other files.

    cd emacs-lisp-intro-2.00

    # To create a DVI file that can be printed directly or converted
    # to PostScript or PDF and then printed, execute the following:

    ./configure
    make dvi

    # To create an HTML file, execute the following
    #   (presumably you have already executed the `./configure' command
    #    before running `make dvi'; if not execute `./configure' now);
    # this will place HTML files into a emacs-lisp-intro/ subdirectory:

    makeinfo --html --verbose emacs-lisp-intro.texi

    # To create a single, large HTML file in the current directory,
    # use the --no-split option, like this:

    makeinfo --html --no-split --verbose emacs-lisp-intro.texi

        # At the time of writing, `makeinfo' version 4.0b creates HTML
        # files with %20 in addresses instead of a space.  Some
        # browsers have difficulty following such references.  In
        # GNU Emacs, you can replace the occurrences of %20 with a
        # command such as
        #              (replace-string "%20" " ")

    # To create a single, large Info file in the current directory
    # instead of the usual 16 smaller Info files, and also, to avoid
    # indenting paragraphs, execute:

    makeinfo --no-split --paragraph-indent=0 --verbose emacs-lisp-intro.texi

    # To create a single, large Plain text file in the current
    # directory, execute:

    makeinfo --fill-column=70 --no-split --paragraph-indent=0 \
    --verbose --no-headers --output=emacs-lisp-intro.txt emacs-lisp-intro.texi

###