Merge pull request #5838 from grondo/jobtap-R

doc: add missing R documentation to flux-jobtap-plugins(7)

doc/man7/flux-jobtap-plugins.rst

@@ -82,6 +82,7 @@ The full list of available args includes the following:
 name       type description
 ========== ==== ==========================================
 jobspec    o    jobspec with environment redacted
+R          o    R with scheduling key redacted (RUN state or later)
 id         I    jobid
 state      i    current job state
 prev_state i    previous state (``job.state.*`` callbacks)
@@ -208,6 +209,11 @@ job.state.priority
   ``flux_jobtap_reprioritize_job()``. See the :ref:`priority` section
   for more detailed information about plugin management of job priority.
 
+job.state.sched
+  In the callback for ``FLUX_JOB_STATE_SCHED`` a plugin may set ``R``
+  in output args. In this case, if an ``R`` is not already assigned, then
+  this will force ``R`` for the current job and bypass the scheduler.
+
 job.priority.get
   The job manager calls the ``job.priority.get`` topic whenever it wants
   to update the job priority of a single job. The plugin should return a