view lispintro/INSTALL @ 68127:40429cab94e1

* mh-index.el (mh-index-search): Checking mh-find-path-run is unnecessary. * mh-init.el (mh-sys-path): Co-locate with mh-variants, which uses it. (mh-variants): Note variable isn't meant to be accessed directly; use function mh-variants instead. (mh-variant-info, mh-variant-mh-info, mh-variant-mu-mh-info) (mh-variant-nmh-info): Co-locate next to mh-variants, which uses them. Updated to use mh-file-command-p which is more accurrate than file-executable-p which returns t for directories. (mh-file-command-p): Move here from mh-utils, since mh-variant-*-info are the only functions to use it. (mh-variant-set, mh-variant-set-variant, mh-variant-p): Use function mh-variants instead of variable. More robust. (mh-find-path-run): Move here from mh-utils.el. Mention that checking this variable is unnecessary. (mh-find-path): Move here from mh-utils.el. With the advent of MH variants and an mhparam command that doesn't work if there isn't an MH profile, we can't get libdir for running install-mh. So don't bother. If there's an issue with the environment, direct the user to install MH and run install-mh (closes SF #835192). Don't read ~/.mh_profile directly. Use mh-profile-component which uses mhparam (closes SF #1016027). * mh-utils.el (mh-get-profile-field): Rename to mh-profile-component-value. Add colon to search removing unnecessary addition of colon to field in mh-profile-component. (mh-profile-component): Modify call to mh-profile-component-value accordingly. Move next to mh-profile-component-value. (mh-find-path-run, mh-find-path, mh-file-command-p): Move to mh-init.el. It makes sense that code that is only run once per session (more or less) is in mh-init.el rather than cluttering mh-utils.el. (mh-no-install, mh-install): Delete.

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

###