unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#25626: 25.1; doc of `bufferpos-to-filepos' for type `exact'
@ 2017-02-05 17:20 Drew Adams
  2017-02-05 18:34 ` Eli Zaretskii
  0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2017-02-05 17:20 UTC (permalink / raw)
  To: 25626

The doc string says this:

  ‘exact’, in which case we may end up re-(en/de)coding a large
    part of the file/buffer.

And (elisp) `Text Representations' says this:

  ‘exact’
    The result must be accurate.  The function may need to encode
    and decode a large part of the buffer.

If I understand the code right, I think both of these are misleading.
They can give the impression that the text in the region can have its
encoding changed in its buffer.

But when `bufferpos-to-filepos' encodes some text it puts the resulting
text in a different, temporary buffer, and returns its position - the
original text (in the original buffer) does not have its encoding
changed.

Please consider clarifying this, so that it lets users know that the
encoding cost of `exact' is only one of performance and that the buffer
text is not changed in any way (in particular, its encoding is not
changed).

Or if I'm mistaken, and it does possibly change the encoding of some of
the buffer text, then please consider clarifying the doc to state this
explicitly.

In other words, please elaborate on (clarify) what is meant by "may need
to encode and decode a large part of the buffer" and "may end up
re-(en/de)coding a large part of the file/buffer".

In GNU Emacs 25.1.1 (x86_64-w64-mingw32)
 of 2016-11-15
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --without-dbus --without-compress-install 'CFLAGS=-O2
 -static -g3''





^ permalink raw reply	[flat|nested] 5+ messages in thread
[parent not found: <<8d705983-882e-48fb-a171-3fa9f025ac4f@default>]

end of thread, other threads:[~2017-02-05 20:22 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-02-05 17:20 bug#25626: 25.1; doc of `bufferpos-to-filepos' for type `exact' Drew Adams
2017-02-05 18:34 ` Eli Zaretskii
2017-02-05 18:58   ` Drew Adams
2017-02-05 19:56     ` Eli Zaretskii
     [not found] <<8d705983-882e-48fb-a171-3fa9f025ac4f@default>
     [not found] ` <<83tw887ahx.fsf@gnu.org>
     [not found]   ` <<bcc4886f-9b9b-4ab4-bc05-51cdbff5e639@default>
     [not found]     ` <<83mve076p9.fsf@gnu.org>
2017-02-05 20:22       ` Drew Adams

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).