Re: Cross-referencing frenzy

Jeff Garzik (jgarzik@mandrakesoft.com)
Thu, 19 Apr 2001 01:38:37 -0400


Richard Gooch wrote:
> Exactly. A ChangeLog should pre preserved for all time. It is an
> incredibly useful tool. Many times I've gone back and checked when
> something was done, and in relation to other changes before, after or
> around the same time.

agreed

> Except the CONFIG_APM_IGNORE_SUSPEND_BOUNCE was in the apm.c source
> file (in a ChangeLog). So just ignoring Documentation/ won't solve the
> problem.
>
> One trick I've used on my own (non-Linux) code is to insert a space
> after the first underscore. That fools the global search, but leaves
> the essence of the ChangeLog entry. It's a bit hackish, though.
>
> A cleaner solution is to parse the source code, ignoring comment
> blocks. However, that's a bit more work.

Or CC the maintainers, who can manually check, distributing the work :)

The stuff in ChangeLogs is clearly not to be touched. Various
documentation has to be examined manually to determine if its outdated
or not. There is no 100% automatic way to do this.

Jeff

-- 
Jeff Garzik       | "The universe is like a safe to which there is a
Building 1024     |  combination -- but the combination is locked up
MandrakeSoft      |  in the safe."    -- Peter DeVries
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/