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

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#31725: closed (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 message dated Tue, 05 Jun 2018 19:09:02 +0300
with message-id <83in6x9pwh.fsf <at> gnu.org>
and subject line Re: bug#31725: Mysterious file in lispref manual's example(emacs-26.1)
has caused the debbugs.gnu.org bug report #31725,
regarding Mysterious file in lispref manual's example(emacs-26.1)
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> 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: 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 3 (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 4 (text/html, inline)]

[Message part 5 (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.

Previous Next

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