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: Making DOC argument of define-minor-mode optional
Date: Wed, 23 Nov 2016 17:50:22 +0200
Message-ID: <83eg226vr5.fsf@gnu.org>
References: <CAArVCkQmr1GynatympsJQcVE4Bj0yqMYRUSEDz6a4O8_mv-d+w@mail.gmail.com>
Reply-To: Eli Zaretskii <eliz@gnu.org>
NNTP-Posting-Host: blaine.gmane.org
X-Trace: blaine.gmane.org 1479916296 6327 195.159.176.226 (23 Nov 2016 15:51:36 GMT)
X-Complaints-To: usenet@blaine.gmane.org
NNTP-Posting-Date: Wed, 23 Nov 2016 15:51:36 +0000 (UTC)
Cc: emacs-devel@gnu.org
To: Philipp Stephani <p.stephani2@gmail.com>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 23 16:51:29 2016
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 1c9ZpZ-0000OS-Gq
	for ged-emacs-devel@m.gmane.org; Wed, 23 Nov 2016 16:51:29 +0100
Original-Received: from localhost ([::1]:34637 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 1c9Zpd-00058Q-4U
	for ged-emacs-devel@m.gmane.org; Wed, 23 Nov 2016 10:51:33 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48131)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <eliz@gnu.org>) id 1c9Zoo-00057K-9I
	for emacs-devel@gnu.org; Wed, 23 Nov 2016 10:50:43 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <eliz@gnu.org>) id 1c9Zoj-0003cj-FF
	for emacs-devel@gnu.org; Wed, 23 Nov 2016 10:50:42 -0500
Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:56305)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <eliz@gnu.org>)
	id 1c9Zoj-0003cY-AD; Wed, 23 Nov 2016 10:50:37 -0500
Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2475
	helo=home-c4e4a596f7)
	by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128)
	(Exim 4.82) (envelope-from <eliz@gnu.org>)
	id 1c9Zoi-00044H-KJ; Wed, 23 Nov 2016 10:50:37 -0500
In-reply-to: <CAArVCkQmr1GynatympsJQcVE4Bj0yqMYRUSEDz6a4O8_mv-d+w@mail.gmail.com>
	(message from Philipp Stephani on Wed, 23 Nov 2016 10:04:13 +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:209564
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/209564>

> From: Philipp Stephani <p.stephani2@gmail.com>
> Date: Wed, 23 Nov 2016 10:04:13 +0000
> 
> the docstring created by define-minor-mode with nil DOC is useful and often better than what users write.
> Should DOC therefore be optional?

Not sure we would like to educate Lisp programmers to stop thinking
about good doc strings.