Mercurial > hg > xemacs-beta
diff lisp/hm--html-menus/README @ 70:131b0175ea99 r20-0b30
Import from CVS: tag r20-0b30
author | cvs |
---|---|
date | Mon, 13 Aug 2007 09:02:59 +0200 |
parents | 6a22abad6937 |
children | 0d2f883870bc |
line wrap: on
line diff
--- a/lisp/hm--html-menus/README Mon Aug 13 09:00:04 2007 +0200 +++ b/lisp/hm--html-menus/README Mon Aug 13 09:02:59 2007 +0200 @@ -1,10 +1,7 @@ -This README file describes the emacs lisp package hm--html-menus-5.5. +This README file describes the emacs lisp package hm--html-menus-5.0. The package provides functions and various popup and pulldown menus for a html mode called hm--html-mode, a mode for writing html pages. -It provides also a minor mode (hm--html-minor-mode), which can be used -together with another html major mode, like the psgml-html mode in the -XEmacs 19.14. It has an interface to view the html documents in a W3 browser with Netscape, the w3-package from William M. Perry and Mosaic with the @@ -12,8 +9,11 @@ interface, which makes it very easy to insert links or images, by just clicking on them. -Look at the file NEWS, to see what is new in this release. Some -of the major changes are also listed in the ANNOUNCEMENT file. +Look at the file NEWS, to see what is new in this release. One of the +main changes is, that it is no longer based on the html-mode.el +package from Marc Andreessen. Therefore the name of the mode has +changed to hm--html-mode and also the way to install the package is a +little bit different. So please read the installtion hints CAREFULLY! You should (but don't need) also get the w3 package from: @@ -23,18 +23,17 @@ and epoch. -This package is tested with the xemacs 19.15 on Suns with SunOS 5.5 -and on PC's with linux. But it should work also on other (possibly -only UNIX ?) platforms. +This package is tested with the xemacs 19.14 and the emacs 19.30 on +Suns with SunOS 4.1.3 and 5.5 and on PC's with linux. But it should +work also on other (possibly only UNIX ?) platforms. -Read the file README-EMACS-19, if you want to use this package with -GNU Emacs 19. +Read the file README-EMACS-19, if you want to use this package with +GNU Emacs 19. Thanks to Richard Stallman, who has helped me to port this package to the Emacs 19 and thanks to John Ladwig, who has corrected a lot of the -text and comments in this package and to all the other people like -Jerry G. DeLapp, Andreas Ernst, Bob Weiner and so on, who had provided -code, ideas, bug fixes or bug reports for this package. +text and comments in this package and to all the other people, who had +provided code, ideas, bug fixes or bug reports for this package. The package consists of the following files: @@ -47,17 +46,13 @@ adapt.el : provides functions to use this package with the GNU Emacs 19 hm--html.el : provides functions to write html pages; - in this file are all commands defined, - which inserts html elements and entities; -hm--html-indentation.el : provides the indentation stuff; -hm--html-keys.el : provides the keybindings; + some of these functions are similar to + functions of the html-mode.el; +hm--html-keys.el : provides the new keybindings; hm--html-menu.el : provides the menus; hm--html-mode.el : provides the functions for the definition of the hm--html-mode; this is now the main file of the package; -hm--html-not-standard.el : provides functions to insert some - non standard html elements; - this file is not evaluated by default; hm--html-configuration.el : configuration file for the html mode; choose this as system configuration file; hm--html-drag-and-drop.el : defines the HTML- specific functions @@ -66,7 +61,7 @@ returns the date in the format "day-month-year" like "30-Jun-1993". html-view.el : Ron Tapia's html-view.el to view html-pages - in the Xmosaic; it is patched for the use + in the Xmosaic; it is patched for use with the xemacs; internal-drag-and-drop.el : provides the general (html-mode independend functions) of the drag and @@ -77,18 +72,15 @@ with this mode you can expand templates, which are described in the file templates-syntax.doc (look at the files - command-description.html.tmpl and - frame.html.tmpl for examples); + command-description.tmpl and frame.tmpl for + examples); templates can be expanded automatically, if you include a file with templates via the - html pulldown menu item "Templates ..." - or with the item "Templates (fixed dirs)..."; -command-description.html.tmpl : Templatefile for the use with the + html pulldown menu item "Templates ..."; +command-description.tmpl : Templatefile for the use with the tmpl-minor-mode; -frame.html.tmpl : Templatefile, provides a simple frame; -doc/hm--html-mode.texinfo : Package documentation in the Texinfo format; -doc/umlaute.texinfo : Texinfo include file for german vowel - mutation (deutsche Umlaute); +frame.tmpl : Templatefile, provides a simple frame; + @@ -98,9 +90,9 @@ Note: In this version the setting of the environment variables HTML_CONFIG_FILE and HTML_USER_CONFIG_FILE are no longer necessary, -if you put the user configuration file in the home directory and -the system configuration file in one of the load path directories -of your XEmacs or Emacs 19. +if you put the user configuration file in the home directrory and +the system (site) configuration file in one of the load path directories +of your xemacs or GNU Emacs 19. 1. Put all the *.el files in one of your xemacs (or emacs) lisp load directories (i.e. lisp/packages). @@ -154,13 +146,8 @@ It could also be, that you've already the autoload lines for the w3 package in your emacs. - If you want to use this the hm--html-minor-mode together - with the psgml-html modes, then you should add the following - line (works only in XEmacs version >= 19.15 and != 20.0) - (add-hook 'html-mode-hook 'hm--html-minor-mode) - -3. Set (if you want) the environment variable HTML_CONFIG_FILE - to the html system configuration file i.e.: +3. Set the environment variable HTML_CONFIG_FILE to the html system + configuration file i.e.: setenv HTML_CONFIG_FILE /usr/xemacs/lisp/hm--html-configuration.el 4. Set (if you want) the environment variable HTML_USER_CONFIG_FILE to @@ -171,20 +158,11 @@ 5. Check the files hm--html-configuration.el and .hm--html-configuration.el whether all variables are set suitable for - you and your site or not. You can make changes in both of these files - and you can also create a site specific configuration file, called - hm--html-site-config-file.el and specified by the lisp variable - hm--html-site-config-file or the environment variable - HTML_SITE_CONFIG_FILE, and put your site specific settings in this - file. A site specific configuration file is useful, if you're a - system administrator and want to make site specific settings - without changing a file of this package or use the normal emacs - configuration files. + you and your site or not. You can make changes in both of these files. Note that .hm--html-configuration.el precedes the settings in - hm--html-site-config-file.el, which precedes the settings in - hm--html-configuration.el (user specific configuration overwrites - site specific configuration and site specific configuration - overwrites the settings made by the package). + hm--html-configuration.el, because it is the user specific + configuration file. So you should made site specific changes in + hm--html-configuration.el. Look at first at the following variables: @@ -198,7 +176,7 @@ 6. If you want to use templatefiles, you should put these files in the directory to which `hm--html-template-dir' points. - You can use the file command-description.html.tmpl as + You can use the file command-description.tmpl as an example. 7. If you don't want to use the feature of adding html comments @@ -259,9 +237,8 @@ it should be, but at the moment I've not the time to make a better one. -There is also a (small) html documentation about the package. You can -find it on: -http://www.tnt.uni-hannover.de/~muenkel/software/own/hm--html-menus/overview.html +There is also a html documentation about the package. You can find it on: +http://www.tnt.uni-hannover.de:80/data/info/www/tnt/soft/info/www/html-editors/hm--html-menus/overview.html Please send any bug reports, fixes or comments to