From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Jorge Peixoto de Morais Neto Newsgroups: gmane.emacs.bugs Subject: bug#23350: 25.0.93; Docstring of bookmark-save-flag wrongly says that bookmark-default-file defaults do ~/.emacs.bmk Date: Sun, 24 Apr 2016 12:37:48 -0300 Message-ID: <1461512268.13483.16.camel@gmail.com> References: <1461444156.13483.3.camel@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1461512371 32603 80.91.229.3 (24 Apr 2016 15:39:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 24 Apr 2016 15:39:31 +0000 (UTC) To: John Mastro , 23350@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Apr 24 17:39:19 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1auM7y-00033m-BM for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Apr 2016 17:39:18 +0200 Original-Received: from localhost ([::1]:55790 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1auM7x-0006Ar-PL for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Apr 2016 11:39:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56503) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1auM7m-0005qI-KH for bug-gnu-emacs@gnu.org; Sun, 24 Apr 2016 11:39:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1auM7i-0004rv-KW for bug-gnu-emacs@gnu.org; Sun, 24 Apr 2016 11:39:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:32824) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1auM7i-0004rp-Go for bug-gnu-emacs@gnu.org; Sun, 24 Apr 2016 11:39:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1auM7i-0007vW-CX for bug-gnu-emacs@gnu.org; Sun, 24 Apr 2016 11:39:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Jorge Peixoto de Morais Neto Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 24 Apr 2016 15:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 23350 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 23350-submit@debbugs.gnu.org id=B23350.146151228230384 (code B ref 23350); Sun, 24 Apr 2016 15:39:02 +0000 Original-Received: (at 23350) by debbugs.gnu.org; 24 Apr 2016 15:38:02 +0000 Original-Received: from localhost ([127.0.0.1]:45157 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1auM6j-0007tp-Nk for submit@debbugs.gnu.org; Sun, 24 Apr 2016 11:38:02 -0400 Original-Received: from mail-pa0-f68.google.com ([209.85.220.68]:34754) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1auM6h-0007tT-LV for 23350@debbugs.gnu.org; Sun, 24 Apr 2016 11:38:00 -0400 Original-Received: by mail-pa0-f68.google.com with SMTP id yl2so10695813pac.1 for <23350@debbugs.gnu.org>; Sun, 24 Apr 2016 08:37:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:subject:from:to:date:in-reply-to:references:mime-version :content-transfer-encoding; bh=+egh2II/+2SCgq1YZMBfn4m281b2hQBaCiJ+GP+oDIk=; b=mNoe08IedhnqJR9PHVqUz0S70PaOH5kPw8shQWO4feN+MD+YVL7fo2RD9bi48aU16v fO+0AVoKYBnhMWAytukeWAbHxR7xaXS5orgo8ZwFBUPh0+yBZH1qI4v2UZ3BdhLEJW4Q h+PT2JlgN15D1w8jDeuSiMliGEc1V/hryVdqp30IG9VoRHPaUBpAiWsDzMWO9y69Ute7 hbAoD+nAWMn7qZ+Bb/f5x6p0KpAEH6gdmov/+s7D8YF32h2EdRKte0B+6DsVMkq9kRsU ol2r+im8B9Gofns88TUrMm0dZRa2s7swRH2XdcnavuN0hFq6rjfOxZW970rhT18rlU8r y5JA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:message-id:subject:from:to:date:in-reply-to :references:mime-version:content-transfer-encoding; bh=+egh2II/+2SCgq1YZMBfn4m281b2hQBaCiJ+GP+oDIk=; b=CUMIKRANHF6CJai0Fy9XusWeH5hkRo3bn/lmsIB1PWp84UhTvAdc2fmF4g0hdPkN4l aePxowJRh20KzM/e/ti5hNrqMcPts4IVdXn0V+UY3WfhvOt/fGvAVj52ioENRpRHRQOM 2x2UKnxI8Vwbd9AZro0D58dfq6yzS6k4MnkTno3+F7uyzNV9cs13iF5fA45kJgXKIjiE LUOGX0pcwy1mjBkdMqpTBQ3YNKoa1L8yJdQX+MwhZwKhDH/sFUXzkafJ4wWPtSl3+JUF lQDo8orcJ4lEBG7dNc4MQ/CN6vXoEg1cqcVeZYN5zm1vJibx3Vl0VrjCCBP7kglRUuB0 KXIQ== X-Gm-Message-State: AOPr4FU5zoP9CIDxTx0HFJ5XGLkEN+uf/J3/9CHwx/bwbrLNumjca3YHKhO32goJRjK4Eg== X-Received: by 10.66.229.33 with SMTP id sn1mr42730396pac.49.1461512273973; Sun, 24 Apr 2016 08:37:53 -0700 (PDT) Original-Received: from [192.168.25.29] ([191.33.140.232]) by smtp.googlemail.com with ESMTPSA id x184sm21767720pfb.53.2016.04.24.08.37.51 (version=TLSv1/SSLv3 cipher=OTHER); Sun, 24 Apr 2016 08:37:53 -0700 (PDT) In-Reply-To: X-Mailer: Evolution 3.18.5.2-0ubuntu1 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:116763 Archived-At: On Sat, 2016-04-23 at 14:32 -0700, John Mastro wrote: > My reading of the docstring and code is that it's working as intended. > It's not that .emacs.bmk is the default, but that it was the default in > the past. > > The logic seems to be (assuming ~/.emacs.d/ is the user's Emacs > directory): >   1. If `bookmark-file' is non-nil, use that >   2. If ~/.emacs.d/bookmarks exists, use that >   3. If ~/.emacs.d/.emacs.bmk exists, use that >   4. Otherwise, use ~/.emacs.d/bookmarks > > Note that ~/.emacs.d/bookmarks is used in both 2 and 4. > > In other words, ~/.emacs.d/bookmarks is the real default, but it's > accommodating the continued use of the old default > (~/.emacs.d/.emacs.bmk). In a vanilla, non-customized installation of Emacs, bookmark-default-file is "~/.emacs.d/bookmarks".  That is what should be reported as the default value. Instead, the docstring of bookmark-save-flag says: > To specify the file in which to save them, modify the variable > ‘bookmark-default-file’, which is ‘~/.emacs.bmk’ by default. This is confusing.  The docstring of bookmark-load is also confusing, as it says: > Your own personal bookmark file, ‘~/.emacs.bmk’, is > maintained automatically by Emacs These docstrings could send a novice user in the wrong direction, consuming his time and reinforcing the image that configuring Emacs is time-consuming.  -- - I am Brazilian.  I hope my English is correct and I welcome corrections. - Please adopt free formats like PDF, ODF, LaTeX, Vorbis, Opus, WebM and 7z. - Free software for Android: https://f-droid.org/