xemacs-beta: man/hm--html-mode.texi comparison

comparison man/hm--html-mode.texi @ 177:6075d714658b r20-3b15

Import from CVS: tag r20-3b15

author	cvs
date	Mon, 13 Aug 2007 09:51:16 +0200
parents	25f70ba0133c
children	489f57a838ef

comparison

equal deleted inserted replaced

-:6866abce6aaf
+:6075d714658b
 @comment %**start of header (This is for running Texinfo on a region.)
 @setfilename hm--html-mode.info
 @settitle HM HTML Mode
 @setchapternewpage odd
 @comment %**end of header (This is for running Texinfo on a region.)
-@comment $Id: hm--html-mode.texi,v 1.3 1997/05/29 23:50:32 steve Exp $
+@comment $Id: hm--html-mode.texi,v 1.4 1997/07/26 22:10:08 steve Exp $
 @ifinfo
 This file documents the Elisp package @code{hm--html-menus}.
 Copyright @copyright{} 1997 Heiko Münkel
 @iftex
 @input umlaute.texinfo
 @end iftex
 @titlepage
 @sp 10
-@center @titlefont{The Elisp Package hm---html-menus}
+@center @titlefont{The Elisp Package hm{-}{-}html{-}menus}
 @sp 4
 @center by Heiko Münkel
 @sp 4
-@center Version 5.7, May 1997
+@center Version 5.8, July 1997
 @page
 @vskip 0pt plus 1filll
 Copyright @copyright{} 1997 Heiko Münkel
 @sp 4
 Permission is granted to make and distribute verbatim copies of
 * Overview::                    Overview
 * Distribution::                How to get the latest version
 * Installation::                How to install the package
 * Customization::               How to customize the package
 * Add New Elements::            How to add new HTML elements
-* Use With psgml-html::         Use this package as an add-on minor mode
+* Use With Other Major Modes::
 * Internal Drag And Drop::      The HTML independent drag and drop package
 * Template Minor Mode::         The HTML independent template package
 * Hints For Emacs 19 Users::    Missing features in the Emacs 19
 * Bug Reports::                 How and to whom you should send bug reports
 * Concept Index::               Concept Index
 @cindex overview
 @cindex version
 @findex hm--html-mode
 @findex hm--html-minor-mode
-This document describes the Elisp package @emph{hm---html-menus 5.7}.
+This document describes the Elisp package @emph{hm---html-menus 5.8}.
 The version of the document is:@*
-$Id: hm--html-mode.texi,v 1.3 1997/05/29 23:50:32 steve Exp $
+$Id: hm--html-mode.texi,v 1.4 1997/07/26 22:10:08 steve Exp $
 The package provides commands and various popup and pulldown menus for
 an HTML mode called @dfn{hm---html-mode}, a mode for writing HTML pages
 for the World Wide Web (WWW).  It also provides a minor mode
-(@dfn{hm---html-minor-mode}), which can be used together with another
+(@dfn{hm---html-minor-mode}), which can be used together with other HTML
-HTML major mode, like the psgml-html modes in XEmacs 19.14.
+major modes, like the psgml-html mode in XEmacs 19.14 or other major
+edit modes, like the perl-mode.
 You can easily view the HTML documents by calling the browsers w3 (a
 nice elisp package from William M. Perry), Netscape, or Mosaic directly
 from the pulldown menu of the mode.
 @itemx NEWS
 The NEWS and Change log file.
 @itemx adapt.el
 Provides (emulates XEmacs) functions for the use of this package with
 GNU Emacs 19.
+@itemx drop
+An xbm file with the drag and drop mouse pointer in the XEmacs.
+@itemx dropmsk
+An xbm file with the mask for the drag and drop mouse pointer in the XEmacs.
 @itemx hm--html.el
 Provides functions to write html pages. It defines all commands which
 insert html elements and entities.
 @itemx hm--html-indentation.el
 Provides the lisp code for the indentation.
 @enumerate
 @item Put all the *.el files in one of your XEmacs (or emacs) lisp load
 directories (e.g. site-lisp/hm--html-menus).
