From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#25469: 26.0.50; Document lock files Date: Tue, 17 Jan 2017 22:04:07 +0200 Message-ID: <83r3418nd4.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1496080544 13609 195.159.176.226 (29 May 2017 17:55:44 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 29 May 2017 17:55:44 +0000 (UTC) Cc: 25469@debbugs.gnu.org To: Philipp Stephani Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jan 17 21:21:17 2017 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 1cTaFm-0001uI-83 for geb-bug-gnu-emacs@m.gmane.org; Tue, 17 Jan 2017 21:21:14 +0100 Original-Received: from localhost ([::1]:37513 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTaFq-0000Rq-VT for geb-bug-gnu-emacs@m.gmane.org; Tue, 17 Jan 2017 15:21:19 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36694) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTaFg-0000QE-5e for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:21:10 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cTaFb-0007AM-39 for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:21:08 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35887) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cTaFb-0007AH-00 for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:21:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cTaFa-0000ZE-S3 for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:21:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 17 Jan 2017 20:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25469 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 25469-submit@debbugs.gnu.org id=B25469.14846844142070 (code B ref 25469); Tue, 17 Jan 2017 20:21:02 +0000 Original-Received: (at 25469) by debbugs.gnu.org; 17 Jan 2017 20:20:14 +0000 Original-Received: from localhost ([127.0.0.1]:34079 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTaEo-0000XK-L6 for submit@debbugs.gnu.org; Tue, 17 Jan 2017 15:20:14 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:45241) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTaEn-0000Wt-F7 for 25469@debbugs.gnu.org; Tue, 17 Jan 2017 15:20:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cTZzb-0005uR-Md for 25469@debbugs.gnu.org; Tue, 17 Jan 2017 15:04:34 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:42575) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTZzb-0005uL-KB; Tue, 17 Jan 2017 15:04:31 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1204 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1cTZzZ-0006YM-Qs; Tue, 17 Jan 2017 15:04:31 -0500 In-reply-to: (message from Philipp Stephani on Tue, 17 Jan 2017 20:41:35 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:132998 > From: Philipp Stephani > Date: Tue, 17 Jan 2017 20:41:35 +0100 > > > There is no documentation at all about the format used by lock file > names in either the Emacs or the Elisp manual: the indexes don't contain > an entry for .#, and neither manual documents the format. Given that > these files are highly visible, I think their format should be > documented. I'm not sure I agree. The format is an internal implementation detail, and in fact we've changed it recently to solve an obscure bug. Neither users nor Lisp programmers need to be aware of the format, and if they are really curious, they can look in the C sources.