From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: Proposal: new mode-line `%'-construct %o meaning "Degree of
	travel of window through buffer".
Date: Mon, 22 May 2017 07:13:50 +0300
Message-ID: <83bmqlo7ep.fsf@gnu.org>
References: <20170515204416.GA7349@acm.fritz.box>
	<CAM-tV-9h2OTVp_sO86U4n4JZC2U_iftHaEj63WsLKOQxhdKwDQ@mail.gmail.com>
	<20170517211552.2a4dab7e@jabberwock.cb.piermont.com>
	<8360gy6b5y.fsf@gnu.org>
	<20170518120116.161c1098@jabberwock.cb.piermont.com>
	<83r2zm3zqz.fsf@gnu.org>
	<20170518124541.4cce1567@jabberwock.cb.piermont.com>
	<83pof63q9f.fsf@gnu.org>
	<20170518161304.456e6dce@jabberwock.cb.piermont.com>
	<83lgpt52uh.fsf@gnu.org>
	<20170518165124.7f19ef9b@jabberwock.cb.piermont.com>
	<83fug14bg0.fsf@gnu.org>
	<CAFyQvY3ZMgW3WOgXhzZtYoej=jpDvLg790+z19-PiRykO_jGhw@mail.gmail.com>
Reply-To: Eli Zaretskii <eliz@gnu.org>
NNTP-Posting-Host: blaine.gmane.org
X-Trace: blaine.gmane.org 1495426480 5568 195.159.176.226 (22 May 2017 04:14:40 GMT)
X-Complaints-To: usenet@blaine.gmane.org
NNTP-Posting-Date: Mon, 22 May 2017 04:14:40 +0000 (UTC)
Cc: acm@muc.de, emacs-devel@gnu.org
To: Kaushal Modi <kaushal.modi@gmail.com>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon May 22 06:14:37 2017
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane.org
Original-Received: from lists.gnu.org ([208.118.235.17])
	by blaine.gmane.org with esmtp (Exim 4.84_2)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1dCejs-0001LP-MJ
	for ged-emacs-devel@m.gmane.org; Mon, 22 May 2017 06:14:36 +0200
Original-Received: from localhost ([::1]:40300 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1dCejy-000486-5D
	for ged-emacs-devel@m.gmane.org; Mon, 22 May 2017 00:14:42 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38072)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <eliz@gnu.org>) id 1dCejT-0003tt-Dg
	for emacs-devel@gnu.org; Mon, 22 May 2017 00:14:12 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <eliz@gnu.org>) id 1dCejM-0006sM-69
	for emacs-devel@gnu.org; Mon, 22 May 2017 00:14:08 -0400
Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53497)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <eliz@gnu.org>)
	id 1dCejM-0006sG-2R; Mon, 22 May 2017 00:14:04 -0400
Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4264
	helo=home-c4e4a596f7)
	by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
	(Exim 4.82) (envelope-from <eliz@gnu.org>)
	id 1dCejL-0007hr-8o; Mon, 22 May 2017 00:14:03 -0400
In-reply-to: <CAFyQvY3ZMgW3WOgXhzZtYoej=jpDvLg790+z19-PiRykO_jGhw@mail.gmail.com>
	(message from Kaushal Modi on Mon, 22 May 2017 02:22:49 +0000)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-devel/>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Original-Sender: "Emacs-devel" <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.devel:215081
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/215081>

> From: Kaushal Modi <kaushal.modi@gmail.com>
> Date: Mon, 22 May 2017 02:22:49 +0000
> Cc: emacs-devel@gnu.org
> 
> +This option is a list where the first element specifies the field
> +width to space-fill or truncate to, and the second element specifies
> +the type of buffer offset to display in `mode-line-position'.

Our style for documenting Lisp data structures is less abstract:

  This option's value is a list of the form (WIDTH TYPE),
  where WIDTH specifies ...