Re: xdisp.c's struct it questions.

[Alan Mackenzie]

Hello again, Eli.

On Sat, Oct 03, 2015 at 07:09:09PM +0300, Eli Zaretskii wrote:
> > Date: Sat, 3 Oct 2015 15:48:36 +0000
> > From: Alan Mackenzie <address@hidden>

> > I'm trying to get some stuff in xdisp.c working.  It's hard.

> My sympathies.  Please consider recording in the comments everything
> you learn that isn't already there.  Let's take something positive and
> useful from your ordeal ;-)

The biggest time sink for me at the moment is the vagueness in xdisp.c's
use of the word "line".  Sometimes it means a screen line, sometimes it
means a text line.

An example is `forward_to_next_line_start'.  It sounds like just what I
need, but is it?  If it were called `forward_to_next_screen_line_start',
or `forward_to_next_text_line_start', I could save myself an awful lot
of poring through source code.  Even the comments preceding these
routines tend to be vague about this.

A positive example is `move_it_in_display_line_to', which is explicit
about what sort of line it means.

-- 
Alan Mackenzie (Nuremberg, Germany).