unofficial mirror of bug-guile@gnu.org 
 help / color / mirror / Atom feed
* Problem generating documentation
@ 2009-10-23 23:57 Xan Lopez
  2009-10-24  8:55 ` Neil Jerram
  0 siblings, 1 reply; 10+ messages in thread
From: Xan Lopez @ 2009-10-23 23:57 UTC (permalink / raw)
  To: bug-guile

Hi,

Using commit 32b12f40509e4bcb0823e1bb2a57e50af14560b5, I get the
following error when the doc is being generated:

make[3]: Entering directory `/home/xan/git/guile/libguile'
cat alist.doc arbiters.doc array-handle.doc array-map.doc arrays.doc
async.doc backtrace.doc boolean.doc bitvectors.doc bytevectors.doc
chars.doc continuations.doc debug.doc deprecated.doc deprecation.doc
discouraged.doc dynl.doc dynwind.doc eq.doc error.doc eval.doc
evalext.doc extensions.doc feature.doc fluids.doc fports.doc
futures.doc gc-malloc.doc gc.doc gettext.doc generalized-arrays.doc
generalized-vectors.doc goops.doc gsubr.doc guardians.doc hash.doc
hashtab.doc hooks.doc i18n.doc init.doc ioext.doc keywords.doc
lang.doc list.doc load.doc macros.doc mallocs.doc modules.doc
numbers.doc objects.doc objprop.doc options.doc pairs.doc ports.doc
print.doc procprop.doc procs.doc properties.doc r6rs-ports.doc
random.doc rdelim.doc read.doc root.doc rw.doc scmsigs.doc script.doc
simpos.doc smob.doc sort.doc srcprop.doc srfi-13.doc srfi-14.doc
srfi-4.doc stackchk.doc stacks.doc stime.doc strings.doc strorder.doc
strports.doc struct.doc symbols.doc threads.doc throw.doc uniform.doc
values.doc variable.doc vectors.doc version.doc vports.doc weaks.doc
dynl.doc filesys.doc posix.doc net_db.doc socket.doc regex-posix.doc |
GUILE_AUTO_COMPILE=0 ../meta/uninstalled-env guile-tools
snarf-check-and-output-texi          > guile-procedures.texi || { rm
guile-procedures.texi; false; }
ERROR: In procedure skip_block_comment:
ERROR: /home/xan/git/guile/guile-tools:1:3: unterminated `#! ... !#' comment
make[3]: *** [guile-procedures.texi] Error 1
make[3]: Leaving directory `/home/xan/git/guile/libguile'
make[2]: *** [all] Error 2
make[2]: Leaving directory `/home/xan/git/guile/libguile'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/home/xan/git/guile'
make: *** [all] Error 2
niraikanai:~/git/guile%git log

Apparently someone is interpreting the shebang as a comment, and is
aborting when it sees the comment is not finished. Not sure what tools
of those I have would be relevant here, so I won't start listing
everything under the Sun. Just ask away :)

Cheers, Xan




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-23 23:57 Problem generating documentation Xan Lopez
@ 2009-10-24  8:55 ` Neil Jerram
  2009-10-26 20:59   ` Xan Lopez
  0 siblings, 1 reply; 10+ messages in thread
From: Neil Jerram @ 2009-10-24  8:55 UTC (permalink / raw)
  To: Xan Lopez; +Cc: bug-guile

Xan Lopez <xan@gnome.org> writes:

> Hi,
>
> Using commit 32b12f40509e4bcb0823e1bb2a57e50af14560b5, I get the
> following error when the doc is being generated:

> ERROR: In procedure skip_block_comment:
> ERROR: /home/xan/git/guile/guile-tools:1:3: unterminated `#! ... !#' comment

If you take a look at /home/xan/git/guile/guile-tools, is the comment
really unterminated (as a Scheme block comment)?  There should be

!#

on its own on line 4, and that terminates the block comment.

> Apparently someone is interpreting the shebang as a comment,

Yes, Guile does that.  See `Block Comments' in the manual.

Regards,
        Neil





^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-24  8:55 ` Neil Jerram
@ 2009-10-26 20:59   ` Xan Lopez
  2009-10-26 21:16     ` Ludovic Courtès
  0 siblings, 1 reply; 10+ messages in thread
From: Xan Lopez @ 2009-10-26 20:59 UTC (permalink / raw)
  To: Neil Jerram; +Cc: bug-guile

