From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#6755: 24.0.50; Customize buffer is too wide. Put doc string on separate line. Date: Sat, 21 Sep 2019 14:44:39 +0000 (UTC) Message-ID: <780890ec-8e55-4829-942f-b9daf3513908@default> References: <871rwgt32h.fsf@gnus.org> <87tv99loqr.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="97448"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 6755@debbugs.gnu.org To: Mauro Aranda , Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Sep 21 16:45:12 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iBgdL-000PFr-Gz for geb-bug-gnu-emacs@m.gmane.org; Sat, 21 Sep 2019 16:45:11 +0200 Original-Received: from localhost ([::1]:42188 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iBgdK-00089r-Ch for geb-bug-gnu-emacs@m.gmane.org; Sat, 21 Sep 2019 10:45:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37774) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iBgdD-00089h-PM for bug-gnu-emacs@gnu.org; Sat, 21 Sep 2019 10:45:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iBgdC-0002ml-KM for bug-gnu-emacs@gnu.org; Sat, 21 Sep 2019 10:45:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52519) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iBgdC-0002mU-FE for bug-gnu-emacs@gnu.org; Sat, 21 Sep 2019 10:45:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iBgdC-0004VC-BG for bug-gnu-emacs@gnu.org; Sat, 21 Sep 2019 10:45:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 21 Sep 2019 14:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6755 X-GNU-PR-Package: emacs Original-Received: via spool by 6755-submit@debbugs.gnu.org id=B6755.156907710117281 (code B ref 6755); Sat, 21 Sep 2019 14:45:02 +0000 Original-Received: (at 6755) by debbugs.gnu.org; 21 Sep 2019 14:45:01 +0000 Original-Received: from localhost ([127.0.0.1]:33107 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iBgdA-0004Ue-VU for submit@debbugs.gnu.org; Sat, 21 Sep 2019 10:45:01 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:46062) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iBgd8-0004UR-St for 6755@debbugs.gnu.org; Sat, 21 Sep 2019 10:44:59 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x8LEiPCH009628; Sat, 21 Sep 2019 14:44:52 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=4N8SM9tXdwo8uaIdx9Z4853zqN95p0ZaeIbJ8RbJr44=; b=ppvNv7McAQEoE8Xdz50uXiySf8wn81tYxLe/shU+pvZXkXiD2vuO25x8T7kZ1yK9Lspi 6ZulbqH0yOpQokCeLJUjpG/vbQzgr4t54bojgseLMD1TAJX6kz00NnBRLiZ4eMU0GqEL 1hUAKWtatIX/aKqa6d03VZKTOvIqSd/05tcQVO/v3bAilRj2bcUlrpg2hWlRG/kX0nYV kJ3qRI/vptvOe3VcDjYodfmmZ/178kHg/22j1qm3MXCgi9rCguxUfYTZQcy64dPZivqt vjzFIkesfdNFEhcCilCji/Csai5FcD2Z0vc8Wz2CP3FWKVEiesYQ8qTnS2I5ZNzIfMpi vQ== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 2v5btph86c-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 21 Sep 2019 14:44:52 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x8LEiphc139685; Sat, 21 Sep 2019 14:44:52 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserp3020.oracle.com with ESMTP id 2v5bpcn8p6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 21 Sep 2019 14:44:51 +0000 Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x8LEieMY028914; Sat, 21 Sep 2019 14:44:40 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4888.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9387 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=892 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1909210162 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9387 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=968 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1909210162 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:166878 Archived-At: OP, here. FWIW, this enhancement request (or bug report) did not ask for the doc string to be filled. It asked for it to be moved to its own line. Those are not at all the same thing. A doc string should be under the control of its author. It should already follow the conventions for doc string line length. The doc string line length is NOT the problem. The OP report says this: We go to great trouble to ensure that doc string text width is reasonable, but Customize currently defeats that effort by simply appending the doc string to existing text and buttons in the buffer. Please respect that motivation. Authors go to great trouble to format doc strings. Please do not override that willy nilly by filling the doc they've gone to some trouble to format. If you want to add an _option_ to _also_ fill the doc string, that's a different enhancement request, not this one. That should in any case be independent. If a user wants doc strings to be blindly filled systematically that's her right, so I'm not against adding such an option. But that's not a fulfillment of _this_ enhancement request (or bug fix). What's needed for this report is to move the doc string to its own line. Can that please be done, or at least considered? And if you _also_ want to consider filling the doc string (that should be a separate enhancement request), please do _not_ do so systematically. Let users choose to do that (opt in), with a user option.