github.com/lmorg/murex@v0.0.0-20240217211045-e081c89cd4ef/builtins/core/processes/bgfg_doc.yaml (about)

     1  - DocumentID: bg
     2    Title: >+
     3      `bg`
     4    CategoryID: commands
     5    Summary: >-
     6      Run processes in the background
     7    Description: |-
     8      `bg` supports two modes: it can either be run as a function block which will
     9      execute in the background, or it can take stopped processes and daemonize
    10      them.
    11    Usage: |-
    12      POSIX only:
    13       ```
    14       bg { code block }
    15  
    16       bg fid
    17       ```
    18    Examples: |-
    19  
    20      ```
    21      bg { sleep 5; out "Morning" }
    22      ```
    23  
    24    Flags:
    25    Detail: |-
    26      The examples above will work on any system (Windows included). However the
    27      `ctrl+z` usage of backgrounding a stopped process (like Bash) is only
    28      supported on POSIX systems due to the limitation of required signals on
    29      non-platforms. This means the usage described in the examples is cross
    30      cross platform while `bg int` currently does not work on Windows nor Plan 9.
    31    Synonyms:
    32    Related:
    33      - fid-list
    34      - fid-kill
    35      - fid-killall
    36      - fg
    37      - jobs
    38      - exec
    39  
    40  - DocumentID: fg
    41    Title: >+
    42      `fg`
    43    CategoryID: commands
    44    Summary: >-
    45      Sends a background process into the foreground
    46    Description: |-
    47      `fg` resumes a stopped process and sends it into the foreground.
    48    Usage: |-
    49      POSIX only:
    50  
    51      ```
    52      fg fid
    53      ```
    54    Examples: |-
    55    Flags:
    56    Detail: |-
    57      This builtin is only supported on POSIX systems. There is no support planned
    58      for Windows (due to the kernel not supporting the right signals) nor Plan 9.
    59    Synonyms:
    60    Related:
    61      - fid-list
    62      - fid-kill
    63      - fid-killall
    64      - bg
    65      - jobs
    66      - exec