aboutsummaryrefslogtreecommitdiff
path: root/vis-subprocess.c
diff options
context:
space:
mode:
authorMatěj Cepl <mcepl@cepl.eu>2025-06-12 18:49:34 +0200
committerRandy Palamar <randy@rnpnr.xyz>2025-06-13 08:19:26 -0600
commit18fb151c7d80c2e37a07177f39d186df50fccb14 (patch)
tree47ab28599a4df51488aaca5c6f14b89b61e9f043 /vis-subprocess.c
parent44e0280ee72587e47f184ae6a372e9f6bb0c761f (diff)
downloadvis-18fb151c7d80c2e37a07177f39d186df50fccb14.tar.gz
vis-18fb151c7d80c2e37a07177f39d186df50fccb14.tar.xz
doc: fix Doxygen comments for vis-subprocess.c
Diffstat (limited to 'vis-subprocess.c')
-rw-r--r--vis-subprocess.c6
1 files changed, 5 insertions, 1 deletions
diff --git a/vis-subprocess.c b/vis-subprocess.c
index e17d24f..3223f10 100644
--- a/vis-subprocess.c
+++ b/vis-subprocess.c
@@ -29,7 +29,7 @@ static Process *new_process_in_pool(void) {
/**
* Removes the subprocess information from the pool, sets invalidator to NULL
* and frees resources.
- * @param a reference to the process to be removed
+ * @param target reference to the process to be removed
* @return the next process in the pool
*/
static Process *destroy_process(Process *target) {
@@ -59,6 +59,7 @@ static Process *destroy_process(Process *target) {
* of the process.
* Also stores the subprocess information to the internal pool to track
* its status and responses.
+ * @param vis the editor instance
* @param name a string that contains a unique name for the subprocess.
* This name will be passed to the PROCESS_RESPONSE event handler
* to distinguish running subprocesses.
@@ -164,6 +165,7 @@ int vis_process_before_tick(fd_set *readfds) {
* Reads data from the given subprocess file descriptor `fd` and fires
* the PROCESS_RESPONSE event in Lua with given subprocess `name`,
* `rtype` and the read data as arguments.
+ * @param vis the editor instance
* @param fd the file descriptor to read data from
* @param name a name of the subprocess
* @param rtype a type of file descriptor where the new data is found
@@ -179,6 +181,7 @@ static void read_and_fire(Vis* vis, int fd, const char *name, ResponseType rtype
/**
* Checks if a subprocess is dead or needs to be killed then raises an event
* or kills it if necessary.
+ * @param vis the editor instance
* @param current the process to wait for or kill
* @return true if the process is dead
*/
@@ -211,6 +214,7 @@ just_destroy:
* the pool. If so, it reads their data and fires corresponding events.
* Also checks if each subprocess from the pool is dead or needs to be
* killed then raises an event or kills it if necessary.
+ * @param vis the editor instance
* @param readfds the structure for `pselect` call with file descriptors
*/
void vis_process_tick(Vis *vis, fd_set *readfds) {