diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/ChangeLog | 18 | ||||
| -rw-r--r-- | man/calc.texi | 38 | ||||
| -rw-r--r-- | man/files.texi | 5 | ||||
| -rw-r--r-- | man/glossary.texi | 3 | ||||
| -rw-r--r-- | man/gnus.texi | 42 | ||||
| -rw-r--r-- | man/sieve.texi | 4 |
6 files changed, 93 insertions, 17 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index 18cd4b72bc6..2395e82fdbb 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,8 +1,26 @@ +2007-08-10 Katsumi Yamaoka <yamaoka@jpl.org> + + * gnus.texi (NNTP): Mention nntp-xref-number-is-evil. + +2007-08-08 Glenn Morris <rgm@gnu.org> + + * glossary.texi (Glossary): Deprecate `iff'. + * gnus.texi, sieve.texi: Replace `iff'. + +2007-08-07 Chong Yidong <cyd@stupidchicken.com> + + * files.texi (File Conveniences): Document point motion keys in Image + mode. + 2007-08-03 Jay Belanger <jay.p.belanger@gmail.com> * calc.texi (Basic Graphics): Mention the graphing of error forms. (Graphics Options): Mention how `g s' handles error forms. + (Curve Fitting): Mention plotting the curves. + (Standard Nonlinear Models): Add additional models. + (Curve Fitting Details): Mention the Levenberg-Marquardt method. + (Linear Fits): Correct result. 2007-08-01 Alan Mackenzie <acm@muc.de> diff --git a/man/calc.texi b/man/calc.texi index 9e50629a3b2..e13dd9097d6 100644 --- a/man/calc.texi +++ b/man/calc.texi @@ -23962,7 +23962,13 @@ such as @expr{y = m x + b} where @expr{m} and @expr{b} are parameters to be determined. For a typical set of measured data there will be no single @expr{m} and @expr{b} that exactly fit the data; in this case, Calc chooses values of the parameters that provide the closest -possible fit. +possible fit. The model formula can be entered in various ways after +the key sequence @kbd{a F} is pressed. + +If the letter @kbd{P} is pressed after @kbd{a F} but before the model +description is entered, the data as well as the model formula will be +plotted after the formula is determined. This will be indicated by a +``P'' in the minibuffer after the help message. @menu * Linear Fits:: @@ -24055,7 +24061,7 @@ $$ @noindent is on the stack and we wish to do a simple linear fit. Type @kbd{a F}, then @kbd{1} for the model, then @key{RET} to use -the default names. The result will be the formula @expr{3 + 2 x} +the default names. The result will be the formula @expr{3. + 2. x} on the stack. Calc has created the model expression @kbd{a + b x}, then found the optimal values of @expr{a} and @expr{b} to fit the data. (In this case, it was able to find an exact fit.) Calc then @@ -24245,6 +24251,8 @@ case, the model might be @expr{a x + b y + c z}; and in the polynomial case, the model could be @expr{a x + b x^2 + c x^3}. You can get a homogeneous linear or multilinear model by pressing the letter @kbd{h} followed by a regular model key, like @kbd{1} or @kbd{2}. +This will be indicated by an ``h'' in the minibuffer after the help +message. It is certainly possible to have other constrained linear models, like @expr{2.3 + a x} or @expr{a - 4 x}. While there is no single @@ -24454,6 +24462,18 @@ Quadratic. @mathit{a + b (x-c)^2 + d (x-e)^2}. Gaussian. @texline @math{{a \over b \sqrt{2 \pi}} \exp\left( -{1 \over 2} \left( x - c \over b \right)^2 \right)}. @infoline @mathit{(a / b sqrt(2 pi)) exp(-0.5*((x-c)/b)^2)}. +@item s +Logistic @emph{s} curve. +@texline @math{a/(1+e^{b(x-c)})}. +@infoline @mathit{a/(1 + exp(b (x - c)))}. +@item b +Logistic bell curve. +@texline @math{ae^{b(x-c)}/(1+e^{b(x-c)})^2}. +@infoline @mathit{a exp(b (x - c))/(1 + exp(b (x - c)))^2}. +@item o +Hubbert linearization. +@texline @math{{y \over x} = a(1-x/b)}. +@infoline @mathit{(y/x) = a (1 - x/b)}. @end table All of these models are used in the usual way; just press the appropriate @@ -24462,8 +24482,9 @@ result will be a formula as shown in the above table, with the best-fit values of the parameters substituted. (You may find it easier to read the parameter values from the vector that is placed in the trail.) -All models except Gaussian and polynomials can generalize as shown to any -number of independent variables. Also, all the built-in models have an +All models except Gaussian, logistics, Hubbert and polynomials can +generalize as shown to any number of independent variables. Also, all +the built-in models except for the logistic and Hubbert curves have an additive or multiplicative parameter shown as @expr{a} in the above table which can be replaced by zero or one, as appropriate, by typing @kbd{h} before the model key. @@ -24603,7 +24624,7 @@ to convert the model into this form. For example, if the model is @expr{a + b x + c x^2}, then @expr{f(x) = 1}, @expr{g(x) = x}, and @expr{h(x) = x^2} are suitable functions. -For other models, Calc uses a variety of algebraic manipulations +For most other models, Calc uses a variety of algebraic manipulations to try to put the problem into the form @smallexample @@ -24662,7 +24683,12 @@ The Gaussian model looks quite complicated, but a closer examination shows that it's actually similar to the quadratic model but with an exponential that can be brought to the top and moved into @expr{Y}. -An example of a model that cannot be put into general linear +The logistic models cannot be put into general linear form. For these +models, and the Hubbert linearization, Calc computes a rough +approximation for the parameters, then uses the Levenberg-Marquardt +iterative method to refine the approximations. + +Another model that cannot be put into general linear form is a Gaussian with a constant background added on, i.e., @expr{d} + the regular Gaussian formula. If you have a model like this, your best bet is to replace enough of your parameters with diff --git a/man/files.texi b/man/files.texi index 747b0dba806..7ba36916684 100644 --- a/man/files.texi +++ b/man/files.texi @@ -2898,7 +2898,10 @@ point. Partial Completion mode offers other features extending mode allows you to toggle between displaying the file as an image in the Emacs buffer, and displaying its underlying text representation, using the command @kbd{C-c C-c} (@code{image-toggle-display}). This -works only when Emacs can display the specific image type. +works only when Emacs can display the specific image type. If the +displayed image is wider or taller than the frame, the usual point +motion keys (@kbd{C-f}, @kbd{C-p}, and so forth) cause different parts +of the image to be displayed. @findex thumbs-mode @findex mode, thumbs diff --git a/man/glossary.texi b/man/glossary.texi index d082e6ec077..f289c2ca1cb 100644 --- a/man/glossary.texi +++ b/man/glossary.texi @@ -603,7 +603,8 @@ Hyper}. @item Iff ``Iff'' means ``if and only if.'' This terminology comes from -mathematics. +mathematics. Try to avoid using this term in documentation, since +many are unfamiliar with it and mistake it for a typo. @item Inbox An inbox is a file in which mail is delivered by the operating system. diff --git a/man/gnus.texi b/man/gnus.texi index fe26aa5f662..94144b65e3f 100644 --- a/man/gnus.texi +++ b/man/gnus.texi @@ -12945,6 +12945,34 @@ network is fast, setting this variable to a really small number means that fetching will probably be slower. If this variable is @code{nil}, @code{nntp} will never split requests. The default is 5. +@item nntp-xref-number-is-evil +@vindex nntp-xref-number-is-evil +When Gnus refers to an article having the @code{Message-ID} that a user +specifies or having the @code{Message-ID} of the parent article of the +current one (@pxref{Finding the Parent}), Gnus sends a @code{HEAD} +command to the @acronym{NNTP} server to know where it is, and the server +returns the data containing the pairs of a group and an article number +in the @code{Xref} header. Gnus normally uses the article number to +refer to the article if the data shows that that article is in the +current group, while it uses the @code{Message-ID} otherwise. However, +some news servers, e.g., ones running Diablo, run multiple engines +having the same articles but article numbers are not kept synchronized +between them. In that case, the article number that appears in the +@code{Xref} header varies by which engine is chosen, so you cannot refer +to the parent article that is in the current group, for instance. If +you connect to such a server, set this variable to a non-@code{nil} +value, and Gnus never uses article numbers. For example: + +@lisp +(setq gnus-select-method + '(nntp "newszilla" + (nntp-address "newszilla.example.com") + (nntp-xref-number-is-evil t) + @dots{})) +@end lisp + +The default value of this server variable is @code{nil}. + @item nntp-prepare-server-hook @vindex nntp-prepare-server-hook A hook run before attempting to connect to an @acronym{NNTP} server. @@ -18595,23 +18623,23 @@ predicate to individual groups. @table @code @item short -True iff the article is shorter than @code{gnus-agent-short-article} +True if the article is shorter than @code{gnus-agent-short-article} lines; default 100. @item long -True iff the article is longer than @code{gnus-agent-long-article} +True if the article is longer than @code{gnus-agent-long-article} lines; default 200. @item low -True iff the article has a download score less than +True if the article has a download score less than @code{gnus-agent-low-score}; default 0. @item high -True iff the article has a download score greater than +True if the article has a download score greater than @code{gnus-agent-high-score}; default 0. @item spam -True iff the Gnus Agent guesses that the article is spam. The +True if the Gnus Agent guesses that the article is spam. The heuristics may change over time, but at present it just computes a checksum and sees whether articles match. @@ -26651,7 +26679,7 @@ New @file{make.bat} for compiling and installing Gnus under MS Windows Use @file{make.bat} if you want to install Gnus under MS Windows, the first argument to the batch-program should be the directory where -@file{xemacs.exe} respectively @file{emacs.exe} is located, iff you want +@file{xemacs.exe} respectively @file{emacs.exe} is located, if you want to install Gnus after compiling it, give @file{make.bat} @code{/copy} as the second parameter. @@ -27008,7 +27036,7 @@ The envelope sender address can be customized when using Sendmail. @item Gnus no longer generate the Sender: header automatically. -Earlier it was generated iff the user configurable email address was +Earlier it was generated when the user configurable email address was different from the Gnus guessed default user address. As the guessing algorithm is rarely correct these days, and (more controversially) the only use of the Sender: header was to check if you are entitled to diff --git a/man/sieve.texi b/man/sieve.texi index 1030babd593..4b7a95be952 100644 --- a/man/sieve.texi +++ b/man/sieve.texi @@ -307,7 +307,7 @@ Authenticate to the server. @item sieve-manage-capability @findex sieve-manage-capability -Return a list of capabilities the server support. +Return a list of capabilities the server supports. @item sieve-manage-listscripts @findex sieve-manage-listscripts @@ -315,7 +315,7 @@ List scripts on the server. @item sieve-manage-havespace @findex sieve-manage-havespace -Returns non-@code{nil} iff server have roam for a script of given +Return non-@code{nil} if the server has room for a script of given size. @item sieve-manage-getscript |