groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 07/23: [hdtbl]: Make examples more helpful.


From: G. Branden Robinson
Subject: [groff] 07/23: [hdtbl]: Make examples more helpful.
Date: Thu, 21 Nov 2024 14:47:47 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 347379d2df44809aa7a793a56e66a3c8ade66d10
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Nov 20 20:59:33 2024 -0600

    [hdtbl]: Make examples more helpful.
    
    * contrib/hdtbl/examples/chess_board.roff:
    * contrib/hdtbl/examples/col_rowspan_colors.roff:
    * contrib/hdtbl/examples/color_boxes.roff:
    * contrib/hdtbl/examples/color_nested_tables.roff:
    * contrib/hdtbl/examples/color_table_cells.roff:
    * contrib/hdtbl/examples/color_transitions.roff:
    * contrib/hdtbl/examples/fonts_n.in:
    * contrib/hdtbl/examples/fonts_x.in:
    * contrib/hdtbl/examples/mixed_pickles.roff:
    * contrib/hdtbl/examples/rainbow.roff:
    * contrib/hdtbl/examples/short_reference.roff: Use `soquiet` request
      instead of `so` and provide a more helpful diagnostic than the
      formatter would have.
---
 contrib/hdtbl/ChangeLog                         | 16 ++++++++++++++++
 contrib/hdtbl/examples/chess_board.roff         |  7 ++++++-
 contrib/hdtbl/examples/col_rowspan_colors.roff  |  8 +++++++-
 contrib/hdtbl/examples/color_boxes.roff         |  7 ++++++-
 contrib/hdtbl/examples/color_nested_tables.roff |  8 ++++++--
 contrib/hdtbl/examples/color_table_cells.roff   |  9 +++++++--
 contrib/hdtbl/examples/color_transitions.roff   |  9 +++++++--
 contrib/hdtbl/examples/fonts_n.in               |  8 +++++++-
 contrib/hdtbl/examples/fonts_x.in               |  8 +++++++-
 contrib/hdtbl/examples/mixed_pickles.roff       |  8 +++++++-
 contrib/hdtbl/examples/rainbow.roff             |  9 +++++++--
 contrib/hdtbl/examples/short_reference.roff     |  9 +++++++--
 12 files changed, 90 insertions(+), 16 deletions(-)

diff --git a/contrib/hdtbl/ChangeLog b/contrib/hdtbl/ChangeLog
index 3180cb47a..4b3ae6d91 100644
--- a/contrib/hdtbl/ChangeLog
+++ b/contrib/hdtbl/ChangeLog
@@ -1,3 +1,19 @@
+2024-11-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * examples/chess_board.roff:
+       * examples/col_rowspan_colors.roff:
+       * examples/color_boxes.roff:
+       * examples/color_nested_tables.roff:
+       * examples/color_table_cells.roff:
+       * examples/color_transitions.roff:
+       * examples/fonts_n.in:
+       * examples/fonts_x.in:
+       * examples/mixed_pickles.roff:
+       * examples/rainbow.roff:
+       * examples/short_reference.roff: Use `soquiet` request instead
+       of `so` and provide a more helpful diagnostic than the formatter
+       would have.
+
 2024-11-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [hdtbl]: Tweak shell style in test script.
diff --git a/contrib/hdtbl/examples/chess_board.roff 
b/contrib/hdtbl/examples/chess_board.roff
index c7eee60f6..63008c700 100644
--- a/contrib/hdtbl/examples/chess_board.roff
+++ b/contrib/hdtbl/examples/chess_board.roff
@@ -23,7 +23,12 @@ along with this program.  If not, see 
<http://www.gnu.org/licenses/>.
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
 .
 .
 .nr *x 8
diff --git a/contrib/hdtbl/examples/col_rowspan_colors.roff 
b/contrib/hdtbl/examples/col_rowspan_colors.roff
index 90f2e7a14..5bc9ca6e7 100644
--- a/contrib/hdtbl/examples/col_rowspan_colors.roff
+++ b/contrib/hdtbl/examples/col_rowspan_colors.roff
@@ -23,7 +23,13 @@ along with this program.  If not, see 
<http://www.gnu.org/licenses/>.
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .\" Seed the random number generator for reproducible builds.
 .random-seed 131545532 19201711
