GNU bug report logs - #31725
Mysterious file in lispref manual's example(emacs-26.1)

Previous Next

Package: emacs;

Reported by: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>

Date: Tue, 5 Jun 2018 15:38:02 UTC

Severity: normal

Done: Eli Zaretskii <eliz <at> gnu.org>

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 31725 in the body.
You can then email your comments to 31725 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#31725; Package emacs. (Tue, 05 Jun 2018 15:38:02 GMT) Full text and rfc822 format available.
Acknowledgement sent to Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Tue, 05 Jun 2018 15:38:02 GMT) Full text and rfc822 format available.

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

From: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: Mysterious file in lispref manual's example(emacs-26.1)
Date: Wed, 6 Jun 2018 00:37:28 +0900

[Message part 1 (text/plain, inline)]
Hi, Emacs developers.

In doc/lispref/files.texi: 1671-1674, example says about "foo1".

>>> start here
@group
(add-name-to-file "foo1" "foo3")
     @result{} nil
@end group
<<< end here

 But I could not find meaning of this file in this example's context.

Is this @group-block necessary?

Thanks.

ayatakesi <ayanokoji.takesi <at> gmail.com>

[Message part 2 (text/html, inline)]
Reply sent to Eli Zaretskii <eliz <at> gnu.org>:
You have taken responsibility. (Tue, 05 Jun 2018 16:10:02 GMT) Full text and rfc822 format available.
Notification sent to Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>:
bug acknowledged by developer. (Tue, 05 Jun 2018 16:10:02 GMT) Full text and rfc822 format available.

Message #10 received at 31725-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>
Cc: 31725-done <at> debbugs.gnu.org
Subject: Re: bug#31725: Mysterious file in lispref manual's example(emacs-26.1)
Date: Tue, 05 Jun 2018 19:09:02 +0300

> From: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>
> Date: Wed, 6 Jun 2018 00:37:28 +0900
> 
> In doc/lispref/files.texi: 1671-1674, example says about "foo1".
> 
> >>> start here
> @group
> (add-name-to-file "foo1" "foo3")
>      @result{} nil
> @end group
> <<< end here
> 
>  But I could not find meaning of this file in this example's context.

It's just a file name.  It has no meaning beyond that.  the example
shows how to create a hard link to a file.

> Is this @group-block necessary? 

It prevents a multi-line example from being split between pages, see
the Texinfo manual for the details of @group.

Thanks.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Wed, 04 Jul 2018 11:24:05 GMT) Full text and rfc822 format available.
This bug report was last modified 7 years and 43 days ago.

Previous Next

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