Fix comments for documentation

prodos/directory.go

@@ -39,11 +39,17 @@ type DirectoryHeader struct {
 }
 
 const (
-	StorageDeleted   = 0
+	// File is deleted
-	StorageSeedling  = 1
+	StorageDeleted = 0
-	StorageSapling   = 2
+	// File is <= 512 bytes
-	StorageTree      = 3
+	StorageSeedling = 1
-	StoragePascal    = 4
+	// File is > 512 bytes and <= 128 KB
+	StorageSapling = 2
+	// File is > 128 KB and <= 16 MB
+	StorageTree = 3
+	// Pacal storage area
+	StoragePascal = 4
+	// Directory
 	StorageDirectory = 13
 )
 

prodos/memfile.go

@@ -6,20 +6,24 @@
 
 package prodos
 
+// MemoryFile containts file data and size
 type MemoryFile struct {
 	data []byte
 	size int
 }
 
+// NewMemoryFile creates an in-memory file of the specified size in bytes
 func NewMemoryFile(size int) *MemoryFile {
 	return &MemoryFile{make([]byte, size), size}
 }
 
+// WriteAt writes data to the specified offset in the file
 func (memoryFile *MemoryFile) WriteAt(data []byte, offset int64) (int, error) {
 	copy(memoryFile.data[int(offset):], data)
 	return len(data), nil
 }
 
+// ReadAt reads data from the specified offset in the file
 func (memoryFile *MemoryFile) ReadAt(data []byte, offset int64) (int, error) {
 	copy(data, memoryFile.data[int(offset):])
 	return len(data), nil