From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31730: 26; doc string of `update-glyphless-char-display' Date: Tue, 5 Jun 2018 22:03:07 -0700 (PDT) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1528261328 4728 195.159.176.226 (6 Jun 2018 05:02:08 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 6 Jun 2018 05:02:08 +0000 (UTC) To: 31730@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jun 06 07:02:04 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1fQQaC-00013n-Dw for geb-bug-gnu-emacs@m.gmane.org; Wed, 06 Jun 2018 07:02:04 +0200 Original-Received: from localhost ([::1]:50360 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQQcH-0008RE-Qy for geb-bug-gnu-emacs@m.gmane.org; Wed, 06 Jun 2018 01:04:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51834) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQQc9-0008R6-Nr for bug-gnu-emacs@gnu.org; Wed, 06 Jun 2018 01:04:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fQQc6-0002Yg-Ij for bug-gnu-emacs@gnu.org; Wed, 06 Jun 2018 01:04:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:56113) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fQQc6-0002YU-Dg for bug-gnu-emacs@gnu.org; Wed, 06 Jun 2018 01:04:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fQQc6-0005Sl-5N for bug-gnu-emacs@gnu.org; Wed, 06 Jun 2018 01:04: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: Wed, 06 Jun 2018 05:04:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 31730 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.152826140520953 (code B ref -1); Wed, 06 Jun 2018 05:04:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 6 Jun 2018 05:03:25 +0000 Original-Received: from localhost ([127.0.0.1]:35777 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQQbV-0005Rt-8S for submit@debbugs.gnu.org; Wed, 06 Jun 2018 01:03:25 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:60816) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQQbT-0005Ra-Ac for submit@debbugs.gnu.org; Wed, 06 Jun 2018 01:03:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fQQbN-00020u-7t for submit@debbugs.gnu.org; Wed, 06 Jun 2018 01:03:18 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:49303) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fQQbN-00020Z-5K for submit@debbugs.gnu.org; Wed, 06 Jun 2018 01:03:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51777) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQQbL-0008Od-Vn for bug-gnu-emacs@gnu.org; Wed, 06 Jun 2018 01:03:16 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fQQbI-0001ws-R5 for bug-gnu-emacs@gnu.org; Wed, 06 Jun 2018 01:03:16 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:49626) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fQQbI-0001w2-GR for bug-gnu-emacs@gnu.org; Wed, 06 Jun 2018 01:03:12 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w56527FE187934 for ; Wed, 6 Jun 2018 05:03:10 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=zrA7mt83EY5uM0S0t6sXetH6chJzJfHTkQi1InTWjF8=; b=k8oSq5YoGi80OCys7834iA5L26/uSc3HXIispU8UfAg54Mn+QeuREJXR/pFD+tzxndb0 wPNBJWUkHop657kSWFlNp93lwci3u9d5ipYHizkCGnW1b9c5lO/sn7k+EZEWMbw8OzRg KBNsj5jyX7FguW9E7s9Ty/A1CPGbOgAL22lHGf9iF19DaAPnz/F+SaZBMwJKITAxwAgU PZg1K3ByToRJdS8nLrernnZcxFXq0oUn4M+X+87ptxJf2ix19tgv4OTf501Q8PJcV/+u fTdFNwRzWY7n4f8zzd0xrAmzJ7HLf26s153DLrqFVWWhk9h8djSsprftiyuTQaJdqzyH dQ== Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp2120.oracle.com with ESMTP id 2jbvypjxj2-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 06 Jun 2018 05:03:10 +0000 Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w56539b4001018 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 6 Jun 2018 05:03:09 GMT Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w56539YM022835 for ; Wed, 6 Jun 2018 05:03:09 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4690.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8915 signatures=668702 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=774 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1805220000 definitions=main-1806060057 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 208.118.235.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:147073 Archived-At: The doc string is not understandable (to me). 1. For starters, neither of the functions parameters is described. This is the main problem with this doc. 2. And it's not clear what "making the setting" of a variable "take effect" even means. Some help in this regard comes from the doc string of `glyphless-char-display-control', but the statement about making the setting of the variable take effect could be made more clear. If the value is only set effectively by the options's :set function, then just say, in the doc string of `update-glyphless-char-display', that it is the :set function for option `glyphless-char-display'. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''