+@item @emph{For XEmacs only}: Put the files @file{drop} and @file{dropmsk}
+in the directory specified by the lisp variable
+@code{idd-data-directory}. By default it is
+@file{<prefix>/lib/xemacs-<version>/etc/idd} (eg: if you have installed
+the XEmacs 19.15 at your site in @file{/usr/local}, then it is the
+directory @file{/usr/local/xemacs/lib/xemacs-19.15/etc/idd}.
+If you'd like to put the files in another directory, then you must set
+the variable @code{idd-data-directory} to this directory (eg:
+@code{(setq idd-data-directory "/usr/local/data")})
 @item Put the following in your .emacs (or default.el or site-init.el):
 @lisp
 (autoload 'hm--html-mode "hm--html-mode" "HTML major mode." t)
 (autoload 'hm--html-minor-mode "hm--html-mode" "HTML minor mode." t)
 (or (assoc "\\.html$" auto-mode-alist)
 You should be able to use the package after its installation without
 any further customization. But it contains a lot of user variables to
 adapt the package better to your special needs. How to do this is
 described in this chapter.
+Since the XEmacs 19.15 and 20.2 a special package can be used for the
+customization of lisp packages. This package uses now also this
+feature. Therefore you can set all user variables with the help of the
+Customize submenu, which can be selected in the Option menu.  If you use
+it, the variables will currently be saved in a special customization
+file and not in one of the configuration files (@pxref{Customization
+(Configuration) Files, Customization (Configuration) Files}) of this
+package. Please look at the @file{NEWS} file or the info manuals of the
+XEmacs to find out more about the customization package.
 @menu
 * Customization (Configuration) Files::
 * Customization Variables::
 @end menu
 path. If you write the filename without its extension (.el), emacs
 tries first to load a compiled version of the file.
 The environment variables overwrite the lisp variables.
+You can prevent the loading of the site specific customization file
+by starting the emacs with the -no-site-file flag.
 You can also put the site specific customization in any standard emacs
 customization file like, @file{default.el}. But an advantage to
 using @file{hm--site-configuration-file.el} is that it is very likely
 you will be able to use this file with future versions of the
 package. I'll try to make it as backward compatible as possible.
 home directory of the user. This can be overwritten by setting either
 the environment variable @code{HTML_USER_CONFIG_FILE} or the lisp
 variable @code{hm--html-user-config-file} to the name of the file and
 its path. If you write the filename without its extension (.el), emacs
 tries first to load a compiled version of the file.
+If neither the environment variable nor the lisp variable is set, the
+variable @code{init-file-user} will be respected. This means, that
+you'll get the @file{~other-user/.hm--html-configuration.el}, if you've
+started the emacs with the options @code{-u other-user}. In all cases,
+no user specific customization file will be loaded, if the @code{-q}
+option was given to the emacs.
 You can also put the user specific customization in your
 @file{.emacs}. It's up to you to decide which way is better.
 @emph{Note}: This file is loaded after the package and the site specific
 @subsection  Automatic Insert Of Information
 @cindex automatic insert
 @cindex date
 @cindex changed comment
 @cindex created comment
-@vindex hm--html-automatic-new-date
+@vindex hm--html-automatic-update-title-date
 @vindex hm--html-automatic-changed-comment
 @vindex hm--html-automatic-create-modified-line
 @vindex hm--html-automatic-update-modified-line
 @vindex hm--html-changed-comment-prefix
 @vindex hm--html-created-comment-prefix
 @vindex hm--html-mode-prefix-key
 @itemize @bullet
 @item
 @code{hm--html-minor-mode-prefix-key}: The prefix key for the key tables
-in @code{hm--html-minor-mode}.
+in the minor mode @code{hm--html-minor-mode}.
 @item
-@code{hm--html-mode-prefix-key}: The prefix key for the hm--html keys in
+@code{hm--html-mode-prefix-key}: The prefix key for the keys in the
-@code{hm--html-mode}.
+major mode @code{hm--html-mode}.
 @end itemize
 @node Pulldown Menu Names, Hook Variables, Prefix Keys, Customization Variables
 @comment  node-name,  next,  previous,  up
 elements. In the future I'll try to implement a better indentation for
 these elements.
 @end itemize
-@node Add New Elements, Use With psgml-html, Customization, Top
+@node Add New Elements, Use With Other Major Modes, Customization, Top
 @comment  node-name,  next,  previous,  up
 @chapter  Add New Elements
 @cindex add new html elements
 @cindex non standard html
 @vindex hm--html-tag-name-alist
 different sorts of elements, like anchors, frame elements (doesn't mean
 the Netscape element frame) and so on. These "groups" are the same as
 the submenu groups.
-@node Use With psgml-html, Internal Drag And Drop, Add New Elements, Top
+@node Use With Other Major Modes, Internal Drag And Drop, Add New Elements, Top
 @comment  node-name,  next,  previous,  up
-@chapter  Use With psgml-html
+@chapter  Use With Other Major Modes
-@cindex use with other HTML modes
+@cindex use with other major modes
+@cindex use with psgml-html
+@cindex psgml-html
 @findex hm--html-minor-mode
 The package provides a minor mode called @code{hm--html-minor-mode},
-which could be used to join the features of this package with another
+which could be used to join the features of this package with other HTML
-HTML package. Currently this is only tested with the psgml-html mode in
+packages or use it's features in other major edit modes. This is
-XEmacs. Please let me know if it works or not with other packages
+usefull, if you'd like to extend another HTML mode or if you'll write
-or in Emacs 19.
+program code, which contain HTML parts.
+Currently this is tested with the psgml-html mode, the @code{perl-mode}
+and the @code{java-mode}. Please let me know if it works or not with
+other packages.
 If you'd like to use the minor mode in psgml-html mode,
 put the following line in your @file{.emacs}:
 @lisp
 @code{html-mode-hook} doesn't exist in those versions. Therefore in those
 versions you must either call the minor mode by hand or change the
 lisp file of the psgml-html mode.
-@node Internal Drag And Drop, Template Minor Mode, Use With psgml-html, Top
+@node Internal Drag And Drop, Template Minor Mode, Use With Other Major Modes, Top
 @comment  node-name,  next,  previous,  up
 @chapter  Internal Drag And Drop
 @cindex drag and drop
 @cindex internal drag and drop
 @vindex idd-actions
 @node Drag And Drop Customization, The Drag And Drop Commands, Internal Drag And Drop, Internal Drag And Drop
 @comment  node-name,  next,  previous,  up
 @section  Drag And Drop Customization
 @cindex customization
 @cindex configuration
+Since the XEmacs 19.15 and 20.2 a special package can be used for the
+customization of lisp packages. The internal drag and drop package uses
+now also this feature. Therefore you can set all user variables with the
+help of the Customize submenu, which can be selected in the Option menu.
+If you use it, the variables will currently be saved in a special
+customization file. Please look at the @file{NEWS} file or the info
+manuals of the XEmacs to find out more about the customization package.
 The internal drag and drop functions may be used in all
 modes. Therefore their general customization isn't done in
 @file{hm--html-configuration.el}. Its variables are defined in the file
 @file{internal-drag-and-drop.el} instead. You can set them in your
 @menu
 * Defining The Drag And Drop Actions::
 * The Mouse Bindings::
+* The Drag And Drop Mouse Pointer::
 @end menu
 @node Defining The Drag And Drop Actions, The Mouse Bindings, Drag And Drop Customization, Drag And Drop Customization
 @comment  node-name,  next,  previous,  up
 @subsection  Defining The Drag And Drop Actions
 (((idd-if-local-file-p . t))
 hm--html-idd-add-file-link-to-buffer)))
 @end lisp
-@node The Mouse Bindings,  , Defining The Drag And Drop Actions, Drag And Drop Customization
+@node The Mouse Bindings, The Drag And Drop Mouse Pointer, Defining The Drag And Drop Actions, Drag And Drop Customization
 @comment  node-name,  next,  previous,  up
 @subsection  The Mouse Bindings
 @cindex mouse bindings
 @vindex idd-global-mouse-keys
 @vindex idd-global-help-mouse-keys
 The @emph{disadvantage} of the @code{press-button-during-move} type
 compared with the @code{click} type is that you can't select a destination
 region, and therefore a drag and drop action depending on a selected
 region can't be started with that type of mouse binding.
 @end itemize
+@node The Drag And Drop Mouse Pointer,  , The Mouse Bindings, Drag And Drop Customization
+@comment  node-name,  next,  previous,  up
+@subsection  The Drag And Drop Mouse Pointer
+@cindex mouse pointer glyph
+@vindex idd-mouse-pointer-image
+@vindex idd-data-directory
+@vindex idd-overwrite-mouse-pointers
+@vindex idd-drag-and-drop-pointer-glyph
+@findex idd-make-drag-and-drop-pointer-glyph
+In the XEmacs the mouse pointer glyph (shape) can be set to any
+glyph. This is used during the drag and drop command to indicate, that
+the command is active. There exists the following three variables to
+customize this:
+@itemize @bullet
+@item
+@code{idd-mouse-pointer-image}: The name of the xbm file with the mouse
+pointer image. By default this is the file @file{drop}. There exists
+also a file called @file{dropmsk}, which contains the mask image. The
+mask file is loaded automaticly.
+@item
+@code{idd-data-directory}: The name fo the directory, where the file
+@code{idd-mouse-pointer-image} is searched. By default this is the
+subdirectory @file{idd} in the XEmacs install directory
+@code{data-directory}.
+@item
+@code{idd-overwrite-mouse-pointers}: A list with pointer glyph
+variables, which should be overwritten by the
+@code{idd-drag-and-drop-pointer-glyph}. If it is nil, the pointer wont
+be changed. Currently it must be nil in the Emacs.
+@end itemize
+If one of the variables @code{idd-mouse-pointer-image} or
+@code{idd-data-directory} is changed, the command
+@code{idd-make-drag-and-drop-pointer-glyph} must be called. This command
+builds the mouse pointer glyph, which is stored in
+@code{idd-drag-and-drop-pointer-glyph}.
+I don't know how to set the the mouse pointer in the Emacs to a drag and
+drop image. Any hints for doing this are welcome.
 @node The Drag And Drop Commands,  , Drag And Drop Customization, Internal Drag And Drop
 @comment  node-name,  next,  previous,  up
 @section  The Drag And Drop Commands
 @cindex drag and drop commands
 @vindex tmpl-automatic-expand
 @vindex tmpl-filter-regexp
 @vindex tmpl-sign
 @vindex tmpl-minor-mode-map
+Since the XEmacs 19.15 and 20.2 a special package can be used for the
+customization of lisp packages. The internal drag and drop package uses
+now also this feature. Therefore you can set all user variables with the
+help of the Customize submenu, which can be selected in the Option menu.
+If you use it, the variables will currently be saved in a special
+customization file. Please look at the @file{NEWS} file or the info
+manuals of the XEmacs to find out more about the customization package.
 Templates may be used for all editing modes, not only for
-@code{hm--html-mode}. Therefore their general customization isn't done in
+@code{hm--html-mode}. Therefore their general customization isn't done
-@file{hm--html-configuration.el}. Template variables are defined in the file
+in @file{hm--html-configuration.el}. Template variables are defined in
-@file{tmpl-minor-mode.el} instead. You can set them in your
+the file @file{tmpl-minor-mode.el} instead. You can set them in your
 @file{.emacs} or in one of the other emacs init files (e.g.
 @file{default.el}). The following are the main variables for
 customization.
 @itemize @bullet
 @item
 The history variable determined by @code{tmpl-history-variable-name}
 isn't used, because the function @code{read-file-name} doesn't support
 it in the Emacs 19.
+@item
+The mouse pointer shape (glyph) wont be changed in the Emacs 19 during a
+drag and drop command. For that a way is needed to set the mouse pointer
+shape to an image.
 @end itemize
 @node Bug Reports, Concept Index, Hints For Emacs 19 Users, Top
 @comment  node-name,  next,  previous,  up

Mercurial > hg > xemacs-beta

comparison man/hm--html-mode.texi @ 177:6075d714658b r20-3b15