1. Why this?
  2. Prerequisites/Things to know
  3. GNU Emacs and core components
    1. Emerge with different USE flags
    2. Editing capabilities
    3. Emerge Elisp packages
    4. eselect module
  4. Individual packages
    1. app-doc/casting-spels-emacs
    2. app-doc/elisp-manual
    3. app-emacs/analog
    4. app-emacs/apel
    5. app-emacs/auctex
    6. app-emacs/autoconf-mode
    7. app-emacs/bbdb
    8. app-emacs/binclock
    9. app-emacs/bm
    10. app-emacs/boxquote
    11. app-emacs/bubblet
    12. app-emacs/chess
    13. app-emacs/circe
    14. app-emacs/cldoc
    15. app-emacs/color-theme
    16. app-emacs/cperl-mode
    17. app-emacs/csharp-mode
    18. app-emacs/csv-mode
    19. app-emacs/develock
    20. app-emacs/df-mode
    21. app-emacs/dictionary
    22. app-emacs/dircolors
    23. app-emacs/dired-sort-menu
    24. app-emacs/doxymacs
    25. app-emacs/easypg
    26. app-emacs/ecb
    27. app-emacs/elscreen
    28. app-emacs/emacs-daemon
    29. app-emacs/emacs-jabber
    30. app-emacs/emacs-w3m
    31. app-emacs/emacs-wget
    32. app-emacs/erobot
    33. app-emacs/eperiodic
    34. app-emacs/erc
    35. app-emacs/ess
    36. app-emacs/fff
    37. app-emacs/filladapt
    38. app-emacs/flashcard
    39. app-emacs/flim
    40. app-emacs/folding
    41. app-emacs/gentoo-syntax
    42. app-emacs/gnuserv
    43. app-emacs/graphviz-dot-mode
    44. app-emacs/h4x0r
    45. app-emacs/haskell-mode
    46. app-emacs/highline
    47. app-emacs/htmlfontify
    48. app-emacs/htmlize
    49. app-emacs/howm
    50. app-emacs/ibuffer
    51. app-emacs/igrep
    52. app-emacs/initsplit
    53. app-emacs/jam-mode
    54. app-emacs/javascript
    55. app-emacs/keywiz
    56. app-emacs/limit
    57. app-emacs/lua-mode
    58. app-emacs/mailcrypt
    59. app-emacs/matlab
    60. app-emacs/mew
    61. app-emacs/mic-paren
    62. app-emacs/mldonkey
    63. app-emacs/mmm-mode
    64. app-emacs/mode-compile
    65. app-emacs/mpg123-el
    66. app-emacs/muse
    67. app-emacs/navi2ch
    68. app-emacs/nxml-mode
    69. app-emacs/ocaml-mode
    70. app-emacs/org-mode
    71. app-emacs/php-mode
    72. app-emacs/po-mode
    73. app-emacs/proofgeneral
    74. app-emacs/protbuf
    75. app-emacs/psql
    76. app-emacs/pymacs
    77. app-emacs/python-mode
    78. app-emacs/qwerty
    79. app-emacs/redo
    80. app-emacs/remember
    81. app-emacs/rfcview
    82. app-emacs/riece
    83. app-emacs/rst
    84. app-emacs/ruby-mode
    85. app-emacs/setnu
    86. app-emacs/slime
    87. app-emacs/sml-mode
    88. app-emacs/stripes
    89. app-emacs/table
    90. app-emacs/tdtd
    91. app-emacs/thumbs
    92. app-emacs/tnt
    93. app-emacs/tramp
    94. app-emacs/tuareg-mode
    95. app-emacs/typing
    96. app-emacs/u-vm-color
    97. app-emacs/uboat
    98. app-emacs/uptimes
    99. app-emacs/vhdl-mode
    100. app-emacs/view-process
    101. app-emacs/vm
    102. app-emacs/volume
    103. app-emacs/w3m-type-ahead
    104. app-emacs/wanderlust
    105. app-emacs/whine
    106. app-emacs/xrdb-mode
    107. app-emacs/xslide
    108. app-emacs/yow
    109. app-emacs/zenirc

Why this?

Some packages need testing when being keyworded or stabilised, so they are collected here.

Improvements of the test plans are of course welcome, attach them to the respective stabilisation bug or write an e-mail to emacs@gentoo.org.

