diff options
author | Chong Yidong <cyd@stupidchicken.com> | 2011-02-05 01:13:36 -0500 |
---|---|---|
committer | Chong Yidong <cyd@stupidchicken.com> | 2011-02-05 01:13:36 -0500 |
commit | a41c866068bc9428c5ba354d53d0dd4abd829d6f (patch) | |
tree | 663e85f8af7b57f82c52d28457ae3a295396e5ee /doc | |
parent | 9ad53e98fd3ac179a8498e867f7fc59bd9de0de3 (diff) | |
download | emacs-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/ChangeLog | 9 | ||||
-rw-r--r-- | doc/emacs/maintaining.texi | 29 | ||||
-rw-r--r-- | doc/emacs/rmail.texi | 24 | ||||
-rw-r--r-- | doc/lispref/ChangeLog | 5 | ||||
-rw-r--r-- | doc/lispref/commands.texi | 15 |
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 |