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

Previous Next

Full log

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.

Previous Next

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