Prerequisites/Things to know

Add

   (require 'site-gentoo)

to /usr/share/emacs/site-lisp/site-start.el or to your ~/.emacs file.

Emacs uses a special scheme for key combinations which uses C for Ctrl and M for Alt. So C-x C-c means Ctrl+x and Ctrl-c, which let's you exit Emacs.

Always make sure with the Eselect module that you have the latest stable version active.

GNU Emacs and core components

Here are some test cases to for GNU Emacs:

Emerge with different USE flags

Watch out that the X USE flag will switch between a console only and X-enabled Emacs editor. When having X support switched on, run emacs with the -nw switch to test text-only mode.

Editing capabilities

Call Emacs with a file as parameter, even run it with (server-start) in your ~/.emacs file and use the emacsclient executable to open test files.

Emerge Elisp packages

Emerge several packages from the app-emacs category and test them (various test cases are provided here).

eselect module

Emerge several versions of Emacs and CVS Emacs, try to switch versions and call the executables (check version with -version parameter). Check if correct man pages are symlinked.

Individual packages

app-doc/casting-spels-emacs

  1. Browse the HTML documentation at file:///usr/share/doc/casting-spels-emacs-19/html/casting-spels-emacs-1.html
  2. In Emacs, type M-x load-library RET wizard-adventure-emacs RET
  3. Type C-x b *scratch* RET and switch to the scratch buffer
  4. Try some commands, like (look) or (walk west). Terminate the commands by pressing C-j.

app-doc/elisp-manual

This should be tested with Emacs and with stand-alone info. Within Emacs:

  1. Type C-h i d to get the Info directory node
  2. Check if there is a dir entry for Elisp <version>
  3. Press RET at the dir entry to go to the manual
  4. Browse around

With stand-alone info:

  1. In the shell, type info
  2. Follow steps 2 etc as above

app-emacs/analog

  1. Add the following code to your ~/.emacs file:
    (setq analog-entry-list
          '(("test"
    	 (("df -HT" (label . "df") (type . shell-command) (lines . 10)
    	   (position . head) (actions) (faces) (alerts))
    	  ("last" (label . "last") (type . shell-command) (lines . 10)
    	   (position . head) (actions) (faces) (alerts)))))
          analog-use-timer t
          analog-timer-period 10)
    
  2. (Re)Start Emacs
  3. Press M-x and type analog
  4. You should get a status display for df -HT and last, updated every 10 seconds
  5. Press q to quit

app-emacs/apel

  1. emerge app-emacs/elscreen with it, see below

app-emacs/auctex

  1. Call emacs test.tex (empty file)
  2. Press C-c C-e and follow the instructions in the minibuffer (the line at the end)

USE=preview-latex only:

  1. Load the file circ.tex attached to this page
  2. Press C-c C-p C-b. There is an intentional error (you can see it by the comments around the region). Maybe you have to let LaTeX process it before via C-c C-c

app-emacs/autoconf-mode

  1. Load the file aclocal.m4 attached to this page
  2. The mode line should now say Autoconf
  3. You should get syntax highlighting if font-lock-mode is enabled
  4. Move the cursor to the beginning of some code block and press C-@ (or C-SPC)
  5. Move to the end of the code block and press C-c ;
  6. The block should be commented out now

app-emacs/bbdb

  1. Press M-x and type bbdb-create
  2. Follow prompts and enter all the information you want
  3. Press the following keys and play around: e (edit entry), ; (edit notes), d (delete entry)

app-emacs/binclock

  1. Press M-x and type binclock
  2. Current time in binary form should be displayed

app-emacs/bm

  1. Open a text file
  2. Move to some line you want to bookmark
  3. Press M-x and type bm-toggle
  4. The line should be highlighted now
  5. Repeat previous 3 steps another time
  6. Press M-x and type bm-show
  7. You should get a buffer *bm-bookmarks* with a list of the bookmarks