On Sat, Oct 24, 2009 at 10:55 AM, Neil Jerram <neil@ossau.uklinux.net> wrote:
> Xan Lopez <xan@gnome.org> writes:
>
>> Hi,
>>
>> Using commit 32b12f40509e4bcb0823e1bb2a57e50af14560b5, I get the
>> following error when the doc is being generated:
>
>> ERROR: In procedure skip_block_comment:
>> ERROR: /home/xan/git/guile/guile-tools:1:3: unterminated `#! ... !#' comment
>
> If you take a look at /home/xan/git/guile/guile-tools, is the comment
> really unterminated (as a Scheme block comment)?  There should be
>
> !#
>
> on its own on line 4, and that terminates the block comment.

Ok, the problem is that I had a file named "guile-tools" in the
toplevel, which was a shell script and had nothing to do with
meta/guile-tools (no idea how it got there...), which is what I assume
you were talking about. If I do a 'git status' git says it does not
know anything about that, so I moved it out of the way, did a 'git
clean -f', and now things seem to work OK.

So I guess we can close the issue unless someone wants to figure out
how that file managed to be generated.




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-26 20:59   ` Xan Lopez
@ 2009-10-26 21:16     ` Ludovic Courtès
  2009-10-27 21:20       ` Neil Jerram
  0 siblings, 1 reply; 10+ messages in thread
From: Ludovic Courtès @ 2009-10-26 21:16 UTC (permalink / raw)
  To: bug-guile

Hello,

Xan Lopez <xan@gnome.org> writes:

> On Sat, Oct 24, 2009 at 10:55 AM, Neil Jerram <neil@ossau.uklinux.net> wrote:
>> Xan Lopez <xan@gnome.org> writes:
>>
>>> Hi,
>>>
>>> Using commit 32b12f40509e4bcb0823e1bb2a57e50af14560b5, I get the
>>> following error when the doc is being generated:
>>
>>> ERROR: In procedure skip_block_comment:
>>> ERROR: /home/xan/git/guile/guile-tools:1:3: unterminated `#! ... !#' comment
>>
>> If you take a look at /home/xan/git/guile/guile-tools, is the comment
>> really unterminated (as a Scheme block comment)?  There should be
>>
>> !#
>>
>> on its own on line 4, and that terminates the block comment.
>
> Ok, the problem is that I had a file named "guile-tools" in the
> toplevel, which was a shell script and had nothing to do with
> meta/guile-tools (no idea how it got there...), which is what I assume
> you were talking about.

I just hit that too.  The stale $top_builddir/guile-tools typically
comes from ‘branch_release-1-8’ or from a very old build of ‘master’.

Thanks,
Ludo’.





^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-26 21:16     ` Ludovic Courtès
@ 2009-10-27 21:20       ` Neil Jerram
  2009-10-27 23:21         ` Andy Wingo
  0 siblings, 1 reply; 10+ messages in thread
From: Neil Jerram @ 2009-10-27 21:20 UTC (permalink / raw)
  To: Ludovic Courtès; +Cc: bug-guile

ludo@gnu.org (Ludovic Courtès) writes:

> Hello,
>
> Xan Lopez <xan@gnome.org> writes:

>> Ok, the problem is that I had a file named "guile-tools" in the
>> toplevel, which was a shell script and had nothing to do with
>> meta/guile-tools (no idea how it got there...), which is what I assume
>> you were talking about.

Cool, thanks for closing the loop on this.

> I just hit that too.  The stale $top_builddir/guile-tools typically
> comes from ‘branch_release-1-8’ or from a very old build of ‘master’.

But is it cleaned by make distclean?  I would guess so, since I
regularly switch between branches, using make distclean, and have never
seen this.

If make distclean does clean it, I don't think we need anything else -
unless someone wants to propose a patch to HACKING to cover this.

   Neil




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-27 21:20       ` Neil Jerram
@ 2009-10-27 23:21         ` Andy Wingo
  2009-10-28  8:49           ` Ludovic Courtès
  0 siblings, 1 reply; 10+ messages in thread
From: Andy Wingo @ 2009-10-27 23:21 UTC (permalink / raw)
  To: Neil Jerram; +Cc: bug-guile, Ludovic Courtès

Hi,

On Tue 27 Oct 2009 22:20, Neil Jerram <neil@ossau.uklinux.net> writes:

> ludo@gnu.org (Ludovic Courtès) writes:
>
>> Hello,
>>
>> Xan Lopez <xan@gnome.org> writes:
>
>>> Ok, the problem is that I had a file named "guile-tools" in the
>>> toplevel, which was a shell script and had nothing to do with
>>> meta/guile-tools (no idea how it got there...), which is what I assume
>>> you were talking about.
>
> Cool, thanks for closing the loop on this.
>
>> I just hit that too.  The stale $top_builddir/guile-tools typically
>> comes from ‘branch_release-1-8’ or from a very old build of ‘master’.
>
> But is it cleaned by make distclean?  I would guess so, since I
> regularly switch between branches, using make distclean, and have never
> seen this.

I think the deal was that it used to be generated, and in the root. But
I changed it to be not generated, and in the meta/. But this error was
coming from Scheme; perhaps there was a issue with load path issue
whereby guile-tools was loaded from a path and not absolutely?

There might be a deeper bug lurking here. I can't think through it right
now though.

Andy
-- 
http://wingolog.org/




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-27 23:21         ` Andy Wingo
@ 2009-10-28  8:49           ` Ludovic Courtès
  2009-10-28 21:03             ` Neil Jerram
  0 siblings, 1 reply; 10+ messages in thread
