DOCUMENTATION To access the pov-mode.info file, start Emacs and type C-u C-h i RET. This will prompt you for a file: give the pov-mode.info file that you can find in the pov-mode.el directory. Or install it somewhere in your INFOPATH and run install-info pov-mode.info dir. The source of pov-mode.info is in the info directory. So, if you have a decent TeX installation you can give the command texi2pdf --clean pov-mode.texi and print it as pdf. Or makeinfo --html pov-mode.texi and create a HTML doc directory. So you can skip the rest of this file and read the *real* documentation. INSTALLATION Step 1: Adding the load-path and auto-mode setup. Add the following code to your emacs customization file (at "~/.emacs"). (add-to-list 'load-path "~/john/pov-mode-3.x") (autoload 'pov-mode "pov-mode" "PoVray scene file mode" t) (add-to-list 'auto-mode-alist '("\\.pov\\'" . pov-mode)) (add-to-list 'auto-mode-alist '("\\.inc\\'" . pov-mode)) The "~/john/pov-mode-3.x" should be the path to the file pov-mode.el . Now, restart emacs. Now, if you open POV-Ray file (file ending in ".pov"), emacs will automagically load the pov-mode. Step 2: Download and install somewhere the InsertMenu directory, I'd recommend you to unpack it in the same directory of pov-mode.el. It is possible that <http://www.imagico.de/> has a fresher version. Step 3: Adding POV-Ray documentation path and include dir path. Type M-x customize-group RET pov RET Move your cursor to Pov Include Dir If its value is not correct, enter the correct path. Now, move your cursor to Pov Documentation Directory If its value is not correct, enter the correct path. Move your cursor to Pov Insertmenu Location If its value is not correct, enter the correct path. Once you have the correct path, scroll to the top and click the button "Save for Future Sessions" then click "Finish". Emacs will now create elisp code in your emacs init file. Now, restart emacs. This step tells pov-mode where is your POV-Ray include path so that you can view a include file in a POV-Ray file by placing your cursor on the path and type C-c C-c i. And if your cursor is on a keyword, type C-c C-c h will open its documentation in a browser. ---------------------- CUSTOMIZATION * If you have a slow computer, you can speed up loading pov-mode by byte-compile this package. To byte-compile, type M-x byte-compile-file and then enter the path to the pov-mode.el file. * You can customize the behaviour of pov-mode via typing M-x customize-group pov. So, try this! * You can customize the Insert menu by adding your template file in the directory InsertMenu. Simply name your template file in the same way other files are named, and use a different number. For example, suppose myscene_template.txt is your template file, and you want to add it under the menu "Insert:Scene Template". Rename your file to "01 - my scene.txt", then place it in the directory "InsertMenu/00 - Scene templates", then restart emacs. Then, your scene template file will appear as the first item in the menu "Insert:Scene Template". ---------------------- FEATURES To learn about the basics of using pov-mode, open a pov file and press C-h m.