app-emacs/boxquote

  1. Press M-x and type boxquote-shell-command
  2. Type some command, like pwd or fortune
  3. A quoted box similar to the following example should appear:
    ,----[ fortune ]
    | Vi has one purpose, and should be used only for that purpose.
    | To configure Emacs for compilation.
    |                 -- Floyd Davidson
    `----
    

app-emacs/bubblet

  1. Press M-x and type bubblet
  2. Play a game by clicking units of more than two same-coloured blocks

app-emacs/chess

  1. Make sure you are member of the games group, and /usr/games/bin is in your PATH
  2. Make sure you have Emacs open in an X session, not console
  3. Press M-x and type chess
  4. A new window with a chess board should appear
  5. Press V to change the size of pieces
  6. Type in some move like e4 or move pieces with the mouse

app-emacs/circe

  1. Press M-x and type circe
  2. Enter irc.freenode.net as host and 6667 as port
  3. Fool around on IRC

app-emacs/cldoc

  1. Execute the test plan for app-emacs/slime, see below
  2. Open the file cldoc-test.lisp attached to this page
  3. Check that the file's major mode is Lisp
  4. Move the point over defun
  5. You should see this in the minibuffer:
    defun: function-name lambda-list [[declaration* | documentation]] form* => function-name
    

app-emacs/color-theme

  1. Press M-x and type color-theme-select
  2. Use the cursor up/down keys and press return to select a theme

app-emacs/cperl-mode

  1. Load the file example.pl attached to this page
  2. The mode line should tell you that Perl mode is enabled
  3. Press M-x and type cperl-mode
  4. Highlighting should change a little bit and mode line should announce CPerl
  5. Check version by C-h v cperl-version
  6. Go to a Perl statement (like use) and press C-c C-h v
  7. You should get some help about this functions (bottom line)

app-emacs/csharp-mode

  1. Load the file test.cs attached to this page
  2. The mode line should now say C#
  3. Press M-xand type global-font-lock-mode
  4. The source code should be highlighted (or not highlighted anymore)

app-emacs/csv-mode

  1. Load the file test.csv attached to this page
  2. The mode line should now say CSV
  3. Mark the text with the mouse
  4. Press M-xand type csv-sort-fields and confirm the next question
  5. Lines should be sorted now
  6. Press M-xand type csv-transpose
  7. Columns and lines are now transposed

app-emacs/develock

  1. Load the file ChangeLog attached to this page
  2. Press M-xand type develock-mode
  3. You should now see markers for different errors: overlong lines, leading whitespace (non-tabs)

app-emacs/df-mode

  1. Press M-x and type df-mode
  2. The mode line should show buffer size / free space on partition

app-emacs/dictionary

  1. Press M-x and type dictionary-search
  2. Type some English word and watch the output

app-emacs/dircolors

  1. Press C-x C-f
  2. Type some incomplete path, e.g. /usr/share/emacs/site-lisp/
  3. Press TAB
  4. You should see directories in blue, source files in yellow, etc.

app-emacs/dired-sort-menu

  1. Press C-x C-f and type in a path (not an empty directory, please)
  2. The contents should be displayed in the main window
  3. Press M-x and type dired-sort-menu-toggle-reverse
  4. Repeat the former step and the ordering should be reversed everytime

app-emacs/doxymacs

  1. Load the file use_flag.h attached to this page
  2. Mode line should show C/l doxy
  3. Go to the first functions, press M-x and type doxymacs-insert-blank-multiline-comment
  4. A multiline comment should be there for you now

app-emacs/easypg

  1. You need a working GnuPG including a private key
  2. Press M-x and type epa-list-keys
  3. Your keyring should be displayed, select an entry and check the contents
  4. Press M-x and type epa-sign-file
  5. Choose a file you wish to sign, then check the signature (.asc file)
  6. Press M-x and type epa-sign-region in a writable opened file (aka buffer)
  7. See an inline signature appear

app-emacs/ecb

  1. Start Emacs in a folder with the source code of a program
  2. Press M-x and type ecb-activate
  3. It should display some windows with your source files
  4. Possibly use M-x ecb-change-layout and see a list of options with TAB

app-emacs/elscreen

  1. Press M-x and type load-library
  2. Type elscreen
  3. Press C-z C-c (a new tab should appear on one of the top lines)
  4. Work with Emacs (open a file or whatever)
  5. Use C-z C-p to switch to the previous screen in cyclic order, or C-z C-a to toggle screens
  6. Press M-x and type calculator
  7. A small window should appear over the minibuffer (regression test for Bug 196996)

app-emacs/emacs-daemon

This will work only if Emacs itself supports the --daemon option. Use eselect emacs set emacs-23 to make sure that you have Emacs 23.

  1. As root, create a link for the init script for a user: ln -s emacs /etc/init.d/emacs.<user>
  2. Start the Emacs daemon with /etc/init.d/emacs.<user> start
  3. Login as the user that you had previously specified
  4. Connect to the Emacs daemon with emacsclient -t in a terminal, or with emacsclient -c for a new X frame
  5. Type C-x 5 0 to disconnect again

app-emacs/emacs-jabber

  1. Press M-x and type jabber-customize
  2. Give an XMPP server and a user name in the correct fields
  3. Save settings (either permanent or for that session only)
  4. Press M-x and type jabber-connect
  5. Type in password when asked
  6. Go to buffer *-jabber-*
  7. Try to chat with some contacts you might have

app-emacs/emacs-w3m

  1. Press M-x and type w3m
  2. You should be able to browse the WWW now
  3. Press RET or middle mouse button on an image to display it

app-emacs/emacs-wget

  1. Press M-x and type wget
  2. Type in name of a file to download from the internet
  3. Possibly confirm creation of ~/download
  4. Press M-x and type wget-web-page
  5. Type in a domain name
  6. Check ~/download for the files

app-emacs/erobot

  1. Press M-x and type erobot-tour
  2. If something moves on the screen, you are done

app-emacs/eperiodic

  1. Press M-x and type eperiodic
  2. Move around with the cursor keys and watch the property table below change

app-emacs/erc

  1. Press M-x and type erc
  2. Answer the questions, the default is good for Freenode
  3. chat along on your favourite Gentoo channel

app-emacs/ess

  1. Create a working directory and cd there
  2. Make sure you have dev-lang/R installed
  3. Start Emacs, press M-x and type R
  4. An R shell should appear, saying iESS in the mode line
  5. Press M-x and type server-start
  6. Type fix(iterator) in the R shell
  7. A new window should open with a function skeleton
  8. Leave the window with C-#

app-emacs/fff

  1. Press M-x and type fff-install-map
  2. Press C-c C-f C-f and type a filename (without path!)
  3. It should locate the file and open it

app-emacs/filladapt

  1. Add the following line to your ~/.emacs file: (require 'filladapt)
  2. Restart Emacs
  3. Open a file
  4. Press M-x and type filladapt-mode
  5. The status line should show Filladapt
  6. Press M-q, the paragraph should be reformatted

app-emacs/flashcard

  1. Load the file emacs.deck attached to this page
  2. Answer the questions

app-emacs/flim

  1. Emerge reverse dependencies: app-emacs/emacs-jabber, app-emacs/cmail, app-emacs/mu-cite, app-emacs/semi, app-emacs/wanderlust
  2. Test them

app-emacs/folding

  1. Make sure you have Emacs open in an X session, not console
  2. Open /usr/share/emacs/site-lisp/folding/folding.el
  3. Press M-x and type folding-mode
  4. All functions should be folded and highlighted
  5. Click on function name with middle mouse button to unfold

app-emacs/gentoo-syntax

  1. Open an ebuild, eclass and/or eselect file
  2. It should highlight the syntax
  3. Press C-c C-e and type in an ebuild sub command (manifest, unpack, compile etc.)

app-emacs/gnuserv

  1. Press M-x and type gnuserv-start
  2. Change to a terminal window and type gnuclient somefile there
  3. The file should now appear in an Emacs frame
  4. Finish editing with C-x #; the gnuclient command should return then

The above should be tested for both of the following:

  1. app-emacs/gnuserv and app-editors/xemacs installed, or
  2. app-emacs/gnuserv and app-emacs/gnuserv-programs installed

app-emacs/graphviz-dot-mode

  1. Load the file helloworld.dot attached to this page
  2. Check if dot is indicated in the mode line
  3. Typing M-x followed by font-lock-mode should toggle syntax highlighting
  4. Change the indentation of a few lines; the TAB key should restore it

If you have media-gfx/graphviz installed, you may now also test previewing:

  1. Type C-c c to generate a PNG image
  2. Type C-c p
  3. A *preview* window with the image should appear

app-emacs/h4x0r

  1. Open some text file
  2. Press M-x and type h4x0r-buffer
  3. T3h bUff0r sh001d b3 c0nv0rt3d t0 l33t sp33x n0w

app-emacs/haskell-mode

  1. Load the file Interp2.lhs attached to this page
  2. Check if there is a Haskell menu
  3. Check if there is LitHaskell on the bottom line
  4. Press M-xand type global-font-lock-mode
  5. The source code should be highlighted

app-emacs/highline

  1. Load a text file
  2. Press C-u M-x and type highline-mode
  3. The current line should be highlighted now

app-emacs/htmlfontify

This mode produces a HTML file out of a given text file:

  1. Open a text file
  2. Press M-x and type htmlfontify-buffer
  3. Save as file with extension .html
  4. Use a browser to verify that the output looks ok

app-emacs/htmlize

This mode produces a HTML file out of a given text file:

  1. Open a text file
  2. Press M-x and type htmlize-buffer
  3. Save as file with extension .html
  4. Use a browser to verify that the output looks ok

app-emacs/howm

  1. Press M-x and type howm-menu
  2. Play with it

app-emacs/ibuffer

  1. Make sure you have set Emacs 21 by eselect emacs set emacs-21
  2. Emerge it
  3. Open some files
  4. Press M-x and type ibuffer
  5. Check if all open files are nicely listed

app-emacs/igrep

  1. Press M-x and type igrep-find
  2. Type in a regex that should match the contents of files
  3. Type in a pattern for filenames in which should be searched

app-emacs/initsplit

  1. Add the contents of dotemacs.initsplit to your ~/.emacs file
  2. Add the line (setq confirm-kill-emacs (quote y-or-n-p)) to the file ~/test (this activates quit confirmation in Emacs, maybe you have it switched on already)
  3. Restart Emacs and check if you are asked for confirmation when quitting

app-emacs/jam-mode

  1. Load the file strawberry.jam attached to this page
  2. Go to line starting with cat
  3. Press M-x and type jam-indent-line, the line should be indented now
  4. Pressing M-x followed by font-lock-mode should toggle syntax highlighting

app-emacs/javascript

  1. Load the file bottles-1079.js attached to this page
  2. Check if JavaScript is indicated in the mode line
  3. Pressing M-x followed by font-lock-mode should toggle syntax highlighting
  4. Change the indentation of a few lines; the TAB key should restore it

app-emacs/keywiz

  1. Press M-x and type keywiz
  2. Press the key combinations connected to the given function
  3. Leave with q and see how miserably you failed

app-emacs/limit

  1. See test plan for app-emacs/flim

app-emacs/lua-mode

  1. Load the file test.lua attached to this page
  2. Pressing M-x followed by font-lock-mode should toggle syntax highlighting

app-emacs/mailcrypt

  1. Emerge dev-python/py-gnupg
  2. Use ebuild tool to compile mailcrypt ebuild
  3. Go to ${S}/${PN}-${PV}/tests/
  4. Run make

app-emacs/matlab

  1. Load the file test.m attached to this page
  2. It should ask you for MLINT configuration (say no)
  1. Text should be highlighted
  2. Edit the file (add a space e.g.) and save it
  3. Emacs should ask {{{Function and file names are different. Fix?(y or n) }}}
  4. Answer with yes, double(a) should now be test(a)

If you have Matlab installed (not shipped with Gentoo):

  1. Press M-x and type matlab-shell
  2. Play around there

app-emacs/mew

  1. Add lines to ~/.mew according to http://www.mew.org/release/info/mew_6.html.en#SEC6, the upper part is not relevant to set up only the mail configuration itself
  2. Press M-x and type mew
  3. Mail retrieval should start immediately
  4. Select a mail and press Enter to read it
  5. Press M-x and type mew-send to compose a mail
  6. Send it by C-c C-c

app-emacs/mic-paren

  1. Press M-x and type paren-activate
  2. Open a C or Lisp file (see the bottom of this page)
  3. Matching (and mismatched) parentheses should be highlighted now

app-emacs/mldonkey

  1. Run /usr/bin/mlnet (or the init script)
  2. Start Emacs, press M-x and type mldonkey
  3. A succesful connect is enough if you have an unconfigured mldonkey else
  4. try M-x and type mldonkey-sort-age to see your shared files listed

app-emacs/mmm-mode

  1. Load the file mmm-example.sh attached to this page
  2. Press y to accept the local variables of the file
  3. The two regions of the embedded here-documents should be highlighted now
  4. Move the cursor into the first highlighted region
  5. The mode line should change to (Shell-script[HTML][sh] MMM)
  6. Move to the second region
  7. The mode line should change to (Shell-script[Lisp][sh] MMM)
  8. Press C-h k TAB
  9. The help buffer should show the documentation for lisp-indent-line

app-emacs/mode-compile

  1. Load the file hello.c attached to this page
  2. Press M-x and type mode-compile
  3. You have to confirm the compile line (have a look if it is ok)
  4. Go to the directory where you stored hello.c and check if the corresponding executable gives correct output

app-emacs/mpg123-el

  1. Press M-x and type mpg123
  2. Choose a directory where you have MP3 or Ogg files
  3. Press space bar to start playing
  4. Help is provided in the very window, use some hotkeys

app-emacs/muse

  1. Add the following lines to your ~/.emacs file:
      (require 'muse-html)
      (require 'muse-latex)
      (require 'muse-texinfo)
      (require 'muse-docbook)
    
  2. Restart Emacs and doad the file test.muse attached to this page
  3. Press M-x and type muse-publish-file
  4. Answer the questsions, publishing style has tab completion, redo with different styles (PDF, LaTex?, Info, HTML etc.)
  5. Check output files if they make sense to you

app-emacs/navi2ch

  1. Press M-x and type navi2ch
  2. Move cursor to [+]PC等 around bottom
  3. Press SPACE to expand the tree
  4. Move cursor to UNIX (unix)
  5. Press SPACE to list up articles
  6. Check if articles are listed up
  7. Press SPACE on an article you choose
  8. You should read the contents of the article
  9. Press q three times to quit

If Japanese characters are not displayed correctly, you may have to install Japanese fonts first, before performing above test:

  1. Install Japanese fonts (emerge mplus-fonts e.g.)
  2. Add the following code to your ~/.emacs file:
    (create-fontset-from-fontset-spec
     "-mplus-gothic-*-r-normal--12-*-*-*-*-*-fontset-mplus_12r,
      ascii:-mplus-fxd-medium-r-semicondensed--12-*-*-*-*-*-iso8859-1,
      japanese-jisx0208:-mplus-gothic-medium-r-normal--12-*-jisx0208.1990-0,
      katakana-jisx0201:-mplus-gothic-medium-r-normal--12-*-jisx0201.1976-0")
    (set-default-font "fontset-mplus_12r")
    (set-language-environment "Japanese")
    
  3. (Re-)Start Emacs

app-emacs/nxml-mode

  1. Load the file test.valid.xml attached to this page
  2. You should get syntax highlighting and the mode line should show (nXML Valid)
  3. Load the file test.invalid.xml
  4. The mode line should show (nXML Invalid)
  5. Press C-h m and try some of the commands mentioned there

app-emacs/ocaml-mode

  1. Load the file text.ml attached to this page
  2. The mode line should show caml, if you have app-emacs/tuareg-mode installed you may have to switch to the right mode by M-x caml-mode
  3. You should get syntax highlighting if font-lock-mode is enabled
  4. Try some commands like C-c b and C-c w to insert begin and while forms

app-emacs/org-mode

  1. Load the file example.org attached to this page
  2. The mode line should show Org
  3. Text should be highlighted (if not press M-x and type font-lock-mode)
  4. Move the cursor to the * Top level headline
  5. Press TAB several times
  6. The state should cycle between FOLDED, CHILDREN, and SUBTREE, unfolding the respective sections
  7. Move the cursor to the * Example table line
  8. Press TAB until you are in state SUBTREE
  9. Move cursor to the number 10 in the second column
  10. Press TAB
  11. The line is calculated and the whole table reformatted, to accomodate the wider columns

app-emacs/php-mode

  1. Load the file admin.php attached to this page
  2. Text should be highlighted
  3. If not press M-x and type font-lock-mode

app-emacs/po-mode

  1. Load the file cups_de.po attached to this page
  2. Jump from field field with n
  3. Edit with RETURN
  4. Save the change for an entry with C-c C-c

app-emacs/proofgeneral

  1. Press M-x and type lego-mode
  2. A nice menu should appear (be sure to have started Emacs in X)

app-emacs/protbuf

  1. Open a file named test.txt (contents does not matter)
  2. Put (protect-buffer-from-kill-mode nil (get-buffer "test.txt")) into the buffer *scratch*
  3. Go to the end of the just pasted line and press C-x C-e
  4. Go to the buffer test.txt
  5. Press C-x k RET and the buffer should not be closed (including a message in the bottom line), the displayed buffer may change though

app-emacs/psql

  1. Load the file test.sql attached to this page
  2. The mode line should now say psql
  3. You should get syntax highlighting if font-lock-mode is enabled

app-emacs/pymacs

  1. Press M-x and type pymacs-eval
  2. Type in a Python expression. For example 1+1
  3. Check the output: Successful execution returns nil or calculation result (2 in above case)
  4. Use M-x pymacs-load to load a Python library if you want to check some special expressions

app-emacs/python-mode

  1. Open /usr/bin/emerge (be careful when editing)
  2. Go down some lines so you are inside the first try block
  3. Press M-x and type py-goto-block-up
  4. Cursor should be on try
  5. Press C-c ! , this opens a Python interactive shell
  6. Do some Python

app-emacs/qwerty

  1. Press M-x and type qwerty
  2. Press M-x and type dvorak
  3. Typed in letters should not match the output on the screen
  4. Press C-x C-c to quit emacs (people with confirmation can use t for y)

app-emacs/redo

  1. Add (require 'redo) to your ~/.emacs file
  2. (Re)Start Emacs and type in text
  3. Undo by C-_
  4. Press M-x and type redo
  5. The text should reappear

app-emacs/remember

  1. Press M-x and type remember
  2. Write down a note and press C-c C-c
  3. Check ~/.notes if it has been saved correctly

app-emacs/rfcview

  1. Load an RFC text file, e.g. http://www.ietf.org/rfc/rfc2324.txt
  2. Page headers and footers should be suppressed, headings should be highlighted

app-emacs/riece

  1. Press M-x and type riece
  2. Answer the questions
  3. Type C-c j to join a channel
  4. Try some commands (type C-h m for a list))
  5. Type C-c q to quit

app-emacs/rst

  1. Load the file example.rst attached to this page
  2. Check if bottom line says (reST)
  3. Press M-x and type font-lock-mode, this should toggle highlighting
  4. Add ^^ below the first word (An)
  5. Press M-x and type rst-adjust
  6. Check if the carets are multiplied

app-emacs/ruby-mode

  1. Load the file biorhythm.rb attached to this page
  2. Check if there is Ruby on the bottom line
  3. Press M-x and type global-font-lock-mode
  4. See if the source code is highlighted (or if it is switched-off)

app-emacs/setnu

  1. Open any file
  2. Press M-x and type setnu-mode
  3. Lines should be preceded by a line number now
  4. Another M-x setnu-mode should turn it off again

app-emacs/slime

  1. Add the following line to your ~/.emacs file

(setq inferior-lisp-program "sbcl"), instead of sbcl you must choose the Common LISP implementation you use

  1. Press M-x and type slime
  2. If you get a console-like display, it is working

app-emacs/sml-mode

  1. Open file test.sml attached to this page
  2. Check if bottom line says (SML)
  3. Press M-x and type font-lock-mode
  4. Check highlighting
  5. info sml-mode for documentation

app-emacs/stripes

  1. Open a text file
  2. Press M-x and type stripes-mode
  3. You should see a pyjama-like pattern now

app-emacs/table

  1. Please test this package with both emacs-21.4-r12 and emacs-22.1-r1 (where it is disabled - a message should be displayed in pkg_postinst)
  2. Press M-x and type table-insert
  3. Press RET 4 times for the default answers to all questions
  4. A 3x3 table template should appear
  5. Type some text; press TAB to go to the next field

app-emacs/tdtd

  1. Follow the instructions in /usr/share/doc/tdtd-*/tutorial.txt

app-emacs/thumbs

  1. Press M-x (make sure you are in X) and type thumbs
  2. Choose a directory where images are located
  3. Watch the output

app-emacs/tnt

  1. Press M-x and type tnt-open
  2. Follow the menu and connect to an AIM server

app-emacs/tramp

  1. Press C-x C-f
  2. Type in /ssh:username@dev.gentoo.org:filename
  3. Edit it, save it (C-x C-s), control by normal ssh if everything went fine
  4. Press M-x and type tramp-version
  5. Check output to be in sync with emerged version
  6. Press C-x C-f
  7. Type in /su::/etc/rc.conf and give your root password (make sure you start Emacs as normal user)
  8. Edit and save the file

app-emacs/tuareg-mode

  1. Open text.ml in Emacs
  2. Code should be highlighted and mode line should show Tuareg
  3. Go to a random code line and press C-M-h
  4. A phrase (like a block after a let statement) should be marked

app-emacs/typing

  1. Press M-x and type typing-of-emacs
  2. Have fun

app-emacs/u-vm-color

  1. Follow test plan for app-emacs/vm, see below
  2. In addition, fonts should be coloured now

app-emacs/uboat

  1. Press M-x and type uboat-death-message
  2. A message should appear in the echo area

app-emacs/uptimes

  1. Add the following line to your ~/.emacs file: (require 'uptimes)
  2. Start Emacs again
  3. Press M-x and type uptimes
  4. A list of Emacs session uptimes should be displayed

app-emacs/vhdl-mode

  1. Load the file Example.vhd attached to this page
  2. The mode line should say (VHDL/es) now
  3. Press C-h v vhdl-version RET and verify if you have the right version (an older version of vhdl-mode comes with Emacs itself)
  4. Pressing M-x followed by font-lock-mode should toggle syntax highlighting
  5. Press M-> to go to the end of the buffer
  6. Type entity and press SPACE
  7. Answer the questions, the template should be filled (empty answer(s) to terminate)

app-emacs/view-process

  1. Press M-x and type view-processes
  2. A list of all running processes should be displayed

app-emacs/vm

  1. Create a file ~/.vm where you specify how mail is retrieved:
    • (setq vm-spool-files '("pop:HOST:110:pass:USER:*")) for POP
      (HOST and USER should be replaced by appropriate values),
    • (setq vm-spool-files '("imap:HOST:143:inbox:login:USER:*")) for IMAP
    • Add an mbox file to download and use (setq vm-spool-files '("~/mbox.file"))
    • See info vm / Starting Up / Spool Files for more information
  2. Press M-x and type vm to start vm
  3. Press g to retrieve new mail
  4. Press SPACE to view a message
  5. You should see the contents of your mail folder now

app-emacs/volume

  1. Press M-x and type volume
  2. An indicator bar should appear
  3. Use the left and right arrow keys to change the audio volume
  4. Press q to quit

app-emacs/w3m-type-ahead

  1. Follow the test plan for app-emacs/emacs-w3m
  2. In addition, the / key should do incremental searches, but limited to the text in HREF anchors

app-emacs/wanderlust

  1. Create a file {~/.folders
    1. -gmane.emacs.announce:@news.gmane.org:119
  2. Press M-x and type {wl
  3. Enter the newsgroup by clicking on the folder name

app-emacs/whine

  1. Press M-x and type whinify
  2. Try some keyboard commands, like cursor movement
  3. The commands should print silly messages in the message line now
  4. Press M-x and type unwhinify to turn it off again

app-emacs/xrdb-mode

  1. Load the file Emacs.ad attached to this page
  2. The mode line should say (xrdb) now
  3. Pressing M-x followed by font-lock-mode should toggle syntax highlighting

app-emacs/xslide

  1. Load the file test.xsl attached to this page
  2. The mode line should say (XSL) now
  3. Pressing M-x followed by font-lock-mode should toggle syntax highlighting
  4. Press M-x and type xsl-electric- followed by two times tab key
  5. Choose a function and check if they generate the correct character

app-emacs/yow

  1. Test this package with GNU Emacs 22.1 or later
  2. Press M-x and type yow
  3. A random quotation should appear in the minibuffer (try it several times; it should be a different one each time)

app-emacs/zenirc

  1. Add the following lines to your ~/.emacs file:
    • (setq zenirc-server-default "irc.freenode.net")
    • (setq zenirc-nick-default "name")
  2. Restart Emacs
  3. Press M-x and type zenirc
  4. Use IRC commands as usual

Attachments