Document Omit in Overview; minor adjustments

Author: philpennock

LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright © 2016,2018 Pennock Tech, LLC
+Copyright © 2016,2018,2025 Pennock Tech, LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

Overview.md

@@ -277,12 +277,19 @@ appropriately within tabular itself.
   + Skipability:
     - `Skipable` is the property key, value must be a boolean
     - non-boolean values may result in panic
-    - currently only a column property, and is permitted to be used by
-      renderers to control whether or not to skip a column entirely,
-      or for the JSON rendered to skip including a field for items in that
-      column if empty.
-      + At present, is only used by JSON, have not yet implemented a
-        multiple-pass system to let it be used for entire-column suppression.
+    - currently only a column property, used by JSON to indicate to skip
+      fields in that column, if and only if those cells are empty.
+  + Omission:
+    - `Omit` is the property key, value must be a boolean
+    - indicates that the affected item should not be rendered, at all, no
+      matter the value
+    - is currently only a column property, may be extended to rows in the
+      future
+    - is supported by all renderers
+    - all renderers support this property being on Column 0 (the defaults
+      pseudo-column) to set a default for the table's columns, such that this
+      bool can be set explicitly false on some columns to only render those
+      columns.
 * `go.pennock.tech/tabular/properties/align`
   + controls for text alignment; currently this is limited to very simplistic
     `Left`, `Center` and `Right` values, which may be used as values for the

doc.go

@@ -11,6 +11,10 @@ Sub-packages provide for rendering a TextTable which is designed for a
 fixed-cell grid layout of character cells, such as a Unix TTY; for rendering as
 an HTML table; for rendering as a CSV.
 
+Most clients doing table rendering should probably import
+"go.pennock.tech/tabular/auto" and use `auto.New("texttable")` to get an object
+which can be easily rendered.
+
 The core package provides a Table interface; each sub-package embeds a Table in
 their own core object, so all methods in the Table interface can be directly
 used upon such objects.  These provide for your basic addition of cells, etc.