summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorChong Yidong <cyd@stupidchicken.com>2011-02-05 01:13:36 -0500
committerChong Yidong <cyd@stupidchicken.com>2011-02-05 01:13:36 -0500
commita41c866068bc9428c5ba354d53d0dd4abd829d6f (patch)
tree663e85f8af7b57f82c52d28457ae3a295396e5ee /doc
parent9ad53e98fd3ac179a8498e867f7fc59bd9de0de3 (diff)
downloademacs-a41c866068bc9428c5ba354d53d0dd4abd829d6f.tar.gz
Last remaining doc additions required by 23.3.
* doc/emacs/maintaining.texi (VC Change Log): Document vc-log-incoming and vc-log-outgoing. (Merging): Document vc-find-conflicted-file. * doc/emacs/rmail.texi (Rmail Display): Document Rmail MIME support more accurately. * doc/lispref/commands.texi (Accessing Mouse): Note that a header line is not included in the row of posn-col-row. * etc/NEWS: Remove +++ and --- lines.
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/ChangeLog9
-rw-r--r--doc/emacs/maintaining.texi29
-rw-r--r--doc/emacs/rmail.texi24
-rw-r--r--doc/lispref/ChangeLog5
-rw-r--r--doc/lispref/commands.texi15
5 files changed, 70 insertions, 12 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 20e672f9ab6..b89f9226c3b 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,12 @@
+2011-02-05 Chong Yidong <cyd@stupidchicken.com>
+
+ * rmail.texi (Rmail Display): Document Rmail MIME support more
+ accurately.
+
+ * maintaining.texi (VC Change Log): Document vc-log-incoming and
+ vc-log-outgoing.
+ (Merging): Document vc-find-conflicted-file.
+
2011-02-04 Glenn Morris <rgm@gnu.org>
* custom.texi (Variables): Fix typo.
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index ccbea017c91..f7be0015ffa 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -900,6 +900,14 @@ Display revision control state and change history
@item C-x v L
Display the change history for the current repository
(@code{vc-print-root-log}).
+
+@item C-x v I
+Display the changes that will be received with a pull operation
+(@code{vc-log-incoming}).
+
+@item C-x v O
+Display the changes that will be sent by the next push operation
+(@code{vc-log-outgoing}).
@end table
@kindex C-x v l
@@ -921,6 +929,19 @@ version-controlled directory tree as a whole. With a prefix argument,
the command prompts for the maximum number of revisions to display.
RCS, SCCS, and CVS do not support this feature.
+ On a distributed version control system, the @kbd{C-x v I}
+(@code{vc-log-incoming}) command displays a log buffer showing the
+changes that will be applied, the next time you run the version
+control system's ``pull'' command to get new revisions from another
+repository. This other repository is the default one from which
+changes are pulled, as defined by the version control system; with a
+prefix argument, @code{vc-log-incoming} prompts for a specific
+repository from which changes would be pulled, and lists the changes
+accordingly. Similarly, @kbd{C-x v O} (@code{vc-log-outgoing}) shows
+the changes that will be sent to another repository, the next time you
+run the ``push'' command; with a prefix argument, it prompts for a
+specific repository to which changes would be pushed.
+
In the @samp{*vc-change-log*} buffer, you can use the following keys
to move between the logs of revisions and of files, to view past
revisions, to modify change comments, to view annotations and to view
@@ -1374,12 +1395,18 @@ master file revision with user B's changes in it is 1.11.
@end group
@end smallexample
-@cindex vc-resolve-conflicts
+@findex vc-resolve-conflicts
Then you can resolve the conflicts by editing the file manually. Or
you can type @code{M-x vc-resolve-conflicts} after visiting the file.
This starts an Ediff session, as described above. Don't forget to
commit the merged version afterwards.
+@findex vc-find-conflicted-file
+ If there is more than one conflicted file in a merge, type @kbd{M-x
+vc-find-conflicted-file} after resolving the conflicts in each file.
+This command visits the next conflicted file, and moves point to the
+first conflict marker in that file.
+
@node Multi-User Branching
@subsubsection Multi-User Branching
diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi
index 633ffa89de0..1c2cf797c1f 100644
--- a/doc/emacs/rmail.texi
+++ b/doc/emacs/rmail.texi
@@ -1143,12 +1143,12 @@ feature, set @code{rmail-highlighted-headers} to @code{nil}.
@cindex MIME messages (Rmail)
@vindex rmail-enable-mime
- By default, Rmail automatically decodes @acronym{MIME} (Multipurpose
-Internet Mail Extensions) messages. If the message contains multiple
-parts (@acronym{MIME} entities), each part is represented by a tagline
-in the Rmail buffer. The tagline summarizes the part's depth, index,
-and type, and may also contain a button for handling it, e.g. saving
-it to a file or displaying it as an image in the Rmail buffer.
+ If a message is in @acronym{MIME} (Multipurpose Internet Mail
+Extensions) format and contains multiple parts (@acronym{MIME}
+entities), Rmail displays each part with a @dfn{tagline}. The tagline
+summarizes the part's index, size, and content type. Depending on the
+content type, it may also contain one or more buttons; these perform
+actions such as saving the part into a file.
@table @kbd
@findex rmail-mime-toggle-hidden
@@ -1158,7 +1158,7 @@ Hide or show the @acronym{MIME} part at point
@findex rmail-mime-next-item
@item @key{TAB}
-Move point to the next @acronym{MIME} part
+Move point to the next @acronym{MIME} tagline button.
(@code{rmail-mime-next-item}).
@findex rmail-mime-previous-item
@@ -1173,6 +1173,16 @@ Toggle between @acronym{MIME} display and raw message
(@code{rmail-mime}).
@end table
+ Each plain-text @acronym{MIME} part is initially displayed
+immediately after its tagline, as part of the Rmail buffer, while
+@acronym{MIME} parts of other types are represented only by their
+taglines, with their actual contents hidden. In either case, you can
+toggle a @acronym{MIME} part between its ``displayed'' and ``hidden''
+states by typing @key{RET} anywhere in the part---or anywhere in its
+tagline, apart from a tagline button for some other action. Type
+@key{RET} (or click with the mouse) to activate a tagline button, and
+@key{TAB} to cycle point between tagline buttons.
+
The @kbd{v} (@code{rmail-mime}) command toggles between the default
@acronym{MIME} display described above, and a ``raw'' display showing
the undecoded @acronym{MIME} data. With a prefix argument, this
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index c651c5cab89..56f35ef3296 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-02-05 Chong Yidong <cyd@stupidchicken.com>
+
+ * commands.texi (Accessing Mouse): Note that a header line is not
+ included in the row of posn-col-row.
+
2011-01-28 Chong Yidong <cyd@stupidchicken.com>
* vol1.texi (Top):
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 2e0c020a5bb..91aae9594bb 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -1917,10 +1917,17 @@ into frame-relative coordinates:
@end defun
@defun posn-col-row position
-Return the row and column (in units of the frame's default character
-height and width) of @var{position}, as a cons cell @code{(@var{col} .
-@var{row})}. These are computed from the @var{x} and @var{y} values
-actually found in @var{position}.
+This function returns a cons cell @code{(@var{col} . @var{row})},
+containing the estimated column and row corresponding to buffer
+position @var{position}. The return value is given in units of the
+frame's default character width and height, as computed from the
+@var{x} and @var{y} values corresponding to @var{position}. (So, if
+the actual characters have non-default sizes, the actual row and
+column may differ from these computed values.)
+
+Note that @var{row} is counted from the top of the text area. If the
+window possesses a header line (@pxref{Header Lines}), it is
+@emph{not} counted as the first line.
@end defun
@defun posn-actual-col-row position