txt: ## link.md
  link
  
  Combined from primary sources listed below.
  
  # [In IO::Path](#___top "go to top of document")[§](#(IO::Path)_routine_link "direct link")
  
  See primary documentation
  [in context](/type/IO/Path#routine_link)
  for **routine link**.
  
  ```raku
  method link(IO::Path:D $target: IO() $link --> Bool:D)
  sub    link(      IO() $target, IO() $link --> Bool:D)
  ```
  
  Create a new *hard* link `$link` to existing `$target`. Returns `True` on success; [fails](/routine/fail) with [`X::IO::Link`](/type/X/IO/Link) if the hard link could not be created. To create a symbolic link, see [`symlink`](/routine/symlink).
  