[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Line numbers in doc snarf comments
From: |
Martin Grabmueller |
Subject: |
Re: Line numbers in doc snarf comments |
Date: |
Tue, 13 Nov 2001 13:06:49 +0100 |
> From: Neil Jerram <address@hidden>
> Sender: address@hidden
>
> Currently, the doc snarf output in libguile/guile.texi includes
> comments saying the file and line number whence each docstring was
> snarfed. For example:
>
> @c snarfed from alist.c:58
>
> A copy of guile.texi (doc/maint/guile.texi) gets checked into CVS as
> part of the automatic doc updates mechanism, and the existence of the
> line numbers (which often change) causes a rather unnecessary amount
> of CVS protocol traffic.
>
> So, does anyone mind if I change the doc snarf jobs to omit the line
> numbers?
Maybe the line numbers could be useful when trying to fix errors in
the docstrings. Could you maybe add a switch or something so one can
switch the line numbers on conditionally?
Except for that I have no objections.
'martin