Merge pull request #440 from gnustep/agsdoc-html-style

Agsdoc html style update

ChangeLog

@@ -1,3 +1,10 @@
+2024-11-08 Richard Frith-Macdonald <[email protected]>
+
+	* Headers/Foundation/NSFileHandle.h:
+	* Source/GSFileHandle.m:
+	* Source/NSFileHandle.m:
+	Add -truncateAtOffset:error: method (issue 325)
+
 2024-11-03 Richard Frith-Macdonald <[email protected]>
 
 	* Source/NSFileManager.m: Fix case where positive result of asking
@@ -31,9 +38,10 @@
 	* Source/NSDatePrivate.h:
 	NSDate is now a small object in slot 6, when configuring GNUstep with the
 	clang/libobjc2 toolchain.  This is done by compressing the binary64 fp
-	holding the seconds since reference date (because someone at Apple thought
-	it would be a good idea to represent a time interval as a fp). Note that
-	this assumes that IEEE 754 is used.
+	holding the seconds since reference date (because someone at Apple
+	thought it would be a good idea to represent a time interval as a fp).
+	Note that this assumes that IEEE 754 is used.
+
 	* Source/NSCalendarDate.m:
 	Remove access to the NSDate private concrete Class
 	and implement -timeIntervalSinceReferenceDate instead.

Headers/Foundation/NSFileHandle.h

@@ -99,6 +99,11 @@ GS_EXPORT_CLASS
 - (void) synchronizeFile;
 - (void) truncateFileAtOffset: (unsigned long long)pos;
 
+#if OS_API_VERSION(MAC_OS_X_VERSION_10_15, GS_API_LATEST)
+- (BOOL) truncateAtOffset: (unsigned long long)offset 
+                    error: (out NSError **)error;
+#endif
+
 @end
 
 // Notification names.

Source/DocMakefile

@@ -243,7 +243,8 @@ GCObject.h \
 # directory.
 #
 Base_AGSDOC_FLAGS = \
-	-MakeFrames YES \
+	-MakeFrames NO \
+	-IndexFile Base \
 	-DocumentationDirectory ../Documentation/Base \
 	-HeaderDirectory ../Headers/Foundation \
 	-Declared Foundation \
@@ -252,14 +253,14 @@ Base_AGSDOC_FLAGS = \
 	-ConstantsTemplate TypesAndConstants \
 	-FunctionsTemplate Functions \
 	-MacrosTemplate Functions \
-	-StylesheetURL gnustepStyle \
 	-TypedefsTemplate TypesAndConstants \
 	-VariablesTemplate TypesAndConstants \
 	-WordMap '{\
 	}' -Up Base
 
 BaseAdditions_AGSDOC_FLAGS = \
-	-MakeFrames YES \
+	-MakeFrames NO \
+	-IndexFile BaseAdditions \
 	-DocumentationDirectory ../Documentation/BaseAdditions \
 	-HeaderDirectory ../Headers/GNUstepBase \
 	-Declared GNUstepBase \

Source/GSFileHandle.m

@@ -1722,7 +1722,6 @@ - (void) truncateFileAtOffset: (unsigned long long)pos
     {
       [NSException raise: NSFileHandleOperationException
 		  format: @"attempt to truncate invalid file"];
-
     }
   if (ftruncate(descriptor, pos) < 0)
     {
@@ -1732,6 +1731,21 @@ - (void) truncateFileAtOffset: (unsigned long long)pos
   [self seekToFileOffset: pos];
 }
 
+- (BOOL) truncateAtOffset: (unsigned long long)offset
+                    error: (out NSError **)error
+{
+  if (ftruncate((isStandardFile ? descriptor : -1), offset) < 0)
+    {
+      if (error)
+	{
+	  *error = [NSError _last];
+	}
+      return NO;
+    }
+  [self seekToFileOffset: offset];
+  return YES;
+}
+
 - (void) writeInBackgroundAndNotify: (NSData*)item forModes: (NSArray*)modes
 {
   NSMutableDictionary*	info;

Source/NSFileHandle.m

@@ -467,6 +467,12 @@ - (void) truncateFileAtOffset: (unsigned long long)pos
   [self subclassResponsibility: _cmd];
 }
 
+- (BOOL) truncateAtOffset: (unsigned long long)offset
+                    error: (out NSError **)error
+{
+  [self subclassResponsibility: _cmd];
+  return NO;
+}
 
 @end
 

Tools/AGSHtml.h

@@ -50,6 +50,7 @@
   unsigned		sssect;
   BOOL			isContentsDoc;
   BOOL			ivarsAtEnd;
+  BOOL			cssNavigation;
   BOOL			verbose;
   BOOL			warn;
 }
@@ -61,6 +62,9 @@
 - (NSString*) makeLink: (NSString*)r
 		ofType: (NSString*)t
 		 isRef: (BOOL)f;
+- (NSString*) makeURL: (NSString*)r
+	       ofType: (NSString*)t
+                isRef: (BOOL)f;
 - (NSString*) makeLink: (NSString*)r
 		ofType: (NSString*)t
 		inUnit: (NSString*)u