GNU bug report logs - #13945
`abreviated-home-dir' isn't documented

Previous Next

Package: emacs;

Reported by: Xue Fuqiao <xfq.free <at> gmail.com>

Date: Wed, 13 Mar 2013 07:59:01 UTC

Severity: minor

Tags: notabug

Done: npostavs <at> users.sourceforge.net

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 13945 in the body.
You can then email your comments to 13945 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#13945; Package emacs. (Wed, 13 Mar 2013 07:59:01 GMT) Full text and rfc822 format available.
Acknowledgement sent to Xue Fuqiao <xfq.free <at> gmail.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Wed, 13 Mar 2013 07:59:02 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Xue Fuqiao <xfq.free <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: `abreviated-home-dir' isn't documented
Date: Wed, 13 Mar 2013 15:57:07 +0800

In the source code of `command-line':

  ;; Force recomputation, in case it was computed during the dump.
  (setq abbreviated-home-dir nil)

The variable `abbreviated-home-dir' (which is defined in files.el) is
not documented in elisp manual. (Maybe there isn't a need?)

BTW what does the expression above do?  I had searched loadup.el and
some other files in `lisp/', but I didn't find anything useful.

-- 
Best regards, Xue Fuqiao.
http://www.emacswiki.org/emacs/XueFuqiao
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#13945; Package emacs. (Sun, 02 Apr 2017 01:59:01 GMT) Full text and rfc822 format available.

Message #8 received at 13945 <at> debbugs.gnu.org (full text, mbox):

From: npostavs <at> users.sourceforge.net
To: Xue Fuqiao <xfq.free <at> gmail.com>
Cc: 13945 <at> debbugs.gnu.org
Subject: Re: bug#13945: `abreviated-home-dir' isn't documented
Date: Sat, 01 Apr 2017 21:59:25 -0400

tags 13945 notabug
close 13945
quit

Xue Fuqiao <xfq.free <at> gmail.com> writes:

> In the source code of `command-line':
>
>   ;; Force recomputation, in case it was computed during the dump.
>   (setq abbreviated-home-dir nil)
>
> The variable `abbreviated-home-dir' (which is defined in files.el) is
> not documented in elisp manual. (Maybe there isn't a need?)

It doesn't need to be documented in the elisp manual, the docstring
should be enough.

> BTW what does the expression above do?  I had searched loadup.el and
> some other files in `lisp/', but I didn't find anything useful.

It forces abbreviated-home-dir to be recomputed next time
abbreviate-file-name is called.

    (defun abbreviate-file-name (filename)
      ...
          (or abbreviated-home-dir
              (setq abbreviated-home-dir
              ...
Added tag(s) notabug. Request was from npostavs <at> users.sourceforge.net to control <at> debbugs.gnu.org. (Sun, 02 Apr 2017 01:59:02 GMT) Full text and rfc822 format available.
bug closed, send any further explanations to 13945 <at> debbugs.gnu.org and Xue Fuqiao <xfq.free <at> gmail.com> Request was from npostavs <at> users.sourceforge.net to control <at> debbugs.gnu.org. (Sun, 02 Apr 2017 01:59:02 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sun, 30 Apr 2017 11:24:04 GMT) Full text and rfc822 format available.
This bug report was last modified 8 years and 54 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.