txt: ## symlink.md
  symlink
  
  Combined from primary sources listed below.
  
  # [In IO::Path](#___top "go to top of document")[§](#(IO::Path)_routine_symlink "direct link")
  
  See primary documentation
  [in context](/type/IO/Path#routine_symlink)
  for **routine symlink**.
  
  ```raku
  method symlink(IO::Path:D $target: IO() $link, Bool :$absolute = True --> Bool:D)
  sub    symlink(      IO() $target, IO() $link, Bool :$absolute = True --> Bool:D)
  ```
  
  Create a new *symbolic* link `$link` to existing `$target`. Returns `True` on success; [fails](/routine/fail) with [`X::IO::Symlink`](/type/X/IO/Symlink) if the symbolic link could not be created. If `$target` does not exist, creates a dangling symbolic link.
  
  `symlink` creates a symbolic link using an absolute path by default. To create a relative symlink set the `absolute` parameter to `False` e.g. `:!absolute`. This flag was introduced in Rakudo version 2020.11.
  
  To create a hard link, see [`link`](/routine/link).
  
  **Note:** on Windows, creation of symbolic links may require escalated privileges.
  