Update upstream source from tag 'upstream/5.8'

Update to upstream version '5.8'
with Debian dir b7a9cb7b782a12a49dca06e06ca2554b5a95bf93

1 files changed, 22 insertions, 0 deletions

diff --git a/Doc/help/dot b/Doc/help/dot
new file mode 100644
index 000000000..2d969a509
--- /dev/null
+++ b/Doc/help/dot
@@ -0,0 +1,22 @@
+. file [ arg ... ]
+       Read  commands  from  file and execute them in the current shell
+       environment.
+
+       If file does not contain a slash, or if PATH_DIRS  is  set,  the
+       shell  looks  in  the  components of $path to find the directory
+       containing file.  Files in the current directory  are  not  read
+       unless  `.'  appears  somewhere  in  $path.   If  a  file  named
+       `file.zwc' is found, is newer than file,  and  is  the  compiled
+       form  (created with the zcompile builtin) of file, then commands
+       are read from that file instead of file.
+
+       If any arguments arg are given, they become the  positional  pa-
+       rameters;  the  old  positional parameters are restored when the
+       file is done executing.  However, if no arguments are given, the
+       positional  parameters  remain those of the calling context, and
+       no restoring is done.
+
+       If file was not found the return status  is  127;  if  file  was
+       found  but  contained  a  syntax error the return status is 126;
+       else the return status is the exit status of  the  last  command
+       executed.