diff --git a/contrib/hdtbl/examples/color_boxes.roff 
b/contrib/hdtbl/examples/color_boxes.roff
index 02e548305..691dceed8 100644
--- a/contrib/hdtbl/examples/color_boxes.roff
+++ b/contrib/hdtbl/examples/color_boxes.roff
@@ -23,7 +23,12 @@ along with this program.  If not, see 
<http://www.gnu.org/licenses/>.
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
 .
 .\" Seed the random number generator for reproducible builds.
 .random-seed 131545532 19201711
diff --git a/contrib/hdtbl/examples/color_nested_tables.roff 
b/contrib/hdtbl/examples/color_nested_tables.roff
index 946d2974c..6d5435aaa 100644
--- a/contrib/hdtbl/examples/color_nested_tables.roff
+++ b/contrib/hdtbl/examples/color_nested_tables.roff
@@ -19,13 +19,17 @@ for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
 ..
 .
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
 .
 .
 .\" Seed the random number generator for reproducible builds.
diff --git a/contrib/hdtbl/examples/color_table_cells.roff 
b/contrib/hdtbl/examples/color_table_cells.roff
index df059c35a..6c44801fe 100644
--- a/contrib/hdtbl/examples/color_table_cells.roff
+++ b/contrib/hdtbl/examples/color_table_cells.roff
@@ -19,13 +19,18 @@ for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
 ..
 .
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .\" Seed the random number generator for reproducible builds.
 .random-seed 131545532 19201711
diff --git a/contrib/hdtbl/examples/color_transitions.roff 
b/contrib/hdtbl/examples/color_transitions.roff
index 0ab59ea49..ddf1a2812 100644
--- a/contrib/hdtbl/examples/color_transitions.roff
+++ b/contrib/hdtbl/examples/color_transitions.roff
@@ -19,13 +19,18 @@ for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
 ..
 .
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .de ctab
 .nr #cc 0
diff --git a/contrib/hdtbl/examples/fonts_n.in 
b/contrib/hdtbl/examples/fonts_n.in
index 212f7ecbf..5405bd8bb 100644
--- a/contrib/hdtbl/examples/fonts_n.in
+++ b/contrib/hdtbl/examples/fonts_n.in
@@ -38,7 +38,13 @@ along with this program.  If not, see 
<http://www.gnu.org/licenses/>.
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .if !d fontpath \
 .  ds fontpath @fontdir@
diff --git a/contrib/hdtbl/examples/fonts_x.in 
b/contrib/hdtbl/examples/fonts_x.in
index 7b4ba1347..e8c49e4cf 100644
--- a/contrib/hdtbl/examples/fonts_x.in
+++ b/contrib/hdtbl/examples/fonts_x.in
@@ -38,7 +38,13 @@ along with this program.  If not, see 
<http://www.gnu.org/licenses/>.
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .if !d fontpath \
 .  ds fontpath @fontdir@
diff --git a/contrib/hdtbl/examples/mixed_pickles.roff 
b/contrib/hdtbl/examples/mixed_pickles.roff
index 4153e6591..37b997e1c 100644
--- a/contrib/hdtbl/examples/mixed_pickles.roff
+++ b/contrib/hdtbl/examples/mixed_pickles.roff
@@ -29,7 +29,13 @@ along with this program.  If not, see 
<http://www.gnu.org/licenses/>.
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .H Table with Mixed Content: \
    .br \
diff --git a/contrib/hdtbl/examples/rainbow.roff 
b/contrib/hdtbl/examples/rainbow.roff
index ecd59f51a..e36094f0f 100644
--- a/contrib/hdtbl/examples/rainbow.roff
+++ b/contrib/hdtbl/examples/rainbow.roff
@@ -19,13 +19,18 @@ for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
 ..
 .
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .nr *n 25
 .nr *# 0 1
diff --git a/contrib/hdtbl/examples/short_reference.roff 
b/contrib/hdtbl/examples/short_reference.roff
index 0d1a647ca..fa94e9c0d 100644
--- a/contrib/hdtbl/examples/short_reference.roff
+++ b/contrib/hdtbl/examples/short_reference.roff
@@ -19,13 +19,18 @@ for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
 ..
 .
 .if !d sopath \
 .  ds sopath
 .
-.so \*[sopath]examples/common.roff
+.ds lib examples/common.roff
+.soquiet \*[sopath]\*[lib]
+.if !d common \{\
+.  tmc \n[.F]: cannot find "\*[lib]"; specify its location
+.  tm1 " with groff '-I' or '-d sopath=' option
+.\}
+.
 .
 .t*pv 1.2 1.2 "" x
 .H Short Reference for the HDtbl-Macros



reply via email to

[Prev in Thread] Current Thread [Next in Thread]