@end tex
-@node Top
+@node Top, Starting Up, (dir), (dir)
@top The Gnus Newsreader
@ifinfo
@end iftex
@menu
-* Starting Up:: Finding news can be a pain.
-* Group Buffer:: Selecting, subscribing and killing groups.
-* Summary Buffer:: Reading, saving and posting articles.
-* Article Buffer:: Displaying and handling articles.
-* Composing Messages:: Information on sending mail and news.
-* Select Methods:: Gnus reads all messages from various select methods.
-* Scoring:: Assigning values to articles.
-* Various:: General purpose settings.
-* The End:: Farewell and goodbye.
-* Appendices:: Terminology, Emacs intro, FAQ, History, Internals.
-* Index:: Variable, function and concept index.
-* Key Index:: Key Index.
+* Starting Up:: Finding news can be a pain.
+* Group Buffer:: Selecting, subscribing and killing groups.
+* Summary Buffer:: Reading, saving and posting articles.
+* Article Buffer:: Displaying and handling articles.
+* Composing Messages:: Information on sending mail and news.
+* Select Methods:: Gnus reads all messages from various select methods.
+* Scoring:: Assigning values to articles.
+* Various:: General purpose settings.
+* The End:: Farewell and goodbye.
+* Appendices:: Terminology, Emacs intro, FAQ, History, Internals.
+* Index:: Variable, function and concept index.
+* Key Index:: Key Index.
@detailmenu
--- The Detailed Node Listing ---
Starting Gnus
-* Finding the News:: Choosing a method for getting news.
-* The First Time:: What does Gnus do the first time you start it?
-* The Server is Down:: How can I read my mail then?
-* Slave Gnusae:: You can have more than one Gnus active at a time.
-* Fetching a Group:: Starting Gnus just to read a group.
-* New Groups:: What is Gnus supposed to do with new groups?
-* Startup Files:: Those pesky startup files---@file{.newsrc}.
-* Auto Save:: Recovering from a crash.
-* The Active File:: Reading the active file over a slow line Takes Time.
-* Changing Servers:: You may want to move from one server to another.
-* Startup Variables:: Other variables you might change.
+* Finding the News:: Choosing a method for getting news.
+* The First Time:: What does Gnus do the first time you start it?
+* The Server is Down:: How can I read my mail then?
+* Slave Gnusae:: You can have more than one Gnus active at a time.
+* Fetching a Group:: Starting Gnus just to read a group.
+* New Groups:: What is Gnus supposed to do with new groups?
+* Changing Servers:: You may want to move from one server to another.
+* Startup Files:: Those pesky startup files---@file{.newsrc}.
+* Auto Save:: Recovering from a crash.
+* The Active File:: Reading the active file over a slow line Takes Time.
+* Startup Variables:: Other variables you might change.
New Groups
-* Checking New Groups:: Determining what groups are new.
-* Subscription Methods:: What Gnus should do with new groups.
-* Filtering New Groups:: Making Gnus ignore certain new groups.
+* Checking New Groups:: Determining what groups are new.
+* Subscription Methods:: What Gnus should do with new groups.
+* Filtering New Groups:: Making Gnus ignore certain new groups.
Group Buffer
-* Group Buffer Format:: Information listed and how you can change it.
-* Group Maneuvering:: Commands for moving in the group buffer.
-* Selecting a Group:: Actually reading news.
-* Group Data:: Changing the info for a group.
-* Subscription Commands:: Unsubscribing, killing, subscribing.
-* Group Levels:: Levels? What are those, then?
-* Group Score:: A mechanism for finding out what groups you like.
-* Marking Groups:: You can mark groups for later processing.
-* Foreign Groups:: Creating and editing groups.
-* Group Parameters:: Each group may have different parameters set.
-* Listing Groups:: Gnus can list various subsets of the groups.
-* Sorting Groups:: Re-arrange the group order.
-* Group Maintenance:: Maintaining a tidy @file{.newsrc} file.
-* Browse Foreign Server:: You can browse a server. See what it has to offer.
-* Exiting Gnus:: Stop reading news and get some work done.
-* Group Topics:: A folding group mode divided into topics.
-* Misc Group Stuff:: Other stuff that you can to do.
+* Group Buffer Format:: Information listed and how you can change it.
+* Group Maneuvering:: Commands for moving in the group buffer.
+* Selecting a Group:: Actually reading news.
+* Subscription Commands:: Unsubscribing, killing, subscribing.
+* Group Data:: Changing the info for a group.
+* Group Levels:: Levels? What are those, then?
+* Group Score:: A mechanism for finding out what groups you like.
+* Marking Groups:: You can mark groups for later processing.
+* Foreign Groups:: Creating and editing groups.
+* Group Parameters:: Each group may have different parameters set.
+* Listing Groups:: Gnus can list various subsets of the groups.
+* Sorting Groups:: Re-arrange the group order.
+* Group Maintenance:: Maintaining a tidy @file{.newsrc} file.
+* Browse Foreign Server:: You can browse a server. See what it has to offer.
+* Exiting Gnus:: Stop reading news and get some work done.
+* Group Topics:: A folding group mode divided into topics.
+* Misc Group Stuff:: Other stuff that you can to do.
Group Buffer Format
-* Group Line Specification:: Deciding how the group buffer is to look.
-* Group Modeline Specification:: The group buffer modeline.
-* Group Highlighting:: Having nice colors in the group buffer.
+* Group Line Specification:: Deciding how the group buffer is to look.
+* Group Modeline Specification:: The group buffer modeline.
+* Group Highlighting:: Having nice colors in the group buffer.
Group Topics
-* Topic Variables:: How to customize the topics the Lisp Way.
-* Topic Commands:: Interactive E-Z commands.
-* Topic Sorting:: Sorting each topic individually.
-* Topic Topology:: A map of the world.
-* Topic Parameters:: Parameters that apply to all groups in a topic.
+* Topic Variables:: How to customize the topics the Lisp Way.
+* Topic Commands:: Interactive E-Z commands.
+* Topic Sorting:: Sorting each topic individually.
+* Topic Topology:: A map of the world.
+* Topic Parameters:: Parameters that apply to all groups in a topic.
Misc Group Stuff
-* Scanning New Messages:: Asking Gnus to see whether new messages have arrived.
-* Group Information:: Information and help on groups and Gnus.
-* Group Timestamp:: Making Gnus keep track of when you last read a group.
-* File Commands:: Reading and writing the Gnus files.
+* Scanning New Messages:: Asking Gnus to see whether new messages have arrived.
+* Group Information:: Information and help on groups and Gnus.
+* Group Timestamp:: Making Gnus keep track of when you last read a group.
+* File Commands:: Reading and writing the Gnus files.
Summary Buffer
* Choosing Articles:: Reading articles.
* Paging the Article:: Scrolling the current article.
* Reply Followup and Post:: Posting articles.
+* Delayed Articles::
* Marking Articles:: Marking articles as read, expirable, etc.
* Limiting:: You can limit the summary buffer.
* Threading:: How threads are made.
* Tree Display:: A more visual display of threads.
* Mail Group Commands:: Some commands can only be used in mail groups.
* Various Summary Stuff:: What didn't fit anywhere else.
-* Exiting the Summary Buffer:: Returning to the Group buffer.
+* Exiting the Summary Buffer:: Returning to the Group buffer,
+ or reselecting the current group.
* Crosspost Handling:: How crossposted articles are dealt with.
* Duplicate Suppression:: An alternative when crosspost handling fails.
* Security:: Decrypt and Verify.
Summary Buffer Format
-* Summary Buffer Lines:: You can specify how summary lines should look.
-* To From Newsgroups:: How to not display your own name.
-* Summary Buffer Mode Line:: You can say how the mode line should look.
-* Summary Highlighting:: Making the summary buffer all pretty and nice.
+* Summary Buffer Lines:: You can specify how summary lines should look.
+* To From Newsgroups:: How to not display your own name.
+* Summary Buffer Mode Line:: You can say how the mode line should look.
+* Summary Highlighting:: Making the summary buffer all pretty and nice.
Choosing Articles
-* Choosing Commands:: Commands for choosing articles.
-* Choosing Variables:: Variables that influence these commands.
+* Choosing Commands:: Commands for choosing articles.
+* Choosing Variables:: Variables that influence these commands.
Reply, Followup and Post
-* Summary Mail Commands:: Sending mail.
-* Summary Post Commands:: Sending news.
-* Summary Message Commands:: Other Message-related commands.
-* Canceling and Superseding:: ``Whoops, I shouldn't have called him that.''
+* Summary Mail Commands:: Sending mail.
+* Summary Post Commands:: Sending news.
+* Summary Message Commands:: Other Message-related commands.
+* Canceling and Superseding::
Marking Articles
-* Unread Articles:: Marks for unread articles.
-* Read Articles:: Marks for read articles.
-* Other Marks:: Marks that do not affect readedness.
-* Setting Marks:: How to set and remove marks.
-* Generic Marking Commands:: How to customize the marking.
-* Setting Process Marks:: How to mark articles for later processing.
+* Unread Articles:: Marks for unread articles.
+* Read Articles:: Marks for read articles.
+* Other Marks:: Marks that do not affect readedness.
+* Setting Marks::
+* Generic Marking Commands::
+* Setting Process Marks::
+
+Marking Articles
+
+* Setting Marks:: How to set and remove marks.
+* Generic Marking Commands:: How to customize the marking.
+* Setting Process Marks:: How to mark articles for later processing.
Threading
-* Customizing Threading:: Variables you can change to affect the threading.
-* Thread Commands:: Thread based commands in the summary buffer.
+* Customizing Threading:: Variables you can change to affect the threading.
+* Thread Commands:: Thread based commands in the summary buffer.
Customizing Threading
-* Loose Threads:: How Gnus gathers loose threads into bigger threads.
-* Filling In Threads:: Making the threads displayed look fuller.
-* More Threading:: Even more variables for fiddling with threads.
-* Low-Level Threading:: You thought it was over... but you were wrong!
+* Loose Threads:: How Gnus gathers loose threads into bigger threads.
+* Filling In Threads:: Making the threads displayed look fuller.
+* More Threading:: Even more variables for fiddling with threads.
+* Low-Level Threading:: You thought it was over... but you were wrong!
Decoding Articles
-* Uuencoded Articles:: Uudecode articles.
-* Shell Archives:: Unshar articles.
-* PostScript Files:: Split PostScript.
-* Other Files:: Plain save and binhex.
-* Decoding Variables:: Variables for a happy decoding.
-* Viewing Files:: You want to look at the result of the decoding?
+* Uuencoded Articles:: Uudecode articles.
+* Shell Archives:: Unshar articles.
+* PostScript Files:: Split PostScript.
+* Other Files:: Plain save and binhex.
+* Decoding Variables:: Variables for a happy decoding.
+* Viewing Files:: You want to look at the result of the decoding?
Decoding Variables
-* Rule Variables:: Variables that say how a file is to be viewed.
-* Other Decode Variables:: Other decode variables.
-* Uuencoding and Posting:: Variables for customizing uuencoding.
+* Rule Variables:: Variables that say how a file is to be viewed.
+* Other Decode Variables:: Other decode variables.
+* Uuencoding and Posting:: Variables for customizing uuencoding.
Article Treatment
-* Article Highlighting:: You want to make the article look like fruit salad.
-* Article Fontisizing:: Making emphasized text look nice.
-* Article Hiding:: You also want to make certain info go away.
-* Article Washing:: Lots of way-neat functions to make life better.
-* Article Buttons:: Click on URLs, Message-IDs, addresses and the like.
-* Article Date:: Grumble, UT!
-* Article Signature:: What is a signature?
-* Article Miscellania:: Various other stuff.
+* Article Highlighting:: You want to make the article look like fruit salad.
+* Article Fontisizing:: Making emphasized text look nice.
+* Article Hiding:: You also want to make certain info go away.
+* Article Washing:: Lots of way-neat functions to make life better.
+* Article Buttons:: Click on URLs, Message-IDs, addresses and the like.
+* Article Date:: Grumble, UT!
+* Article Signature:: What is a signature?
+* Article Miscellania:: Various other stuff.
Alternative Approaches
Various Summary Stuff
-* Summary Group Information:: Information oriented commands.
-* Searching for Articles:: Multiple article commands.
-* Summary Generation Commands:: (Re)generating the summary buffer.
-* Really Various Summary Commands:: Those pesky non-conformant commands.
+* Summary Group Information:: Information oriented commands.
+* Searching for Articles:: Multiple article commands.
+* Summary Generation Commands::
+* Really Various Summary Commands:: Those pesky non-conformant commands.
Article Buffer
-* Hiding Headers:: Deciding what headers should be displayed.
-* Using MIME:: Pushing articles through @sc{mime} before reading them.
-* Customizing Articles:: Tailoring the look of the articles.
-* Article Keymap:: Keystrokes available in the article buffer.
-* Misc Article:: Other stuff.
+* Hiding Headers:: Deciding what headers should be displayed.
+* Using MIME:: Pushing articles through @sc{mime} before reading them.
+* Customizing Articles:: Tailoring the look of the articles.
+* Article Keymap:: Keystrokes available in the article buffer.
+* Misc Article:: Other stuff.
Composing Messages
-* Mail:: Mailing and replying.
-* Posting Server:: What server should you post via?
-* Mail and Post:: Mailing and posting at the same time.
-* Archived Messages:: Where Gnus stores the messages you've sent.
-* Posting Styles:: An easier way to specify who you are.
-* Drafts:: Postponing messages and rejected messages.
-* Rejected Articles:: What happens if the server doesn't like your article?
-* Using GPG:: How to use GPG and MML to sign and encrypt messages
+* Mail:: Mailing and replying.
+* Posting Server:: What server should you post via?
+* Mail and Post:: Mailing and posting at the same time.
+* Archived Messages:: Where Gnus stores the messages you've sent.
+* Posting Styles:: An easier way to specify who you are.
+* Drafts:: Postponing messages and rejected messages.
+* Rejected Articles:: What happens if the server doesn't like your article?
+* Using GPG:: How to use GPG and MML to sign and encrypt messages
Select Methods
-* Server Buffer:: Making and editing virtual servers.
-* Getting News:: Reading USENET news with Gnus.
-* Getting Mail:: Reading your personal mail with Gnus.
-* Browsing the Web:: Getting messages from a plethora of Web sources.
-* Other Sources:: Reading directories, files, SOUP packets.
-* Combined Groups:: Combining groups into one group.
-* Gnus Unplugged:: Reading news and mail offline.
+* Server Buffer:: Making and editing virtual servers.
+* Getting News:: Reading USENET news with Gnus.
+* Getting Mail:: Reading your personal mail with Gnus.
+* Browsing the Web:: Getting messages from a plethora of Web sources.
+* Other Sources:: Reading directories, files, SOUP packets.
+* Combined Groups:: Combining groups into one group.
+* Gnus Unplugged:: Reading news and mail offline.
Server Buffer
-* Server Buffer Format:: You can customize the look of this buffer.
-* Server Commands:: Commands to manipulate servers.
-* Example Methods:: Examples server specifications.
-* Creating a Virtual Server:: An example session.
-* Server Variables:: Which variables to set.
-* Servers and Methods:: You can use server names as select methods.
-* Unavailable Servers:: Some servers you try to contact may be down.
+* Server Buffer Format:: You can customize the look of this buffer.
+* Server Commands:: Commands to manipulate servers.
+* Example Methods:: Examples server specifications.
+* Creating a Virtual Server:: An example session.
+* Server Variables:: Which variables to set.
+* Servers and Methods:: You can use server names as select methods.
+* Unavailable Servers:: Some servers you try to contact may be down.
Getting News
-* NNTP:: Reading news from an @sc{nntp} server.
-* News Spool:: Reading news from the local spool.
+* NNTP:: Reading news from an @sc{nntp} server.
+* News Spool:: Reading news from the local spool.
+
+@sc{nntp}
+
+* Direct Functions:: Connecting directly to the server.
+* Indirect Functions:: Connecting indirectly to the server.
+* Common Variables:: Understood by several connection functions.
Getting Mail
-* Mail in a Newsreader:: Important introductory notes.
-* Getting Started Reading Mail:: A simple cookbook example.
-* Splitting Mail:: How to create mail groups.
-* Mail Sources:: How to tell Gnus where to get mail from.
-* Mail Backend Variables:: Variables for customizing mail handling.
-* Fancy Mail Splitting:: Gnus can do hairy splitting of incoming mail.
-* Group Mail Splitting:: Use group customize to drive mail splitting.
-* Incorporating Old Mail:: What about the old mail you have?
-* Expiring Mail:: Getting rid of unwanted mail.
-* Washing Mail:: Removing cruft from the mail you get.
-* Duplicates:: Dealing with duplicated mail.
-* Not Reading Mail:: Using mail backends for reading other files.
-* Choosing a Mail Backend:: Gnus can read a variety of mail formats.
+* Mail in a Newsreader:: Important introductory notes.
+* Getting Started Reading Mail:: A simple cookbook example.
+* Splitting Mail:: How to create mail groups.
+* Mail Sources:: How to tell Gnus where to get mail from.
+* Mail Backend Variables:: Variables for customizing mail handling.
+* Fancy Mail Splitting:: Gnus can do hairy splitting of incoming mail.
+* Group Mail Splitting:: Use group customize to drive mail splitting.
+* Incorporating Old Mail:: What about the old mail you have?
+* Expiring Mail:: Getting rid of unwanted mail.
+* Washing Mail:: Removing gruft from the mail you get.
+* Duplicates:: Dealing with duplicated mail.
+* Not Reading Mail:: Using mail backends for reading other files.
+* Choosing a Mail Backend:: Gnus can read a variety of mail formats.
Mail Sources
-* Mail Source Specifiers:: How to specify what a mail source is.
-* Mail Source Customization:: Some variables that influence things.
-* Fetching Mail:: Using the mail source specifiers.
+* Mail Source Specifiers:: How to specify what a mail source is.
+* Mail Source Customization:: Some variables that influence things.
+* Fetching Mail:: Using the mail source specifiers.
Choosing a Mail Backend
Browsing the Web
-* Web Searches:: Creating groups from articles that match a string.
-* Slashdot:: Reading the Slashdot comments.
-* Ultimate:: The Ultimate Bulletin Board systems.
-* Web Archive:: Reading mailing list archived on web.
-* RSS:: Reading RDF site summary.
-* Customizing w3:: Doing stuff to Emacs/w3 from Gnus.
+* Web Searches:: Creating groups from articles that match a string.
+* Slashdot:: Reading the Slashdot comments.
+* Ultimate:: The Ultimate Bulletin Board systems.
+* Web Archive:: Reading mailing list archived on web.
+* RSS:: Reading RDF site summary.
+* Customizing w3:: Doing stuff to Emacs/w3 from Gnus.
Other Sources
-* Directory Groups:: You can read a directory as if it was a newsgroup.
-* Anything Groups:: Dired? Who needs dired?
-* Document Groups:: Single files can be the basis of a group.
-* SOUP:: Reading @sc{soup} packets ``offline''.
-* Mail-To-News Gateways:: Posting articles via mail-to-news gateways.
-* IMAP:: Using Gnus as a @sc{imap} client.
+* Directory Groups:: You can read a directory as if it was a newsgroup.
+* Anything Groups:: Dired? Who needs dired?
+* Document Groups:: Single files can be the basis of a group.
+* SOUP:: Reading @sc{soup} packets ``offline''.
+* Mail-To-News Gateways:: Posting articles via mail-to-news gateways.
+* IMAP:: Using Gnus as a @sc{imap} client.
Document Groups
SOUP
-* SOUP Commands:: Commands for creating and sending @sc{soup} packets
-* SOUP Groups:: A backend for reading @sc{soup} packets.
-* SOUP Replies:: How to enable @code{nnsoup} to take over mail and news.
+* SOUP Commands:: Commands for creating and sending @sc{soup} packets
+* SOUP Groups:: A backend for reading @sc{soup} packets.
+* SOUP Replies:: How to enable @code{nnsoup} to take over mail and news.
@sc{imap}
-* Splitting in IMAP:: Splitting mail with nnimap.
-* Editing IMAP ACLs:: Limiting/enabling other users access to a mailbox.
-* Expunging mailboxes:: Equivalent of a "compress mailbox" button.
+* Splitting in IMAP:: Splitting mail with nnimap.
+* Editing IMAP ACLs:: Limiting/enabling other users access to a mailbox.
+* Expunging mailboxes:: Equivalent of a "compress mailbox" button.
Combined Groups
-* Virtual Groups:: Combining articles from many groups.
-* Kibozed Groups:: Looking through parts of the newsfeed for articles.
+* Virtual Groups:: Combining articles from many groups.
+* Kibozed Groups:: Looking through parts of the newsfeed for articles.
Gnus Unplugged
-* Agent Basics:: How it all is supposed to work.
-* Agent Categories:: How to tell the Gnus Agent what to download.
-* Agent Commands:: New commands for all the buffers.
-* Agent Expiry:: How to make old articles go away.
-* Agent and IMAP:: How to use the Agent with IMAP.
-* Outgoing Messages:: What happens when you post/mail something?
-* Agent Variables:: Customizing is fun.
-* Example Setup:: An example @file{.gnus.el} file for offline people.
-* Batching Agents:: How to fetch news from a @code{cron} job.
-* Agent Caveats:: What you think it'll do and what it does.
+* Agent Basics:: How it all is supposed to work.
+* Agent Categories:: How to tell the Gnus Agent what to download.
+* Agent Commands:: New commands for all the buffers.
+* Agent Expiry:: How to make old articles go away.
+* Agent and IMAP:: How to use the Agent with IMAP.
+* Outgoing Messages:: What happens when you post/mail something?
+* Agent Variables:: Customizing is fun.
+* Example Setup:: An example @file{.gnus.el} file for offline people.
+* Batching Agents:: How to fetch news from a @code{cron} job.
+* Agent Caveats:: What you think it'll do and what it does.
Agent Categories
-* Category Syntax:: What a category looks like.
-* Category Buffer:: A buffer for maintaining categories.
-* Category Variables:: Customize'r'Us.
+* Category Syntax:: What a category looks like.
+* Category Buffer:: A buffer for maintaining categories.
+* Category Variables:: Customize'r'Us.
Agent Commands
-* Group Agent Commands::
-* Summary Agent Commands::
-* Server Agent Commands::
+* Group Agent Commands::
+* Summary Agent Commands::
+* Server Agent Commands::
Scoring
-* Summary Score Commands:: Adding score entries for the current group.
-* Group Score Commands:: General score commands.
-* Score Variables:: Customize your scoring. (My, what terminology).
-* Score File Format:: What a score file may contain.
-* Score File Editing:: You can edit score files by hand as well.
-* Adaptive Scoring:: Big Sister Gnus knows what you read.
-* Home Score File:: How to say where new score entries are to go.
-* Followups To Yourself:: Having Gnus notice when people answer you.
-* Scoring Tips:: How to score effectively.
-* Reverse Scoring:: That problem child of old is not problem.
-* Global Score Files:: Earth-spanning, ear-splitting score files.
-* Kill Files:: They are still here, but they can be ignored.
-* Converting Kill Files:: Translating kill files to score files.
-* GroupLens:: Getting predictions on what you like to read.
-* Advanced Scoring:: Using logical expressions to build score rules.
-* Score Decays:: It can be useful to let scores wither away.
+* Summary Score Commands:: Adding score entries for the current group.
+* Group Score Commands:: General score commands.
+* Score Variables:: Customize your scoring. (My, what terminology).
+* Score File Format:: What a score file may contain.
+* Score File Editing:: You can edit score files by hand as well.
+* Adaptive Scoring:: Big Sister Gnus knows what you read.
+* Home Score File:: How to say where new score entries are to go.
+* Followups To Yourself:: Having Gnus notice when people answer you.
+* Scoring On Other Headers:: Scoring on non-standard headers.
+* Scoring Tips:: How to score effectively.
+* Reverse Scoring:: That problem child of old is not problem.
+* Global Score Files:: Earth-spanning, ear-splitting score files.
+* Kill Files:: They are still here, but they can be ignored.
+* Converting Kill Files:: Translating kill files to score files.
+* GroupLens:: Getting predictions on what you like to read.
+* Advanced Scoring:: Using logical expressions to build score rules.
+* Score Decays:: It can be useful to let scores wither away.
GroupLens
-* Using GroupLens:: How to make Gnus use GroupLens.
-* Rating Articles:: Letting GroupLens know how you rate articles.
-* Displaying Predictions:: Displaying predictions given by GroupLens.
-* GroupLens Variables:: Customizing GroupLens.
+* Using GroupLens:: How to make Gnus use GroupLens.
+* Rating Articles:: Letting GroupLens know how you rate articles.
+* Displaying Predictions:: Displaying predictions given by GroupLens.
+* GroupLens Variables:: Customizing GroupLens.
Advanced Scoring
Various
-* Process/Prefix:: A convention used by many treatment commands.
-* Interactive:: Making Gnus ask you many questions.
-* Symbolic Prefixes:: How to supply some Gnus functions with options.
-* Formatting Variables:: You can specify what buffers should look like.
-* Window Layout:: Configuring the Gnus buffer windows.
-* Faces and Fonts:: How to change how faces look.
-* Compilation:: How to speed Gnus up.
-* Mode Lines:: Displaying information in the mode lines.
-* Highlighting and Menus:: Making buffers look all nice and cozy.
-* Buttons:: Get tendinitis in ten easy steps!
-* Daemons:: Gnus can do things behind your back.
-* NoCeM:: How to avoid spam and other fatty foods.
-* Undo:: Some actions can be undone.
-* Moderation:: What to do if you're a moderator.
-* XEmacs Enhancements:: There are more pictures and stuff under XEmacs.
-* Fuzzy Matching:: What's the big fuzz?
-* Thwarting Email Spam:: A how-to on avoiding unsolicited commercial email.
-* Various Various:: Things that are really various.
+* Process/Prefix:: A convention used by many treatment commands.
+* Interactive:: Making Gnus ask you many questions.
+* Symbolic Prefixes:: How to supply some Gnus functions with options.
+* Formatting Variables:: You can specify what buffers should look like.
+* Window Layout:: Configuring the Gnus buffer windows.
+* Faces and Fonts:: How to change how faces look.
+* Compilation:: How to speed Gnus up.
+* Mode Lines:: Displaying information in the mode lines.
+* Highlighting and Menus:: Making buffers look all nice and cozy.
+* Buttons:: Get tendinitis in ten easy steps!
+* Daemons:: Gnus can do things behind your back.
+* NoCeM:: How to avoid spam and other fatty foods.
+* Undo:: Some actions can be undone.
+* Moderation:: What to do if you're a moderator.
+* XEmacs Enhancements:: There are more pictures and stuff under XEmacs.
+* Fuzzy Matching:: What's the big fuzz?
+* Thwarting Email Spam:: A how-to on avoiding unsolicited commercial email.
+* Various Various:: Things that are really various.
Formatting Variables
-* Formatting Basics:: A formatting variable is basically a format string.
-* Mode Line Formatting:: Some rules about mode line formatting variables.
-* Advanced Formatting:: Modifying output in various ways.
-* User-Defined Specs:: Having Gnus call your own functions.
-* Formatting Fonts:: Making the formatting look colorful and nice.
+* Formatting Basics:: A formatting variable is basically a format string.
+* Mode Line Formatting:: Some rules about mode line formatting variables.
+* Advanced Formatting:: Modifying output in various ways.
+* User-Defined Specs:: Having Gnus call your own functions.
+* Formatting Fonts:: Making the formatting look colorful and nice.
+* Positioning Point:: Moving point to a position after an operation.
+* Tabulation:: Tabulating your output.
+* Wide Characters:: Dealing with wide characters.
XEmacs Enhancements
-* Picons:: How to display pictures of what your reading.
-* Smileys:: Show all those happy faces the way they were meant to be shown.
-* Toolbar:: Click'n'drool.
-* XVarious:: Other XEmacsy Gnusey variables.
+* Picons:: How to display pictures of what your reading.
+* Smileys:: Show all those happy faces the way they were meant to be shown.
+* Toolbar:: Click'n'drool.
+* XVarious:: Other XEmacsy Gnusey variables.
Picons
-* Picon Basics:: What are picons and How do I get them.
-* Picon Requirements:: Don't go further if you aren't using XEmacs.
-* Easy Picons:: Displaying Picons---the easy way.
-* Hard Picons:: The way you should do it. You'll learn something.
-* Picon Useless Configuration:: Other variables you can trash/tweak/munge/play with.
+* Picon Basics:: What are picons and How do I get them.
+* Picon Requirements:: Don't go further if you aren't using XEmacs.
+* Easy Picons:: Displaying Picons---the easy way.
+* Hard Picons:: The way you should do it. You'll learn something.
+* Picon Useless Configuration:: Other variables you can trash/tweak/munge/play with.
Appendices
-* History:: How Gnus got where it is today.
-* On Writing Manuals:: Why this is not a beginner's guide.
-* Terminology:: We use really difficult, like, words here.
-* Customization:: Tailoring Gnus to your needs.
-* Troubleshooting:: What you might try if things do not work.
-* Gnus Reference Guide:: Rilly, rilly technical stuff.
-* Emacs for Heathens:: A short introduction to Emacsian terms.
-* Frequently Asked Questions:: A question-and-answer session.
+* History:: How Gnus got where it is today.
+* On Writing Manuals:: Why this is not a beginner's guide.
+* Terminology:: We use really difficult, like, words here.
+* Customization:: Tailoring Gnus to your needs.
+* Troubleshooting:: What you might try if things do not work.
+* Gnus Reference Guide:: Rilly, rilly technical stuff.
+* Emacs for Heathens:: A short introduction to Emacsian terms.
History
-* Gnus Versions:: What Gnus versions have been released.
-* Other Gnus Versions:: Other Gnus versions that also have been released.
-* Why?:: What's the point of Gnus?
-* Compatibility:: Just how compatible is Gnus with @sc{gnus}?
-* Conformity:: Gnus tries to conform to all standards.
-* Emacsen:: Gnus can be run on a few modern Emacsen.
-* Gnus Development:: How Gnus is developed.
-* Contributors:: Oodles of people.
-* New Features:: Pointers to some of the new stuff in Gnus.
+* Gnus Versions:: What Gnus versions have been released.
+* Other Gnus Versions:: Other Gnus versions that also have been released.
+* Why?:: What's the point of Gnus?
+* Compatibility:: Just how compatible is Gnus with @sc{gnus}?
+* Conformity:: Gnus tries to conform to all standards.
+* Emacsen:: Gnus can be run on a few modern Emacsen.
+* Gnus Development:: How Gnus is developed.
+* Contributors:: Oodles of people.
+* New Features:: Pointers to some of the new stuff in Gnus.
New Features
-* ding Gnus:: New things in Gnus 5.0/5.1, the first new Gnus.
-* September Gnus:: The Thing Formally Known As Gnus 5.2/5.3.
-* Red Gnus:: Third time best---Gnus 5.4/5.5.
-* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7.
-* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9.
+* ding Gnus:: New things in Gnus 5.0/5.1, the first new Gnus.
+* September Gnus:: The Thing Formally Known As Gnus 5.2/5.3.
+* Red Gnus:: Third time best---Gnus 5.4/5.5.
+* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7.
+* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9.
Customization
-* Slow/Expensive Connection:: You run a local Emacs and get the news elsewhere.
-* Slow Terminal Connection:: You run a remote Emacs.
-* Little Disk Space:: You feel that having large setup files is icky.
-* Slow Machine:: You feel like buying a faster machine.
+* Slow/Expensive Connection:: You run a local Emacs and get the news elsewhere.
+* Slow Terminal Connection:: You run a remote Emacs.
+* Little Disk Space:: You feel that having large setup files is icky.
+* Slow Machine:: You feel like buying a faster machine.
Gnus Reference Guide
-* Gnus Utility Functions:: Common functions and variable to use.
-* Backend Interface:: How Gnus communicates with the servers.
-* Score File Syntax:: A BNF definition of the score file standard.
-* Headers:: How Gnus stores headers internally.
-* Ranges:: A handy format for storing mucho numbers.
-* Group Info:: The group info format.
-* Extended Interactive:: Symbolic prefixes and stuff.
-* Emacs/XEmacs Code:: Gnus can be run under all modern Emacsen.
-* Various File Formats:: Formats of files that Gnus use.
+* Gnus Utility Functions:: Common functions and variable to use.
+* Backend Interface:: How Gnus communicates with the servers.
+* Score File Syntax:: A BNF definition of the score file standard.
+* Headers:: How Gnus stores headers internally.
+* Ranges:: A handy format for storing mucho numbers.
+* Group Info:: The group info format.
+* Extended Interactive:: Symbolic prefixes and stuff.
+* Emacs/XEmacs Code:: Gnus can be run under all modern Emacsen.
+* Various File Formats:: Formats of files that Gnus use.
Backend Interface
-* Required Backend Functions:: Functions that must be implemented.
-* Optional Backend Functions:: Functions that need not be implemented.
-* Error Messaging:: How to get messages and report errors.
-* Writing New Backends:: Extending old backends.
-* Hooking New Backends Into Gnus:: What has to be done on the Gnus end.
-* Mail-like Backends:: Some tips on mail backends.
+* Required Backend Functions:: Functions that must be implemented.
+* Optional Backend Functions:: Functions that need not be implemented.
+* Error Messaging:: How to get messages and report errors.
+* Writing New Backends:: Extending old backends.
+* Hooking New Backends Into Gnus:: What has to be done on the Gnus end.
+* Mail-like Backends:: Some tips on mail backends.
Various File Formats
-* Active File Format:: Information on articles and groups available.
-* Newsgroups File Format:: Group descriptions.
+* Active File Format:: Information on articles and groups available.
+* Newsgroups File Format:: Group descriptions.
Emacs for Heathens
-* Keystrokes:: Entering text and executing commands.
-* Emacs Lisp:: The built-in Emacs programming language.
+* Keystrokes:: Entering text and executing commands.
+* Emacs Lisp:: The built-in Emacs programming language.
@end detailmenu
@end menu
-@node Starting Up
+@node Starting Up, Group Buffer, Top, Top
@chapter Starting Gnus
@cindex starting up
terminology section (@pxref{Terminology}).
@menu
-* Finding the News:: Choosing a method for getting news.
-* The First Time:: What does Gnus do the first time you start it?
-* The Server is Down:: How can I read my mail then?
-* Slave Gnusae:: You can have more than one Gnus active at a time.
-* Fetching a Group:: Starting Gnus just to read a group.
-* New Groups:: What is Gnus supposed to do with new groups?
-* Startup Files:: Those pesky startup files---@file{.newsrc}.
-* Auto Save:: Recovering from a crash.
-* The Active File:: Reading the active file over a slow line Takes Time.
-* Changing Servers:: You may want to move from one server to another.
-* Startup Variables:: Other variables you might change.
+* Finding the News:: Choosing a method for getting news.
+* The First Time:: What does Gnus do the first time you start it?
+* The Server is Down:: How can I read my mail then?
+* Slave Gnusae:: You can have more than one Gnus active at a time.
+* Fetching a Group:: Starting Gnus just to read a group.
+* New Groups:: What is Gnus supposed to do with new groups?
+* Changing Servers:: You may want to move from one server to another.
+* Startup Files:: Those pesky startup files---@file{.newsrc}.
+* Auto Save:: Recovering from a crash.
+* The Active File:: Reading the active file over a slow line Takes Time.
+* Startup Variables:: Other variables you might change.
@end menu
-@node Finding the News
+@node Finding the News, The First Time, Starting Up, Starting Up
@section Finding the News
@cindex finding news
@end lisp
-@node The First Time
+@node The First Time, The Server is Down, Finding the News, Starting Up
@section The First Time
@cindex first time usage
special.
-@node The Server is Down
+@node The Server is Down, Slave Gnusae, The First Time, Starting Up
@section The Server is Down
@cindex server errors
levels.) Also @pxref{Group Levels}.
-@node Slave Gnusae
+@node Slave Gnusae, Fetching a Group, The Server is Down, Starting Up
@section Slave Gnusae
@cindex slave
information in the normal (i.e., master) @code{.newsrc} file.
-@node Fetching a Group
+@node Fetching a Group, New Groups, Slave Gnusae, Starting Up
@section Fetching a Group
@cindex fetching a group
It takes the group name as a parameter.
-@node New Groups
+@node New Groups, Changing Servers, Fetching a Group, Starting Up
@section New Groups
@cindex new groups
@cindex subscription
when you do the @kbd{g} command (@pxref{Scanning New Messages}).
@menu
-* Checking New Groups:: Determining what groups are new.
-* Subscription Methods:: What Gnus should do with new groups.
-* Filtering New Groups:: Making Gnus ignore certain new groups.
+* Checking New Groups:: Determining what groups are new.
+* Subscription Methods:: What Gnus should do with new groups.
+* Filtering New Groups:: Making Gnus ignore certain new groups.
@end menu
-@node Checking New Groups
+@node Checking New Groups, Subscription Methods, New Groups, New Groups
@subsection Checking New Groups
Gnus normally determines whether a group is new or not by comparing the
Use the mantra ``dingnusdingnusdingnus'' to achieve permanent bliss.
-@node Subscription Methods
+@node Subscription Methods, Filtering New Groups, Checking New Groups, New Groups
@subsection Subscription Methods
@vindex gnus-subscribe-newsgroup-method
will not work. This is ga-ga. So don't do it.
-@node Filtering New Groups
+@node Filtering New Groups, , Subscription Methods, New Groups
@subsection Filtering New Groups
A nice and portable way to control which new newsgroups should be
@code{gnus-subscribe-options-newsgroup-method}.
-@node Changing Servers
+@node Changing Servers, Startup Files, New Groups, Starting Up
@section Changing Servers
@cindex changing servers
affect which articles Gnus thinks are read.
-@node Startup Files
+@node Startup Files, Auto Save, Changing Servers, Starting Up
@section Startup Files
@cindex startup files
@cindex .newsrc
-@node Auto Save
+@node Auto Save, The Active File, Startup Files, Starting Up
@section Auto Save
@cindex dribble file
@cindex auto-save
read the dribble file on startup without querying the user.
-@node The Active File
+@node The Active File, Startup Variables, Auto Save, Starting Up
@section The Active File
@cindex active file
@cindex ignored groups
secondary select methods.
-@node Startup Variables
+@node Startup Variables, , The Active File, Starting Up
@section Startup Variables
@table @code
@end table
-@node Group Buffer
+@node Group Buffer, Summary Buffer, Starting Up, Top
@chapter Group Buffer
@cindex group buffer
@end iftex
@menu
-* Group Buffer Format:: Information listed and how you can change it.
-* Group Maneuvering:: Commands for moving in the group buffer.
-* Selecting a Group:: Actually reading news.
-* Group Data:: Changing the info for a group.
-* Subscription Commands:: Unsubscribing, killing, subscribing.
-* Group Levels:: Levels? What are those, then?
-* Group Score:: A mechanism for finding out what groups you like.
-* Marking Groups:: You can mark groups for later processing.
-* Foreign Groups:: Creating and editing groups.
-* Group Parameters:: Each group may have different parameters set.
-* Listing Groups:: Gnus can list various subsets of the groups.
-* Sorting Groups:: Re-arrange the group order.
-* Group Maintenance:: Maintaining a tidy @file{.newsrc} file.
-* Browse Foreign Server:: You can browse a server. See what it has to offer.
-* Exiting Gnus:: Stop reading news and get some work done.
-* Group Topics:: A folding group mode divided into topics.
-* Misc Group Stuff:: Other stuff that you can to do.
+* Group Buffer Format:: Information listed and how you can change it.
+* Group Maneuvering:: Commands for moving in the group buffer.
+* Selecting a Group:: Actually reading news.
+* Subscription Commands:: Unsubscribing, killing, subscribing.
+* Group Data:: Changing the info for a group.
+* Group Levels:: Levels? What are those, then?
+* Group Score:: A mechanism for finding out what groups you like.
+* Marking Groups:: You can mark groups for later processing.
+* Foreign Groups:: Creating and editing groups.
+* Group Parameters:: Each group may have different parameters set.
+* Listing Groups:: Gnus can list various subsets of the groups.
+* Sorting Groups:: Re-arrange the group order.
+* Group Maintenance:: Maintaining a tidy @file{.newsrc} file.
+* Browse Foreign Server:: You can browse a server. See what it has to offer.
+* Exiting Gnus:: Stop reading news and get some work done.
+* Group Topics:: A folding group mode divided into topics.
+* Misc Group Stuff:: Other stuff that you can to do.
@end menu
-@node Group Buffer Format
+@node Group Buffer Format, Group Maneuvering, Group Buffer, Group Buffer
@section Group Buffer Format
@menu
-* Group Line Specification:: Deciding how the group buffer is to look.
-* Group Modeline Specification:: The group buffer modeline.
-* Group Highlighting:: Having nice colors in the group buffer.
+* Group Line Specification:: Deciding how the group buffer is to look.
+* Group Modeline Specification:: The group buffer modeline.
+* Group Highlighting:: Having nice colors in the group buffer.
@end menu
-@node Group Line Specification
+@node Group Line Specification, Group Modeline Specification, Group Buffer Format, Group Buffer Format
@subsection Group Line Specification
@cindex group buffer format
group, or a bogus native group.
-@node Group Modeline Specification
+@node Group Modeline Specification, Group Highlighting, Group Line Specification, Group Buffer Format
@subsection Group Modeline Specification
@cindex group modeline
@end table
-@node Group Highlighting
+@node Group Highlighting, , Group Modeline Specification, Group Buffer Format
@subsection Group Highlighting
@cindex highlighting
@cindex group highlighting
calls @code{gnus-group-highlight-line} by default.
-@node Group Maneuvering
+@node Group Maneuvering, Selecting a Group, Group Buffer Format, Group Buffer
@section Group Maneuvering
@cindex group movement
is @code{t}.
-@node Selecting a Group
+@node Selecting a Group, Subscription Commands, Group Maneuvering, Group Buffer
@section Selecting a Group
@cindex group selection
selected.
-@node Subscription Commands
+@node Subscription Commands, Group Data, Selecting a Group, Group Buffer
@section Subscription Commands
@cindex subscription
Also @pxref{Group Levels}.
-@node Group Data
+@node Group Data, Group Levels, Subscription Commands, Group Buffer
@section Group Data
@table @kbd
@end table
-@node Group Levels
+@node Group Levels, Group Score, Group Data, Group Buffer
@section Group Levels
@cindex group level
@cindex level
to 5. The default is 6.
-@node Group Score
+@node Group Score, Marking Groups, Group Levels, Group Buffer
@section Group Score
@cindex group score
@cindex group rank
slow things down somewhat.
-@node Marking Groups
+@node Marking Groups, Foreign Groups, Group Score, Group Buffer
@section Marking Groups
@cindex marking groups
the command to be executed.
-@node Foreign Groups
+@node Foreign Groups, Group Parameters, Marking Groups, Group Buffer
@section Foreign Groups
@cindex foreign groups
newsgroups.
-@node Group Parameters
+@node Group Parameters, Listing Groups, Foreign Groups, Group Buffer
@section Group Parameters
@cindex group parameters
the @code{to-group} example shows.
-@node Listing Groups
+@node Listing Groups, Sorting Groups, Group Parameters, Group Buffer
@section Listing Groups
@cindex group listing
groups. It is @code{t} by default.
-@node Sorting Groups
+@node Sorting Groups, Group Maintenance, Listing Groups, Group Buffer
@section Sorting Groups
@cindex sorting groups
move groups around.
-@node Group Maintenance
+@node Group Maintenance, Browse Foreign Server, Sorting Groups, Group Buffer
@section Group Maintenance
@cindex bogus groups
@end table
-@node Browse Foreign Server
+@node Browse Foreign Server, Exiting Gnus, Group Maintenance, Group Buffer
@section Browse Foreign Server
@cindex foreign servers
@cindex browsing servers
@end table
-@node Exiting Gnus
+@node Exiting Gnus, Group Topics, Browse Foreign Server, Group Buffer
@section Exiting Gnus
@cindex exiting Gnus
@end quotation
-@node Group Topics
+@node Group Topics, Misc Group Stuff, Exiting Gnus, Group Buffer
@section Group Topics
@cindex topics
@end lisp
@menu
-* Topic Variables:: How to customize the topics the Lisp Way.
-* Topic Commands:: Interactive E-Z commands.
-* Topic Sorting:: Sorting each topic individually.
-* Topic Topology:: A map of the world.
-* Topic Parameters:: Parameters that apply to all groups in a topic.
+* Topic Variables:: How to customize the topics the Lisp Way.
+* Topic Commands:: Interactive E-Z commands.
+* Topic Sorting:: Sorting each topic individually.
+* Topic Topology:: A map of the world.
+* Topic Parameters:: Parameters that apply to all groups in a topic.
@end menu
-@node Topic Variables
+@node Topic Variables, Topic Commands, Group Topics, Group Topics
@subsection Topic Variables
@cindex topic variables
topics that have no unread articles in them. The default is @code{t}.
-@node Topic Commands
+@node Topic Commands, Topic Sorting, Topic Variables, Group Topics
@subsection Topic Commands
@cindex topic commands
@end table
-@node Topic Sorting
+@node Topic Sorting, Topic Topology, Topic Commands, Group Topics
@subsection Topic Sorting
@cindex topic sorting
@xref{Sorting Groups}, for more information about group sorting.
-@node Topic Topology
+@node Topic Topology, Topic Parameters, Topic Sorting, Group Topics
@subsection Topic Topology
@cindex topic topology
@cindex topology
allowed---@code{visible} and @code{invisible}.
-@node Topic Parameters
+@node Topic Parameters, , Topic Topology, Group Topics
@subsection Topic Parameters
@cindex topic parameters
happens. You just have to be careful if you do stuff like that.
-@node Misc Group Stuff
+@node Misc Group Stuff, , Group Topics, Group Buffer
@section Misc Group Stuff
@menu
-* Scanning New Messages:: Asking Gnus to see whether new messages have arrived.
-* Group Information:: Information and help on groups and Gnus.
-* Group Timestamp:: Making Gnus keep track of when you last read a group.
-* File Commands:: Reading and writing the Gnus files.
+* Scanning New Messages:: Asking Gnus to see whether new messages have arrived.
+* Group Information:: Information and help on groups and Gnus.
+* Group Timestamp:: Making Gnus keep track of when you last read a group.
+* File Commands:: Reading and writing the Gnus files.
@end menu
@table @kbd
@end table
-@node Scanning New Messages
+@node Scanning New Messages, Group Information, Misc Group Stuff, Misc Group Stuff
@subsection Scanning New Messages
@cindex new messages
@cindex scanning new news
news.
-@node Group Information
+@node Group Information, Group Timestamp, Scanning New Messages, Misc Group Stuff
@subsection Group Information
@cindex group information
@cindex information on groups
@end table
-@node Group Timestamp
+@node Group Timestamp, File Commands, Group Information, Misc Group Stuff
@subsection Group Timestamp
@cindex timestamps
@cindex group timestamps
@end lisp
-@node File Commands
+@node File Commands, , Group Timestamp, Misc Group Stuff
@subsection File Commands
@cindex file commands
@end table
-@node Summary Buffer
+@node Summary Buffer, Article Buffer, Group Buffer, Top
@chapter Summary Buffer
@cindex summary buffer
* Choosing Articles:: Reading articles.
* Paging the Article:: Scrolling the current article.
* Reply Followup and Post:: Posting articles.
+* Delayed Articles::
* Marking Articles:: Marking articles as read, expirable, etc.
* Limiting:: You can limit the summary buffer.
* Threading:: How threads are made.
@end menu
-@node Summary Buffer Format
+@node Summary Buffer Format, Summary Maneuvering, Summary Buffer, Summary Buffer
@section Summary Buffer Format
@cindex summary buffer format
@end iftex
@menu
-* Summary Buffer Lines:: You can specify how summary lines should look.
-* To From Newsgroups:: How to not display your own name.
-* Summary Buffer Mode Line:: You can say how the mode line should look.
-* Summary Highlighting:: Making the summary buffer all pretty and nice.
+* Summary Buffer Lines:: You can specify how summary lines should look.
+* To From Newsgroups:: How to not display your own name.
+* Summary Buffer Mode Line:: You can say how the mode line should look.
+* Summary Highlighting:: Making the summary buffer all pretty and nice.
@end menu
@findex mail-extract-address-components
with those specs that require it. The default is @code{""}.
-@node Summary Buffer Lines
+@node Summary Buffer Lines, To From Newsgroups, Summary Buffer Format, Summary Buffer Format
@subsection Summary Buffer Lines
@vindex gnus-summary-line-format
This restriction may disappear in later versions of Gnus.
-@node To From Newsgroups
+@node To From Newsgroups, Summary Buffer Mode Line, Summary Buffer Lines, Summary Buffer Format
@subsection To From Newsgroups
@cindex To
@cindex Newsgroups
as you would the extra headers from the mail groups.
-@node Summary Buffer Mode Line
+@node Summary Buffer Mode Line, Summary Highlighting, To From Newsgroups, Summary Buffer Format
@subsection Summary Buffer Mode Line
@vindex gnus-summary-mode-line-format
@end table
-@node Summary Highlighting
+@node Summary Highlighting, , Summary Buffer Mode Line, Summary Buffer Format
@subsection Summary Highlighting
@table @code
@end table
-@node Summary Maneuvering
+@node Summary Maneuvering, Choosing Articles, Summary Buffer Format, Summary Buffer
@section Summary Maneuvering
@cindex summary movement
@end table
-@node Choosing Articles
+@node Choosing Articles, Paging the Article, Summary Maneuvering, Summary Buffer
@section Choosing Articles
@cindex selecting articles
@menu
-* Choosing Commands:: Commands for choosing articles.
-* Choosing Variables:: Variables that influence these commands.
+* Choosing Commands:: Commands for choosing articles.
+* Choosing Variables:: Variables that influence these commands.
@end menu
-@node Choosing Commands
+@node Choosing Commands, Choosing Variables, Choosing Articles, Choosing Articles
@subsection Choosing Commands
None of the following movement commands understand the numeric prefix,
@end table
-@node Choosing Variables
+@node Choosing Variables, , Choosing Commands, Choosing Articles
@subsection Choosing Variables
Some variables relevant for moving and selecting articles:
@end table
-@node Paging the Article
+@node Paging the Article, Reply Followup and Post, Choosing Articles, Summary Buffer
@section Scrolling the Article
@cindex article scrolling
@end table
-@node Reply Followup and Post
+@node Reply Followup and Post, Delayed Articles, Paging the Article, Summary Buffer
@section Reply, Followup and Post
@menu
* Summary Mail Commands:: Sending mail.
* Summary Post Commands:: Sending news.
* Summary Message Commands:: Other Message-related commands.
-* Canceling and Superseding:: ``Whoops, I shouldn't have called him that.''
+* Canceling and Superseding::
@end menu
-@node Summary Mail Commands
+@node Summary Mail Commands, Summary Post Commands, Reply Followup and Post, Reply Followup and Post
@subsection Summary Mail Commands
@cindex mail
@cindex composing mail
Also @pxref{(message)Header Commands} for more information.
-@node Summary Post Commands
+@node Summary Post Commands, Summary Message Commands, Summary Mail Commands, Reply Followup and Post
@subsection Summary Post Commands
@cindex post
@cindex composing news
Also @pxref{(message)Header Commands} for more information.
-@node Summary Message Commands
+@node Summary Message Commands, Canceling and Superseding, Summary Post Commands, Reply Followup and Post
@subsection Summary Message Commands
@table @kbd
@end table
-@node Canceling and Superseding
+@node Canceling and Superseding, , Summary Message Commands, Reply Followup and Post
@subsection Canceling Articles
@cindex canceling articles
@cindex superseding articles
Just remember, kids: There is no 'c' in 'supersede'.
+@node Delayed Articles, Marking Articles, Reply Followup and Post, Summary Buffer
+@section Delayed Articles
+@cindex delayed sending
+@cindex send delayed
+
+Sometimes, you might wish to delay the sending of a message. For
+example, you might wish to arrange for a message to turn up just in time
+to remind your about the birthday of your Significant Other. For this,
+there is the @code{gnus-delay} package. Setup is simple:
+
+@lisp
+(gnus-delay-initialize)
+@end lisp
+
+@findex gnus-delay-article
+Normally, to send a message you use the @kbd{C-c C-c} command from
+Message mode. To delay a message, use @kbd{C-c C-j}
+(@code{gnus-delay-article}) instead. This will ask you for how long the
+message should be delayed. Possible answers are:
-@node Marking Articles
+@itemize
+@item
+A time span. Consists of an integer and a letter. For example,
+@code{42d} means to delay for 42 days. Available letters are @code{m}
+(minutes), @code{h} (hours), @code{d} (days), @code{w} (weeks), @code{M}
+(months) and @code{Y} (years).
+
+@item
+A specific date. Looks like @code{YYYYY-MM-DD}. The message will be
+delayed until that day, at a specific time (eight o'clock by default).
+See also @code{gnus-delay-default-hour}.
+
+@item
+A specific time of day. Given in @code{hh:mm} format, 24h, no am/pm
+stuff. The deadline will be at that time today, except if that time has
+already passed, then it's at the given time tomorrow. So if it's ten
+o'clock in the morning and you specify @code{11:15}, then the deadline
+is one hour and fifteen minutes hence. But if you specify @code{9:20},
+that means a time tomorrow.
+@end itemize
+
+The action of the @code{gnus-delay-article} command is influenced by a
+couple of variables:
+
+@table @code
+@item gnus-delay-default-hour
+@vindex gnus-delay-default-hour
+When you specify a specific date, the message will be due on that hour
+on the given date. Possible values are integers 0 through 23.
+
+@item gnus-delay-default-delay
+@vindex gnus-delay-default-delay
+This is a string and gives the default delay. It can be of any of the
+formats described above.
+
+@item gnus-delay-group
+@vindex gnus-delay-group
+Delayed articles will be kept in this group on the drafts server until
+they are due. You probably don't need to change this. The default
+value is @code{"delayed"}.
+
+@item gnus-delay-header
+@vindex gnus-delay-header
+The deadline for each article will be stored in a header. This variable
+is a string and gives the header name. You probably don't need to
+change this. The default value is @code{"X-Gnus-Delayed"}.
+@end table
+
+The way delaying works is like this: when you use the
+@code{gnus-delay-article} command, you give a certain delay. Gnus
+calculates the deadline of the message and stores it in the
+@code{X-Gnus-Delayed} header and puts the message in the
+@code{nndraft:delayed} group.
+
+And whenever you get new news, Gnus looks through the group for articles
+which are due and sends them. It uses the @code{gnus-delay-send-drafts}
+function for this. By default, this function is added to the hook
+@code{gnus-get-new-news-hook}. But of course, you can change this.
+Maybe you want to use the demon to send drafts? Just tell the demon to
+execute the @code{gnus-delay-send-drafts} function.
+
+@table @code
+@item gnus-delay-initialize
+@findex gnus-delay-initialize
+By default, this function installs the @kbd{C-c C-j} key binding in
+Message mode and @code{gnus-delay-send-drafts} in
+@code{gnus-get-new-news-hook}. But it accepts two optional arguments,
+@code{no-keymap} and @code{no-check}. If @code{no-keymap} is non-nil,
+the @kbd{C-c C-j} binding is not intalled. If @code{no-check} is
+non-nil, @code{gnus-get-new-news-hook} is not changed.
+
+For example, @code{(gnus-delay-initialize nil t)} means to change the
+keymap but not to change @code{gnus-get-new-news-hook}. Presumably, you
+want to use the demon for sending due delayed articles. Just don't
+forget to set that up :-)
+@end table
+
+
+@node Marking Articles, Limiting, Delayed Articles, Summary Buffer
@section Marking Articles
@cindex article marking
@cindex article ticking
In addition, you also have marks that do not affect readedness.
@menu
-* Unread Articles:: Marks for unread articles.
-* Read Articles:: Marks for read articles.
-* Other Marks:: Marks that do not affect readedness.
+* Unread Articles:: Marks for unread articles.
+* Read Articles:: Marks for read articles.
+* Other Marks:: Marks that do not affect readedness.
+* Setting Marks::
+* Generic Marking Commands::
+* Setting Process Marks::
@end menu
@ifinfo
@end menu
-@node Unread Articles
+@node Unread Articles, Read Articles, Marking Articles, Marking Articles
@subsection Unread Articles
The following marks mark articles as (kinda) unread, in one form or
@end table
-@node Read Articles
+@node Read Articles, Other Marks, Unread Articles, Marking Articles
@subsection Read Articles
@cindex expirable mark
@end table
-@node Other Marks
+@node Other Marks, Setting Marks, Read Articles, Marking Articles
@subsection Other Marks
@cindex process mark
@cindex bookmarks
you'll only see the cache mark and not the replied mark.
-@node Setting Marks
+@node Setting Marks, Generic Marking Commands, Other Marks, Marking Articles
@subsection Setting Marks
@cindex setting marks
The default is @code{t}.
-@node Generic Marking Commands
+@node Generic Marking Commands, Setting Process Marks, Setting Marks, Marking Articles
@subsection Generic Marking Commands
Some people would like the command that ticks an article (@kbd{!}) go to
@end lisp
-@node Setting Process Marks
+@node Setting Process Marks, , Generic Marking Commands, Marking Articles
@subsection Setting Process Marks
@cindex setting process marks
set process marks based on article body contents.
-@node Limiting
+@node Limiting, Threading, Marking Articles, Summary Buffer
@section Limiting
@cindex limiting
@end table
-@node Threading
+@node Threading, Sorting the Summary Buffer, Limiting, Summary Buffer
@section Threading
@cindex threading
@cindex article threading
@menu
-* Customizing Threading:: Variables you can change to affect the threading.
-* Thread Commands:: Thread based commands in the summary buffer.
+* Customizing Threading:: Variables you can change to affect the threading.
+* Thread Commands:: Thread based commands in the summary buffer.
@end menu
-@node Customizing Threading
+@node Customizing Threading, Thread Commands, Threading, Threading
@subsection Customizing Threading
@cindex customizing threading
@menu
-* Loose Threads:: How Gnus gathers loose threads into bigger threads.
-* Filling In Threads:: Making the threads displayed look fuller.
-* More Threading:: Even more variables for fiddling with threads.
-* Low-Level Threading:: You thought it was over... but you were wrong!
+* Loose Threads:: How Gnus gathers loose threads into bigger threads.
+* Filling In Threads:: Making the threads displayed look fuller.
+* More Threading:: Even more variables for fiddling with threads.
+* Low-Level Threading:: You thought it was over... but you were wrong!
@end menu
-@node Loose Threads
+@node Loose Threads, Filling In Threads, Customizing Threading, Customizing Threading
@subsubsection Loose Threads
@cindex <
@cindex >
@end table
-@node Filling In Threads
+@node Filling In Threads, More Threading, Loose Threads, Customizing Threading
@subsubsection Filling In Threads
@table @code
@end table
-@node More Threading
+@node More Threading, Low-Level Threading, Filling In Threads, Customizing Threading
@subsubsection More Threading
@table @code
@end table
-@node Low-Level Threading
+@node Low-Level Threading, , More Threading, Customizing Threading
@subsubsection Low-Level Threading
@table @code
@end table
-@node Thread Commands
+@node Thread Commands, , Customizing Threading, Threading
@subsection Thread Commands
@cindex thread commands
Matching}).
-@node Sorting the Summary Buffer
+@node Sorting the Summary Buffer, Asynchronous Fetching, Threading, Summary Buffer
@section Sorting the Summary Buffer
@findex gnus-thread-sort-by-total-score
-@node Asynchronous Fetching
+@node Asynchronous Fetching, Article Caching, Sorting the Summary Buffer, Summary Buffer
@section Asynchronous Article Fetching
@cindex asynchronous article fetching
@cindex article pre-fetch
@c from the next group.
-@node Article Caching
+@node Article Caching, Persistent Articles, Asynchronous Fetching, Summary Buffer
@section Article Caching
@cindex article caching
@cindex caching
file.
-@node Persistent Articles
+@node Persistent Articles, Article Backlog, Article Caching, Summary Buffer
@section Persistent Articles
@cindex persistent articles
@end lisp
-@node Article Backlog
+@node Article Backlog, Saving Articles, Persistent Articles, Summary Buffer
@section Article Backlog
@cindex backlog
@cindex article backlog
This variable is @code{nil} by default.
-@node Saving Articles
+@node Saving Articles, Decoding Articles, Article Backlog, Summary Buffer
@section Saving Articles
@cindex saving articles
around to the groups/directories with @code{nneething}.
-@node Decoding Articles
+@node Decoding Articles, Article Treatment, Saving Articles, Summary Buffer
@section Decoding Articles
@cindex decoding articles
encoded in some way or other. Gnus can decode them for you.
@menu
-* Uuencoded Articles:: Uudecode articles.
-* Shell Archives:: Unshar articles.
-* PostScript Files:: Split PostScript.
-* Other Files:: Plain save and binhex.
-* Decoding Variables:: Variables for a happy decoding.
-* Viewing Files:: You want to look at the result of the decoding?
+* Uuencoded Articles:: Uudecode articles.
+* Shell Archives:: Unshar articles.
+* PostScript Files:: Split PostScript.
+* Other Files:: Plain save and binhex.
+* Decoding Variables:: Variables for a happy decoding.
+* Viewing Files:: You want to look at the result of the decoding?
@end menu
@cindex series
commands, and you have to mark the articles manually with @kbd{#}.
-@node Uuencoded Articles
+@node Uuencoded Articles, Shell Archives, Decoding Articles, Decoding Articles
@subsection Uuencoded Articles
@cindex uudecode
@cindex uuencoded articles
off.
-@node Shell Archives
+@node Shell Archives, PostScript Files, Uuencoded Articles, Decoding Articles
@subsection Shell Archives
@cindex unshar
@cindex shell archives
@end table
-@node PostScript Files
+@node PostScript Files, Other Files, Shell Archives, Decoding Articles
@subsection PostScript Files
@cindex PostScript
@end table
-@node Other Files
+@node Other Files, Decoding Variables, PostScript Files, Decoding Articles
@subsection Other Files
@table @kbd
@end table
-@node Decoding Variables
+@node Decoding Variables, Viewing Files, Other Files, Decoding Articles
@subsection Decoding Variables
Adjective, not verb.
@menu
-* Rule Variables:: Variables that say how a file is to be viewed.
-* Other Decode Variables:: Other decode variables.
-* Uuencoding and Posting:: Variables for customizing uuencoding.
+* Rule Variables:: Variables that say how a file is to be viewed.
+* Other Decode Variables:: Other decode variables.
+* Uuencoding and Posting:: Variables for customizing uuencoding.
@end menu
-@node Rule Variables
+@node Rule Variables, Other Decode Variables, Decoding Variables, Decoding Variables
@subsubsection Rule Variables
@cindex rule variables
@end table
-@node Other Decode Variables
+@node Other Decode Variables, Uuencoding and Posting, Rule Variables, Decoding Variables
@subsubsection Other Decode Variables
@table @code
@end table
-@node Uuencoding and Posting
+@node Uuencoding and Posting, , Other Decode Variables, Decoding Variables
@subsubsection Uuencoding and Posting
@table @code
@end table
-@node Viewing Files
+@node Viewing Files, , Decoding Variables, Decoding Articles
@subsection Viewing Files
@cindex viewing files
@cindex pseudo-articles
Why isn't anything real anymore? How did we get here?
-@node Article Treatment
+@node Article Treatment, MIME Commands, Decoding Articles, Summary Buffer
@section Article Treatment
Reading through this huge manual, you may have quite forgotten that the
these articles easier.
@menu
-* Article Highlighting:: You want to make the article look like fruit salad.
-* Article Fontisizing:: Making emphasized text look nice.
-* Article Hiding:: You also want to make certain info go away.
-* Article Washing:: Lots of way-neat functions to make life better.
-* Article Buttons:: Click on URLs, Message-IDs, addresses and the like.
-* Article Date:: Grumble, UT!
-* Article Signature:: What is a signature?
-* Article Miscellania:: Various other stuff.
+* Article Highlighting:: You want to make the article look like fruit salad.
+* Article Fontisizing:: Making emphasized text look nice.
+* Article Hiding:: You also want to make certain info go away.
+* Article Washing:: Lots of way-neat functions to make life better.
+* Article Buttons:: Click on URLs, Message-IDs, addresses and the like.
+* Article Date:: Grumble, UT!
+* Article Signature:: What is a signature?
+* Article Miscellania:: Various other stuff.
@end menu
-@node Article Highlighting
+@node Article Highlighting, Article Fontisizing, Article Treatment, Article Treatment
@subsection Article Highlighting
@cindex highlighting
@xref{Customizing Articles}, for how to highlight articles automatically.
-@node Article Fontisizing
+@node Article Fontisizing, Article Hiding, Article Highlighting, Article Treatment
@subsection Article Fontisizing
@cindex emphasis
@cindex article emphasis
@xref{Customizing Articles}, for how to fontize articles automatically.
-@node Article Hiding
+@node Article Hiding, Article Washing, Article Fontisizing, Article Treatment
@subsection Article Hiding
@cindex article hiding
automatically.
-@node Article Washing
+@node Article Washing, Article Buttons, Article Hiding, Article Treatment
@subsection Article Washing
@cindex washing
@cindex article washing
@xref{Customizing Articles}, for how to wash articles automatically.
-@node Article Buttons
+@node Article Buttons, Article Date, Article Washing, Article Treatment
@subsection Article Buttons
@cindex buttons
@xref{Customizing Articles}, for how to buttonize articles automatically.
-@node Article Date
+@node Article Date, Article Signature, Article Buttons, Article Treatment
@subsection Article Date
The date is most likely generated in some obscure timezone you've never
preferred format automatically.
-@node Article Signature
+@node Article Signature, Article Miscellania, Article Date, Article Treatment
@subsection Article Signature
@cindex signatures
@cindex article signature
signature after all.
-@node Article Miscellania
+@node Article Miscellania, , Article Signature, Article Treatment
@subsection Article Miscellania
@table @kbd
@end table
-@node MIME Commands
+@node MIME Commands, Charsets, Article Treatment, Summary Buffer
@section @sc{mime} Commands
@cindex MIME decoding
@cindex attachments
@end table
-@node Charsets
+@node Charsets, Article Commands, MIME Commands, Summary Buffer
@section Charsets
@cindex charsets
@end lisp
-@node Article Commands
+@node Article Commands, Summary Sorting, Charsets, Summary Buffer
@section Article Commands
@table @kbd
@end table
-@node Summary Sorting
+@node Summary Sorting, Finding the Parent, Article Commands, Summary Buffer
@section Summary Sorting
@cindex summary sorting
Commands}).
-@node Finding the Parent
+@node Finding the Parent, Alternative Approaches, Summary Sorting, Summary Buffer
@section Finding the Parent
@cindex parent articles
@cindex referring articles
consuming.) @code{nnmh} does not support this at all.
-@node Alternative Approaches
+@node Alternative Approaches, Tree Display, Finding the Parent, Summary Buffer
@section Alternative Approaches
Different people like to read news using different methods. This being
@end menu
-@node Pick and Read
+@node Pick and Read, Binary Groups, Alternative Approaches, Alternative Approaches
@subsection Pick and Read
@cindex pick and read
@code{gnus-summary-line-format} does (@pxref{Summary Buffer Lines}).
-@node Binary Groups
+@node Binary Groups, , Pick and Read, Alternative Approaches
@subsection Binary Groups
@cindex binary groups
@code{gnus-binary-mode-hook} is called in binary minor mode buffers.
-@node Tree Display
+@node Tree Display, Mail Group Commands, Alternative Approaches, Summary Buffer
@section Tree Display
@cindex trees
@xref{Window Layout}.
-@node Mail Group Commands
+@node Mail Group Commands, Various Summary Stuff, Tree Display, Summary Buffer
@section Mail Group Commands
@cindex mail group commands
@end lisp
-@node Various Summary Stuff
+@node Various Summary Stuff, Exiting the Summary Buffer, Mail Group Commands, Summary Buffer
@section Various Summary Stuff
@menu
-* Summary Group Information:: Information oriented commands.
-* Searching for Articles:: Multiple article commands.
-* Summary Generation Commands:: (Re)generating the summary buffer.
-* Really Various Summary Commands:: Those pesky non-conformant commands.
+* Summary Group Information:: Information oriented commands.
+* Searching for Articles:: Multiple article commands.
+* Summary Generation Commands::
+* Really Various Summary Commands:: Those pesky non-conformant commands.
@end menu
@table @code
@end table
-@node Summary Group Information
+@node Summary Group Information, Searching for Articles, Various Summary Stuff, Various Summary Stuff
@subsection Summary Group Information
@table @kbd
@end table
-@node Searching for Articles
+@node Searching for Articles, Summary Generation Commands, Summary Group Information, Various Summary Stuff
@subsection Searching for Articles
@table @kbd
the process mark (@code{gnus-summary-universal-argument}).
@end table
-@node Summary Generation Commands
+@node Summary Generation Commands, Really Various Summary Commands, Searching for Articles, Various Summary Stuff
@subsection Summary Generation Commands
@table @kbd
@end table
-@node Really Various Summary Commands
+@node Really Various Summary Commands, , Summary Generation Commands, Various Summary Stuff
@subsection Really Various Summary Commands
@table @kbd
@end table
-@node Exiting the Summary Buffer
+@node Exiting the Summary Buffer, Crosspost Handling, Various Summary Stuff, Summary Buffer
@section Exiting the Summary Buffer
@cindex summary exit
@cindex exiting groups
both subscribed and unsubscribed groups (@pxref{Crosspost Handling}).
-@node Crosspost Handling
+@node Crosspost Handling, Duplicate Suppression, Exiting the Summary Buffer, Summary Buffer
@section Crosspost Handling
@cindex velveeta
For an alternative approach, @pxref{Duplicate Suppression}.
-@node Duplicate Suppression
+@node Duplicate Suppression, Security, Crosspost Handling, Summary Buffer
@section Duplicate Suppression
By default, Gnus tries to make sure that you don't have to read the same
@code{gnus-save-duplicate-list} to @code{nil}. Uhm. I'll leave this up
to you to figure out, I think.
-@node Security
+@node Security, Mailing List, Duplicate Suppression, Summary Buffer
@section Security
Gnus is able to verify PGP or S/MIME signed messages or decrypt PGP
@end table
-@node Mailing List
+@node Mailing List, , Security, Summary Buffer
@section Mailing List
Gnus understands some mailing list fields of RFC 2369.
@end table
-@node Article Buffer
+@node Article Buffer, Composing Messages, Summary Buffer, Top
@chapter Article Buffer
@cindex article buffer
tell Gnus otherwise.
@menu
-* Hiding Headers:: Deciding what headers should be displayed.
-* Using MIME:: Pushing articles through @sc{mime} before reading them.
-* Customizing Articles:: Tailoring the look of the articles.
-* Article Keymap:: Keystrokes available in the article buffer.
-* Misc Article:: Other stuff.
+* Hiding Headers:: Deciding what headers should be displayed.
+* Using MIME:: Pushing articles through @sc{mime} before reading them.
+* Customizing Articles:: Tailoring the look of the articles.
+* Article Keymap:: Keystrokes available in the article buffer.
+* Misc Article:: Other stuff.
@end menu
-@node Hiding Headers
+@node Hiding Headers, Using MIME, Article Buffer, Article Buffer
@section Hiding Headers
@cindex hiding headers
@cindex deleting headers
This is also the default value for this variable.
-@node Using MIME
+@node Using MIME, Customizing Articles, Hiding Headers, Article Buffer
@section Using @sc{mime}
@cindex @sc{mime}
Also see @pxref{MIME Commands}.
-@node Customizing Articles
+@node Customizing Articles, Article Keymap, Using MIME, Article Buffer
@section Customizing Articles
@cindex article customization
everything.
-@node Article Keymap
+@node Article Keymap, Misc Article, Customizing Articles, Article Buffer
@section Article Keymap
Most of the keystrokes in the summary buffer can also be used in the
@end table
-@node Misc Article
+@node Misc Article, , Article Keymap, Article Buffer
@section Misc Article
@table @code
@end table
-@node Composing Messages
+@node Composing Messages, Select Methods, Article Buffer, Top
@chapter Composing Messages
@cindex composing messages
@cindex messages
on your setup (@pxref{Posting Server}).
@menu
-* Mail:: Mailing and replying.
-* Posting Server:: What server should you post via?
-* Mail and Post:: Mailing and posting at the same time.
-* Archived Messages:: Where Gnus stores the messages you've sent.
-* Posting Styles:: An easier way to specify who you are.
-* Drafts:: Postponing messages and rejected messages.
-* Rejected Articles:: What happens if the server doesn't like your article?
-* Using GPG:: How to use GPG and MML to sign and encrypt messages
+* Mail:: Mailing and replying.
+* Posting Server:: What server should you post via?
+* Mail and Post:: Mailing and posting at the same time.
+* Archived Messages:: Where Gnus stores the messages you've sent.
+* Posting Styles:: An easier way to specify who you are.
+* Drafts:: Postponing messages and rejected messages.
+* Rejected Articles:: What happens if the server doesn't like your article?
+* Using GPG:: How to use GPG and MML to sign and encrypt messages
@end menu
Also see @pxref{Canceling and Superseding} for information on how to
remove articles you shouldn't have posted.
-@node Mail
+@node Mail, Posting Server, Composing Messages, Composing Messages
@section Mail
Variables for customizing outgoing mail:
@end table
-@node Posting Server
+@node Posting Server, Mail and Post, Mail, Composing Messages
@section Posting Server
When you press those magical @kbd{C-c C-c} keys to ship off your latest
you can set this variable to @code{nil}.
-@node Mail and Post
+@node Mail and Post, Archived Messages, Posting Server, Composing Messages
@section Mail and Post
Here's a list of variables relevant to both mailing and
Modify to suit your needs.
-@node Archived Messages
+@node Archived Messages, Posting Styles, Mail and Post, Composing Messages
@section Archived Messages
@cindex archived messages
@cindex sent messages
@end table
-@node Posting Styles
+@node Posting Styles, Drafts, Archived Messages, Composing Messages
@section Posting Styles
@cindex posting styles
@cindex styles
if you fill many roles.
-@node Drafts
+@node Drafts, Rejected Articles, Posting Styles, Composing Messages
@section Drafts
@cindex drafts
as unsendable. This is a toggling command.
-@node Rejected Articles
+@node Rejected Articles, Using GPG, Drafts, Composing Messages
@section Rejected Articles
@cindex rejected articles
(@pxref{Drafts}). When the server comes back up again, you'd then
typically enter that group and send all the articles off.
-@node Using GPG
+@node Using GPG, , Rejected Articles, Composing Messages
@section Using GPG
@cindex using gpg
Gnus will ask for your passphrase and then it will send your message, if
you've typed it correctly.
-@node Select Methods
+@node Select Methods, Scoring, Composing Messages, Top
@chapter Select Methods
@cindex foreign groups
@cindex select methods
The different methods all have their peculiarities, of course.
@menu
-* Server Buffer:: Making and editing virtual servers.
-* Getting News:: Reading USENET news with Gnus.
-* Getting Mail:: Reading your personal mail with Gnus.
-* Browsing the Web:: Getting messages from a plethora of Web sources.
-* Other Sources:: Reading directories, files, SOUP packets.
-* Combined Groups:: Combining groups into one group.
-* Gnus Unplugged:: Reading news and mail offline.
+* Server Buffer:: Making and editing virtual servers.
+* Getting News:: Reading USENET news with Gnus.
+* Getting Mail:: Reading your personal mail with Gnus.
+* Browsing the Web:: Getting messages from a plethora of Web sources.
+* Other Sources:: Reading directories, files, SOUP packets.
+* Combined Groups:: Combining groups into one group.
+* Gnus Unplugged:: Reading news and mail offline.
@end menu
-@node Server Buffer
+@node Server Buffer, Getting News, Select Methods, Select Methods
@section Server Buffer
Traditionally, a @dfn{server} is a machine or a piece of software that
(@code{gnus-group-enter-server-mode}) command in the group buffer.
@menu
-* Server Buffer Format:: You can customize the look of this buffer.
-* Server Commands:: Commands to manipulate servers.
-* Example Methods:: Examples server specifications.
-* Creating a Virtual Server:: An example session.
-* Server Variables:: Which variables to set.
-* Servers and Methods:: You can use server names as select methods.
-* Unavailable Servers:: Some servers you try to contact may be down.
+* Server Buffer Format:: You can customize the look of this buffer.
+* Server Commands:: Commands to manipulate servers.
+* Example Methods:: Examples server specifications.
+* Creating a Virtual Server:: An example session.
+* Server Variables:: Which variables to set.
+* Servers and Methods:: You can use server names as select methods.
+* Unavailable Servers:: Some servers you try to contact may be down.
@end menu
@vindex gnus-server-mode-hook
@code{gnus-server-mode-hook} is run when creating the server buffer.
-@node Server Buffer Format
+@node Server Buffer Format, Server Commands, Server Buffer, Server Buffer
@subsection Server Buffer Format
@cindex server buffer format
Also @pxref{Formatting Variables}.
-@node Server Commands
+@node Server Commands, Example Methods, Server Buffer Format, Server Buffer
@subsection Server Commands
@cindex server commands
@end table
-@node Example Methods
+@node Example Methods, Creating a Virtual Server, Server Commands, Server Buffer
@subsection Example Methods
Most select methods are pretty simple and self-explanatory:
@code{ssh} @file{config} file.
-@node Creating a Virtual Server
+@node Creating a Virtual Server, Server Variables, Example Methods, Server Buffer
@subsection Creating a Virtual Server
If you're saving lots of articles in the cache by using persistent
buffer, and you should be able to enter any of the groups displayed.
-@node Server Variables
+@node Server Variables, Servers and Methods, Creating a Virtual Server, Server Buffer
@subsection Server Variables
One sticky point when defining variables (both on backends and in Emacs
@end lisp
-@node Servers and Methods
+@node Servers and Methods, Unavailable Servers, Server Variables, Server Buffer
@subsection Servers and Methods
Wherever you would normally use a select method
over.
-@node Unavailable Servers
+@node Unavailable Servers, , Servers and Methods, Server Buffer
@subsection Unavailable Servers
If a server seems to be unreachable, Gnus will mark that server as
@end table
-@node Getting News
+@node Getting News, Getting Mail, Server Buffer, Select Methods
@section Getting News
@cindex reading news
@cindex news backends
or it can read from a local spool.
@menu
-* NNTP:: Reading news from an @sc{nntp} server.
-* News Spool:: Reading news from the local spool.
+* NNTP:: Reading news from an @sc{nntp} server.
+* News Spool:: Reading news from the local spool.
@end menu
-@node NNTP
+@node NNTP, News Spool, Getting News, Getting News
@subsection @sc{nntp}
@cindex nntp
@end table
@menu
-* Direct Functions:: Connecting directly to the server.
-* Indirect Functions:: Connecting indirectly to the server.
-* Common Variables:: Understood by several connection functions.
+* Direct Functions:: Connecting directly to the server.
+* Indirect Functions:: Connecting indirectly to the server.
+* Common Variables:: Understood by several connection functions.
@end menu
-@node Direct Functions
+@node Direct Functions, Indirect Functions, NNTP, NNTP
@subsubsection Direct Functions
@cindex direct connection functions
@end table
-@node Indirect Functions
+@node Indirect Functions, Common Variables, Direct Functions, NNTP
@subsubsection Indirect Functions
@cindex indirect connection functions
@end table
-@node Common Variables
+@node Common Variables, , Indirect Functions, NNTP
@subsubsection Common Variables
The following variables affect the behavior of all, or several of the
@end table
-@node News Spool
+@node News Spool, , NNTP, Getting News
@subsection News Spool
@cindex nnspool
@cindex news spool
@end table
-@node Getting Mail
+@node Getting Mail, Browsing the Web, Getting News, Select Methods
@section Getting Mail
@cindex reading mail
@cindex mail
course.
@menu
-* Mail in a Newsreader:: Important introductory notes.
-* Getting Started Reading Mail:: A simple cookbook example.
-* Splitting Mail:: How to create mail groups.
-* Mail Sources:: How to tell Gnus where to get mail from.
-* Mail Backend Variables:: Variables for customizing mail handling.
-* Fancy Mail Splitting:: Gnus can do hairy splitting of incoming mail.
-* Group Mail Splitting:: Use group customize to drive mail splitting.
-* Incorporating Old Mail:: What about the old mail you have?
-* Expiring Mail:: Getting rid of unwanted mail.
-* Washing Mail:: Removing gruft from the mail you get.
-* Duplicates:: Dealing with duplicated mail.
-* Not Reading Mail:: Using mail backends for reading other files.
-* Choosing a Mail Backend:: Gnus can read a variety of mail formats.
+* Mail in a Newsreader:: Important introductory notes.
+* Getting Started Reading Mail:: A simple cookbook example.
+* Splitting Mail:: How to create mail groups.
+* Mail Sources:: How to tell Gnus where to get mail from.
+* Mail Backend Variables:: Variables for customizing mail handling.
+* Fancy Mail Splitting:: Gnus can do hairy splitting of incoming mail.
+* Group Mail Splitting:: Use group customize to drive mail splitting.
+* Incorporating Old Mail:: What about the old mail you have?
+* Expiring Mail:: Getting rid of unwanted mail.
+* Washing Mail:: Removing gruft from the mail you get.
+* Duplicates:: Dealing with duplicated mail.
+* Not Reading Mail:: Using mail backends for reading other files.
+* Choosing a Mail Backend:: Gnus can read a variety of mail formats.
@end menu
-@node Mail in a Newsreader
+@node Mail in a Newsreader, Getting Started Reading Mail, Getting Mail, Getting Mail
@subsection Mail in a Newsreader
If you are used to traditional mail readers, but have decided to switch
You Do.)
-@node Getting Started Reading Mail
+@node Getting Started Reading Mail, Splitting Mail, Mail in a Newsreader, Getting Mail
@subsection Getting Started Reading Mail
It's quite easy to use Gnus to read your new mail. You just plonk the
Especially @pxref{Choosing a Mail Backend} and @pxref{Expiring Mail}.
-@node Splitting Mail
+@node Splitting Mail, Mail Sources, Getting Started Reading Mail, Getting Mail
@subsection Splitting Mail
@cindex splitting mail
@cindex mail splitting
month's rent money.
-@node Mail Sources
+@node Mail Sources, Mail Backend Variables, Splitting Mail, Getting Mail
@subsection Mail Sources
Mail can be gotten from many different sources---the mail spool, from a
instance.
@menu
-* Mail Source Specifiers:: How to specify what a mail source is.
-* Mail Source Customization:: Some variables that influence things.
-* Fetching Mail:: Using the mail source specifiers.
+* Mail Source Specifiers:: How to specify what a mail source is.
+* Mail Source Customization:: Some variables that influence things.
+* Fetching Mail:: Using the mail source specifiers.
@end menu
-@node Mail Source Specifiers
+@node Mail Source Specifiers, Mail Source Customization, Mail Sources, Mail Sources
@subsubsection Mail Source Specifiers
@cindex POP
@cindex mail server
See above for a list of keywords for each type of mail source.
-@node Mail Source Customization
+@node Mail Source Customization, Fetching Mail, Mail Source Specifiers, Mail Sources
@subsubsection Mail Source Customization
The following is a list of variables that influence how the mail is
@end table
-@node Fetching Mail
+@node Fetching Mail, , Mail Source Customization, Mail Sources
@subsubsection Fetching Mail
@vindex mail-sources
-@node Mail Backend Variables
+@node Mail Backend Variables, Fancy Mail Splitting, Mail Sources, Getting Mail
@subsection Mail Backend Variables
These variables are (for the most part) pertinent to all the various
@end table
-@node Fancy Mail Splitting
+@node Fancy Mail Splitting, Group Mail Splitting, Mail Backend Variables, Getting Mail
@subsection Fancy Mail Splitting
@cindex mail splitting
@cindex fancy mail splitting
messages goes into the new group.
-@node Group Mail Splitting
+@node Group Mail Splitting, Incorporating Old Mail, Fancy Mail Splitting, Getting Mail
@subsection Group Mail Splitting
@cindex mail splitting
@cindex group mail splitting
by @code{gnus-group-split-update}, this function will run
@code{gnus-group-split-updated-hook} just before finishing.
-@node Incorporating Old Mail
+@node Incorporating Old Mail, Expiring Mail, Group Mail Splitting, Getting Mail
@subsection Incorporating Old Mail
@cindex incorporating old mail
@cindex import old mail
using the new mail backend.
-@node Expiring Mail
+@node Expiring Mail, Washing Mail, Incorporating Old Mail, Getting Mail
@subsection Expiring Mail
@cindex article expiry
auto-expire turned on.
-@node Washing Mail
+@node Washing Mail, Duplicates, Expiring Mail, Getting Mail
@subsection Washing Mail
@cindex mail washing
@cindex list server brain damage
@end table
-@node Duplicates
+@node Duplicates, Not Reading Mail, Washing Mail, Getting Mail
@subsection Duplicates
@vindex nnmail-treat-duplicates
received. Think of all the fun! She'll never see any of it! Whee!
-@node Not Reading Mail
+@node Not Reading Mail, Choosing a Mail Backend, Duplicates, Getting Mail
@subsection Not Reading Mail
If you start using any of the mail backends, they have the annoying
incoming mail.
-@node Choosing a Mail Backend
+@node Choosing a Mail Backend, , Not Reading Mail, Getting Mail
@subsection Choosing a Mail Backend
Gnus will read the mail spool when you activate a mail group. The mail
@end menu
-@node Unix Mail Box
+@node Unix Mail Box, Rmail Babyl, Choosing a Mail Backend, Choosing a Mail Backend
@subsubsection Unix Mail Box
@cindex nnmbox
@cindex unix mail box
@end table
-@node Rmail Babyl
+@node Rmail Babyl, Mail Spool, Unix Mail Box, Choosing a Mail Backend
@subsubsection Rmail Babyl
@cindex nnbabyl
@cindex rmail mbox
@end table
-@node Mail Spool
+@node Mail Spool, MH Spool, Rmail Babyl, Choosing a Mail Backend
@subsubsection Mail Spool
@cindex nnml
@cindex mail @sc{nov} spool
Commands}).
-@node MH Spool
+@node MH Spool, Mail Folders, Mail Spool, Choosing a Mail Backend
@subsubsection MH Spool
@cindex nnmh
@cindex mh-e mail spool
@end table
-@node Mail Folders
+@node Mail Folders, Comparing Mail Backends, MH Spool, Choosing a Mail Backend
@subsubsection Mail Folders
@cindex nnfolder
@cindex mbox folders
@code{nnfolder-directory}. This only works if you use long file names,
though.
-@node Comparing Mail Backends
+@node Comparing Mail Backends, , Mail Folders, Choosing a Mail Backend
@subsubsection Comparing Mail Backends
First, just for terminology, the @dfn{backend} is the common word for a
@end table
-@node Browsing the Web
+@node Browsing the Web, Other Sources, Getting Mail, Select Methods
@section Browsing the Web
@cindex web
@cindex browsing the web
interfaces to these sources.
@menu
-* Web Searches:: Creating groups from articles that match a string.
-* Slashdot:: Reading the Slashdot comments.
-* Ultimate:: The Ultimate Bulletin Board systems.
-* Web Archive:: Reading mailing list archived on web.
-* RSS:: Reading RDF site summary.
-* Customizing w3:: Doing stuff to Emacs/w3 from Gnus.
+* Web Searches:: Creating groups from articles that match a string.
+* Slashdot:: Reading the Slashdot comments.
+* Ultimate:: The Ultimate Bulletin Board systems.
+* Web Archive:: Reading mailing list archived on web.
+* RSS:: Reading RDF site summary.
+* Customizing w3:: Doing stuff to Emacs/w3 from Gnus.
@end menu
All the web sources require Emacs/w3 and the url library to work.
leisure from your local disk. No more World Wide Wait for you.
-@node Web Searches
+@node Web Searches, Slashdot, Browsing the Web, Browsing the Web
@subsection Web Searches
@cindex nnweb
@cindex DejaNews
@end table
-@node Slashdot
+@node Slashdot, Ultimate, Web Searches, Browsing the Web
@subsection Slashdot
@cindex Slashdot
@cindex nnslashdot
-@node Ultimate
+@node Ultimate, Web Archive, Slashdot, Browsing the Web
@subsection Ultimate
@cindex nnultimate
@cindex Ultimate Bulletin Board
@end table
-@node Web Archive
+@node Web Archive, RSS, Ultimate, Browsing the Web
@subsection Web Archive
@cindex nnwarchive
@cindex Web Archive
The password for your account on the web server.
@end table
-@node RSS
+@node RSS, Customizing w3, Web Archive, Browsing the Web
@subsection RSS
@cindex nnrss
@cindex RSS
(add-to-list 'nnmail-extra-headers nnrss-url-field)
@end lisp
-@node Customizing w3
+@node Customizing w3, , RSS, Browsing the Web
@subsection Customizing w3
@cindex w3
@cindex html
follow the link.
-@node Other Sources
+@node Other Sources, Combined Groups, Browsing the Web, Select Methods
@section Other Sources
Gnus can do more than just read news or mail. The methods described
newsgroups.
@menu
-* Directory Groups:: You can read a directory as if it was a newsgroup.
-* Anything Groups:: Dired? Who needs dired?
-* Document Groups:: Single files can be the basis of a group.
-* SOUP:: Reading @sc{soup} packets ``offline''.
-* Mail-To-News Gateways:: Posting articles via mail-to-news gateways.
-* IMAP:: Using Gnus as a @sc{imap} client.
+* Directory Groups:: You can read a directory as if it was a newsgroup.
+* Anything Groups:: Dired? Who needs dired?
+* Document Groups:: Single files can be the basis of a group.
+* SOUP:: Reading @sc{soup} packets ``offline''.
+* Mail-To-News Gateways:: Posting articles via mail-to-news gateways.
+* IMAP:: Using Gnus as a @sc{imap} client.
@end menu
-@node Directory Groups
+@node Directory Groups, Anything Groups, Other Sources, Other Sources
@subsection Directory Groups
@cindex nndir
@cindex directory groups
methods if you feel the need to have a non-read-only @code{nndir}.
-@node Anything Groups
+@node Anything Groups, Document Groups, Directory Groups, Other Sources
@subsection Anything Groups
@cindex nneething
@end table
-@node Document Groups
+@node Document Groups, SOUP, Anything Groups, Other Sources
@subsection Document Groups
@cindex nndoc
@cindex documentation group
@end menu
-@node Document Server Internals
+@node Document Server Internals, , Document Groups, Document Groups
@subsubsection Document Server Internals
Adding new document types to be recognized by @code{nndoc} isn't
low probability with @samp{0} being the lowest valid number.
-@node SOUP
+@node SOUP, Mail-To-News Gateways, Document Groups, Other Sources
@subsection SOUP
@cindex SOUP
@cindex offline
reading and Gnus for packing/sending these @sc{soup} packets.
@menu
-* SOUP Commands:: Commands for creating and sending @sc{soup} packets
-* SOUP Groups:: A backend for reading @sc{soup} packets.
-* SOUP Replies:: How to enable @code{nnsoup} to take over mail and news.
+* SOUP Commands:: Commands for creating and sending @sc{soup} packets
+* SOUP Groups:: A backend for reading @sc{soup} packets.
+* SOUP Replies:: How to enable @code{nnsoup} to take over mail and news.
@end menu
-@node SOUP Commands
+@node SOUP Commands, SOUP Groups, SOUP, SOUP
@subsubsection SOUP Commands
These are commands for creating and manipulating @sc{soup} packets.
@end table
-@node SOUP Groups
+@node SOUP Groups, SOUP Replies, SOUP Commands, SOUP
@subsubsection @sc{soup} Groups
@cindex nnsoup
@end table
-@node SOUP Replies
+@node SOUP Replies, , SOUP Groups, SOUP
@subsubsection SOUP Replies
Just using @code{nnsoup} won't mean that your postings and mailings end
@sc{soup}ed you use the second.
-@node Mail-To-News Gateways
+@node Mail-To-News Gateways, IMAP, SOUP, Other Sources
@subsection Mail-To-News Gateways
@cindex mail-to-news gateways
@cindex gateways
-@node IMAP
+@node IMAP, , Mail-To-News Gateways, Other Sources
@subsection @sc{imap}
@cindex nnimap
@cindex @sc{imap}
@end table
@menu
-* Splitting in IMAP:: Splitting mail with nnimap.
-* Editing IMAP ACLs:: Limiting/enabling other users access to a mailbox.
-* Expunging mailboxes:: Equivalent of a "compress mailbox" button.
+* Splitting in IMAP:: Splitting mail with nnimap.
+* Editing IMAP ACLs:: Limiting/enabling other users access to a mailbox.
+* Expunging mailboxes:: Equivalent of a "compress mailbox" button.
@end menu
-@node Splitting in IMAP
+@node Splitting in IMAP, Editing IMAP ACLs, IMAP, IMAP
@subsubsection Splitting in @sc{imap}
@cindex splitting imap mail
@end table
-@node Editing IMAP ACLs
+@node Editing IMAP ACLs, Expunging mailboxes, Splitting in IMAP, IMAP
@subsubsection Editing @sc{imap} ACLs
@cindex editing imap acls
@cindex Access Control Lists
INBOX.mailbox).
@end itemize
-@node Expunging mailboxes
+@node Expunging mailboxes, , Editing IMAP ACLs, IMAP
@subsubsection Expunging mailboxes
@cindex expunging
-@node Combined Groups
+@node Combined Groups, Gnus Unplugged, Other Sources, Select Methods
@section Combined Groups
Gnus allows combining a mixture of all the other group types into bigger
groups.
@menu
-* Virtual Groups:: Combining articles from many groups.
-* Kibozed Groups:: Looking through parts of the newsfeed for articles.
+* Virtual Groups:: Combining articles from many groups.
+* Kibozed Groups:: Looking through parts of the newsfeed for articles.
@end menu
-@node Virtual Groups
+@node Virtual Groups, Kibozed Groups, Combined Groups, Combined Groups
@subsection Virtual Groups
@cindex nnvirtual
@cindex virtual groups
-@node Kibozed Groups
+@node Kibozed Groups, , Virtual Groups, Combined Groups
@subsection Kibozed Groups
@cindex nnkiboze
@cindex kibozing
their @sc{nov} lines removed from the @sc{nov} file.
-@node Gnus Unplugged
+@node Gnus Unplugged, , Combined Groups, Select Methods
@section Gnus Unplugged
@cindex offline
@cindex unplugged
Of course, to use it as such, you have to learn a few new commands.
@menu
-* Agent Basics:: How it all is supposed to work.
-* Agent Categories:: How to tell the Gnus Agent what to download.
-* Agent Commands:: New commands for all the buffers.
-* Agent Expiry:: How to make old articles go away.
-* Agent and IMAP:: How to use the Agent with IMAP.
-* Outgoing Messages:: What happens when you post/mail something?
-* Agent Variables:: Customizing is fun.
-* Example Setup:: An example @file{.gnus.el} file for offline people.
-* Batching Agents:: How to fetch news from a @code{cron} job.
-* Agent Caveats:: What you think it'll do and what it does.
+* Agent Basics:: How it all is supposed to work.
+* Agent Categories:: How to tell the Gnus Agent what to download.
+* Agent Commands:: New commands for all the buffers.
+* Agent Expiry:: How to make old articles go away.
+* Agent and IMAP:: How to use the Agent with IMAP.
+* Outgoing Messages:: What happens when you post/mail something?
+* Agent Variables:: Customizing is fun.
+* Example Setup:: An example @file{.gnus.el} file for offline people.
+* Batching Agents:: How to fetch news from a @code{cron} job.
+* Agent Caveats:: What you think it'll do and what it does.
@end menu
-@node Agent Basics
+@node Agent Basics, Agent Categories, Gnus Unplugged, Gnus Unplugged
@subsection Agent Basics
First, let's get some terminology out of the way.
@end itemize
-@node Agent Categories
+@node Agent Categories, Agent Commands, Agent Basics, Gnus Unplugged
@subsection Agent Categories
One of the main reasons to integrate the news transport layer into the
managing categories.
@menu
-* Category Syntax:: What a category looks like.
-* Category Buffer:: A buffer for maintaining categories.
-* Category Variables:: Customize'r'Us.
+* Category Syntax:: What a category looks like.
+* Category Buffer:: A buffer for maintaining categories.
+* Category Variables:: Customize'r'Us.
@end menu
-@node Category Syntax
+@node Category Syntax, Category Buffer, Agent Categories, Agent Categories
@subsubsection Category Syntax
A category consists of two things.
@end itemize
@end enumerate
-@node Category Buffer
+@node Category Buffer, Category Variables, Category Syntax, Agent Categories
@subsubsection Category Buffer
You'd normally do all category maintenance from the category buffer.
@end table
-@node Category Variables
+@node Category Variables, , Category Buffer, Agent Categories
@subsubsection Category Variables
@table @code
@end table
-@node Agent Commands
+@node Agent Commands, Agent Expiry, Agent Categories, Gnus Unplugged
@subsection Agent Commands
All the Gnus Agent commands are on the @kbd{J} submap. The @kbd{J j}
@menu
-* Group Agent Commands::
-* Summary Agent Commands::
-* Server Agent Commands::
+* Group Agent Commands::
+* Summary Agent Commands::
+* Server Agent Commands::
@end menu
You can run a complete batch fetch from the command line with the
-@node Group Agent Commands
+@node Group Agent Commands, Summary Agent Commands, Agent Commands, Agent Commands
@subsubsection Group Agent Commands
@table @kbd
@end table
-@node Summary Agent Commands
+@node Summary Agent Commands, Server Agent Commands, Group Agent Commands, Agent Commands
@subsubsection Summary Agent Commands
@table @kbd
@end table
-@node Server Agent Commands
+@node Server Agent Commands, , Summary Agent Commands, Agent Commands
@subsubsection Server Agent Commands
@table @kbd
@end table
-@node Agent Expiry
+@node Agent Expiry, Agent and IMAP, Agent Commands, Gnus Unplugged
@subsection Agent Expiry
@vindex gnus-agent-expire-days
unread, ticked and dormant articles will be kept indefinitely.
-@node Agent and IMAP
+@node Agent and IMAP, Outgoing Messages, Agent Expiry, Gnus Unplugged
@subsection Agent and IMAP
The Agent work with any Gnus backend, including nnimap. However,
directory. It's emptied when you synchronize flags.
-@node Outgoing Messages
+@node Outgoing Messages, Agent Variables, Agent and IMAP, Gnus Unplugged
@subsection Outgoing Messages
When Gnus is unplugged, all outgoing messages (both mail and news) are
-@node Agent Variables
+@node Agent Variables, Example Setup, Outgoing Messages, Gnus Unplugged
@subsection Agent Variables
@table @code
@end table
-@node Example Setup
+@node Example Setup, Batching Agents, Agent Variables, Gnus Unplugged
@subsection Example Setup
If you don't want to read this manual, and you have a fairly standard
find out which of the other gazillion things you want to customize.
-@node Batching Agents
+@node Batching Agents, Agent Caveats, Example Setup, Gnus Unplugged
@subsection Batching Agents
Having the Gnus Agent fetch articles (and post whatever messages you've
@end example
-@node Agent Caveats
+@node Agent Caveats, , Batching Agents, Gnus Unplugged
@subsection Agent Caveats
The Gnus Agent doesn't seem to work like most other offline
articles; when it's plugged, it only talks to your ISP.
-@node Scoring
+@node Scoring, Various, Select Methods, Top
@chapter Scoring
@cindex scoring
silently to help keep the sizes of the score files down.
@menu
-* Summary Score Commands:: Adding score entries for the current group.
-* Group Score Commands:: General score commands.
-* Score Variables:: Customize your scoring. (My, what terminology).
-* Score File Format:: What a score file may contain.
-* Score File Editing:: You can edit score files by hand as well.
-* Adaptive Scoring:: Big Sister Gnus knows what you read.
-* Home Score File:: How to say where new score entries are to go.
-* Followups To Yourself:: Having Gnus notice when people answer you.
-* Scoring On Other Headers:: Scoring on non-standard headers.
-* Scoring Tips:: How to score effectively.
-* Reverse Scoring:: That problem child of old is not problem.
-* Global Score Files:: Earth-spanning, ear-splitting score files.
-* Kill Files:: They are still here, but they can be ignored.
-* Converting Kill Files:: Translating kill files to score files.
-* GroupLens:: Getting predictions on what you like to read.
-* Advanced Scoring:: Using logical expressions to build score rules.
-* Score Decays:: It can be useful to let scores wither away.
+* Summary Score Commands:: Adding score entries for the current group.
+* Group Score Commands:: General score commands.
+* Score Variables:: Customize your scoring. (My, what terminology).
+* Score File Format:: What a score file may contain.
+* Score File Editing:: You can edit score files by hand as well.
+* Adaptive Scoring:: Big Sister Gnus knows what you read.
+* Home Score File:: How to say where new score entries are to go.
+* Followups To Yourself:: Having Gnus notice when people answer you.
+* Scoring On Other Headers:: Scoring on non-standard headers.
+* Scoring Tips:: How to score effectively.
+* Reverse Scoring:: That problem child of old is not problem.
+* Global Score Files:: Earth-spanning, ear-splitting score files.
+* Kill Files:: They are still here, but they can be ignored.
+* Converting Kill Files:: Translating kill files to score files.
+* GroupLens:: Getting predictions on what you like to read.
+* Advanced Scoring:: Using logical expressions to build score rules.
+* Score Decays:: It can be useful to let scores wither away.
@end menu
-@node Summary Score Commands
+@node Summary Score Commands, Group Score Commands, Scoring, Scoring
@section Summary Score Commands
@cindex score commands
pretend they are keymaps or not.
-@node Group Score Commands
+@node Group Score Commands, Score Variables, Summary Score Commands, Scoring
@section Group Score Commands
@cindex group score commands
@end example
-@node Score Variables
+@node Score Variables, Score File Format, Group Score Commands, Scoring
@section Score Variables
@cindex score variables
@end table
-@node Score File Format
+@node Score File Format, Score File Editing, Score Variables, Scoring
@section Score File Format
@cindex score file format
@end table
-@node Score File Editing
+@node Score File Editing, Adaptive Scoring, Score File Format, Scoring
@section Score File Editing
You normally enter all scoring commands from the summary buffer, but you
e} to begin editing score files.
-@node Adaptive Scoring
+@node Adaptive Scoring, Home Score File, Score File Editing, Scoring
@section Adaptive Scoring
@cindex adaptive scoring
rigorous statistical methods) will have to be done to make this useful.
-@node Home Score File
+@node Home Score File, Followups To Yourself, Adaptive Scoring, Scoring
@section Home Score File
The score file where new score file entries will go is called the
precedence over this variable.
-@node Followups To Yourself
+@node Followups To Yourself, Scoring On Other Headers, Home Score File, Scoring
@section Followups To Yourself
Gnus offers two commands for picking out the @code{Message-ID} header in
is system-dependent.
-@node Scoring On Other Headers
+@node Scoring On Other Headers, Scoring Tips, Followups To Yourself, Scoring
@section Scoring On Other Headers
@cindex scoring on other headers
See? Simple.
-@node Scoring Tips
+@node Scoring Tips, Reverse Scoring, Scoring On Other Headers, Scoring
@section Scoring Tips
@cindex scoring tips
@end table
-@node Reverse Scoring
+@node Reverse Scoring, Global Score Files, Scoring Tips, Scoring
@section Reverse Scoring
@cindex reverse scoring
rest as read, and expunge them to boot.
-@node Global Score Files
+@node Global Score Files, Kill Files, Reverse Scoring, Scoring
@section Global Score Files
@cindex global score files
holding our breath yet?
-@node Kill Files
+@node Kill Files, Converting Kill Files, Global Score Files, Scoring
@section Kill Files
@cindex kill files
@end table
-@node Converting Kill Files
+@node Converting Kill Files, GroupLens, Kill Files, Scoring
@section Converting Kill Files
@cindex kill files
@cindex converting kill files
before.
-@node GroupLens
+@node GroupLens, Advanced Scoring, Converting Kill Files, Scoring
@section GroupLens
@cindex GroupLens
article.
@menu
-* Using GroupLens:: How to make Gnus use GroupLens.
-* Rating Articles:: Letting GroupLens know how you rate articles.
-* Displaying Predictions:: Displaying predictions given by GroupLens.
-* GroupLens Variables:: Customizing GroupLens.
+* Using GroupLens:: How to make Gnus use GroupLens.
+* Rating Articles:: Letting GroupLens know how you rate articles.
+* Displaying Predictions:: Displaying predictions given by GroupLens.
+* GroupLens Variables:: Customizing GroupLens.
@end menu
-@node Using GroupLens
+@node Using GroupLens, Rating Articles, GroupLens, GroupLens
@subsection Using GroupLens
To use GroupLens you must register a pseudonym with your local Better
you, based on how the people you usually agree with have already rated.
-@node Rating Articles
+@node Rating Articles, Displaying Predictions, Using GroupLens, GroupLens
@subsection Rating Articles
In GroupLens, an article is rated on a scale from 1 to 5, inclusive.
next article, just type @kbd{4 n}.
-@node Displaying Predictions
+@node Displaying Predictions, GroupLens Variables, Rating Articles, GroupLens
@subsection Displaying Predictions
GroupLens makes a prediction for you about how much you will like a
@end table
-@node GroupLens Variables
+@node GroupLens Variables, , Displaying Predictions, GroupLens
@subsection GroupLens Variables
@table @code
@end table
-@node Advanced Scoring
+@node Advanced Scoring, Score Decays, GroupLens, Scoring
@section Advanced Scoring
Scoring on Subjects and From headers is nice enough, but what if you're
@end menu
-@node Advanced Scoring Syntax
+@node Advanced Scoring Syntax, Advanced Scoring Examples, Advanced Scoring, Advanced Scoring
@subsection Advanced Scoring Syntax
Ordinary scoring rules have a string as the first element in the rule.
simple scoring, and the match types are also the same.
-@node Advanced Scoring Examples
+@node Advanced Scoring Examples, Advanced Scoring Tips, Advanced Scoring Syntax, Advanced Scoring
@subsection Advanced Scoring Examples
Let's say you want to increase the score of articles written by Lars
The possibilities are endless.
-@node Advanced Scoring Tips
+@node Advanced Scoring Tips, , Advanced Scoring Examples, Advanced Scoring
@subsection Advanced Scoring Tips
The @code{&} and @code{|} logical operators do short-circuit logic.
@end example
-@node Score Decays
+@node Score Decays, , Advanced Scoring, Scoring
@section Score Decays
@cindex score decays
@cindex decays
four days, Gnus will decay the scores four times, for instance.
-@node Various
+@node Various, The End, Scoring, Top
@chapter Various
@menu
-* Process/Prefix:: A convention used by many treatment commands.
-* Interactive:: Making Gnus ask you many questions.
-* Symbolic Prefixes:: How to supply some Gnus functions with options.
-* Formatting Variables:: You can specify what buffers should look like.
-* Window Layout:: Configuring the Gnus buffer windows.
-* Faces and Fonts:: How to change how faces look.
-* Compilation:: How to speed Gnus up.
-* Mode Lines:: Displaying information in the mode lines.
-* Highlighting and Menus:: Making buffers look all nice and cozy.
-* Buttons:: Get tendinitis in ten easy steps!
-* Daemons:: Gnus can do things behind your back.
-* NoCeM:: How to avoid spam and other fatty foods.
-* Undo:: Some actions can be undone.
-* Moderation:: What to do if you're a moderator.
-* XEmacs Enhancements:: There are more pictures and stuff under XEmacs.
-* Fuzzy Matching:: What's the big fuzz?
-* Thwarting Email Spam:: A how-to on avoiding unsolicited commercial email.
-* Various Various:: Things that are really various.
+* Process/Prefix:: A convention used by many treatment commands.
+* Interactive:: Making Gnus ask you many questions.
+* Symbolic Prefixes:: How to supply some Gnus functions with options.
+* Formatting Variables:: You can specify what buffers should look like.
+* Window Layout:: Configuring the Gnus buffer windows.
+* Faces and Fonts:: How to change how faces look.
+* Compilation:: How to speed Gnus up.
+* Mode Lines:: Displaying information in the mode lines.
+* Highlighting and Menus:: Making buffers look all nice and cozy.
+* Buttons:: Get tendinitis in ten easy steps!
+* Daemons:: Gnus can do things behind your back.
+* NoCeM:: How to avoid spam and other fatty foods.
+* Undo:: Some actions can be undone.
+* Moderation:: What to do if you're a moderator.
+* XEmacs Enhancements:: There are more pictures and stuff under XEmacs.
+* Fuzzy Matching:: What's the big fuzz?
+* Thwarting Email Spam:: A how-to on avoiding unsolicited commercial email.
+* Various Various:: Things that are really various.
@end menu
-@node Process/Prefix
+@node Process/Prefix, Interactive, Various, Various
@section Process/Prefix
@cindex process/prefix convention
expirable, you could say `M P b M-& E'.
-@node Interactive
+@node Interactive, Symbolic Prefixes, Process/Prefix, Various
@section Interactive
@cindex interaction
@end table
-@node Symbolic Prefixes
+@node Symbolic Prefixes, Formatting Variables, Interactive, Various
@section Symbolic Prefixes
@cindex symbolic prefixes
Interactive}.
-@node Formatting Variables
+@node Formatting Variables, Window Layout, Symbolic Prefixes, Various
@section Formatting Variables
@cindex formatting variables
lots of percentages everywhere.
@menu
-* Formatting Basics:: A formatting variable is basically a format string.
-* Mode Line Formatting:: Some rules about mode line formatting variables.
-* Advanced Formatting:: Modifying output in various ways.
-* User-Defined Specs:: Having Gnus call your own functions.
-* Formatting Fonts:: Making the formatting look colorful and nice.
-* Positioning Point:: Moving point to a position after an operation.
-* Tabulation:: Tabulating your output.
-* Wide Characters:: Dealing with wide characters.
+* Formatting Basics:: A formatting variable is basically a format string.
+* Mode Line Formatting:: Some rules about mode line formatting variables.
+* Advanced Formatting:: Modifying output in various ways.
+* User-Defined Specs:: Having Gnus call your own functions.
+* Formatting Fonts:: Making the formatting look colorful and nice.
+* Positioning Point:: Moving point to a position after an operation.
+* Tabulation:: Tabulating your output.
+* Wide Characters:: Dealing with wide characters.
@end menu
Currently Gnus uses the following formatting variables:
-@node Formatting Basics
+@node Formatting Basics, Mode Line Formatting, Formatting Variables, Formatting Variables
@subsection Formatting Basics
Each @samp{%} element will be replaced by some string or other when the
less than 4 characters wide.
-@node Mode Line Formatting
+@node Mode Line Formatting, Advanced Formatting, Formatting Basics, Formatting Variables
@subsection Mode Line Formatting
Mode line formatting variables (e.g.,
@end enumerate
-@node Advanced Formatting
+@node Advanced Formatting, User-Defined Specs, Mode Line Formatting, Formatting Variables
@subsection Advanced Formatting
It is frequently useful to post-process the fields in some way.
@xref{Compilation}.
-@node User-Defined Specs
+@node User-Defined Specs, Formatting Fonts, Advanced Formatting, Formatting Variables
@subsection User-Defined Specs
All the specs allow for inserting user defined specifiers---@samp{u}.
inserted.
-@node Formatting Fonts
+@node Formatting Fonts, Positioning Point, User-Defined Specs, Formatting Variables
@subsection Formatting Fonts
There are specs for highlighting, and these are shared by all the format
Note that the @samp{%(} specs (and friends) do not make any sense on the
mode-line variables.
-
-@node Positioning Point
+@node Positioning Point, Tabulation, Formatting Fonts, Formatting Variables
@subsection Positioning Point
Gnus usually moves point to a pre-defined place on each line in most
place point there.
-@node Tabulation
+@node Tabulation, Wide Characters, Positioning Point, Formatting Variables
@subsection Tabulation
You can usually line up your displays by padding and cutting your
50 will be removed. This is the hard tabulator.
-@node Wide Characters
+@node Wide Characters, , Tabulation, Formatting Variables
@subsection Wide Characters
Proportional fonts in most countries have characters of the same width.
-@node Window Layout
+@node Window Layout, Faces and Fonts, Formatting Variables, Various
@section Window Layout
@cindex window layout
@end itemize
-@node Faces and Fonts
+@node Faces and Fonts, Compilation, Window Layout, Various
@section Faces and Fonts
@cindex faces
@cindex fonts
interface.
-@node Compilation
+@node Compilation, Mode Lines, Faces and Fonts, Various
@section Compilation
@cindex compilation
@cindex byte-compilation
them into the @code{.gnus.el} file and byte-compiling that file.)
-@node Mode Lines
+@node Mode Lines, Highlighting and Menus, Compilation, Various
@section Mode Lines
@cindex mode lines
configure this variable appropriately for her configuration.
-@node Highlighting and Menus
+@node Highlighting and Menus, Buttons, Mode Lines, Various
@section Highlighting and Menus
@cindex visual
@cindex highlighting
@end table
-@node Buttons
+@node Buttons, Daemons, Highlighting and Menus, Various
@section Buttons
@cindex buttons
@cindex mouse
the @code{cdr} contains a function symbol, or a simple string.
-@node Daemons
+@node Daemons, NoCeM, Buttons, Various
@section Daemons
@cindex demons
@cindex daemons
behave.
-@node NoCeM
+@node NoCeM, Undo, Daemons, Various
@section NoCeM
@cindex nocem
@cindex spam
unsubscribed groups (@pxref{Subscription Commands}).
-@node Undo
+@node Undo, Moderation, NoCeM, Various
@section Undo
@cindex undo
command.
-@node Moderation
+@node Moderation, XEmacs Enhancements, Undo, Various
@section Moderation
@cindex moderation
@end lisp
-@node XEmacs Enhancements
+@node XEmacs Enhancements, Fuzzy Matching, Moderation, Various
@section XEmacs Enhancements
@cindex XEmacs
advantage of that.
@menu
-* Picons:: How to display pictures of what your reading.
-* Smileys:: Show all those happy faces the way they were meant to be shown.
-* Toolbar:: Click'n'drool.
-* XVarious:: Other XEmacsy Gnusey variables.
+* Picons:: How to display pictures of what your reading.
+* Smileys:: Show all those happy faces the way they were meant to be shown.
+* Toolbar:: Click'n'drool.
+* XVarious:: Other XEmacsy Gnusey variables.
@end menu
-@node Picons
+@node Picons, Smileys, XEmacs Enhancements, XEmacs Enhancements
@subsection Picons
@iftex
over your shoulder as you read news.
@menu
-* Picon Basics:: What are picons and How do I get them.
-* Picon Requirements:: Don't go further if you aren't using XEmacs.
-* Easy Picons:: Displaying Picons---the easy way.
-* Hard Picons:: The way you should do it. You'll learn something.
-* Picon Useless Configuration:: Other variables you can trash/tweak/munge/play with.
+* Picon Basics:: What are picons and How do I get them.
+* Picon Requirements:: Don't go further if you aren't using XEmacs.
+* Easy Picons:: Displaying Picons---the easy way.
+* Hard Picons:: The way you should do it. You'll learn something.
+* Picon Useless Configuration:: Other variables you can trash/tweak/munge/play with.
@end menu
-@node Picon Basics
+@node Picon Basics, Picon Requirements, Picons, Picons
@subsubsection Picon Basics
What are Picons? To quote directly from the Picons Web site:
@code{gnus-picons-database}.
-@node Picon Requirements
+@node Picon Requirements, Easy Picons, Picon Basics, Picons
@subsubsection Picon Requirements
To have Gnus display Picons for you, you must be running XEmacs
@code{gnus-picons-convert-x-face} variable to use something else.
-@node Easy Picons
+@node Easy Picons, Hard Picons, Picon Requirements, Picons
@subsubsection Easy Picons
To enable displaying picons, simply put the following line in your
@end lisp
-@node Hard Picons
+@node Hard Picons, Picon Useless Configuration, Easy Picons, Picons
@subsubsection Hard Picons
@iftex
-@node Picon Useless Configuration
+@node Picon Useless Configuration, , Hard Picons, Picons
@subsubsection Picon Useless Configuration
@iftex
@end table
-@node Smileys
+@node Smileys, Toolbar, Picons, XEmacs Enhancements
@subsection Smileys
@cindex smileys
@end table
-@node Toolbar
+@node Toolbar, XVarious, Smileys, XEmacs Enhancements
@subsection Toolbar
@table @code
@end table
-@node XVarious
+@node XVarious, , Toolbar, XEmacs Enhancements
@subsection Various XEmacs Variables
@table @code
-@node Fuzzy Matching
+@node Fuzzy Matching, Thwarting Email Spam, XEmacs Enhancements, Various
@section Fuzzy Matching
@cindex fuzzy matching
manglers masquerading as newsreaders.
-@node Thwarting Email Spam
+@node Thwarting Email Spam, Various Various, Fuzzy Matching, Various
@section Thwarting Email Spam
@cindex email spam
@cindex spam
to non-existent domains is yucky, in my opinion.
-@node Various Various
+@node Various Various, , Thwarting Email Spam, Various
@section Various Various
@cindex mode lines
@cindex highlights
@end table
-@node The End
+@node The End, Appendices, Various, Top
@chapter The End
Well, that's the manual---you can get on with your life now. Keep in
@end quotation
-@node Appendices
+@node Appendices, Index, The End, Top
@chapter Appendices
@menu
-* History:: How Gnus got where it is today.
-* On Writing Manuals:: Why this is not a beginner's guide.
-* Terminology:: We use really difficult, like, words here.
-* Customization:: Tailoring Gnus to your needs.
-* Troubleshooting:: What you might try if things do not work.
-* Gnus Reference Guide:: Rilly, rilly technical stuff.
-* Emacs for Heathens:: A short introduction to Emacsian terms.
-* Frequently Asked Questions:: A question-and-answer session.
+* History:: How Gnus got where it is today.
+* On Writing Manuals:: Why this is not a beginner's guide.
+* Terminology:: We use really difficult, like, words here.
+* Customization:: Tailoring Gnus to your needs.
+* Troubleshooting:: What you might try if things do not work.
+* Gnus Reference Guide:: Rilly, rilly technical stuff.
+* Emacs for Heathens:: A short introduction to Emacsian terms.
+* Frequently Asked Questions::
@end menu
-@node History
+@node History, On Writing Manuals, Appendices, Appendices
@section History
@cindex history
``@sc{gnus}''. New vs. old.
@menu
-* Gnus Versions:: What Gnus versions have been released.
-* Other Gnus Versions:: Other Gnus versions that also have been released.
-* Why?:: What's the point of Gnus?
-* Compatibility:: Just how compatible is Gnus with @sc{gnus}?
-* Conformity:: Gnus tries to conform to all standards.
-* Emacsen:: Gnus can be run on a few modern Emacsen.
-* Gnus Development:: How Gnus is developed.
-* Contributors:: Oodles of people.
-* New Features:: Pointers to some of the new stuff in Gnus.
+* Gnus Versions:: What Gnus versions have been released.
+* Other Gnus Versions:: Other Gnus versions that also have been released.
+* Why?:: What's the point of Gnus?
+* Compatibility:: Just how compatible is Gnus with @sc{gnus}?
+* Conformity:: Gnus tries to conform to all standards.
+* Emacsen:: Gnus can be run on a few modern Emacsen.
+* Gnus Development:: How Gnus is developed.
+* Contributors:: Oodles of people.
+* New Features:: Pointers to some of the new stuff in Gnus.
@end menu
-@node Gnus Versions
+@node Gnus Versions, Other Gnus Versions, History, History
@subsection Gnus Versions
@cindex Pterodactyl Gnus
@cindex ding Gnus
released version of Gnus and snuggle up to that instead.
-@node Other Gnus Versions
+@node Other Gnus Versions, Why?, Gnus Versions, History
@subsection Other Gnus Versions
@cindex Semi-gnus
Japanese users.
-@node Why?
+@node Why?, Compatibility, Other Gnus Versions, History
@subsection Why?
What's the point of Gnus?
@kbd{C-u 100 M-x all-hail-xemacs}.
-@node Compatibility
+@node Compatibility, Conformity, Why?, History
@subsection Compatibility
@cindex compatibility
up at you.
-@node Conformity
+@node Conformity, Emacsen, Compatibility, History
@subsection Conformity
No rebels without a clue here, ma'am. We conform to all standards known
know.
-@node Emacsen
+@node Emacsen, Gnus Development, Conformity, History
@subsection Emacsen
@cindex Emacsen
@cindex XEmacs
Emacsen.
-@node Gnus Development
+@node Gnus Development, Contributors, Emacsen, History
@subsection Gnus Development
Gnus is developed in a two-phased cycle. The first phase involves much
-@node Contributors
+@node Contributors, New Features, Gnus Development, History
@subsection Contributors
@cindex contributors
actually are people who are using Gnus. Who'd'a thunk it!
-@node New Features
+@node New Features, , Contributors, History
@subsection New Features
@cindex new features
@menu
-* ding Gnus:: New things in Gnus 5.0/5.1, the first new Gnus.
-* September Gnus:: The Thing Formally Known As Gnus 5.2/5.3.
-* Red Gnus:: Third time best---Gnus 5.4/5.5.
-* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7.
-* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9.
+* ding Gnus:: New things in Gnus 5.0/5.1, the first new Gnus.
+* September Gnus:: The Thing Formally Known As Gnus 5.2/5.3.
+* Red Gnus:: Third time best---Gnus 5.4/5.5.
+* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7.
+* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9.
@end menu
These lists are, of course, just @emph{short} overviews of the
@emph{most} important new features. No, really. There are tons more.
Yes, we have feeping creaturism in full effect.
-@node ding Gnus
+@node ding Gnus, September Gnus, New Features, New Features
@subsubsection (ding) Gnus
New features in Gnus 5.0/5.1:
@end itemize
-@node September Gnus
+@node September Gnus, Red Gnus, ding Gnus, New Features
@subsubsection September Gnus
@iftex
@end itemize
-@node Red Gnus
+@node Red Gnus, Quassia Gnus, September Gnus, New Features
@subsubsection Red Gnus
New features in Gnus 5.4/5.5:
@end itemize
-@node Quassia Gnus
+@node Quassia Gnus, Pterodactyl Gnus, Red Gnus, New Features
@subsubsection Quassia Gnus
New features in Gnus 5.6:
@end itemize
-@node Pterodactyl Gnus
+@node Pterodactyl Gnus, , Quassia Gnus, New Features
@subsubsection Pterodactyl Gnus
New features in Gnus 5.8:
@iftex
@page
-@node The Manual
+@node History, On Writing Manuals, History, Appendices
@section The Manual
@cindex colophon
@cindex manual
@end iftex
-@node On Writing Manuals
+@node On Writing Manuals, Terminology, History, Appendices
@section On Writing Manuals
I guess most manuals are written after-the-fact; documenting a program
@page
-@node Terminology
+@node Terminology, Customization, On Writing Manuals, Appendices
@section Terminology
@cindex terminology
@page
-@node Customization
+@node Customization, Troubleshooting, Terminology, Appendices
@section Customization
@cindex general customization
for some quite common situations.
@menu
-* Slow/Expensive Connection:: You run a local Emacs and get the news elsewhere.
-* Slow Terminal Connection:: You run a remote Emacs.
-* Little Disk Space:: You feel that having large setup files is icky.
-* Slow Machine:: You feel like buying a faster machine.
+* Slow/Expensive Connection:: You run a local Emacs and get the news elsewhere.
+* Slow Terminal Connection:: You run a remote Emacs.
+* Little Disk Space:: You feel that having large setup files is icky.
+* Slow Machine:: You feel like buying a faster machine.
@end menu
-@node Slow/Expensive Connection
+@node Slow/Expensive Connection, Slow Terminal Connection, Customization, Customization
@subsection Slow/Expensive @sc{nntp} Connection
If you run Emacs on a machine locally, and get your news from a machine
@end table
-@node Slow Terminal Connection
+@node Slow Terminal Connection, Little Disk Space, Slow/Expensive Connection, Customization
@subsection Slow Terminal Connection
Let's say you use your home computer for dialing up the system that runs
@end table
-@node Little Disk Space
+@node Little Disk Space, Slow Machine, Slow Terminal Connection, Customization
@subsection Little Disk Space
@cindex disk space
@end table
-@node Slow Machine
+@node Slow Machine, , Little Disk Space, Customization
@subsection Slow Machine
@cindex slow machine
@page
-@node Troubleshooting
+@node Troubleshooting, Gnus Reference Guide, Customization, Appendices
@section Troubleshooting
@cindex troubleshooting
@page
-@node Gnus Reference Guide
+@node Gnus Reference Guide, Emacs for Heathens, Troubleshooting, Appendices
@section Gnus Reference Guide
It is my hope that other people will figure out smart stuff that Gnus
and general methods of operation.
@menu
-* Gnus Utility Functions:: Common functions and variable to use.
-* Backend Interface:: How Gnus communicates with the servers.
-* Score File Syntax:: A BNF definition of the score file standard.
-* Headers:: How Gnus stores headers internally.
-* Ranges:: A handy format for storing mucho numbers.
-* Group Info:: The group info format.
-* Extended Interactive:: Symbolic prefixes and stuff.
-* Emacs/XEmacs Code:: Gnus can be run under all modern Emacsen.
-* Various File Formats:: Formats of files that Gnus use.
+* Gnus Utility Functions:: Common functions and variable to use.
+* Backend Interface:: How Gnus communicates with the servers.
+* Score File Syntax:: A BNF definition of the score file standard.
+* Headers:: How Gnus stores headers internally.
+* Ranges:: A handy format for storing mucho numbers.
+* Group Info:: The group info format.
+* Extended Interactive:: Symbolic prefixes and stuff.
+* Emacs/XEmacs Code:: Gnus can be run under all modern Emacsen.
+* Various File Formats:: Formats of files that Gnus use.
@end menu
-@node Gnus Utility Functions
+@node Gnus Utility Functions, Backend Interface, Gnus Reference Guide, Gnus Reference Guide
@subsection Gnus Utility Functions
@cindex Gnus utility functions
@cindex utility functions
@end table
-@node Backend Interface
+@node Backend Interface, Score File Syntax, Gnus Utility Functions, Gnus Reference Guide
@subsection Backend Interface
Gnus doesn't know anything about @sc{nntp}, spools, mail or virtual
@cindex @code{nnchoke}
@menu
-* Required Backend Functions:: Functions that must be implemented.
-* Optional Backend Functions:: Functions that need not be implemented.
-* Error Messaging:: How to get messages and report errors.
-* Writing New Backends:: Extending old backends.
-* Hooking New Backends Into Gnus:: What has to be done on the Gnus end.
-* Mail-like Backends:: Some tips on mail backends.
+* Required Backend Functions:: Functions that must be implemented.
+* Optional Backend Functions:: Functions that need not be implemented.
+* Error Messaging:: How to get messages and report errors.
+* Writing New Backends:: Extending old backends.
+* Hooking New Backends Into Gnus:: What has to be done on the Gnus end.
+* Mail-like Backends:: Some tips on mail backends.
@end menu
-@node Required Backend Functions
+@node Required Backend Functions, Optional Backend Functions, Backend Interface, Backend Interface
@subsubsection Required Backend Functions
@table @code
@end table
-@node Optional Backend Functions
+@node Optional Backend Functions, Error Messaging, Required Backend Functions, Backend Interface
@subsubsection Optional Backend Functions
@table @code
@end table
-@node Error Messaging
+@node Error Messaging, Writing New Backends, Optional Backend Functions, Backend Interface
@subsubsection Error Messaging
@findex nnheader-report
@code{nnchoke-status-string}.
-@node Writing New Backends
+@node Writing New Backends, Hooking New Backends Into Gnus, Error Messaging, Backend Interface
@subsubsection Writing New Backends
Many backends are quite similar. @code{nnml} is just like
@end lisp
-@node Hooking New Backends Into Gnus
+@node Hooking New Backends Into Gnus, Mail-like Backends, Writing New Backends, Backend Interface
@subsubsection Hooking New Backends Into Gnus
@vindex gnus-valid-select-methods
@end table
-@node Mail-like Backends
+@node Mail-like Backends, , Hooking New Backends Into Gnus, Backend Interface
@subsubsection Mail-like Backends
One of the things that separate the mail backends from the rest of the
@end example
-@node Score File Syntax
+@node Score File Syntax, Headers, Backend Interface, Gnus Reference Guide
@subsection Score File Syntax
Score files are meant to be easily parseable, but yet extremely
manual (@pxref{Score File Format}).
-@node Headers
+@node Headers, Ranges, Score File Syntax, Gnus Reference Guide
@subsection Headers
Internally Gnus uses a format for storing article headers that
contains an alist of header/value pairs (@pxref{To From Newsgroups}).
-@node Ranges
+@node Ranges, Group Info, Headers, Gnus Reference Guide
@subsection Ranges
@sc{gnus} introduced a concept that I found so useful that I've started
sequences.)
-@node Group Info
+@node Group Info, Extended Interactive, Ranges, Gnus Reference Guide
@subsection Group Info
Gnus stores all permanent info on groups in a @dfn{group info} list.
the three final setter functions to have this happen automatically.
-@node Extended Interactive
+@node Extended Interactive, Emacs/XEmacs Code, Group Info, Gnus Reference Guide
@subsection Extended Interactive
@cindex interactive
@findex gnus-interactive
@end table
-@node Emacs/XEmacs Code
+@node Emacs/XEmacs Code, Various File Formats, Extended Interactive, Gnus Reference Guide
@subsection Emacs/XEmacs Code
@cindex XEmacs
@cindex Emacsen
hit these indirections impose on Gnus under XEmacs should be slight.
-@node Various File Formats
+@node Various File Formats, , Emacs/XEmacs Code, Gnus Reference Guide
@subsection Various File Formats
@menu
-* Active File Format:: Information on articles and groups available.
-* Newsgroups File Format:: Group descriptions.
+* Active File Format:: Information on articles and groups available.
+* Newsgroups File Format:: Group descriptions.
@end menu
-@node Active File Format
+@node Active File Format, Newsgroups File Format, Various File Formats, Various File Formats
@subsubsection Active File Format
The active file lists all groups available on the server in
@samp{innd}, in particular @samp{active(5)}.
-@node Newsgroups File Format
+@node Newsgroups File Format, , Active File Format, Various File Formats
@subsubsection Newsgroups File Format
The newsgroups file lists groups along with their descriptions. Not all
@page
-@node Emacs for Heathens
+@node Emacs for Heathens, , Gnus Reference Guide, Appendices
@section Emacs for Heathens
Believe it or not, but some people who use Gnus haven't really used
cat instead.
@menu
-* Keystrokes:: Entering text and executing commands.
-* Emacs Lisp:: The built-in Emacs programming language.
+* Keystrokes:: Entering text and executing commands.
+* Emacs Lisp:: The built-in Emacs programming language.
@end menu
-@node Keystrokes
+@node Keystrokes, Emacs Lisp, Emacs for Heathens, Emacs for Heathens
@subsection Keystrokes
@itemize @bullet
-@node Emacs Lisp
+@node Emacs Lisp, , Keystrokes, Emacs for Heathens
@subsection Emacs Lisp
Emacs is the King of Editors because it's really a Lisp interpreter.
@page
@include gnus-faq.texi
-@node Index
+@node Index, Key Index, Appendices, Top
@chapter Index
@printindex cp
-@node Key Index
+@node Key Index, , Index, Top
@chapter Key Index
@printindex ky