txt: ## dist_zef-lizmat-P5chdir.md
  [![Actions Status](https://github.com/lizmat/P5chdir/workflows/test/badge.svg)](https://github.com/lizmat/P5chdir/actions)
  
  # NAME
  
  Raku port of Perl's chdir() built-in
  
  # SYNOPSIS
  
  ```
  use P5chdir;
  
  say "switched" if chdir; # switched to HOME or LOGDIR
  
  say "switched" if chdir("lib");
  
  ```
  
  # DESCRIPTION
  
  This module tries to mimic the behaviour of Perl's `chdir` built-in as closely as possible in the Raku Programming Language.
  
  ## ORIGINAL PERL 5 DOCUMENTATION
  
  ```
  chdir EXPR
  chdir FILEHANDLE
  chdir DIRHANDLE
  chdir   Changes the working directory to EXPR, if possible. If EXPR is
          omitted, changes to the directory specified by $ENV{HOME}, if set;
          if not, changes to the directory specified by $ENV{LOGDIR}. (Under
          VMS, the variable $ENV{SYS$LOGIN} is also checked, and used if it
          is set.) If neither is set, "chdir" does nothing. It returns true
          on success, false otherwise. See the example under "die".
  
          On systems that support fchdir(2), you may pass a filehandle or
          directory handle as the argument. On systems that don't support
          fchdir(2), passing handles raises an exception.
  
  ```
  
  ## PORTING CAVEATS
  
  In raku, `chdir` only changes the `$*CWD` dynamic variable. It does **not** actually change the default directory from the OS's point of view. This is done this way, because there is no concept of a "default directory per OS thread". And since Raku does not fork, but only does threading, it was felt that the "current directory" concept should be in the `$*CWD` dynamic variable, which can be lexically scoped, and thus can be thread-safe.
  
  # AUTHOR
  
  Elizabeth Mattijsen [liz@raku.rocks](mailto:liz@raku.rocks)
  
  Source can be located at: <https://github.com/lizmat/P5chdir> . Comments and Pull Requests are welcome.
  
  # COPYRIGHT AND LICENSE
  
  Copyright 2018, 2019, 2020, 2021 Elizabeth Mattijsen
  
  Re-imagined from Perl as part of the CPAN Butterfly Plan.
  
  This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.
  