IMAIL User`s Manual
Contents
1. Modified Version as given on the Title Page If there is no section entitled History in the Document create one stating the title year authors and publisher of the Document as given on its Title Page then add an item describing the Modified Version as stated in the previous sentence J Preserve the network location if any given in the Document for public access to a Transparent copy of the Document and likewise the network locations given in the Document for previous versions it was based on These may be placed in the History section You may omit a network location for a work that was published at least four years before the Document itself or if the original publisher of the version it refers to gives permission K In any section entitled Acknowledgements or Dedications preserve the sec tion s title and preserve in the section all the substance and tone of each of the contributor acknowledgements and or dedications given therein L Preserve all the Invariant Sections of the Document unaltered in their text and in their titles Section numbers or the equivalent are not considered part of the section titles M Delete any section entitled Endorsements Such a section may not be included in the Modified Version N Do not retitle any existing section as Endorsements or to conflict in title with any Invariant Section If the Modified Version includes new front matter sections or appendices that qualify2. different formats or between two different IMAP servers IMAIL doesn t care it translates as needed The D imail delete folder command deletes a specified folder All of the messages in the folder and the folder itself are deleted You will be prompted to confirm before any deletion is done The R imail rename folder command renames a specified folder You are prompted for two URLs the old name and the new one At present this command only works in limited circumstances specifically when moving a folder from one place to another on a single IMAP server or when moving a file folder from one place to another within the same file system The rename operation fails if the new name is already in use The imail create folder command creates a new empty folder It prompts for a URL and signals an error if the name is already in use This command is rarely used since the message copying commands automatically create folders as needed Chapter 4 Commands 12 4 4 MIME Support The Multipurpose Internet Mail Extensions MIME define a standard means for struc turing mail messages MIME permits a message to have multiple parts each of which is called an entity It also provides a way to associate type information with each entity For example an ordinary text message has type text plain HTML has type text html and a JPEG image has type image jpeg Additionally MIME entities may be annotated to indicate whether they sh
3. fetched only if you want to view or save it If you aren t interested in the attachment you can delete the message without ever fetching it from the server In addition to these features IMAIL provides a user interface very similar to that of the Emacs Rmail mail reader see section Rmail in the GNU Emacs Manual IMAIL supports most of the same commands and has most of the same key bindings as Rmail IMAIL is primarily intended to be an Rmail replacement for people who wish to read their mail using an IMAP server IMAIL can also read and write Rmail files and unix mail mbox files and provides the ability to copy messages from such a file to an IMAP folder or vice versa this greatly simplifies the transition from Rmail to IMAIL for those of us who have large amounts of mail stored in files Chapter 2 Getting Started 2 2 Getting Started At present IMAIL has only a very simple mechanism for connecting to an IMAP server it makes an unencrypted connection to the server and logs in with a user name and a password In the near future we will implement CRAM MD5 authentication defined in RFC 2095 However we have no plans to implement data stream encryption for the connection To use IMAIL you must create an Edwin init file called edwin on unix machines or edwin ini on Windows or OS 2 machines This file contains arbitrary Scheme expressions that are evaluated in the Edwin environment when Edwin is started In additi
4. file s type from its content As specified by the URL standard pathname is a slash separated sequence of path compo nents where unusual characters appearing in the components such as the space character are specially encoded However IMAIL will accept nearly any character in a component and encode it if required with few exceptions you can type any pathname without encoding IMAIL always displays URLs with proper encoding In practice this means that most unix filenames are written verbatim with exceptions for special characters and with the leading slash omitted However DOS style filenames as used by Windows and OS 2 must be specially rewritten to conform to this style The rewriting rules for Dos file URLs are not specified by the standard so consequently IMAIL defines its own rules for this encoding as follows A Dos filename is encoded by replacing all of the backslash characters with forward slash characters and by encoding unusual characters in the path components Finally the drive letter is prefixed to the path with an additional forward slash separator So for example the filename C My Documents MailMMy Mail rmail becomes the URL rmail localhost C My420Documents Mail My 20Mail rmail 3 4 Server Connections Unlike a file folder in which the folder s contents are always available access to an IMAP folder requires an active network connection to the IMAP server This adds an additional layer of complexity t
5. flags imail next flagged message C M p flags Move to the previous message that has one of the flags flags imail previous flagged message C M 1 flags Make a summary of all messages containing any of the flags flags imail summary by flags The a imail add flag and k imail kill flag commands allow you to assign or remove any flag on the current message Once you have given messages flags to classify them as you wish there are two ways to use the flags in moving and in summaries The command C M n flags imail next flagged message moves to the next message that has one of the flags flags The argument flags specifies one or more flag names separated by commas C M p imail previous flagged message is similar but moves backwards to previous messages numeric argument to either command serves as a repeat count The command C M 1 flags imail summary by flags displays a summary con taining only the messages that have at least one of a specified set of flags The argument flags is one or more flag names separated by commas See Section 4 8 Summaries page 17 for information on summaries Chapter 4 Commands 15 If the flags argument to C M n C M p or C M 1 is empty it means to use the last set of flags specified for any of these commands Some flags such as deleted and filed have built in meanings and are assigned to or removed from messages automatically at appropriate times Here is a list of bui
6. E at all For that reason IMAIL allows you to turn off this feature so that forwarded messages are included in the main body of the message as Rmail does To do this set the variable imail forward using mime to sf Normally when IMAIL forwards a message it sends only a few of the message s header fields In particular it sends only those header fields that you see when viewing the message in IMAIL Sometimes it is desirable to send all of the message s header fields IMAIL provides two ways to do this First if you want to send all of the header fields for a particular message use imail forward with a negative argument like this f Alternatively you can set the variable imail forward all headers to t which will cause all forwarded messages to retain all of their header fields Resending is an alternative similar to forwarding the difference is that resending sends a message that is from the original sender just as it reached you with a few added header fields Resent from and Resent to to indicate that it came via you To resend a message in IMAIL use C u f f runs imail forward which is programmed to invoke imail resend if you provide a numeric argument The m imail mail command is used to start editing an outgoing message that is not a reply It leaves the header fields empty Its only difference from C x 4 m is that it makes the IMAIL buffer accessible for C c C y just as r does Thus m can be used to rep
7. IMAIL User s Manual Edition 1 4 for IMAIL Version 1 8 28 December 2000 by Chris Hanson IMAIL User s Manual Copyright c 2000 Massachusetts Institute of Technology Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 1 or any later version published by the Free Software Foundation with no Invariant Sections with no Front Cover Texts and with no Back Cover Texts A copy of the license is included in the section entitled GNU Free Documentation License Chapter 1 Introduction 1 1 Introduction IMAIL is a program for reading electronic mail It uses the Internet Message Access Protocol IMAP RFC 2060 to access mail that is stored on a server from which IMAIL fetches individual messages on demand The server may have many different folders in which messages are stored arranged in a hierarchical structure like that of a file system Messages are easily moved or copied from one folder to another IMAP also supports the Multipurpose Internet Mail Extensions MIME RFC 2045 which facilitate the sending and receiving of attachments The IMAP protocol supports this by allowing you to fetch some parts of a mail message while leaving others on the server So for example if you receive a message containing a large attachment it is possible to view the text of the message without waiting for the attachment to be fetched from the server the attachment is
8. ME ead 8 imail select message e en te nn 8 imail summary o i4ee a 18 imail summary by flags eee 18 imail summary by recipients 18 imail summary by regexp sess 18 imail summary by topic 18 imail summary select message 19 imail toggl header 5 2 c esses 17 imail toggle message sees EA imail toggle mime entity 14 imail undelete previous message 9 Variable Index Variable Index I imail auto Wrap ci estere een Se Je ERT ge E EE 20 imail default dont reply to names 15 imail default imap mailbox 9 imail default imap server oii gee eee oes 9 imail default ser id gra 9 imail delete after output iu imail dont reply to names 15 imail expunge confirmation 9 imail forward all headers 16 imail forward using mime 16 imail global mail notification 11 imail ignored headers D imail inline mime text subtypes 13 imail kept headers o m er x 17 31 imail known mime charsets 13 imail mime attachment directory 13 imail mime boundary style 12 imail mime collapse digest 12 imail mime show alternatives 12 imail output default 04 T imail pass p
9. age buffer is highlighted in the summary buffer This aids navigation in the summary buffer and is thus the default Set it to if you don t like the highlighting By default the summary buffer has five columns flags message number message length subject and author If imail summary show date is set to t a sixth column containing an abbreviated date appears between the message number and the subject The width of the subject column is specified by the value of imail summary subject width subject fields longer than this number of characters are truncated 4 8 2 Editing in Summaries You can use the IMAIL summary buffer to do almost anything you can do in the IMAIL buffer itself In fact once you have a summary buffer there s no need to switch back to the IMAIL buffer You can select and display various messages in the IMAIL buffer from the summary buffer just by moving point in the summary buffer to different lines It doesn t matter what Emacs command you use to move point whichever line point is on at the end of the command that message is selected in the IMAIL buffer Almost all IMAIL commands work in the summary buffer as well as in the IMAIL buffer Thus din the summary buffer deletes the current message u undeletes and x expunges o outputs the current message to a folder C o saves an attachment from the current message r starts a reply to it You can scroll the current message while remaining in the summary b
10. and imail input from folder which reads a URL and copies all the messages from the specified folder into the current one The messages are appended to the current folder in the same order that they appear in the specified folder The o imail output command copies the current message into a folder that you specify as a URL The folder initially defaults to the current folder unless you have set the variable imail output default to a different default after the first message is output the default folder becomes the one to which you last output a message If the target folder doesn t exist it is created first in any case the copied message is appended to the end of the folder The current message is flagged as filed If the variable imail delete after output is true the message is also marked as deleted The C imail copy folder command copies an entire folder from one place to another You specify two URLs the source and the target and all of the messages from the source folder are copied verbatim to the target folder The source folder is not changed The target folder is created if it doesn t exist If the target folder does exist the source folder s messages are appended to it Note that all of the commands that copy messages between folders will work whether the folders are the same type or not In particular messages in IMAP folders can be copied to file folders and vice versa You can copy messages between two file folders in
11. are not as visually distinctive MIME also specifies a particular kind of multipart message of type multipart alternative in which the parts are different representations of the same message A typical example of this is a mailer that sends both plain text and HTML versions of the message text Normally IMAIL shows only the simplest of these parts which is almost always plain text and suppresses the alternatives However if you set the variable imail mime show alternatives to t IMAIL will show these alternative forms as attachments Another kind of multipart MIME message is the digest message which has type multipart digest Digest messages are normally used by high volume mailing lists to reduce the number of messages sent to the end user instead the user receives one message containing all of the messages from that list in a particular time period usually a day IMAIL can present MIME digest messages in one of two formats The default format is to show all of the component messages of the digest as attachments This is particularly useful for large digests that you will only read a few messages from since you can scan the digest contents for interesting messages without downloading all of the messages in the digest In the alternative format selected by setting imail mime collapse digest to Hf the component messages of a digest are all shown inline As a general rule any MIME entity that contains non textual information is dis
12. argument to any of these commands serves as a repeat count In IMAIL you can specify a numeric argument by typing just the digits You don t need to type C u first The M s imail search command is IMAIL s version of search The usual incremental search command C s works in IMAIL but it searches only within the current message The purpose of M s is to search for another message It reads a string nonincrementally then searches starting at the beginning of the following message for a match It then selects that message If string is empty M s reuses the string used the previous time To search backward in the folder for another message give M s a negative argument In IMAIL you can do this with M s It is also possible to search for a message based on flags See Section 4 5 Flags page 14 To find the next message with the same subject as the current message use C c C n imail next same subject This is useful for following the thread of an email conversa tion C c C p imail previous same subject finds the previous message with the same subject To move to a message specified by absolute message number use j imail select message with the message number as argument With no argument j selects the first message lt imail first message also selects the first message gt imail last message selects the last message M u selects the first unseen message imail first unseen message 4 2 Deleting Messages When you n
13. as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section entitled Endorsements provided it contains nothing but endorsements of your Modified Version by various parties for example statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard You may add a passage of up to five words as a Front Cover Text and a passage of up to 25 words as a Back Cover Text to the end of the list of Cover Texts in the Modified Version Only one passage of Front Cover Text and one of Back Cover Text may be added by or through arrangements made by any one entity If the Document already includes a cover text for the same cover previously added by you or by arrangement made by the same entity you are acting on behalf of you may not add another but you may replace the old one on explicit permission from the previous publisher that added the old one The author s and publisher s of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version 5 COMBINING DOCUMENTS GNU Free Documentation License 26 You may combine the Docume
14. command u imail undelete previous message is designed to cancel the effect of a d command in most cases It undeletes the current message if the current message is deleted Otherwise it moves backward to previous messages until a deleted message is found and undeletes that message Because imail expunge irreversibly deletes mail IMAIL normally requires confirmation before it performs the expunge This confirmation is controlled by the value of the variable imail expunge confirmation which is a list of symbols There are two independent behaviors controlled by this whether to prompt and whether to show the messages being expunged If the list contains the symbol verbose the default the user is prompted for a yes or no style confirmation if the list contains the symbol brief the user is prompted for a y or n style confirmation if neither of these symbols is present no confirmation is done If the list contains the symbol show messages a window is popped up showing the messages to be expunged otherwise the list is not shown You can usually undo a d with a u because the u moves back to and undeletes the message that the d deleted But this does not work when the d skips a few already deleted messages that follow the message being deleted then the u command undeletes the last of the messages that were skipped There is no clean way to avoid this problem However by repeating the u command you can eventually get back to the message that yo
15. d redistribute it with or without modifying it either commercially or noncommercially Secondarily this License preserves for the author and publisher a way to get credit for their work while not being considered responsible for modifications made by others This License is a kind of copyleft which means that derivative works of the document must themselves be free in the same sense It complements the GNU General Public License which is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it is published as a printed book We recommend this License principally for works whose purpose is instruction or reference 1 APPLICABILITY AND DEFINITIONS This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License The Document below refers to any such manual or work Any member of the public is a licensee and is addressed as you A Modified Version of the Document means any work containing the Document or a portion of it either copied verbatim or with modifications and or translated int
16. do these things in the Modified Version A Use in the Title Page and on the covers if any a title distinct from that of the Document and from those of previous versions which should if there were any be listed in the History section of the Document You may use the same title as a previous version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has less than five C State on the Title page the name of the publisher of the Modified Version as the publisher D Preserve all the copyright notices of the Document E Add an appropriate copyright notice for your modifications adjacent to the other copyright notices F Include immediately after the copyright notices a license notice giving the public permission to use the Modified Version under the terms of this License in the form shown in the Addendum below G Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document s license notice H Include an unaltered copy of this License GNU Free Documentation License 25 I Preserve the section entitled History and its title and add to it an item stating at least the title year new authors and publisher of the
17. e or base64 encoding it is decoded before it is saved If the entity is text it is written to the file in text mode relevant only under Windows and OS 2 otherwise it is written in binary mode Chapter 4 Commands 14 A simpler way to save a MIME entity is to point at the entity with the mouse and click the right button imail mouse save mime entity This works the same way as imail save mime entity except that the entity is selected by the mouse instead of point The command C t imail toggle mime entity is similar to imail save mime entity except that instead of saving the entity to a file it toggles whether the entity is shown in line or in abbreviated form A common situation in which this is useful is when the text of a message is in an unknown character set In this case IMAIL by default shows the text in abbreviated form use C t to expand it in place 4 5 Flags Each message can have various flags assigned to it as a means of classification Each flag has a name different names are different flags Any given flag is either present or absent on a particular message A few flag names have standard meanings and are given to messages automatically by IMAIL when appropriate All other flags are assigned only by users a flag Assign the flag flag to the current message imail add flag k flag RET Remove the flag flag from the current message imail kill flag C M n flags Move to the next message that has one of the flags
18. e the rest onto adjacent pages If you publish or distribute Opaque copies of the Document numbering more than 100 you must either include a machine readable Transparent copy along with each Opaque copy or state in or with each Opaque copy a publicly accessible computer network location containing a complete Transparent copy of the Document free of added ma terial which the general network using public has access to download anonymously at no charge using public standard network protocols If you use the latter option you must take reasonably prudent steps when you begin distribution of Opaque copies in quantity to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy directly or through your agents or retailers of that edition to the public It is requested but not required that you contact the authors of the Document well before redistributing any large number of copies to give them a chance to provide you with an updated version of the Document 4 MODIFICATIONS You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above provided that you release the Modified Version under precisely this License with the Modified Version filling the role of the Document thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it In addition you must
19. er thing to note about these examples is that IMAP unlike most file systems allows a folder to contain messages and to have subfolders This includes the inbox folder as shown here At least one server Cyrus puts all subfolders for a user account under inbox but this is not required by IMAP and is not generally true 3 3 2 File URLs URLs are defined in RFC 1738 and RFC 2396 The syntax for IMAP URLs is defined by RFC 2192 except that IMAIL uses only a subset of the defined syntax 3 This is in opposition to RFC 2192 which specifies use of the server specific separator RFC 2396 and RFC 2718 provide compelling arguments against this design Chapter 3 Concepts 5 There are two other URL types supported by IMAIL Rmail URLs and unix mailbox URLs Both of these use the same syntax which is exactly the same as the file URL syntax as follows rmail hostname pathname umail hostname pathname Here hostname refers to the host on which the file folder resides Since IMAIL supports only files on the local file system hostname must be localhost it may also be omitted as in rmail pathname IMAIL also supports a non standard abbreviation rmail pathname The prefixes rmail and umail specify the type of file folder being referred to respectively an Rmail file or a unix mailbox file In the future this design may be changed to use the file prefix for both types and determine the
20. es to the Document are reproduced in all copies and that you add no other conditions whatsoever to those of this License You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute However you may accept compensation in exchange for copies If you distribute a large enough number of copies you must also follow the conditions in section 3 You may also lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover and Back Cover Texts on the back cover Both covers must also clearly and legibly identify you as the publisher of these copies The front cover must present the full title with all words of the title equally prominent and visible You may add other material on the covers in addition Copying with changes limited to the covers as long GNU Free Documentation License 24 as they preserve the title of the Document and satisfy these conditions can be treated as verbatim copying in other respects If the required texts for either cover are too voluminous to fit legibly you should put the first ones listed as many as fit reasonably on the actual cover and continu
21. file In both cases internal data structures may be dropped requiring them to be rebuilt should the folder later be re opened In no case are any changes made to the folder s contents in particular deleted messages are not expunged On IMAP folders the q command is equivalent to M d b On file folders the q command is equivalent to s b The M d command imail disconnect disconnects IMAIL from the IMAP server goes offline This has no effect on file folders The b command imail bury buries the selected IMAIL buffer Burying a buffer means moving it to the bottom of the buffer list and selecting another buffer from the top of the list This is similar to the command bury buffer except that any summary buffer associated with this buffer is also buried and if a window was created to hold the summary buffer it is deleted The s command imail save folder saves out any changes to the selected IMAIL folder For file folders this means writing the folder back out to its file For IMAP folders this no effect In no case are any changes made to the folder s contents in particular deleted messages are not expunged IMAIL normally caches IMAP message bodies in memory in order to increase performance The variable imail body cache limit gives you some control over how this caching is done imail body cache limit is normally set to a positive integer meaning that any Chapter 4 Commands 21 message body or in line MIME entity whose size
22. ge Display erre meon e eme 17 48 Summaries enhn 17 4 8 1 Making Summaries 0 0000 eee eee 18 4 8 2 Editing in Summaries sseeueneeneee 19 4 9 Other Commandes 20 GNU Free Documentation License 22 ADDENDUM How to use this License for your documents Sr Key EE rescatar on 28 Command Indes eere 30 Variable Index 543335004 c etekesxaeseueptivhbewu ae 31 Concept Index sssi oues px xe edie eae wa eo or dedic 32
23. hrase retention time 21 imail primary folderf 2242 228 0 RS nn 9 imail reply with re oo md ener 16 imail summary fixed layout 19 imail summary height 6 r6 re 19 imail summary highlight message 19 imail summary pop up message 19 imail summary show date 19 imail summary subject width 19 imail update interval 11 Concept Index Concept Index A attachment MIME eri iisa 12 B BABY Ml 2 nentes dE DIA n BREET Raves 3 C close Zolder 2 voii Der 20 connection state 2 8 ses aa A A Rex wed 5 CYLUS sia deat ened teats de Ue de PRSE 4 D deletion oov E RILSUPRS E 8 disconnected mode 5 E email Message martir 3 entity MIME escocia essa ane dune 12 CXPUNGING Ee ee A AA a AA A AA dei 8 F ID EE 14 Older allo Re 8b ree UAI T Pe ere 3 folder EE 3 folder Cl acu oer ia n Rena 20 folder Primary esac cine tease onde idee apenas 9 forwarding a message 16 H heirarchical IMAP mailbox 4 hierarchical mailboX ooooocoooooooooo 4 I IMAP 3 50 ueber tun aibi ener eS i IMAP mailbox eeeeeee ees 3 IMAP UR arae E wat este oneri eren 4 DMD ANN E ee iaa laa 12 le 4 32 M Mbox E EE 3 MESS ASE RD TED 3 MME L R MIME attachment 222205 ar lse bed diso dona DA 12 MIME entity ona de pr aie Ana ede 12 Multipurpose Interne
24. iated as attachments Here are IMAIL s MIME specific commands C o Save a MIME attachment to a file imail save attachment w Save an arbitrary MIME entity message part to a file imail save mime entity C t Toggle a MIME entity between its formatted and raw forms imail toggle mime entity The primary MIME command is C o imail save attachment which saves a single attachment to a file If point is on an attachment that is the attachment to be saved otherwise IMAIL prompts for an attachment by name If a prefix argument is specified prompting is performed even if point is on an attachment Once the attachment is deter mined IMAIL prompts for the name of a file to save the attachment to The filename is initialized from the name specified by the attachment if any The directory of the filename is initialized to the directory in which the last attachment was saved or the user s home directory if no attachments have previously been saved If you want to save attachments to a specific directory change the variable imail mime attachment directory to contain the name of that directory The command v imail save mime entity is similar to imail save attachment ex cept that it will save any MIME entity not just an attachment For example this allows you to save the message text This command saves the entity that point is on if point is not on any entity an error is signalled If the entity is encoded e g with quoted printabl
25. in bytes is less than this number is cached However caching can be entirely disabled by setting imail body cache limit to f or made unconditional by setting it to stt Another thing that IMAIL caches is IMAP passwords This is done so that you don t have to keep typing your password whenever you connect to a new IMAP folder However this is also a security risk because the password is kept in Scheme s memory The variable imail pass phrase retention time says how long passwords are cached in minutes Normally this is set to 30 minutes but if you are paranoid you can set it to zero to disable password caching altogether Scheme keeps track of the use of each password and deletes its copy of the password when it has expired Additionally Scheme stores passwords in an obscured form to prevent them being seen during casual browsing through memory structures but this does not provide any protection against a deliberate attempt to find the password GNU Free Documentation License 22 GNU Free Documentation License Version 1 1 March 2000 Copyright 2000 Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed 0 PREAMBLE The purpose of this License is to make a manual textbook or other written document free in the sense of freedom to assure everyone the effective freedom to copy an
26. is that many lines high Alternatively if it is a real number between 0 and 1 exclusive the height of the summary window is computed by multiplying the number of lines in the message window by imail summary height and rounding to the nearest integer If the variable imail summary fixed layout is set to t then an IMAIL message buffer and its associated summary buffer are always shown in a fixed window layout provided the summary buffer exists Selecting either buffer causes all other windows in the current editor frame to be deleted then splits the frame into two windows showing the summary buffer and message buffer Selecting any other buffer when this layout is displayed causes both windows to be deleted and the other buffer displayed in a single window filling the editor frame Basically this causes the message and summary buffers to be treated as a unit most of the time Currently the default for imail summary fixed layout is f but the feature has been very popular and the default may be changed to stt in a future release When fixed layout is not used the variable imail summary pop up message provides a different kind of window splitting for message and summary buffers If this is set to t the default then selecting a new message in the summary buffer causes the message buffer to be popped up in a new window if it isn t already visible If the variable imail summary highlight message is tt the message currently selected in the mess
27. l add flag 2 2 29 fac RR ps 14 imail Dury cea Piet Rota sae etus 20 imail continue cis SEELEN ls 16 imaxl copy folder 25 2m AA EE 11 imail create folder ua Ta AA rre ER imail delete backward 2 e RR 9 Amail delete folder arne HA ddr EDER 11 imail delete forward s Ic lx ER 9 imail disconnect pd 20 im il expunge 20 3269 hg Maeda wedges Lp di 9 i ail first megsag hed EDER E 8 imail first unseen message 8 AMADO NATA eii 16 imail get new mail he De DE be ss 10 imail inp t 2 22 52 bioeb ye I v IX ei 10 imail input from folder fi ima ALA id ER 14 imail laSt Message componer 8 ei rE A ee EN 16 imail mouse save mime entity 13 imail next flagged message 14 inail next message posed dee Rh e 8 imail next same subject eiss 8 30 imail next undeleted message 8 imaill o tp t iuchLer ened b Re neared ates ll imail previous flagged message 14 imail previous message sss 8 imail previous same subject 8 imail previous undeleted message 8 imail quit bos cee GR ra pP REDE eR ep bie 20 imail rename folder 22 ss ssssse 11 Mad a repl y s 5222 woes gon eae een es ue 15 mall TOO iii hu Ree res 16 imail save attachment sss 13 imail save folder c succ eed eed 20 imail save mime entity 13 imail 86 rCh ia ai
28. lt in flags seen Means the message has been selected implying that the user has seen it As signed to a message when it is selected by the user When you start IMAIL it initially shows the first message that lacks this flag deleted Means the message is deleted Assigned by deletion commands and removed by undeletion commands see Section 4 2 Deleting Messages page 8 filed Means the message has been copied to another folder Assigned by the message copying commands see Section 4 3 Multiple Folders page 9 answered Means you have mailed an answer to the message Assigned by the r command imail reply See Section 4 6 Sending Replies page 15 forwarded Means you have forwarded the message Assigned by the f command imail forward See Section 4 6 Sending Replies page 15 resent Means you have resent the message Assigned by the command C u f imail resend See Section 4 6 Sending Replies page 15 All other flags are assigned or removed only by the user and have no standard meaning 4 6 Sending Replies IMAIL has several commands that use Mail mode to send outgoing mail What this section documents are the special commands of IMAIL for entering Mail mode Note that the usual keys for sending mail Gem C x 4 m and C x 5 m are available in IMAIL mode and work just as they usually do m Send a message imail mail c Continue editing the already started outgoing message i
29. ly to or forward a message The c imail continue command resumes editing the mail buffer to finish editing an outgoing message you were already composing or to alter a message you have sent Chapter 4 Commands 17 4 7 Message Display IMAIL provides several variables and commands to give you control over how messages are formatted in the message buffer By default IMAIL automatically wraps long lines at the right margin It uses adaptive fil to do the wrapping which means that common prefixes such as gt and Chris gt will be automatically copied down with the wrapped line Generally this wrapping makes messages easier to read Specifically it is important for messages sent by clients that use soft line breaks because such clients expect the mail reader to wrap lines However if you d rather not have IMAIL do this for you you can disable wrapping by setting the variable imail auto wrap to ftf Another feature of IMAIL is that it filters message headers showing you only the most relevant ones There are two variables that control how this is done and a command that can override the filtering The variable imail kept headers contains a list of regular expressions that are matched against message header names the name is everything to the left of the colon e g From in From cph If imail kept headers is a non empty list then only the headers matching those regular expressions are shown Fur
30. mail continue Send a reply to the current IMAIL message imail reply f Forward the current message to other users mail forward C u f Resend the current message to other users imail resend The most common reason to send a message while in IMAIL is to reply to the message you are reading To do this type r imail reply This displays the mail buffer in another window much like C x 4 m but preinitializes the Subject To CC and In reply to header fields based on the message you are replying to The To field starts out as the address of the person who sent the message you received and the CC field starts out with all the other recipients of that message You can exclude certain recipients from being placed automatically in the CC using the variable imail dont reply to names Its value should be a regular expression as a Chapter 4 Commands 16 string any recipient that the regular expression matches is excluded from the CC field The default value matches your own name and any name starting with info the value of the variable inail default dont reply to names Those names are excluded because there is a convention of using them for large mailing lists to broadcast announcements To omit the CC field completely for a particular reply enter the reply command with a numeric argument C u ror 1 r By default the Subject field of a reply is initialized t
31. nd edit them with IMAIL You can move messages into them with explicit IMAIL commands One major difference between a file based mail reader like Rmail and an IMAP mail reader like IMAIL is that file based mail readers do not need to provide commands to manipulate mail files as opposed to mail messages This is because ordinary file system commands already provide the ability to copy delete and rename such files This isn t the case for IMAP mail readers Consequently IMAIL provides a basic set of commands for manipulating folders i URL Read the folder named URL and run IMAIL on it imail input g Get new mail for the current folder imail get new mail C u g URL Read the folder named URL and append all of its messages to the current folder imail input from folder o URL Copy the current message into the folder named URL imail output C URLI URL2 Copy the folder named URL1 to URL2 imail copy folder D URL Delete the folder named URL imail delete folder R URLI URL2 Rename the folder named URL1 to be URL2 imail rename folder URL Create a folder named URL imail create folder To run IMAIL on a folder other than your primary folder you may use the i imail input command in IMAIL This visits the folder in IMAIL mode You can use M x imail input even when not in IMAIL The g imail get new mail command gets new mail for the current IMAIL folder and if there is new mail moves to the first unseen me
32. nds to the server Chapter 4 Commands T 4 Commands IMAIL provides a rich set of commands for manipulating messages Like Rmail most of these commands are bound to letter keys The most important command is M x imail which is used to start IMAIL With no arguments M x imail reads the primary folder selects the first unseen message in the folder then selects the folder s buffer If the primary folder is an IMAP folder M x imail will connect to the server and check for new mail If M x imail is given a prefix argument it will prompt for the URL of a folder rather than reading the primary folder The IMAIL message buffer is put in IMAIL mode a special mode in which most letter commands are defined to have special meanings Where possible the letters chosen for these commands are the same as those for the corresponding Rmail commands The command keys specified in this chapter are for IMAIL mode unless otherwise specified 4 1 Navigation The most basic thing to do with a message is to read it The way to do this in IMAIL is to select the message The usual practice is to move sequentially through the folder since this is the order of receipt of messages When you enter IMAIL you are positioned at the first message that you have not yet seen that is the first one that has the unseen flag see Section 4 5 Flags page 14 Move forward to see the other new messages move backward to reexamine old messages n Move to the ne
33. nt with other documents released under this License under the terms defined in section 4 above for modified versions provided that you include in the combination all of the Invariant Sections of all of the original documents unmodified and list them all as Invariant Sections of your combined work in its license notice The combined work need only contain one copy of this License and multiple identical Invariant Sections may be replaced with a single copy If there are multiple Invariant Sections with the same name but different contents make the title of each such section unique by adding at the end of it in parentheses the name of the original author or publisher of that section if known or else a unique number Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work In the combination you must combine any sections entitled History in the various original documents forming one section entitled History likewise combine any sec tions entitled Acknowledgements and any sections entitled Dedications You must delete all sections entitled Endorsements 6 COLLECTIONS OF DOCUMENTS You may make a collection consisting of the Document and other documents released under this License and replace the individual copies of this License in the various documents with a single copy that is included in the collection provided that you follow the rules of
34. o another language A Secondary Section is a named appendix or a front matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document s overall subject or to related matters and contains nothing that could fall directly within that overall subject For example if the Document is in part a textbook of mathematics a Secondary Section may not explain any mathematics The relationship could be a matter of historical connection with the subject or with related matters or of legal commercial philosophical ethical or political position regarding them The Invariant Sections are certain Secondary Sections whose titles are designated as being those of Invariant Sections in the notice that says that the Document is released under this License GNU Free Documentation License 23 The Cover Texts are certain short passages of text that are listed as Front Cover Texts or Back Cover Texts in the notice that says that the Document is released under this License A ransparent copy of the Document means a machine readable copy represented in a format whose specification is available to the general public whose contents can be viewed and edited directly and straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely avail able drawing editor and that is suitable for input to text formatte
35. o longer need to keep a message you can delete it This flags it as ignorable and some IMAIL commands pretend it is no longer present but it still has its place in the IMAIL folder and still has its message number Expunging the IMAIL folder actually removes the deleted messages The remaining messages are renumbered consecutively Expunging is the only action that changes the message number of any message d Delete the current message and move to the next nondeleted message imail delete forward C d Delete the current message and move to the previous nondeleted message imail delete backward Chapter 4 Commands 9 u Undelete the current message or move back to a deleted message and undelete it imail undelete previous message Z Expunge the IMAIL folder imail expunge There are two IMAIL commands for deleting messages Both delete the current message and select another message d imail delete forward moves to the following message skipping messages already deleted while C d imail delete backward moves to the pre vious nondeleted message If there is no nondeleted message to move to in the specified direction the message that was just deleted remains current numeric argument to either command reverses the direction of motion after deletion To make all the deleted messages finally vanish from the IMAIL folder type x imail expunge Until you do this you can still undelete the deleted messages The undeletion
36. o the contents of the Subject field of the message being replied to However if the variable imail reply with re is set to stt then the reply subject will be prefixed with Ber Once the mail buffer has been initialized editing and sending the mail goes as usual You can edit the presupplied header fields if they are not right for you You can also use the commands of Mail mode including C c C y which yanks in the message that you are replying to You can switch to the IMAIL buffer select a different message there switch back and yank the new current message Another frequent reason to send mail in IMAIL is to forward the current message to other users f imail forward makes this easy by preinitializing the mail buffer with the current message as a MIME attachment and a subject designating a forwarded message All you have to do is fill in the recipients and send When you forward a message recipients get a message which is from you and which has the original message in its contents By default forwarded messages are sent as MIME attachments which allows MIME aware mail readers to recognize that the attachment is a mail message and to specially present it However this means that such forwarded messages appear more complex when viewed in mail readers that do not understand MIME IMAIL deliberately minimizes the amount of encoding overhead used for MIME forwarded messages but some people prefer not to use MIM
37. o the mail reading process which is reflected in the connection state of an IMAP folder An IMAP folder can be in one of two states online meaning that there is an established network connection between IMAIL and the IMAP server and offline when there is not IMAIL is at present a very simple IMAP mail reader it must be online to read and manipulate File URLs are defined in RFC 1738 Chapter 3 Concepts 6 mail messages Mail readers that have this property are said to operate in online mode Do not confuse the online state with online mode When we refer to online or offline in this document it always means the corresponding state When an IMAP folder is selected in an IMAIL buffer the modeline for that buffer shows either online or offline to indicate the folder s connection state Normally an IMAP folder goes online when it is first selected and stays online indefinitely until it is explicitly disconnected Commands that break the connection are explicitly pointed out in their descriptions below most other commands will force an IMAP folder into the online state if it is offline IMAP also supports two other modes of operation called offline mode and disconnected mode at present IMAIL can not operate in these alternate modes 6 Although IMAP servers are allowed to disconnect mail readers that are inactive for long periods of time IMAIL silently keeps the connection open by periodically transmitting comma
38. on of following the terms and conditions either of that specified version or of any later version that has been published not as a draft by the Free Software Foundation If the Document does not specify a version number of this License you may choose any version ever published not as a draft by the Free Software Foundation ADDENDUM How to use this License for your documents To use this License in a document you have written include a copy of the License in the document and put the following copyright and license notices just after the title page Copyright C year your name Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 1 or any later version published by the Free Software Foundation with the Invariant Sections being list their titles with the Front Cover Texts being list and with the Back Cover Texts being list A copy of the license is included in the section entitled GNU Free Documentation License If you have no Invariant Sections write with no Invariant Sections instead of saying which ones are invariant If you have no Front Cover Texts write no Front Cover Texts instead of Front Cover Texts being list likewise for Back Cover Texts If your document contains nontrivial examples of program code we recommend releasing these examples in parallel under your choice of free software license such as the GNU General P
39. on to any other customizations you put in this file you must include the following expression load option imail Next you must tell Edwin where to find your IMAP server by setting some variables the expression to do this must follow the call to load option Here is an example load option imail set variable imail default imap server imap foo org Note that this is syntactically similar to Scheme s set special form but that it modifies the value of an Edwin editor variable rather than a Scheme variable There are several other variables that control how IMAIL connects to the server See Section 4 3 Multiple Folders page 9 for a complete list By default IMAIL tries to connect to localhost using port 143 and to log in using the user name that you are logged in as This is the right default if you are using stunnel on the client After you are finished creating the init file you can either restart Edwin or you can load the file using M x load file At this point you are ready to run IMAIL To start IMAIL and read the mail in the inbox folder on your IMAP server type M x imail Here at MIT we connect to our server using stunnel http www stunnel org to provide end to end encryption This provides connection security without the need to integrate the encryption into the client or the server Chapter 3 Concepts 3 3 Concepts To use IMAIL effectively it is helpful to know the terminology and unders
40. ould be shown in line or whether they are attachments that should be shown only upon further user action IMAIL provides simple support for MIME messages MIME attachments are shown in the IMAIL buffer by special abbreviations You can write an attachment to a file Multipart MIME structures are recognized and displayed in a clean format that suppresses unneces sary clutter And MIME encodings such as quoted printable and base64 are automatically decoded prior to displaying the message or saving the attachment End user formatting of MIME messages is a complex process partly because these mes sages can be arbitrarily complex in their internal structure IMAIL provides several variables that give you some control over the formatting prcess Many MIME messages have multiple parts for example a message with an attachment normally contains at least two parts the message text and the attachment IMAIL separates the different parts of a MIME message with specially formatted lines There are several styles of separator lines available selected by changing the value of the variable imail mime boundary style The default value of simple means to use long lines of hyphen characters as the separator lines A value of sgml means use long lines of hyphens that are wrapped with lt and gt which makes them valid SGML comments A value of original means to use the original MIME boundaries which have certain useful syntactic properties but
41. per message to give you an overview of the mail in an IMAIL folder Each line shows the message number the sender the flags and the subject Almost all IMAIL commands are valid in the summary buffer also these apply to See the online help for the variable adaptive fill regexp for more information about adaptive fill Chapter 4 Commands 18 the message described by the current line of the summary Moving point in the summary buffer selects messages as you move to their summary lines A summary buffer applies to a single IMAIL folder only if you are editing multiple IMAIL folders each one can have its own summary buffer l he summary buffer name is made by appending summary to the IMAIL buffer s name Normally only one summary buffer is displayed at a time 4 8 1 Making Summaries Here are the commands to create a summary for the current IMAIL folder Once the IMAIL folder has a summary buffer changes in the IMAIL folder such as deleting or expunging messages and getting new mail automatically update the summary h C M h Summarize all messages imail summary 1 flags C M 1 flags Summarize messages that have one or more of the specified flags imail summary by flags C M r rcpts Summarize messages that have one or more of the specified recipients imail summary by recipients C M t topic Summarize messages that have a match for the specified regexp topic in their subjects imail summary by topic C M
42. played as an attachment Attachments are normally shown as specially formatted abbreviations Here is an example Chapter 4 Commands 13 lt imail part name foo doc type application msword length 55499 This shows various things about the attachment including its optional name its MIME type and the length of the attachment in bytes The length is computed on the encoded form of the attachment and is generally slightly larger than the decoded length IMAIL uses somewhat more complicated rules for deciding when a MIME entity is displayed in this abbreviated format and when it is expanded in line In general all non text entities are abbreviated Additionally if a text entity is given a MIME disposition of attachment if the character set of the entity is unknown if the encoding type is unknown or if the subtype is unknown it is abbreviated Two variables control the abbreviation of text entities imail known mime charsets is a list of regular expressions that specify the known character sets by default it specifies US ASCII the ISO 8859 character sets and some random but commonly seen Microsoft Windows character sets The variable imail inline mime text subtypes contains a list of symbols each of which is the name of a text subtype that should be shown in line For example if the symbol htm1 is in this list then MIME parts of type text html are shown in line Text subtypes not appearing in this list are abbrev
43. rom a folder and moved or copied from one folder to another In IMAIL the concept of the folder is used to embrace different grouping mechanisms This is because IMAIL provides a uniform means for accessing different kinds of email sys tems In particular IMAIL supports access to Emacs Rmail files also known as BABYL files for historical reasons to unix mailbox files sometimes called mbox files and to IMAP mailboxes Each of these grouping mechanisms although implemented very differently is viewed as a folder by IMAIL With some exceptions each of these different types of folder are treated exactly the same by IMAIL Finally because IMAIL is extensible other types of folders may be supported in the future 3 3 URLs In email software like Rmail where mail is stored in files filenames are used to refer to groups of messages Since IMAIL folders often aren t files it is necessary to use a more Chapter 3 Concepts 4 general kind of reference for folders To this end IMAIL uses Uniform Resource Locators URLs to refer to folders IMAIL currently supports two kinds of URLs IMAP URLs and file URLS 3 3 1 IMAP URLs The first kind of URL is an IMAP URL which looks like this imap unameQhostname port mailbox In this syntax the parts unameQ and port are optional Hostname is the internet host name or IP address of the IMAP server Uname is the user name that identifies the account to be accessed on the se
44. rs or for automatic translation to a variety of formats suitable for input to text formatters copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent A copy that is not Transparent is called Opaque Examples of suitable formats for Transparent copies include plain ASCII without markup Texinfo input format LaTeX input format SGML or XML using a publicly available DTD and standard conforming simple HTML designed for human modifica tion Opaque formats include PostScript PDF proprietary formats that can be read and edited only by proprietary word processors SGML or XML for which the DTD and or processing tools are not generally available and the machine generated HTML produced by some word processors for output purposes only The Title Page means for a printed book the title page itself plus such following pages as are needed to hold legibly the material this License requires to appear in the title page For works in formats which do not have any title page as such Title Page means the text near the most prominent appearance of the work s title preceding the beginning of the body of the text 2 VERBATIM COPYING You may copy and distribute the Document in any medium either commercially or noncommercially provided that this License the copyright notices and the license notice saying this License appli
45. rver this defaults to your user name Port is the server s IP port this defaults to 143 and is normally not specified Mailbox specifies the IMAP mailbox or folder in IMAIL s terminology that is being referred to Since most IMAP servers support hierarchical mailboxes mailbox is a structured component indicating the location of the folder in the hierarchy much like filenames or HTTP URLs Here are some examples of IMAP URLs showing different mailbox paths imap localhost inbox imap localhost inbox sysadmin imap localhost inbox sysadmin equipment Here you see several interesting properties of IMAP mailboxes The first URL refers to the primary IMAP mailbox for this account called the inbox All IMAP servers must support this mailbox which is always called inbox the name is not case sensitive and may be typed in any combination of upper or lower case letters However case sensitivity for names other than inbox is undefined by IMAP so IMAIL treats all other names as if they were case sensitive The second and third URLs show how hierarchically nested mailboxes are referred to by writing the components of the path separated by slashes Note that IMAP does not re quire particular path separator characters for hierarchical names and in fact different IMAP servers use different separators However IMAIL always uses the forward slash character as a separator and translates to the server s character as needed Anoth
46. s regexp Summarize messages that have a match for the specified regexp anywhere in their header imail summary by regexp The h or C M h imail summary command fills the summary buffer for the current IMAIL folder with a summary of all the messages in the folder It then displays and selects the summary buffer in another window C M 1 flags imail summary by flags makes a partial summary mentioning only the messages that have one or more of the flags flags flags should contain flag names separated by commas C M r rcpts imail summary by recipients makes a partial summary mention ing only the messages that have one or more of the recipients rcpts rcpts should contain mailing addresses separated by commas C M t topic imail summary by topic makes a partial summary mentioning only the messages whose subjects have a match for the regular expression topic C M s regexp imail summary by regexp makes a partial summary mentioning only the messages whose headers contain a match for the regular expression regexp This match includes all lines in the header including for example the date and from lines Chapter 4 Commands 19 Note that there is only one summary buffer for any IMAIL folder making one kind of summary discards any previously made summary There are several variables that affect how summaries are displayed imail summary height controls the height of the summary window If it is an exact positive integer the summary window
47. s special permission from their copyright holders but you may GNU Free Documentation License 27 include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections You may include a translation of this License provided that you also include the original English version of this License In case of a disagreement between the translation and the original English version of this License the original English version will prevail 9 TERMINATION You may not copy modify sublicense or distribute the Document except as expressly provided for under this License Any other attempt to copy modify sublicense or distribute the Document is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Documentation License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns See http www gnu org copyleft Each version of the License is given a distinguishing version number If the Document specifies that a particular numbered version of this License or any later version applies to it you have the opti
48. ssage This command works only on While Emacs Rmail additionally supports the ability to retrieve mail from system inboxes on your local computer usually var spool mail USER on unix systems IMAIL does not IMAIL only supports incoming mail when it is delivered to an IMAP server This Rmail feature can easily be implemented if desired but there has been no call for it We plan to implement a Dired like folder browser in the future Chapter 4 Commands 11 IMAP folders it does nothing on file based folders Normally this command isn t needed since IMAIL periodically checks for new mail in all IMAP folders but it is occasionally useful to force IMAIL to get new mail immediately rather than waiting for the next periodic mail check The command M x imail has the same effect as imail get new mail if the primary folder is already open in a buffer IMAIL normally checks for new mail in IMAP folders according to the value of the variable imail update interval This variable specifies the time between checks in seconds It may also be set to SE which disables automatic mail checking When IMAIL detects new mail in the primary folder it normally modifies the mode line of all buffers to contain the string New Mail This can be disabled by setting the variable imail global mail notification to ftf To copy messages from another folder into the current folder give the g key a numeric argument as in C u g This runs the comm
49. t Mail Extensions 1 3 12 O OMS mode locu a Whee eee e 5 offline States erede Se AER SE dus 5 online m de e dsc eee eras ei ee ee e IS A 5 onlifi Stabe x cessi eed eens RIDE ER Ped 5 P primary Folder elt Ee a Ae EES Se 9 primary IMAP mailbox 222 4 R reply to a message llle eere 15 RECI dee dee ts qoae exta E 9 RECO 2045 eor ret ade a RES 1 3 12 REC 2060 tacite dm tetas haces 1 REG 2095 eiue dai ta 2 RE GC 2390 uit RERERLEZG Pe eR EE RE ERE 3 REC 8215 oco dnd LERRA HEAR MUT ANLE As 3 REG 822 EE EE EE da 3 A E EE dade pem A 1 Rmail fil cui ce pa Re RR VILI eR 3 S searching in IMATL rimi Tris 8 SMEP risa aactor ne Peer dieu a 3 T Type Ob folder eei nr rh 2 Concept Index U undeletion Uniform Resource Locator 33 Table of Contents 1 lIntroduciOoni i2 99 2i0e00e 88 2d5s02 003 1 2 Getting Started o on he ror ca 2 3 e 200 been ral a ida a 3 Did MESSE SES cri de rt A a i p rn e bd 3 3 2 holders ue E me iia 3 SE DN EE 3 asd IMAP URES 523 1153333 dee dida hats 4 2 9 2 Pie URLS cocidas A ea Rer edes 4 3 4 Server Connections o 2252 obese eap diia 5 4 Commands 2499202 cone ete FECE ERE XT XS T ADV Navigation ee ttt put ee d 4 2 Deleting Messages ene 8 4 3 Multiple Folders esi ers dl ia et kate ol eed a 9 4 4 MIME Support 12 45 Ela ii te p PSU RUE COPI e ad 14 4 6 Sending Replies gege edad a RR Dn dne ARR 15 4 7 Messa
50. tand the con cepts underlying IMAIL s design Here we will introduce you to messages folders URLs and server connections 3 1 Messages A message or email message is the basic unit of electronic mail The format of a message is defined by RFC 822 Nearly all email messages are transmitted over the internet which means that the contents of such messages are further constrained by the SMTP protocol that is used for internet message transmission as defined in RFC 821 In brief the primary constraints on an email message is that it may contain only printable US ASCII characters and that lines of text in the message may not exceed 1000 characters including the carriage return linefeed pair at the end of each line These constraints are fairly strict and do not permit messages to contain text in languages other than English or to contain non textual data such as images The Multipurpose Internet Mail Extensions MIME RFC 2045 provide a way to encode other kinds of text and data so that they can be carried in an email message Most modern email software supports the MIME standard one notable exception is Emacs Rmail 3 2 Folders Another important concept is a means for grouping messages together All email software provides some means for doing this and IMAIL is no exception IMAIL provides objects called folders A folder is just a container that holds an arbitrary number of email messages Messages can be added to a folder deleted f
51. thermore the shown headers will be in the same order as the regular expressions If imail kept headers is an empty list then all of the message headers are shown ex cept those matching the regular expression that is the value of the variable imail ignored headers By default the value of imail ignored headers contains some common unin teresting header names this expression is identical to the default used by Rmail Note that imail ignored headers is a single regular expression while imail kept headers is a list of regular expressions This is because imail ignored headers is meant to be an exact analog of the Rmail variable rmail ignored headers Regardless of how the message header filtering is done you can toggle between view ing the filtered headers and the unfiltered headers using the t command imail toggle header If filtered headers are shown this command replaces them with unfiltered headers and vice versa As you can see IMAIL performs extensive transformation of a mail message before pre senting it to you MIME formatting line wrapping and header filtering Sometimes it s desirable to see the original message exactly as it was received without any formatting at all The command C c C t toggles the entire message between a formatted view and a raw view This should be used with care as a message with a large attachment might not fit in memory in its raw form 4 8 Summaries A summary is a buffer containing one line
52. this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individu ally under this License provided you insert a copy of this License into the extracted document and follow this License in all other respects regarding verbatim copying of that document 7 AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other separate and independent documents or works in or on a volume of a storage or distribution medium does not as a whole count as a Modified Version of the Document provided no compilation copyright is claimed for the compilation Such a compilation is called an aggregate and this License does not apply to the other self contained works thus compiled with the Document on account of their being thus compiled if they are not themselves derivative works of the Document If the Cover Text requirement of section 3 is applicable to these copies of the Document then if the Document is less than one quarter of the entire aggregate the Document s Cover Texts may be placed on covers that surround only the Document within the aggregate Otherwise they must appear on covers around the whole aggregate 8 TRANSLATION Iranslation is considered a kind of modification so you may distribute translations of the Document under the terms of section 4 Replacing Invariant Sections with translations require
53. u intend to undelete You can also select a particular deleted message with the M p command then type u to undelete it A deleted message has the deleted flag and as a result deleted appears in the mode line when the current message is deleted In fact deleting or undeleting a message is nothing more than adding or removing this flag See Section 4 5 Flags page 14 4 3 Multiple Folders IMAIL operates by default on your primary folder which is the folder named inbox on your IMAP server Your incoming mail is placed in that folder by your system s mail delivery software Whenever it has an open connection to the server IMAIL notices new mail and brings it to your attention by modifying the Edwin mode line You can specify a different folder to be your primary folder by modifying one or more of IMAIL s variables The simplest way to do this is to change the variable imail primary Chapter 4 Commands 10 folder to contain the URL of the folder that you wish to be your primary folder Normally imail primary folder is 4f in which case the primary folder has the form imap user idOserver mailbox where user id is the value of the variable imail default user id server is the value of imail default imap server and mailbox is the value of imail default imap mailbox imail default user id may be f meaning to use the value of current user name In addition to the primary folder you can also have other folders a
54. ublic License to permit their use in free software Key Index Key Index E cs betes ce er gist Suet ep AG te tein PE LP EM E 11 gt it Hath ote Gaede de Ne eae ted Hee 8 lt EE 8 A EE 14 B balcesieker ere A at sip uie Beige ed dei 20 CA LE CIE use tara dud O UE I e ec 16 Qu ilu esee Se A a oe ee qus 11 e ERG REG Eu rae DEGREES bes dan 8 Ve pig dhe AT P Dp RIS ARR E E Res eet s 8 Octo vu REFS tee Tadd PEE 17 Ud asse du salido dE Ra dab ab wane ae Porque Re de 9 A 18 A TTC 14 CAM p E a Natale expri ed ease detta 14 CGM E dard aree an ias 18 IR 18 OS VA ni desee pp ipao iR dq EE 18 Or ied C brat ni pta dran UP Gre gate Erb OR URINE 13 le EE 14 crib EEN 16 e EE 11 D decide PEEL KE 9 D dnt Shed ote BESS Babee Lois Lee e i E 28 F a E Re yk Gite boty ate ta werk DU LIU DL ii ee oe 16 G Prat ceded da dede ee SE 10 H Ti s Pens duse tes irte it ers dabas detur ated cetera dt aus 18 I DEET 10 J Vi ASTA E S a aE Saag dina ond ihid dup ndr ied gt 8 K EE 14 L v Ud e de 18 M Illa esee prier ii EE 16 Mere re ERR Ge eae 20 MED adie SE PIER rd ob a deals hie ated ek Ra 8 MP ab ei 8 MA e zug Vd rre iae Wd dere REG 8 Moe auda per rusa re NECK ROPA I FUR es acd e ae 8 N pM C ME 8 O rM rr El Key Index 29 T MIDI EHE Er U loot dr pe Bae he ita AA A Ip S NIME E 9 W ER 13 X Em 9 Command Index Command Index I A TCAE cee SES SE SE de Aun quark diens 7 AXmax
55. uffer using and DEL Chapter 4 Commands 20 The IMAIL commands to move between messages also work in the summary buffer but with a twist they move through the set of messages included in the summary They also ensure the IMAIL buffer appears on the screen unlike cursor motion commands which update the contents of the IMAIL buffer but don t display it in a window unless it already appears You can always display the message indicated by point using the command imail summary select message When you are finished using the summary type C x k to delete the summary buffer s window 4 9 Other Commands This section documents a handful of commands and variables that don t fit into any of the other documentation categories q Quit out of IMAIL imail quit This closes all open IMAP connections and buries all IMAIL buffers With prefix argument only affects the current IMAIL buffer leaving any other IMAIL buffers alone M d Disconnect from the IMAP server imail disconnect Bury the IMAIL buffer mail bury S Save changes in the current folder to disk imail save folder When you are finished reading mail in a folder use the q command imail quit This command closes the folder then buries the buffer Closing a folder has different effects depending on the type of folder Closing an IMAP folder causes IMAIL to disconnect from the IMAP server go offline Closing a file folder saves any changes out to the corresponding
56. xt nondeleted message skipping any intervening deleted mes sages imail next undeleted message p Move to the previous nondeleted message imail previous undeleted message M n Move to the next message including deleted messages imail next message M p Move to the previous message including deleted messages imail previous message j Move to the first message With argument n move to message number n imail select message gt Move to the last message imail last message lt Move to the first message imail first message M u Move to the first unseen message imail first unseen message M s string RET Move to the next message containing a match for string imail search M M s string Move to the previous message containing a match for string C c C n Move to the next message with the same subject imail next same subject Chapter 4 Commands 8 C c C p Move to the previous message with the same subject imail previous same subject n and p are the usual way of moving among messages in IMAIL They move through the messages sequentially but skip over deleted messages which is usually what you want to do Their command definitions are named imail next undeleted message and imail previous undeleted message If you do not want to skip deleted messages for example if you want to move to a message to undelete it use the variants M n and M p imail next message and imail previous message A numeric
Download Pdf Manuals
Related Search