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.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Takesi Ayanokoji <ayanokoji.takesi <at> gmail.com>
Subject: bug#31725: closed (Re: bug#31725: Mysterious file in lispref
 manual's example(emacs-26.1))
Date: Tue, 05 Jun 2018 16:10:02 +0000
[Message part 1 (text/plain, inline)]
Your bug report

#31725: Mysterious file in lispref manual's example(emacs-26.1)

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 31725 <at> debbugs.gnu.org.

-- 
31725: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=31725
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
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.

[Message part 3 (message/rfc822, inline)]
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 4 (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 5 (text/html, inline)]

This bug report was last modified 7 years and 44 days ago.

Previous Next


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