cleanup biolerplate comments, enable autogsdoc comments, cleanup some…

… old RCS/CVS tags, fix emails
gnustep · Dec 23, 2023 · 08858ca · 08858ca
1 parent 695b650
commit 08858ca
Show file tree

Hide file tree

Showing 113 changed files with 223 additions and 156 deletions.
diff --git a/Headers/Foundation/NSArchiver.h b/Headers/Foundation/NSArchiver.h
@@ -2,7 +2,7 @@
    Copyright (C) 1995, 1996, 1997, 1998 Free Software Foundation, Inc.
 
    Written by:  Andrew Kachites McCallum <mccallum@gnu.ai.mit.edu>
-   Rewrite by:  Richard Frith-Macdonald <rfm@gnu.org>
+   Written by:  Richard Frith-Macdonald <rfm@gnu.org>
    Date: March 1995
    
    This file is part of the GNUstep Base Library.

diff --git a/Headers/Foundation/NSArray.h b/Headers/Foundation/NSArray.h
@@ -1,4 +1,4 @@
-/* Interface for NSArray for GNUStep
+/**Interface for NSArray for GNUStep
    Copyright (C) 1995-2015 Free Software Foundation, Inc.
 
    Written by:  Andrew Kachites McCallum <mccallum@gnu.ai.mit.edu>

diff --git a/Headers/Foundation/NSByteCountFormatter.h b/Headers/Foundation/NSByteCountFormatter.h
@@ -1,4 +1,4 @@
-/* Definition of class NSByteCountFormatter
+/** Definition of class NSByteCountFormatter
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    Written by: 	Gregory Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSCache.h b/Headers/Foundation/NSCache.h
@@ -1,4 +1,4 @@
-/* Interface for NSCache for GNUStep
+/** Interface for NSCache for GNUStep
    Copyright (C) 2009 Free Software Foundation, Inc.
 
    Written by:  David Chisnall <csdavec@swan.ac.uk>

diff --git a/Headers/Foundation/NSComparisonPredicate.h b/Headers/Foundation/NSComparisonPredicate.h
@@ -1,4 +1,4 @@
-/* Interface for NSComparisonPredicate for GNUStep
+/** Interface for NSComparisonPredicate for GNUStep
    Copyright (C) 2005 Free Software Foundation, Inc.
 
    Written by:  Dr. H. Nikolaus Schaller

diff --git a/Headers/Foundation/NSCompoundPredicate.h b/Headers/Foundation/NSCompoundPredicate.h
@@ -1,4 +1,4 @@
-/* Interface for NSCompoundPredicate for GNUStep
+/** Interface for NSCompoundPredicate for GNUStep
    Copyright (C) 2005 Free Software Foundation, Inc.
 
    Written by:  Dr. H. Nikolaus Schaller

diff --git a/Headers/Foundation/NSData.h b/Headers/Foundation/NSData.h
@@ -1,4 +1,4 @@
-/* Interface for NSData for GNUStep
+/**Interface for NSData for GNUStep
    Copyright (C) 1995 Free Software Foundation, Inc.
 
    Written by:  Andrew Kachites McCallum <mccallum@gnu.ai.mit.edu>

diff --git a/Headers/Foundation/NSDistantObject.h b/Headers/Foundation/NSDistantObject.h
@@ -1,4 +1,4 @@
-/* Interface for GNU Objective-C version of NSDistantObject
+/**Interface for GNU Objective-C version of NSDistantObject
    Copyright (C) 1997 Free Software Foundation, Inc.
    
    Written by:  Richard Frith-Macdonald <richard@brainstorm.co.uk>

diff --git a/Headers/Foundation/NSEnergyFormatter.h b/Headers/Foundation/NSEnergyFormatter.h
@@ -1,4 +1,4 @@
-/* Definition of class NSEnergyFormatter
+/** Definition of class NSEnergyFormatter
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSExtensionRequestHandling.h b/Headers/Foundation/NSExtensionRequestHandling.h
@@ -1,7 +1,7 @@
-/* Definition of class NSExtensionRequestHandling
+/**Definition of class NSExtensionRequestHandling
    Copyright (C) 2019 Free Software Foundation, Inc.
    
-   By: heron
+   By: Gregory John Casamento <greg.casamento@gmail.com>
    Date: Sun Nov 10 04:00:05 EST 2019
 
    This file is part of the GNUstep Library.

diff --git a/Headers/Foundation/NSFileCoordinator.h b/Headers/Foundation/NSFileCoordinator.h
@@ -1,4 +1,4 @@
-/* Definition of class NSFileCoordinator
+/** Definition of class NSFileCoordinator
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    Implemented by: 	Gregory Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSFilePresenter.h b/Headers/Foundation/NSFilePresenter.h
@@ -1,9 +1,9 @@
-/* Definition of class NSFilePresenter
+/** Definition of class NSFilePresenter
    Copyright (C) 2019 Free Software Foundation, Inc.
    
-   Implemented by: 	Gregory Casamento <greg.casamento@gmail.com>
+   Written by: 	Gregory Casamento <greg.casamento@gmail.com>
    Date: 	Sep 2019
-   Original File by: Daniel Ferreira
+   Written by: Daniel Ferreira
 
    This file is part of the GNUstep Library.
    

diff --git a/Headers/Foundation/NSGeometry.h b/Headers/Foundation/NSGeometry.h
@@ -1,4 +1,4 @@
-/* Interface for NSGeometry routines for GNUStep
+/** Interface for NSGeometry routines for GNUStep
  * Copyright (C) 1995 Free Software Foundation, Inc.
  * 
  * Written by:  Adam Fedor <fedor@boulder.colorado.edu>

diff --git a/Headers/Foundation/NSHTTPCookie.h b/Headers/Foundation/NSHTTPCookie.h
@@ -1,7 +1,7 @@
-/* Interface for NSHTTPCookie for GNUstep
+/** Interface for NSHTTPCookie for GNUstep
    Copyright (C) 2006 Software Foundation, Inc.
 
-   Written by:  Richard Frith-Macdonald <frm@gnu.org>
+   Written by:  Richard Frith-Macdonald <rfm@gnu.org>
    Date: 2006
    
    This file is part of the GNUstep Base Library.

diff --git a/Headers/Foundation/NSHTTPCookieStorage.h b/Headers/Foundation/NSHTTPCookieStorage.h
@@ -1,7 +1,7 @@
-/* Interface for NSHTTPCookieStorage for GNUstep
+/** Interface for NSHTTPCookieStorage for GNUstep
    Copyright (C) 2006 Software Foundation, Inc.
 
-   Written by:  Richard Frith-Macdonald <frm@gnu.org>
+   Written by:  Richard Frith-Macdonald <rfm@gnu.org>
    Date: 2006
    
    This file is part of the GNUstep Base Library.

diff --git a/Headers/Foundation/NSISO8601DateFormatter.h b/Headers/Foundation/NSISO8601DateFormatter.h
@@ -1,4 +1,4 @@
-/* Definition of class NSISO8601DateFormatter
+/** Definition of class NSISO8601DateFormatter
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSItemProvider.h b/Headers/Foundation/NSItemProvider.h
@@ -1,7 +1,7 @@
-/* Definition of class NSItemProvider
+/**Definition of class NSItemProvider
    Copyright (C) 2019 Free Software Foundation, Inc.
    
-   By: heron
+   By: Gregory Casamento <greg.casamento@gmail.com>
    Date: Sun Nov 10 04:00:17 EST 2019
 
    This file is part of the GNUstep Library.

diff --git a/Headers/Foundation/NSItemProviderReadingWriting.h b/Headers/Foundation/NSItemProviderReadingWriting.h
@@ -1,7 +1,7 @@
-/* Definition of class NSItemProviderReadingWriting
+/**Definition of class NSItemProviderReadingWriting
    Copyright (C) 2019 Free Software Foundation, Inc.
    
-   By: heron
+   By: Gregory Casamento <greg.casamento@gmail.com>
    Date: Sun Nov 10 04:00:24 EST 2019
 
    This file is part of the GNUstep Library.

diff --git a/Headers/Foundation/NSJSONSerialization.h b/Headers/Foundation/NSJSONSerialization.h
@@ -1,3 +1,27 @@
+/**Definition of class NSJSONSerialization
+   Copyright (C) 2011-2021 Free Software Foundation, Inc.
+
+   By: David Chisnall <github@theravensnest.org>
+   Date: Jul 2011
+
+   This file is part of the GNUstep Library.
+
+   This library is free software; you can redistribute it and/or
+   modify it under the terms of the GNU Lesser General Public
+   License as published by the Free Software Foundation; either
+   version 2 of the License, or (at your option) any later version.
+
+   This library is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+   Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public
+   License along with this library; if not, write to the Free
+   Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+   Boston, MA 02110 USA.
+*/
+
 #import "Foundation/NSObject.h"
 
 @class NSData;

