From 7dcf717b1a0b7ade4a8c69d17f0c8245e5de2d32 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Wed, 20 Feb 2013 18:42:30 -0800 Subject: [PATCH] Port documentation to Texinfo 5.0. --- doc/lispintro/emacs-lisp-intro.texi | 2 +- doc/misc/eshell.texi | 6 +++--- doc/misc/gnus-faq.texi | 8 ++++---- doc/misc/gnus.texi | 12 +++++++++++- doc/misc/semantic.texi | 2 +- doc/misc/speedbar.texi | 2 +- doc/misc/tramp.texi | 6 +++--- 7 files changed, 24 insertions(+), 14 deletions(-) diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index 3366ad6e7f7..3f9208c3c27 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -4583,7 +4583,7 @@ argument to the value returned by its second argument. @item buffer-name Without an argument, return the name of the buffer, as a string. -@itemx buffer-file-name +@item buffer-file-name Without an argument, return the name of the file the buffer is visiting. diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index 3bef6a4595c..ec01f731daf 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi @@ -83,8 +83,8 @@ handling the sort of tasks accomplished by those tools. * GNU Free Documentation License:: The license for this documentation. * Concept Index:: * Function and Variable Index:: -* Key Index:: * Command Index:: +* Key Index:: @end menu @node What is Eshell? @@ -285,8 +285,8 @@ history and invoking commands in a script file. @menu * Invocation:: * Arguments:: -* Variables:: * Built-ins:: +* Variables:: * Aliases:: * History:: * Completion:: @@ -465,7 +465,7 @@ Uses TRAMP's @command{su} or @command{sudo} method to run a command via @end table -@section Built-in variables +@subsection Built-in variables Eshell knows a few built-in variables: @table @code diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index e7367730040..ede957a5c35 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi @@ -3,8 +3,8 @@ @c %**start of header @c Copyright (C) 1995, 2001-2013 Free Software Foundation, Inc. @c -@setfilename gnus-faq.info -@settitle Frequently Asked Questions +@c @setfilename gnus-faq.info +@c @settitle Frequently Asked Questions @c %**end of header @c @@ -41,7 +41,7 @@ Please submit features and suggestions to the @email{ding@@gnus.org, ding list}. @node FAQ - Changes -@subheading Changes +@subsection Changes @@ -57,7 +57,7 @@ reference to discontinued service. @end itemize @node FAQ - Introduction -@subheading Introduction +@subsection Introduction This is the Gnus Frequently Asked Questions list. diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 65e2ce6150e..983887d721d 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -14541,6 +14541,7 @@ maildir, for instance. @menu * Mail Source Specifiers:: How to specify what a mail source is. +* Mail Source Functions:: * Mail Source Customization:: Some variables that influence things. * Fetching Mail:: Using the mail source specifiers. @end menu @@ -15000,6 +15001,7 @@ useful when you use local mail and news. @end table @end table +@node Mail Source Functions @subsubsection Function Interface Some of the above keywords specify a Lisp function to be executed. @@ -16068,6 +16070,10 @@ Spool}). * Mail Spool:: Store your mail in a private spool? * MH Spool:: An mhspool-like back end. * Maildir:: Another one-file-per-message format. +* nnmaildir Group Parameters:: +* Article Identification:: +* NOV Data:: +* Article Marks:: * Mail Folders:: Having one file for each group. * Comparing Mail Back Ends:: An in-depth looks at pros and cons. @end menu @@ -16375,6 +16381,7 @@ different in the future. If your split rules create new groups, remember to supply a @code{create-directory} server parameter. @end table +@node nnmaildir Group Parameters @subsubsection Group parameters @code{nnmaildir} uses several group parameters. It's safe to ignore @@ -16485,6 +16492,7 @@ that are either marked with @code{tick} or not marked with @code{read}, plus a little extra. @end table +@node Article Identification @subsubsection Article identification Articles are stored in the @file{cur/} subdirectory of each maildir. Each article file is named like @code{uniq:info}, where @code{uniq} @@ -16497,6 +16505,7 @@ about the corresponding article. The full pathname of an article is available in the variable @code{nnmaildir-article-file-name} after you request the article in the summary buffer. +@node NOV Data @subsubsection NOV data An article identified by @code{uniq} has its @acronym{NOV} data (used to generate lines in the summary buffer) stored in @@ -16510,6 +16519,7 @@ file, but @emph{beware}: this will also cause @code{nnmaildir} to assign a new article number for this article, which may cause trouble with @code{seen} marks, the Agent, and the cache. +@node Article Marks @subsubsection Article marks An article identified by @code{uniq} is considered to have the mark @code{flag} when the file @file{.nnmaildir/marks/flag/uniq} exists. @@ -25850,8 +25860,8 @@ of all messages matching a particular set of criteria. @menu * Gnus Registry Setup:: -* Fancy splitting to parent:: * Registry Article Refer Method:: +* Fancy splitting to parent:: * Store custom flags and keywords:: * Store arbitrary data:: @end menu diff --git a/doc/misc/semantic.texi b/doc/misc/semantic.texi index de5019ee897..f43316f5012 100644 --- a/doc/misc/semantic.texi +++ b/doc/misc/semantic.texi @@ -520,7 +520,7 @@ Regression tests from the older Semantic 1.x API. @node Glossary @appendix Glossary -@table @keyword +@table @asis @item BNF In semantic 1.4, a BNF file represented ``Bovine Normal Form'', the grammar file used for the 1.4 parser generator. This was a play on diff --git a/doc/misc/speedbar.texi b/doc/misc/speedbar.texi index 7227e2597ae..3cb0ec3aed8 100644 --- a/doc/misc/speedbar.texi +++ b/doc/misc/speedbar.texi @@ -223,7 +223,7 @@ Text in speedbar consists of four different types of data. Knowing how to read these textual elements will make it easier to navigate by identifying the types of data available. -@subsubsection Groups +@subsection Groups @cindex groups Groups summarize information in a single line, and provide a high level diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 807e6b4db29..f1dac493054 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -144,9 +144,6 @@ For the end user: * Usage:: An overview of the operation of @value{tramp}. * Bug Reports:: Reporting Bugs and Problems. * Frequently Asked Questions:: Questions and answers from the mailing list. -* Function Index:: @value{tramp} functions. -* Variable Index:: User options and variables. -* Concept Index:: An item for each concept. For the developer: @@ -155,6 +152,9 @@ For the developer: * Issues:: Debatable Issues and What Was Decided. * GNU Free Documentation License:: The license for this documentation. +* Function Index:: @value{tramp} functions. +* Variable Index:: User options and variables. +* Concept Index:: An item for each concept. @detailmenu --- The Detailed Node Listing --- -- 2.11.4.GIT