From af5304deef1ebbc671b0fc79f049a79f1ad8a192 Mon Sep 17 00:00:00 2001
From: Albert Chu <chu11@llnl.gov>
Date: Wed, 10 Jan 2024 17:37:58 -0800
Subject: [PATCH] fixup! rfc43: add new RFC for job list service

---
 spec_43.rst | 74 ++++++++++++++++++++---------------------------------
 1 file changed, 28 insertions(+), 46 deletions(-)

diff --git a/spec_43.rst b/spec_43.rst
index 3cccae6..4b88eaa 100644
--- a/spec_43.rst
+++ b/spec_43.rst
@@ -197,53 +197,35 @@ Constraint Operators
 Using the constraint syntax described by RFC31, jobs can be filtered
 based on the following constraint operators.
 
-.. list-table::
-   :header-rows: 1
+- ``userid``: Designate one or more userids (*integer) and match jobs
+  submitted by those userids.
 
-   * - Operator
-     - Values
-     - Value Encoding
-     - Description
-   * - userid
-     - one or more userids
-     - integer
-     - match jobs submitted by userids
-   * - name
-     - one or more job names
-     - string
-     - match jobs with job names
-   * - queue
-     - one or more queues
-     - string
-     - match jobs submitted to job queues
-   * - states
-     - one or more job states (bitmask of multiple states also allowed)
-     - string or integer
-     - match jobs in job states
-   * - results
-     - one or more job results (bitmask of multiple results also allowed)
-     - string or integer
-     - match jobs with job results
-   * - | t_submit
-       | t_depend
-       | t_run
-       | t_cleanup
-       | t_inactive
-     - one timestamp prefixed with ">", "<", ">=", or "<="
-     - string
-     - match jobs if the respective timestamp is greater than, less than, greater than or equal, or less than or equal to specified value
-   * - not
-     - one constraint object
-     - constraint object
-     - Logical negation of constraint object
-   * - or
-     - one or more constraint objects
-     - constraint object
-     - Logical or of constraint object(s)
-   * - and
-     - one or more constraint objects
-     - constraint object
-     - Logical and of constraint object(s)
+- ``name``: Designate one or more job names (*string) and match jobs
+  with those job names.
+
+- ``queue``: Designate one or more queues (*string*) and match jobs
+  with those job queues.
+
+- ``states``: Designate one or more job states (*string* or *integer*)
+   and match jobs in those job states.  Both bitmasks (including
+   multiple states) and string names of the states SHALL be accepted.
+
+- ``results``: Designate one or more job results (*string* or *integer*)
+   and match jobs with those results.  Both bitmasks (including
+   multiple results) and string names of the results SHALL be accepted.
+
+- ``t_submit``, ``t_depend``, ``t_run``, ``t_cleanup``,
+   ``t_inactive``: Designate one *string* to compare the respective
+   timestamp with.  The string SHALL be prefixed with ">", "<", ">=",
+   or "<=" and followed with a timestamp value.  Jobs will be matched
+   if the respective timestamp is greater than, less than, greater
+   than or equal, or less than or equal to specified value.
+
+- ``not``: Logical negation of one constraint object.
+
+- ``or``: Logical or of one or more constraint objects.
+
+- ``and``: Logical and of one or more constraint objects..
 
 The following are several constraints examples.