changing doc format and HTML literals

2026-04-22 01:56:46 +00:00
parent 8223dcc6b3
commit f7b066b374
123 changed files with 1917 additions and 1611 deletions
@@ -6,12 +6,17 @@ key : string uniquely identifying the task
 exec_func : function to execute
 return value : the process ID of the started (or still running) task

-:desc
-task() starts the 'exec_func' in a new process and returns that process' ID. If a process with the same 'key' is already running, task will not start a new process but instead just return the PID of the process that is already running.
-
 :see
 >task

-:related
-**PHP:** Background-process patterns using `proc_open()`, queues, cron, or worker supervisors
-**JavaScript / Node.js:** Node `child_process`, worker queues, timers, schedulers, and supervised background jobs
+:content
+Starts `exec_func` in a new process and returns that process ID.
+
+If a process with the same `key` is already running, `task()` does not start a second copy. Instead it returns the PID of the already-running task.
+
+Use the `key` to make a background job idempotent across repeated calls.
+
+Related:
+
+- PHP: background-process patterns using `proc_open()`, queues, cron, or worker supervisors
+- JavaScript / Node.js: Node `child_process`, worker queues, timers, schedulers, and supervised background jobs