-*-tm-gnus manual-*-
tm-gnus manual

tm-gnus 7.25 Reference manual
*****************************

This file documents tm-gnus, a MIME extension for GNUS and Gnus.

Introduction
************

tm-gnus is a GNUS extender to use tm. It supports GNUS 3.*, GNUS 4.*, (ding) GNUS and GNUS 5.*.

tm-gnus extends MIME features to GNUS. tm-gnus decodes RFC 1522 MIME encoded-word in summary buffer and article buffer, and adds a command to preview MIME message using tm-view in summary mode.

In GNUS 3.15 or later and Gnus, tm-gnus can display MIME preview buffer instead of article buffer. It is useful for heavy MIME user.

Note: September Gnus has some features to support tm-gnus. So it is better choice if you don't dislike alpha version.

tm-gnus has following modules:

  - tm-gnus.el:  main module of tm-gnus

  - tm-gnus3.el: module for GNUS 3.*.

  - tm-gnus4.el: module for GNUS 4.*, Gnus 5.0 and 5.1

  - tm-gd3.el:   common part for GNUS

  - tm-gd5.el:   common part for Gnus

  - tm-sgnus.el: module for September Gnus

Features
********

tm-gnus expands following features to GNUS.

Summary buffer decoding
=======================

tm-gnus decodes MIME encoded-word in summary buffer using tm-view (see encoded-word decoding (tm-eword_en)) functions. However if an encoded-word has unsupported charset, it is not decoded.

Extension to Summary mode
=========================

M-t
     In automatic MIME preview support version GNUS, it is the toggle whether to do automatic MIME preview or not. Otherwise it is the toggle for decoding mode of RFC 1522 MIME encoded-word.

v
     Enter mime/viewer-mode to view a message.

mime/viewer-mode is a mode to view MIME messages. You can move in a message, or play each contents included in a message.

Automatic MIME Preview
======================

``Automatic MIME preview'' feature is available in GNUS 3.15 or later and Gnus. If this feature is available, when reading an article in summary mode, tm-gnus displays preview buffer processed by tm-view instead of raw article buffer.

Therefore if an article is encoded by Quoted-Printable or Base64, a decoded article is displayed. In addition, if using tm-rich, rich text article is automatic formated. Of course, multipart article is dealt with correctly.

Different from using metamail, speaker does not roar just then read an article includes audio content, video player does not play just then read an article includes video content, it does not do anonymous ftp or send mail when read an article includes external-message. These contents are played when you do decoding command in preview buffer.

However if you use a slow machine, or are just really impatient, you can stop automatic MIME preview.

 -- Variable: tm-gnus/automatic-mime-preview

     If it is t, tm-gnus is in automatic MIME preview mode.

In September Gnus, semantics of variable gnus-article-buffer is changed, its semantics is divided into following two variables.

 -- Variable: gnus-article-buffer

     It indicates the buffer to display. In automatic MIME preview mode, it indicates preview-buffer "*Article*" processed by tm-view.

 -- Variable: gnus-original-article-buffer

     It indicates raw article-buffer " *Original Article*" even if tm-gnus is in automatic MIME preview mode.

     GNUS and Gnus 5.1 or earlier don't have it, but tm-gnus4 emulate it. In this case, it indicates nil if there is not preview-buffer.