Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
syndot
syndot

Library

  • syndot
    • add
    • diffuse
    • init
    • link
    • list
    • remove
    • rename
    • unlink
  • map.ini
  • gum

References

  • Get Started
    • Installation
  • PyPI
  • Issue Tracker
  • Source Code
  • License
  • Release Notes
    • Version 2.3.1
    • Version 2.3.0
    • Version 2.2.0
    • Version 2.1.0
    • Version 2.0.0
    • Version 1.0.0
Back to top
View this page

link¶

Move dotfiles to the settings directory and create symlinks to them.

Interactive mode to select label(s) is available only if gum is installed in the system.

Usage¶

syndot link [-b | --backup] ([-i | --interactive] | [[-l | --label] <LABEL>...] | [[-p | --path] <PATH>...]) [[-m | --mapfile] <MAP_FILE>] [-n | --no-confirm] [[-s | --start] <PATH_START>]

Options¶

  • -b, --backup - Create a backup copy of the original dotfile.

  • -h, --help - Show the help message and exit.

  • -i, --interactive - Select label(s) to link the associated path(s) in interactive mode using gum, if it is installed in the system. At least a label must be selected. Not allowed together with [-l | --label] or [-p | --path] options.

    Added in version 2.1.

  • -l, --label <LABEL> [<LABEL>...] - Label(s) to link the associated path(s). At least a <LABEL> must be provided. Not allowed together with [-i | --interactive] or [-p | --path] options.

    Added in version 2.0.

  • -m, --mapfile <MAP_FILE> - Path to the map file. If not provided search for a map.ini file in the current directory, so not required if current directory is the settings directory.

  • -n, --no-confirm - Do not ask for confirmation.

    Added in version 2.1.

  • -p, --path <PATH> [<PATH>...] - Dotfile path(s) to link. At least a <PATH> must be provided. Not allowed together with [-i | --interactive] or [-l | --label] options.

    Added in version 2.0.

  • -s, --start <PATH_START> - Filter target based on path starting with <PATH_START>.

    Added in version 2.0.

Next
list
Previous
init
Copyright © 2024 - 2026, Andrea Blengino
Made with Sphinx and @pradyunsg's Furo
On this page
  • link
    • Usage
    • Options