From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: make-vector documentation is wrong
Date: Fri, 15 May 2020 12:58:27 +0300
Message-ID: <83k11d34fw.fsf@gnu.org>
References: <0430a770-2bb8-2d46-9b28-420c8a6e0a24@dancol.org>
 <5bcc3508-9d65-c5b4-255e-898f8e1dc3c1@cs.ucla.edu>
 <jwv8shtna1j.fsf-monnier+emacs@gnu.org>
 <152fab46-8825-2e69-6c74-5309482ac1ba@cs.ucla.edu>
Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202";
	logging-data="49394"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: dancol@dancol.org, monnier@iro.umontreal.ca, emacs-devel@gnu.org
To: Paul Eggert <eggert@cs.ucla.edu>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri May 15 11:59:21 2020
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane-mx.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1jZX7g-000Chb-D8
	for ged-emacs-devel@m.gmane-mx.org; Fri, 15 May 2020 11:59:20 +0200
Original-Received: from localhost ([::1]:41810 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1jZX7f-0007I1-Fb
	for ged-emacs-devel@m.gmane-mx.org; Fri, 15 May 2020 05:59:19 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41984)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@gnu.org>) id 1jZX75-0006aB-Km
 for emacs-devel@gnu.org; Fri, 15 May 2020 05:58:43 -0400
Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:58130)
 by eggs.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <eliz@gnu.org>)
 id 1jZX75-0005hV-50; Fri, 15 May 2020 05:58:43 -0400
Original-Received: from [176.228.60.248] (port=4510 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 1jZX72-0004Dj-KF; Fri, 15 May 2020 05:58:41 -0400
In-Reply-To: <152fab46-8825-2e69-6c74-5309482ac1ba@cs.ucla.edu> (message from
 Paul Eggert on Thu, 14 May 2020 23:34:12 -0700)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.23
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: <https://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-mx.org@gnu.org
Original-Sender: "Emacs-devel"
 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.devel:250369
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/250369>

> From: Paul Eggert <eggert@cs.ucla.edu>
> Date: Thu, 14 May 2020 23:34:12 -0700
> Cc: Daniel Colascione <dancol@dancol.org>,
>  Emacs developers <emacs-devel@gnu.org>
> 
> Emacs currently has exactly two empty strings (one unibyte and one multibyte),
> so the phrase "the empty string" is wrong for the current implementation anyway.

the documentation doesn't have to describe the implementation, it just
needs to tell enough for the Lisp programmers to understand how to use
this stuff.