From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#21391: 24.5; `thing-at-point' should return a string Date: Fri, 11 Nov 2016 16:46:14 +0200 Message-ID: <6dbea00c-3bde-6ec3-b109-7aa205bedb5f@yandex.ru> References: <1773ab35-70b1-42f9-8a8b-fe07881487d1@default> <874m3krnb6.fsf_-_@gmail.com> <83a8dbiaps.fsf@gnu.org> <83pom7gjhl.fsf@gnu.org> <0a8d76e4-4d1b-a26d-2b76-a2d9384d9f72@yandex.ru> <83mvhbgitf.fsf@gnu.org> <25bb22e8-1388-275a-d0da-7e698acdf6da@yandex.ru> <83inrygggr.fsf@gnu.org> <83y40sfyij.fsf@gnu.org> <76505436-e66c-0ed3-6d7a-ce654f38ef30@yandex.ru> <83bmxnfhbi.fsf@gnu.org> <73600483-1df5-597c-6066-232189bbdd4a@yandex.ru> <834m3ffeb9.fsf@gnu.org> <83twbfdvav.fsf@gnu.org> <73be4b9d-2df8-cc83-b873-398cb7dd043b@yandex.ru> <83pom3ds3e.fsf@gnu.org> <83bmxme12w.fsf@gnu.org> <834m3edqyr.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1478875689 21058 195.159.176.226 (11 Nov 2016 14:48:09 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 11 Nov 2016 14:48:09 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:50.0) Gecko/20100101 Thunderbird/50.0 Cc: 21391@debbugs.gnu.org To: Eli Zaretskii , Tino Calancha Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 11 15:47:50 2016 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 1c5D6n-00071T-Vw for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Nov 2016 15:47:14 +0100 Original-Received: from localhost ([::1]:53433 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c5D6o-0003kT-0u for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Nov 2016 09:47:14 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56704) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c5D6h-0003jz-Hb for bug-gnu-emacs@gnu.org; Fri, 11 Nov 2016 09:47:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c5D6c-0000Ok-EX for bug-gnu-emacs@gnu.org; Fri, 11 Nov 2016 09:47:07 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:37736) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c5D6c-0000Nt-Ah for bug-gnu-emacs@gnu.org; Fri, 11 Nov 2016 09:47:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1c5D6b-0006Cr-Uo for bug-gnu-emacs@gnu.org; Fri, 11 Nov 2016 09:47:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 11 Nov 2016 14:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21391 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21391-submit@debbugs.gnu.org id=B21391.147887558423810 (code B ref 21391); Fri, 11 Nov 2016 14:47:01 +0000 Original-Received: (at 21391) by debbugs.gnu.org; 11 Nov 2016 14:46:24 +0000 Original-Received: from localhost ([127.0.0.1]:53135 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c5D60-0006By-Kq for submit@debbugs.gnu.org; Fri, 11 Nov 2016 09:46:24 -0500 Original-Received: from mail-wm0-f51.google.com ([74.125.82.51]:33177) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c5D5z-0006Bm-24 for 21391@debbugs.gnu.org; Fri, 11 Nov 2016 09:46:23 -0500 Original-Received: by mail-wm0-f51.google.com with SMTP id c184so60780908wmd.0 for <21391@debbugs.gnu.org>; Fri, 11 Nov 2016 06:46:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:subject:to:references:cc:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=/Ts6bm5U0ovAV19l6caVh9Ez7IrV1xIW83YTaedlhfs=; b=Go5g+GS7Dao3nodc5xOQw6P+ZpYLpWu4Cko7yVMjRH54IinGbmYCpHWdtnMCAv7rZG TFFgXY+ngnoNY4mtmJwfv/Yz4nwmQILz3kNVfrkCpFeLvEMxEkhjlvNSbh/WG6H/+Gcj XketLOBWbb4qWwFQf1Rf6UvJEyz/+AQeT4XPhBmRQ2qL68vziOG2cgXdXFqtANW314nS TjzpQJZk+Pvkhuxx7TcvLxf2GRAz1ZDNMG4K33CyJz8e0xMal+g7ZzuO9xXIxkVo4j0k SjWLofqnkKliGOcxkjo/Dq41btCCD6SU0LmbVZnO/3PP6jN6HV2MgOC04Bp6CRedIpJy Qccg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:subject:to:references:cc:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=/Ts6bm5U0ovAV19l6caVh9Ez7IrV1xIW83YTaedlhfs=; b=VdzPsclHhUaoXPYLVuFwezCG/Cu7L/6aBCf/u+1yxx2xyrjbcPlCE0sRuza6OCQJgJ X981zB8m5DubxpXc2nw4CzLqhpwyUYV+/K0cSUM9T8UV/85UZL2QqnSWwQyZBKjavDOF 5MSiB2TF5Y1UfaCY5mgfl46GpuszKHsH38TKoZNsiCTvnbbGBXXfZzFOslEpNKkCr8yh TWK/OfJES7d5kUs79NysdHla2MZtDx5trLc7K6ZKtiVqm3zpWxjsD4v83Dbg2OsyFAi+ YbCXPHGx8S8OvDsDr6ahYw8eDPXvJPblMZ2Jf1fWFpt2qjzXoCqjUjg25QUl/U18Yumv jDlA== X-Gm-Message-State: ABUngvdg2urQnbYTmXLSlNcodcdhNYKPhcJgXazELDZ2En/Tk7jrBSPSj3gjYRzXTyFe7w== X-Received: by 10.194.31.201 with SMTP id c9mr8559113wji.176.1478875577232; Fri, 11 Nov 2016 06:46:17 -0800 (PST) Original-Received: from [192.168.0.133] ([212.50.99.193]) by smtp.googlemail.com with ESMTPSA id g10sm11820584wjw.18.2016.11.11.06.46.15 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 11 Nov 2016 06:46:16 -0800 (PST) In-Reply-To: <834m3edqyr.fsf@gnu.org> Content-Language: en-US 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:125618 Archived-At: On 11.11.2016 16:35, Eli Zaretskii wrote: >> The current implementation makes the things harder to understand. >> Currently one user need to read the source code to know the actual >> type this function returns. > > If that's a problem, let's improve the doc string (and the manual, if > needed) to make this more clear. Improve how? By saying that the function behaves in a variety of ways, solely depending on which `thing' it is passed? That won't make it much clearer, or make it easier to follow code that uses `thing-at-point'.