diff --git a/Headers/Foundation/NSLengthFormatter.h b/Headers/Foundation/NSLengthFormatter.h
@@ -1,4 +1,4 @@
-/* Definition of class NSLengthFormatter
+/**Definition of class NSLengthFormatter
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSLinguisticTagger.h b/Headers/Foundation/NSLinguisticTagger.h
@@ -1,4 +1,4 @@
-/* Definition of class NSLinguisticTagger
+/**Definition of class NSLinguisticTagger
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSLocale.h b/Headers/Foundation/NSLocale.h
@@ -1,8 +1,9 @@
-/* NSLocale.h
+/** NSLocale.h
    
    Copyright (C) 2010 Free Software Foundation, Inc.
    
-   Written by: Stefan Bidigaray, Richard Frith-Macdonald
+   Written by: Stefan Bidigaray
+   Written by: Richard Frith-Macdonald
    Date: June, 2010
    
    This library is free software; you can redistribute it and/or

diff --git a/Headers/Foundation/NSMapTable.h b/Headers/Foundation/NSMapTable.h
@@ -1,11 +1,10 @@
-/* NSMapTable interface for GNUStep.
+/**NSMapTable interface for GNUStep.
  * Copyright (C) 1994, 1995, 1996, 2002, 2009  Free Software Foundation, Inc.
  * 
  * Author: Albin L. Jones <Albin.L.Jones@Dartmouth.EDU>
  * Created: Tue Dec 13 00:05:02 EST 1994
- * Updated: Thu Mar 21 15:12:42 EST 1996
  * Serial: 96.03.21.05
- * Modified by: Richard Frith-Macdonald <rfm@gnu.org>
+ * Author: Richard Frith-Macdonald <rfm@gnu.org>
  * Updated: March 2009
  * 
  * This file is part of the GNUstep Base Library.

diff --git a/Headers/Foundation/NSMassFormatter.h b/Headers/Foundation/NSMassFormatter.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSMassFormatter
+/**Definition of class NSMassFormatter
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSMeasurement.h b/Headers/Foundation/NSMeasurement.h
@@ -1,4 +1,4 @@
-/* Definition of class NSMeasurement
+/**Definition of class NSMeasurement
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSMeasurementFormatter.h b/Headers/Foundation/NSMeasurementFormatter.h
@@ -1,4 +1,4 @@
-/* Definition of class NSMeasurementFormatter
+/**Definition of class NSMeasurementFormatter
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSMetadata.h b/Headers/Foundation/NSMetadata.h
@@ -1,7 +1,7 @@
 /**Interface for NSMetadataQuery for GNUStep
    Copyright (C) 2012 Free Software Foundation, Inc.
 
-   Written by: Gregory Casamento
+   Written by: Gregory John Casamento <greg.casamento@gmail.com>
    Date: 2012
    
    This file is part of the GNUstep Base Library.

diff --git a/Headers/Foundation/NSNetServices.h b/Headers/Foundation/NSNetServices.h
@@ -1,4 +1,4 @@
-/* Interface for NSNetServices for GNUstep
+/**Interface for NSNetServices for GNUstep
    Copyright (C) 2006 Free Software Foundation, Inc.
 
    Written by:  Chris B. Vetter

diff --git a/Headers/Foundation/NSObjectScripting.h b/Headers/Foundation/NSObjectScripting.h
@@ -1,7 +1,7 @@
-/* Definition of class NSObjectScripting
+/**Definition of class NSObjectScripting
    Copyright (C) 2019 Free Software Foundation, Inc.
    
-   By: heron
+   By: Gregory John Casamento <greg.casamento@gmail.com>
    Date: Fri Nov  1 00:25:37 EDT 2019
 
    This file is part of the GNUstep Library.

diff --git a/Headers/Foundation/NSOrthography.h b/Headers/Foundation/NSOrthography.h
@@ -1,7 +1,7 @@
-/* Definition of class NSOrthography
+/**Definition of class NSOrthography
    Copyright (C) 2019 Free Software Foundation, Inc.
    
-   By: heron
+   By: Gregory Casamento <greg.casamento@gmail.com>
    Date: Tue Nov  5 03:43:39 EST 2019
 
    This file is part of the GNUstep Library.

diff --git a/Headers/Foundation/NSPersonNameComponents.h b/Headers/Foundation/NSPersonNameComponents.h
@@ -1,4 +1,4 @@
-/* Definition of class NSPersonNameComponents
+/**Definition of class NSPersonNameComponents
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    Implemented by: Gregory Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSPersonNameComponentsFormatter.h b/Headers/Foundation/NSPersonNameComponentsFormatter.h
@@ -1,4 +1,4 @@
-/* Definition of class NSPersonNameComponents
+/**Definition of class NSPersonNameComponents
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    Implemented by: Gregory Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSProgress.h b/Headers/Foundation/NSProgress.h
@@ -1,4 +1,4 @@
-/* Definition of class NSProgress
+/**Definition of class NSProgress
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    Written by: 	Gregory Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSRegularExpression.h b/Headers/Foundation/NSRegularExpression.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSRegularExpression
+/**Definition of class NSRegularExpression
    Copyright (C) 2011 Free Software Foundation, Inc.
 
    This file is part of the GNUstep Library.

diff --git a/Headers/Foundation/NSScriptCoercionHandler.h b/Headers/Foundation/NSScriptCoercionHandler.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptCoercionHandler
+/**Definition of class NSScriptCoercionHandler
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptCommand.h b/Headers/Foundation/NSScriptCommand.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptCommand
+/**Definition of class NSScriptCommand
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptCommandDescription.h b/Headers/Foundation/NSScriptCommandDescription.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptCommandDescription
+/**Definition of class NSScriptCommandDescription
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptExecutionContext.h b/Headers/Foundation/NSScriptExecutionContext.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptExecutionContext
+/**Definition of class NSScriptExecutionContext
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptKeyValueCoding.h b/Headers/Foundation/NSScriptKeyValueCoding.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptKeyValueCoding
+/**Definition of class NSScriptKeyValueCoding
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptObjectSpecifiers.h b/Headers/Foundation/NSScriptObjectSpecifiers.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptObjectSpecifiers
+/**Definition of class NSScriptObjectSpecifiers
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptStandardSuiteCommands.h b/Headers/Foundation/NSScriptStandardSuiteCommands.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptStandardSuiteCommands
+/**Definition of class NSScriptStandardSuiteCommands
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptSuiteRegistry.h b/Headers/Foundation/NSScriptSuiteRegistry.h
@@ -1,5 +1,4 @@
-
-/* Definition of class NSScriptSuiteRegistry
+/**Definition of class NSScriptSuiteRegistry
    Copyright (C) 2019 Free Software Foundation, Inc.
    
    By: Gregory John Casamento <greg.casamento@gmail.com>

diff --git a/Headers/Foundation/NSScriptWhoseTests.h b/Headers/Foundation/NSScriptWhoseTests.h
@@ -1,4 +1,4 @@
-/*
+/**
    Global include file for the GNUstep Base Library.
 
    Copyright (C) 1997 Free Software Foundation, Inc.

diff --git a/Headers/Foundation/NSSerialization.h b/Headers/Foundation/NSSerialization.h
@@ -1,9 +1,9 @@
-/* Protocol for NSSerialization for GNUStep
+/** Protocol for NSSerialization for GNUStep
    Copyright (C) 1995 Free Software Foundation, Inc.
 
    Written by:  Andrew Kachites McCallum <mccallum@gnu.ai.mit.edu>
    Date: 1995
-   Updated by:	Richard Frith-Macdonald <richard@brainstorm.co.uk>
+   Author:	Richard Frith-Macdonald <richard@brainstorm.co.uk>
    Date: 1998
    
    This file is part of the GNUstep Base Library.

diff --git a/Headers/Foundation/NSSortDescriptor.h b/Headers/Foundation/NSSortDescriptor.h
@@ -1,4 +1,4 @@
-/* Interface for NSSortDescriptor for GNUStep
+/**Interface for NSSortDescriptor for GNUStep
    Copyright (C) 2005 Free Software Foundation, Inc.
 
    Written by:  Saso Kiselkov <diablos@manga.sk>

diff --git a/Headers/Foundation/NSTextCheckingResult.h b/Headers/Foundation/NSTextCheckingResult.h
@@ -1,4 +1,4 @@
-/* Copyright (C) 2011 Free Software Foundation, Inc.
+/**Copyright (C) 2011 Free Software Foundation, Inc.
    
    This file is part of the GNUstep Library.
    

diff --git a/Headers/Foundation/NSTimeZone.h b/Headers/Foundation/NSTimeZone.h
@@ -1,4 +1,4 @@
-/* Interface for NSTimeZone for GNUStep
+/**Interface for NSTimeZone for GNUStep
    Copyright (C) 1994, 1996, 1999 Free Software Foundation, Inc.
 
    This file is part of the GNUstep Base Library.

diff --git a/Headers/Foundation/NSURLAuthenticationChallenge.h b/Headers/Foundation/NSURLAuthenticationChallenge.h
@@ -1,4 +1,4 @@
-/* Interface for NSURLAuthenticationChallenge for GNUstep
+/**Interface for NSURLAuthenticationChallenge for GNUstep
    Copyright (C) 2006 Software Foundation, Inc.
 
    Written by:  Richard Frith-Macdonald <frm@gnu.org>

diff --git a/Headers/Foundation/NSURLCredential.h b/Headers/Foundation/NSURLCredential.h
@@ -1,4 +1,4 @@
-/* Interface for NSURLCredential for GNUstep
+/**Interface for NSURLCredential for GNUstep
    Copyright (C) 2006 Software Foundation, Inc.
 
    Written by:  Richard Frith-Macdonald <frm@gnu.org>

diff --git a/Headers/Foundation/NSURLCredentialStorage.h b/Headers/Foundation/NSURLCredentialStorage.h
@@ -1,4 +1,4 @@
-/* Interface for NSURLCredentialStorage for GNUstep
+/**Interface for NSURLCredentialStorage for GNUstep
    Copyright (C) 2006 Software Foundation, Inc.
 
    Written by:  Richard Frith-Macdonald <frm@gnu.org>

diff --git a/Headers/Foundation/NSURLDownload.h b/Headers/Foundation/NSURLDownload.h
@@ -1,4 +1,4 @@
-/* Interface for NSURLDownload for GNUstep
+/**Interface for NSURLDownload for GNUstep
    Copyright (C) 2006 Software Foundation, Inc.
 
    Written by:  Richard Frith-Macdonald <frm@gnu.org>