From: Ludovic Courtès @ 2009-10-28  8:49 UTC (permalink / raw)
  To: Andy Wingo; +Cc: bug-guile, Neil Jerram

Hi,

Andy Wingo <wingo@pobox.com> writes:

> I think the deal was that it used to be generated, and in the root. But
> I changed it to be not generated, and in the meta/. But this error was
> coming from Scheme; perhaps there was a issue with load path issue
> whereby guile-tools was loaded from a path and not absolutely?

Yes, I think so.  It’s run as “./meta/uninstalled-env guile-tools” and
somehow it seems that $top_builddir ended up before $top_builddir/meta
in $PATH (don’t ask me why :-)).

Thanks,
Ludo’.




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-28  8:49           ` Ludovic Courtès
@ 2009-10-28 21:03             ` Neil Jerram
  2009-10-28 21:14               ` Andy Wingo
  2009-10-28 22:22               ` Ludovic Courtès
  0 siblings, 2 replies; 10+ messages in thread
From: Neil Jerram @ 2009-10-28 21:03 UTC (permalink / raw)
  To: Ludovic Courtès; +Cc: bug-guile

ludo@gnu.org (Ludovic Courtès) writes:

> Hi,
>
> Andy Wingo <wingo@pobox.com> writes:
>
>> I think the deal was that it used to be generated, and in the root. But
>> I changed it to be not generated, and in the meta/. But this error was
>> coming from Scheme; perhaps there was a issue with load path issue
>> whereby guile-tools was loaded from a path and not absolutely?
>
> Yes, I think so.  It’s run as “./meta/uninstalled-env guile-tools” and
> somehow it seems that $top_builddir ended up before $top_builddir/meta
> in $PATH (don’t ask me why :-)).

Hmm, it still seems to me that the old generated one should have been
deleted by `make distclean', and hence with an invocation of `make
distclean' (before `git pull' or `git checkout some-other-branch') this
wouldn't have happened.

       Neil




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-28 21:03             ` Neil Jerram
@ 2009-10-28 21:14               ` Andy Wingo
  2009-10-28 22:22               ` Ludovic Courtès
  1 sibling, 0 replies; 10+ messages in thread
From: Andy Wingo @ 2009-10-28 21:14 UTC (permalink / raw)
  To: Neil Jerram; +Cc: bug-guile, Ludovic Courtès

On Wed 28 Oct 2009 22:03, Neil Jerram <neil@ossau.uklinux.net> writes:

> ludo@gnu.org (Ludovic Courtès) writes:
>
>> Andy Wingo <wingo@pobox.com> writes:
>>
>>> I think the deal was that it used to be generated, and in the root. But
>>> I changed it to be not generated, and in the meta/. But this error was
>>> coming from Scheme; perhaps there was a issue with load path issue
>>> whereby guile-tools was loaded from a path and not absolutely?
>>
>> Yes, I think so.  It’s run as “./meta/uninstalled-env guile-tools” and
>> somehow it seems that $top_builddir ended up before $top_builddir/meta
>> in $PATH (don’t ask me why :-)).
>
> Hmm, it still seems to me that the old generated one should have been
> deleted by `make distclean', and hence with an invocation of `make
> distclean' (before `git pull' or `git checkout some-other-branch') this
> wouldn't have happened.

Well the one in the $top_builddir wouldn't have been deleted, as it was
moved to $top_builddir/meta.

A
-- 
http://wingolog.org/




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Problem generating documentation
  2009-10-28 21:03             ` Neil Jerram
  2009-10-28 21:14               ` Andy Wingo
@ 2009-10-28 22:22               ` Ludovic Courtès
  1 sibling, 0 replies; 10+ messages in thread
From: Ludovic Courtès @ 2009-10-28 22:22 UTC (permalink / raw)
  To: Neil Jerram; +Cc: bug-guile

Hi,

Neil Jerram <neil@ossau.uklinux.net> writes:

> ludo@gnu.org (Ludovic Courtès) writes:

[...]

>> Yes, I think so.  It’s run as “./meta/uninstalled-env guile-tools” and
>> somehow it seems that $top_builddir ended up before $top_builddir/meta
>> in $PATH (don’t ask me why :-)).
>
> Hmm, it still seems to me that the old generated one should have been
> deleted by `make distclean', and hence with an invocation of `make
> distclean' (before `git pull' or `git checkout some-other-branch') this
> wouldn't have happened.

You're probably right, but I had skipped that step.

Ludo’.




^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2009-10-28 22:22 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-10-23 23:57 Problem generating documentation Xan Lopez
2009-10-24  8:55 ` Neil Jerram
2009-10-26 20:59   ` Xan Lopez
2009-10-26 21:16     ` Ludovic Courtès
2009-10-27 21:20       ` Neil Jerram
2009-10-27 23:21         ` Andy Wingo
2009-10-28  8:49           ` Ludovic Courtès
2009-10-28 21:03             ` Neil Jerram
2009-10-28 21:14               ` Andy Wingo
2009-10-28 22:22               ` Ludovic Courtès

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).