From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#73709: 29.4; Doc of `file-newer-than-file-p' Date: Thu, 10 Oct 2024 01:21:40 +0200 Message-ID: <87v7y0kgl7.fsf@web.de> References: <86h69msbhi.fsf@gnu.org> <87set6aytj.fsf@web.de> <864j5l4d2x.fsf@gnu.org> Reply-To: Michael Heerdegen Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16351"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 73709@debbugs.gnu.org, drew.adams@oracle.com To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Oct 10 01:22:06 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1syg0L-00045b-V4 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 10 Oct 2024 01:22:06 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1syg0A-0007PS-4J; Wed, 09 Oct 2024 19:21:54 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1syg07-0007PE-Td for bug-gnu-emacs@gnu.org; Wed, 09 Oct 2024 19:21:52 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1syg07-0002mV-Lg for bug-gnu-emacs@gnu.org; Wed, 09 Oct 2024 19:21:51 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=RxlNOdqT5EKD2Oj2nacFjryfDrO+isVv+BUZVki8Lbc=; b=elrBWPaJukidq+rGcg9zVIECCoaMKHznRHuuXz0GSnKC2VyTVtrWZewU8Z/VTjq7bCmXRPgrSyyg5/sUSo66Xbn7l5w2CWdNVAnnDlRPLNwueB/IPUHvZEYlyVku7gssFPDi48gbtJk0R/k1oLkKAC/KsWCgfxx+U7fX3wkoP5fcxcMKrgc9CLokXX4Ifz7Nq8+1Xfo4cay6IexTdeDEirMQbYWNoWzyoExJHQzgmVV9imsLbvMukaV9UqhlNJnWIMVvdsMb9BVCoeEWS/oiRSK16HX0zdWqj9bDV7HVo0TSdr7aFeY7DExqiu906qWqp8CWE+bLyc0uxCQZ/0CPkg==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1syg0I-0006UD-4T for bug-gnu-emacs@gnu.org; Wed, 09 Oct 2024 19:22:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 09 Oct 2024 23:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 73709 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug wontfix Original-Received: via spool by 73709-submit@debbugs.gnu.org id=B73709.172851607924853 (code B ref 73709); Wed, 09 Oct 2024 23:22:02 +0000 Original-Received: (at 73709) by debbugs.gnu.org; 9 Oct 2024 23:21:19 +0000 Original-Received: from localhost ([127.0.0.1]:57939 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1syfzb-0006Sm-A9 for submit@debbugs.gnu.org; Wed, 09 Oct 2024 19:21:19 -0400 Original-Received: from mout.web.de ([212.227.15.4]:36445) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1syfzV-0006S9-MC for 73709@debbugs.gnu.org; Wed, 09 Oct 2024 19:21:17 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de; s=s29768273; t=1728516047; x=1729120847; i=michael_heerdegen@web.de; bh=RxlNOdqT5EKD2Oj2nacFjryfDrO+isVv+BUZVki8Lbc=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date: Message-ID:MIME-Version:Content-Type:cc:content-transfer-encoding: content-type:date:from:message-id:mime-version:reply-to:subject: to; b=gtrljiFg9B2JpAgOW1vu+qSXh3HXqR/kShDzFdYlsQUhvrzDsqmZDS9q/Lill5j8 fw/mViLQ/72/46wH2VbddtUN5YhTLFLMV6MgwIewrDx/83xt6/MeLEmbp6PwiQxqH 4WwXBti2El552AB+uqm87FwolUEFP6bdU3DNtWdNDBQ0GkJwC2UnuSZCgBfHicn1U YQvd+gOLKZvJAtwh5a8l1eJKAoL7gE0juBswfGz4aTfhkO5V8F5E0kjMYMqvJmg21 /A6X3LRE8c9LBTGojskY/ONXj3I8nBkbghbxofArDwUbTsW4boe7ji60dg7ozseTs vfK3tnpkzLN4yXfYtQ== X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6 Original-Received: from drachen.dragon ([92.75.138.227]) by smtp.web.de (mrweb006 [213.165.67.108]) with ESMTPSA (Nemesis) id 1MHEbk-1tBvXa3rUm-0095CL; Thu, 10 Oct 2024 01:20:46 +0200 In-Reply-To: <864j5l4d2x.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 09 Oct 2024 16:31:50 +0300") X-Provags-ID: V03:K1:Hdra17F1mGzt3ejoChxK2qPUWobdYHITZN3sGf5rZJIcG4Qsh3l EPoZGwo/mN/mTXGgfj4ITjicwpT+E7aqEupC6N++g7g9Vvae/yl8laU4RbcyA+ZDJU/zxhX ZlKXnRUHjD1jbQ/5zo9WmGGKeVsvJ5T7MYQYX89BTv5vV71yjHWpZxu0I+YB6Rw1Ci6rEqY 7yugkanddgf04UpWktDhQ== UI-OutboundReport: notjunk:1;M01:P0:/sISncbtFcM=;N9mjI6k9RyupO4+AeBD02mQpk3G 0KMrG0jvtMANfup4Png4DvQbCMv3CVWswS2qdzYuc4J2JgxGw6vutXW8fc2gY2Wi6WtV7dxna 1yV+Q2cYYHXUBRBJzcZHq4rThKhE39GiwjNCBMPlRUcSRVORL5Etas2DARcXYX7TTzkwfuakr /n7RNAsopSx71ovYmInnoBuAlzVrLyxK6BSwzkp6kgf2f1qDFsrWJYa8LIWh90k64NrHzH/ts PKkYEpOjl+f9FXbGLvp6O51bL3OTZliyfwmY1oJLRjeBmAn8YNoX5hT0IEFJv/9zSxBS6XlgL vAsIa1NdCYUXPTRSh/7xh4f+E3h2uctgL1G7IocjKp9O1JjHKm+4f4VWkCHhqKLcoDIqlMSIg +RRTkuFHvctdzUTWQ1ooG84PxQCz5SdE2gQP2Nq1qor63agkcb+XdaFy3CgKf5w1nqWcf98By 4G/Vw9pKpIlrGFh6ID4L4II2mTms6hb0/Z0vxuG1+nQ7rT7tHNF4vDZApYX6hemd3W7fFlpcQ vbUV+kaOEjz+08HPr9bc7BcCzUn/augvs3xehJ4R1BQ8NI3xVLxIPQh2sMuxlSOUhksu54DiD 4u+BpVf6/DKQqOGd4SAb0D8GP6gn0z0zVAIPK55JYtr8JAjvas9a7dI8y6KQYVSn0xKfAb8tR UXsEhf/QQSL7RBJc0QPMD9GzjXg15tHJt3b56sPp69hsggzCOkhIyesO3Z+3I3h36H4fkwZUi TSDjz320YUjbUq45olzzS4QEODerVTJjLGO/RsRpMV2QWY7T2gKRNM3HhMiLdZOg+VABuepI X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:293229 Archived-At: Eli Zaretskii writes: > Are you sure this is a good idea? If the user who reads the doc > string doesn't know the meaning of "the file is newer", how can we be > sure she knows the meaning of "file's last modification time"? [...] I had a look what my find(1) man page says about the command line option "-newer": | Time of the last data modification of the current file is more recent | than that of the last data modification of the reference file. I think something like this is better than saying nothing, and worse than telling all details. Apart from that: if it is hard or not practical to describe what the function returns in every case, we can instead try to describe major use cases. For example, checking whether an auto save file has to be restored, or whether a file has to be recompiled. Then the user would probably have an idea about what this is about even without any background knowledge and implementation details. At least a misunderstanding would be less likely. Michael.