doc: small documentation tweaks

Author: stevearc

doc/oil.txt

@@ -409,7 +409,7 @@ toggle_trash                                                *actions.toggle_tras
 HIGHLIGHTS                                                        *oil-highlights*
 
 OilDir                                                                 *hl-OilDir*
-    Directories in an oil buffer
+    Directory names in an oil buffer
 
 OilDirIcon                                                         *hl-OilDirIcon*
     Icon for directories
@@ -442,13 +442,14 @@ OilChange                                                           *hl-OilChang
     Change action in the oil preview window
 
 OilRestore                                                         *hl-OilRestore*
-    Restore a file from trash
+    Restore (from the trash) action in the oil preview window
 
 OilPurge                                                             *hl-OilPurge*
-    Permanently delete a file from trash
+    Purge (Permanently delete a file from trash) action in the oil preview
+    window
 
 OilTrash                                                             *hl-OilTrash*
-    Delete a file to the trash
+    Trash (delete a file to trash) action in the oil preview window
 
 OilTrashSourcePath                                         *hl-OilTrashSourcePath*
     Virtual text that shows the original path of file in the trash
@@ -474,11 +475,11 @@ Linux:
 
 Mac:
     Oil has limited support for MacOS due to the proprietary nature of the
-    implementation. The trash bin can only be viewed as single dir
+    implementation. The trash bin can only be viewed as a single dir
     (instead of being able to see files that were trashed from a directory).
 
 Windows:
-    Oil does not yet support the Windows trash.
+    Oil does not yet support the Windows trash. PRs are welcome!
 
 ================================================================================
 vim:tw=80:ts=2:ft=help:norl:syntax=help:

lua/oil/adapters/trash/freedesktop.lua

@@ -1,7 +1,6 @@
 -- Based on the FreeDesktop.org trash specification
 -- https://specifications.freedesktop.org/trash-spec/trashspec-1.0.html
--- TODO
--- * make sure that the subdirs for trash use the same entry as the root
+-- TODO make sure that the subdirs for trash use the same entry as the root
 local cache = require("oil.cache")
 local config = require("oil.config")
 local constants = require("oil.constants")

lua/oil/init.lua

@@ -628,7 +628,7 @@ M._get_highlights = function()
     {
       name = "OilDir",
       link = "Directory",
-      desc = "Directories in an oil buffer",
+      desc = "Directory names in an oil buffer",
     },
     {
       name = "OilDirIcon",
@@ -683,17 +683,17 @@ M._get_highlights = function()
     {
       name = "OilRestore",
       link = "OilCreate",
-      desc = "Restore a file from trash",
+      desc = "Restore (from the trash) action in the oil preview window",
     },
     {
       name = "OilPurge",
       link = "OilDelete",
-      desc = "Permanently delete a file from trash",
+      desc = "Purge (Permanently delete a file from trash) action in the oil preview window",
     },
     {
       name = "OilTrash",
       link = "OilDelete",
-      desc = "Delete a file to the trash",
+      desc = "Trash (delete a file to trash) action in the oil preview window",
     },
     {
       name = "OilTrashSourcePath",

scripts/generate.py

@@ -136,15 +136,29 @@ class ColumnDef:
     ),
     ColumnDef("size", "files, ssh", False, True, "The size of the file", HL + []),
     ColumnDef(
-        "permissions", "files, ssh", True, False, "Access permissions of the file", HL + []
+        "permissions",
+        "files, ssh",
+        True,
+        False,
+        "Access permissions of the file",
+        HL + [],
+    ),
+    ColumnDef(
+        "ctime", "files", False, True, "Change timestamp of the file", HL + TIME + []
     ),
-    ColumnDef("ctime", "files", False, True, "Change timestamp of the file", HL + TIME + []),
     ColumnDef(
         "mtime", "files", False, True, "Last modified time of the file", HL + TIME + []
     ),
-    ColumnDef("atime", "files", False, True, "Last access time of the file", HL + TIME + []),
     ColumnDef(
-        "birthtime", "files", False, True, "The time the file was created", HL + TIME + []
+        "atime", "files", False, True, "Last access time of the file", HL + TIME + []
+    ),
+    ColumnDef(
+        "birthtime",
+        "files",
+        False,
+        True,
+        "The time the file was created",
+        HL + TIME + [],
     ),
 ]
 
@@ -239,11 +253,11 @@ def get_trash_vimdoc() -> "VimdocSection":
 
 Mac:
     Oil has limited support for MacOS due to the proprietary nature of the
-    implementation. The trash bin can only be viewed as single dir
+    implementation. The trash bin can only be viewed as a single dir
     (instead of being able to see files that were trashed from a directory).
 
 Windows:
-    Oil does not yet support the Windows trash.
+    Oil does not yet support the Windows trash. PRs are welcome!
 """
     )
     return section