From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Tianxiang Xiong Newsgroups: gmane.emacs.devel Subject: Proposal: alias `clear-buffer` to `erase-buffer` Date: Sat, 14 Jan 2017 11:41:50 -0800 Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a114d77965123db0546132497 X-Trace: blaine.gmane.org 1484422982 21891 195.159.176.226 (14 Jan 2017 19:43:02 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 14 Jan 2017 19:43:02 +0000 (UTC) To: Emacs developers Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jan 14 20:42:58 2017 Return-path: 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 ) id 1cSUDr-00042K-Lv for ged-emacs-devel@m.gmane.org; Sat, 14 Jan 2017 20:42:43 +0100 Original-Received: from localhost ([::1]:49199 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cSUDw-0007yT-Bn for ged-emacs-devel@m.gmane.org; Sat, 14 Jan 2017 14:42:48 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55093) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cSUD3-0007x2-1Q for emacs-devel@gnu.org; Sat, 14 Jan 2017 14:41:53 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cSUD2-0001uP-Cw for emacs-devel@gnu.org; Sat, 14 Jan 2017 14:41:53 -0500 Original-Received: from mail-yw0-x22f.google.com ([2607:f8b0:4002:c05::22f]:33762) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cSUD2-0001uJ-78 for emacs-devel@gnu.org; Sat, 14 Jan 2017 14:41:52 -0500 Original-Received: by mail-yw0-x22f.google.com with SMTP id l75so49167162ywb.0 for ; Sat, 14 Jan 2017 11:41:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=Y8jLZCpA8g9d0j77P74oMThM6c4jnP9NVdzK2mIh2b8=; b=h1LIs+AnCkpTHtpYzDYF+YaxRYFE6+Bg2Lq7aKXEEwV4vDJkR0wJApPK+gkMlMZo4+ QqQDmMR2nWdlkLLcN7fi87+hUmLrq0gm6nYYx0f2jAdCSUAPF1FZSqnVN2wMI4p1ByTu kH0mG8w9oTdktcItSbs85S0gavVsJAi0Jb1aSujNUa+PKtmELUYgCjVkgYlBrpxZz5CE VQf9fO28TFKrtJBYC3GqA9Z6datY56rY8lXvkVfe2lyRzILpD4OUIZw97WWKAgN1swMw dHPeSGQlxU8RNyjSQD9aF3ExT2CzSKT1muXi4gezOjdE/N6wLfaemRQ/UO/A10c6MGZR qE+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=Y8jLZCpA8g9d0j77P74oMThM6c4jnP9NVdzK2mIh2b8=; b=OpcXs12N2aho0hLZpcwcA5zPygi1V3i4WnNRdfCztO/OsWThxlRqPvrPq2mK/9bK/z ZyAxGQ2A82LrUe3eF6b6/G5u1OmU2/SE+g/j8CgJyvskL6WvdtVhu5rC1CkoOaeTEQf8 w8/vts3IOLwA4cQztHsitbNDMVFaf+xDRGwCGI7JWcDQzbd20Lre4nf7R6yAfuY425oT akEOjWnepiSoG5y4XWyPrzduhZqqoS7TbDonwE3eR7DmRUGuqPpEUKAaH6yUpTInMQUM aGHlvJKC3SbBvNsh5Z7l5eOdZ4PUzZ0xTL1T8Dztc0PkGD/NVg0yJOOPR3iCUoeaLhFp 6NmQ== X-Gm-Message-State: AIkVDXIGl8ZoY6s660xbVUpE+MNlv19fBoqTIlVUg0PAkJSEZ9seqq7h/b1f/qxbshCHNTcx4IwTwSm/weJ7kw== X-Received: by 10.129.71.10 with SMTP id u10mr21639421ywa.115.1484422911171; Sat, 14 Jan 2017 11:41:51 -0800 (PST) Original-Received: by 10.129.130.3 with HTTP; Sat, 14 Jan 2017 11:41:50 -0800 (PST) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:4002:c05::22f X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:211298 Archived-At: --001a114d77965123db0546132497 Content-Type: text/plain; charset=UTF-8 The `erase-buffer` function is the only function that "clears" data, but begins with the word "erase". This makes it difficult to discover for new users. The most widely used term seems to be "clear" instead of "erase". See: - `clear-string` - `clear-rectangle` - `clear-abbrev-table` and more. `erase-buffer` should be called `clear-buffer`. We can create an alias in `subr.el` and mark `erase-buffer` as deprecated, though it'll never be safe to remove due to the amount of code that uses it. --001a114d77965123db0546132497 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
The `erase-buffer` function is the only function that &quo= t;clears" data, but begins with the word "erase". This makes= it difficult to discover for new users.

The most widely= used term seems to be "clear" instead of "erase". See:= =C2=A0

- `clear-string`
- `clear-rectang= le`
- `clear-abbrev-table`

and more.

`erase-buffer` should be called `clear-buffer`. We ca= n create an alias in `subr.el` and mark `erase-buffer` as deprecated, thoug= h it'll never be safe to remove due to the amount of code that uses it.=
--001a114d77965123db0546132497--