Bug#321201: kernel-doc: put an ### END ### at the end of files that lack them

[Horms <horms@debian.org>]

On Wed, Aug 03, 2005 at 08:35:47PM -0700, Donald Becker wrote:
> On Thu, 4 Aug 2005, Horms wrote:
> 
> > On Thu, Aug 04, 2005 at 07:42:45AM +0800, Dan Jacobson wrote:
> > > Package: kernel-doc-2.6.8
> > > Version: 2.6.8-10
> > > Severity: wishlist
> > > File: /usr/share/doc/kernel-doc-2.6.8/Documentation/networking/PLIP.txt.gz
> > > Tags: upstream
> > > 
> > > The document seems to end abruptly with
> > > 
> > >    WAIT FOR IN.4 = 0
> > > 
> > > and might be truncated. Perhaps if there were as "Conclusion" section
> > > added, one could tell that the document was not truncated.
> > > 
> > > Same for any other kernel documents, and all kernel versions, etc.
> > > Compare /kernel-doc-2.6.8/Documentation/usb/proc_usb_info.txt.gz which
> > > has an ### END ### at the end.
> > 
> > I see no reason that isn't the end of the document,
> > and I also see no evidence that there is a standard
> > of adding ### END ### to kernel documentation.
> > 
> > I have CCed Donald Becker, who seems to be the author, 
> > hopefully he can comment on the completeness of the document.
> > I've included the trailing portion of the document for
> > his benifit.
> 
> Hmmm, I wrote that a long time ago.  Probably a dozen years ago, since I 
> wrote plip in 1992 or 1993 and I left the IDA in early 1994.
> 
> I'll see if I can dig up some old backups.  I likely wrote this in a mail 
> message, or perhaps the original text can be found in an old kernel 
> version.

I just checked 2.2.0, it seems to be the same there.
And its not in 2.0 or earlier.

-- 
Horms